SilentChat

Webhook-Events

Zuletzt aktualisiert: 16. November 2026

Ausgelöste Ereignisse

EreignisWann
conversation.createdEin neues Gespräch beginnt — durch einen Besucher oder durch Ihr Team aus der Besucherliste
conversation.assignedEin Gespräch wird einer Person zugewiesen (auch bei einer Weitergabe)
conversation.transferredEin Gespräch wird an eine Kollegin, einen Kollegen oder eine Abteilung weitergegeben
conversation.closedEin Gespräch wird geschlossen (auch automatisch)
message.newEine neue Nachricht im Gespräch — vom Besucher, vom Team oder vom Bot
visitor.newEin neuer Besucher wird erfasst — im Chat-Widget oder als neuer E-Mail-Absender. Verlangt Ihr Widget eine Einwilligung, erst nach der Zustimmung
contact.createdEin Kontakt wird angelegt
contact.updatedEin Kontakt wird geändert
team.member_joinedEine Person tritt Ihrem Team bei (Einladung angenommen, Beitrittsanfrage bestätigt oder direkt hinzugefügt)
team.member_removedEine 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:

EreignisFelder in data
Gesprächs-Ereignisseconversation_id, visitor_id, widget_id, status, created_at, falls vorhanden assigned_user_id und department_id
conversation.transferredzusätzlich previous_assigned_user_id (falls vorher jemand zuständig war) und transferred_by_user_id
visitor.newvisitor_id, source (widget oder email), created_at, beim Widget widget_id
contact.createdcontact_id, type, created_at, updated_at, falls verknüpft visitor_id und company_id
contact.updatedwie contact.created, dazu changed_fields — die Namen der geänderten Felder, nicht die Werte
team.member_joinedmember_id, user_id, role_id, seat_type, joined_at
team.member_removeduser_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.