Webhook erstellen
- Gehen Sie zu Einstellungen → APIs & Webhooks → Webhooks
- Klicken Sie auf + Webhook erstellen
- Geben Sie Ihre Webhook-URL ein (muss öffentlich zugänglich sein)
- Klicken Sie auf Speichern
Webhooks verwalten
Bearbeiten: Klicken Sie auf den Webhook → URL aktualisieren → Speichern Löschen: Klicken Sie auf den Webhook → Löschen → BestätigenEreignisse
Twenty sendet Webhooks für diese Ereignistypen:
Alle Ereignistypen werden an Ihre Webhook-URL gesendet. Eine Ereignisfilterung kann in zukünftigen Versionen hinzugefügt werden.
Payload-Format
Jeder Webhook sendet eine HTTP-POST-Anfrage mit einem JSON-Body:Antworten Sie mit einem 2xx-HTTP-Status (200-299), um den Empfang zu bestätigen. Nicht-2xx-Antworten werden als Zustellfehler protokolliert.
Webhook-Validierung
Twenty signiert jede Webhook-Anfrage zu Sicherheitszwecken. Validieren Sie die Signaturen, um sicherzustellen, dass die Anfragen authentisch sind.Header
Validierungsschritte
- Den Zeitstempel aus
X-Twenty-Webhook-Timestampabrufen - Zeichenfolge erstellen:
{timestamp}:{JSON payload} - Den HMAC-SHA256-Hash mit Ihrem Webhook-Geheimnis berechnen
- Mit
X-Twenty-Webhook-Signaturevergleichen
Beispiel (Node.js)
Webhooks vs Workflows
Für den Empfang externer Daten siehe Webhook-Trigger einrichten.