Webhooks einrichten | Mosaio

Webhooks senden bei bestimmten Ereignissen eine HTTP-Anfrage an deine Ziel-URL – ideal für CRM, Newsletter-Tools, Slack oder Automatisierungsplattformen. Du verwaltest sie unter Datensätze → Webhooks (/data/webhooks).

Webhook anlegen

Klicke auf Webhook anlegen.
Vergib einen Namen, z. B. „CRM-Synchronisation“.
Trage die Ziel-URL ein. Nur HTTPS; interne Adressen und Weiterleitungen werden nicht angesteuert.
Wähle die HTTP-Methode (POST empfohlen).
Wähle unter Datensätze den Datentyp und die Ereignisse und/oder unter Funnels den Funnel.
Speichere und kopiere das angezeigte Secret. Es wird nur einmal angezeigt.

Ereignisse

Ereignis	Auslöser
`record.created`	Eintrag angelegt
`record.updated`	Eintrag geändert
`record.deleted`	Eintrag gelöscht oder archiviert
`funnel.completed`	Funnel abgeschlossen
`funnel.partial_lead`	Teil-Lead erfasst
`webhook.test`	Test über „Test senden“

Funnel-Ereignisse sind nur für Rollen mit Zugriff auf Funnel-Antworten verfügbar. Pro Unternehmen sind bis zu 20 Webhooks möglich.

Methoden

Methode	Nutzdaten
POST, PUT, PATCH	JSON im Body
GET	JSON im Query-Parameter `payload` – nicht für Funnel-Ereignisse

Wiederholungen

Antwortet dein Endpunkt nicht mit einem 2xx-Status, versucht Mosaio es bis zu acht Mal erneut – nach 30 s, 2 min, 10 min, 30 min, 1 h, 3 h, 6 h und 12 h. Scheitern alle Versuche, wird der Webhook gestoppt (Status Gestoppt) und muss wieder aktiviert werden.

Detailansicht

Test senden – schickt ein webhook.test-Ereignis.
Zustellungen – jede Zustellung mit Status, Versuchen und Antwortcode.
Nutzdaten anzeigen – der JSON-Body, der gesendet wurde.
Erneut senden – eine Zustellung manuell wiederholen.
Secret erneuern – neues Secret erzeugen; das alte wird ungültig.

Antworte schnell mit 2xx und verarbeite die Daten danach asynchron. Nutze die webhook-id zur Duplikaterkennung – bei Wiederholungen kann dasselbe Ereignis mehrfach ankommen.