Bricksta
English
Integration & Automatisierung

Ausgehende Webhooks: Ereignisse an andere Tools senden

Während ein Trigger Bricksta von außen anstößt, wirkt ein ausgehender Webhook in die andere Richtung: Passiert etwas in einem Vorgang, schickt Bricksta die Daten an ein anderes System — etwa an Zapier, Make, n8n oder ein eigenes Backend. Ausgehende Webhooks findest du im Menü unter Automatisierung → Ausgehend.

Auf dieser Seite

Wie ein ausgehender Webhook wirkt

Ein Webhook hört auf ein Ereignis im Lebenszyklus eines Vorgangs einer Vorlage — angelegt, gestartet, abgeschlossen, eine Aufgabe erledigt oder eine Phase abgeschlossen. Tritt es ein, schickt Bricksta die zugehörigen Daten als JSON per POST an die hinterlegte Ziel-Adresse. Weil praktisch jedes Tool eingehende Webhooks entgegennimmt, deckt dieser eine Baustein beliebig viele Zielsysteme ab.

Einen Webhook anlegen

  1. 1
    Öffne Automatisierung → Ausgehend.
  2. 2
    Gib dem Webhook einen Namen, wähle die Vorlage und das Ereignis, auf das er reagieren soll.
  3. 3
    Trage die Ziel-Adresse (URL) des empfangenden Systems ein. Sie muss öffentlich erreichbar sein — Adressen, die in ein internes Netz zeigen (etwa localhost, 127.0.0.1, private Bereiche oder die Metadaten-Adresse einer Cloud), weist Bricksta ab.
  4. 4
    Optional: erzeuge ein Secret — Bricksta erzeugt den Wert selbst und legt jeder Sendung eine Signatur bei, mit der die Gegenseite die Echtheit prüfen kann. „generieren“ ersetzt ein bestehendes Secret sofort; trage den neuen Wert dann auch beim Empfänger ein.
  5. 5
    Mit „Test senden“ prüfst du die Verbindung, bevor der Webhook produktiv wird.
Das ausgefüllte Anlege-Formular eines Webhooks: Name „Onboarding an Zapier“, Vorlagen-Auswahl „Mitarbeiter-Onboarding“, Ereignis-Auswahl und die Ziel-URL, rechts der „Hinzufügen“-Button.
Das Anlege-Formular: Name, Vorlage, Ereignis und Ziel-URL eintragen — dann hinzufügen.
Die Ausgehend-Seite: oben das Anlege-Formular mit Name, Vorlagen-Auswahl, Ereignis-Auswahl („Vorgang abgeschlossen“) und Ziel-URL; darunter der Webhook „Onboarding an Zapier“ mit Vorlage, Ereignis und Aktiv-Status.
Die Ausgehend-Seite: oben das Anlege-Formular mit Ereignis-Auswahl und Ziel-URL, darunter die vorhandenen Webhooks mit Vorlage, Ereignis und Status.

Jede Sendung landet mit ihrem HTTP-Status im Lauf-Protokoll, sodass du siehst, ob die Gegenseite sie angenommen hat. Über den Aktiv-Schalter pausierst du einen Webhook, ohne ihn zu löschen.

Antwortet die Gegenseite nicht, bricht Bricksta die Sendung nach zehn Sekunden ab und vermerkt sie als Fehlversuch — ein hängendes Ziel hält die übrigen Webhooks also nicht auf. Eine einzelne fehlgeschlagene Sendung wird nicht wiederholt: sie steht mit ihrem Fehler im Lauf-Protokoll, und die nächsten Ereignisse laufen normal weiter. Wiederholt wird nur, wenn Bricksta ein Ereignis gar nicht erst bearbeiten konnte — und höchstens fünfmal, danach gibt Bricksta es auf. Ein Ziel, das Bricksta für dasselbe Ereignis schon einmal angerufen hat, wird bei einer solchen Wiederholung nur dann erneut angerufen, wenn der erste Aufruf mit einem Fehler im Lauf-Protokoll steht. Steht dort ein Eintrag ohne HTTP-Status, konnte Bricksta das Ergebnis des ersten Aufrufs nicht festhalten — dann bleibt es bei dem einen Aufruf, damit die Gegenseite dasselbe Ereignis nicht zweimal bekommt.

Ausgehende Webhooks zu verwalten und ihr Secret zu sehen setzt das Recht zur Vorlagen-Verwaltung (template.manage) voraus. Mitglieder ohne dieses Recht sehen die Webhooks, aber nicht ihr Secret.

Alle Themen