Webhooks

Inhaber und Unternehmensadmin öffnen Unternehmensadmin → Vertrieb & Integrationen → Integrationen → API und Webhooks. Ein Webhook sendet bei jedem gewählten Ereignis einen HTTPS-POST mit JSON an Ihr System.

#Webhook erstellen

1. Wählen Sie unter Webhooks Neuer Webhook.
2. Geben Sie einen Name und die URL ein. Nur HTTPS. Interne und private Netzwerkadressen sind gesperrt.
3. Haken Sie unter Ereignisse an, was gesendet wird: lead.created, deal.created, deal.stage_changed, deal.won, deal.lost, contact.created, contact.updated, company.created, company.updated.
4. Wählen Sie Webhook erstellen, kopieren Sie das Signatur-Secret und wählen Sie Gespeichert. Verwenden Sie es, um bei jeder Anfrage den Header X-Dromix-Signature zu prüfen. Es wird nur jetzt angezeigt; Sie können es später rotieren.

Mit Test senden senden Sie sofort ein ping-Ereignis.

#Signatur prüfen

Jede Anfrage enthält die Header X-Dromix-Event, X-Dromix-Event-Id, X-Dromix-Delivery, X-Dromix-Timestamp (Unix-Sekunden) und X-Dromix-Signature. Die Signatur ist sha256= + HMAC-SHA256(secret, {timestamp}.{body}). Berechnen Sie sie auf Ihrer Seite, vergleichen Sie sie und lehnen Sie Anfragen ab, die älter als 5 Minuten sind.

Nach einer Wiederholung kann dasselbe Ereignis zweimal ankommen. Nutzen Sie X-Dromix-Event-Id, um Doppelte zu überspringen.

Wenn das Secret bekannt wird, wählen Sie Secret rotieren. Das alte Secret funktioniert sofort nicht mehr. Aktualisieren Sie direkt danach Ihren Empfänger.

#Zustellungen und Wiederholungen

Unter Zustellprotokoll sehen Sie jede Zustellung mit Status, Versuchen und nächstem Versuch. Fehlgeschlagene Zustellungen werden nach 1 Min., 5 Min., 30 Min., 2 Std., 6 Std. und 24 Std. wiederholt. Ein Webhook wird nach 50 Fehlschlägen in Folge deaktiviert oder wenn der Empfänger mit 410 Gone antwortet.

Schalten Sie den Webhook mit An wieder ein, sobald Ihr Empfänger wieder funktioniert.