Webhook-Events
Zuletzt aktualisiert: 16. November 2026
Ausgelöste Ereignisse
| Ereignis | Wann |
|---|---|
| conversation.created | Ein neues Gespräch beginnt — durch einen Besucher oder durch Ihr Team aus der Besucherliste |
| conversation.assigned | Ein Gespräch wird einer Person zugewiesen (auch bei einer Weitergabe) |
| conversation.transferred | Ein Gespräch wird an eine Kollegin, einen Kollegen oder eine Abteilung weitergegeben |
| conversation.closed | Ein Gespräch wird geschlossen (auch automatisch) |
| message.new | Eine neue Nachricht im Gespräch — vom Besucher, vom Team oder vom Bot |
| visitor.new | Ein neuer Besucher wird erfasst — im Chat-Widget oder als neuer E-Mail-Absender. Verlangt Ihr Widget eine Einwilligung, erst nach der Zustimmung |
| contact.created | Ein Kontakt wird angelegt |
| contact.updated | Ein Kontakt wird geändert |
| team.member_joined | Eine Person tritt Ihrem Team bei (Einladung angenommen, Beitrittsanfrage bestätigt oder direkt hinzugefügt) |
| team.member_removed | Eine Person wird aus Ihrem Team entfernt |
Payload-Format
Jede Zustellung sendet einen JSON-Body:
{
"id": "01a1c9f6-3ab0-7d5f-8a2d-90c5ff5ce675",
"event": "message.new",
"tenant_id": "01a1c94b-df4e-749e-9e06-e962b0d9f658",
"created_at": "2026-11-11T12:00:00Z",
"data": {
"message_id": "01a1ca2b-…",
"conversation_id": "01a1ca2a-…",
"sender_type": "visitor",
"content_type": "text",
"content": "Hallo, ich habe eine Frage zur Lieferung.",
"created_at": "2026-11-11T12:00:00Z"
}
}
Was data je Ereignis enthält:
| Ereignis | Felder in data |
|---|---|
| Gesprächs-Ereignisse | conversation_id, visitor_id, widget_id, status, created_at, falls vorhanden assigned_user_id und department_id |
| conversation.transferred | zusätzlich previous_assigned_user_id (falls vorher jemand zuständig war) und transferred_by_user_id |
| visitor.new | visitor_id, source (widget oder email), created_at, beim Widget widget_id |
| contact.created | contact_id, type, created_at, updated_at, falls verknüpft visitor_id und company_id |
| contact.updated | wie contact.created, dazu changed_fields — die Namen der geänderten Felder, nicht die Werte |
| team.member_joined | member_id, user_id, role_id, seat_type, joined_at |
| team.member_removed | user_id, removed_at |
Bewusst nicht enthalten: IP-Adressen, Namen, E-Mail-Adressen und Telefonnummern — weder von Besuchern noch von Kontakten oder Teammitgliedern —, außerdem Notizen. Was Sie darüber hinaus brauchen, fragen Sie mit einem API-Schlüssel über die REST-API ab, zum Beispiel einen Kontakt über seine contact_id.
Datenschutz
Mit message.new gehen Nachrichteninhalte an die URL, die Sie eintragen. Sie entscheiden, wohin — tragen Sie nur Ziele ein, mit denen Sie die Daten Ihrer Besucher teilen dürfen.