Skip to main content
Twenty sendet einen HTTP POST an Ihre URL, wenn ein Datensatz erstellt, aktualisiert oder gelöscht wird. Alle Objekttypen sind abgedeckt, einschließlich benutzerdefinierter Objekte.

Webhook erstellen

  1. Gehen Sie zu Einstellungen → APIs & Webhooks → Webhooks
  2. Klicken Sie auf + Webhook erstellen
  3. Geben Sie Ihre Webhook-URL ein (muss öffentlich zugänglich sein)
  4. Klicken Sie auf Speichern
Der Webhook wird sofort aktiviert und beginnt, Benachrichtigungen zu senden.

Webhooks verwalten

Bearbeiten: Klicken Sie auf den Webhook → URL aktualisieren → Speichern Löschen: Klicken Sie auf den Webhook → Löschen → Bestätigen

Ereignisse

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.

Validierungsschritte

  1. Den Zeitstempel aus X-Twenty-Webhook-Timestamp abrufen
  2. Zeichenfolge erstellen: {timestamp}:{JSON payload}
  3. Den HMAC-SHA256-Hash mit Ihrem Webhook-Geheimnis berechnen
  4. Mit X-Twenty-Webhook-Signature vergleichen

Beispiel (Node.js)

Webhooks vs Workflows

Für den Empfang externer Daten siehe Webhook-Trigger einrichten.