SilentChat

Webhooks einrichten

Zuletzt aktualisiert: 16. November 2026

Webhooks senden einen HTTP-POST an Ihre URL, sobald in SilentChat ein Ereignis eintritt — etwa ein neues Gespräch oder eine neue Nachricht. So binden Sie Zapier, Make oder Ihr eigenes System an.

Webhook erstellen

Integrationen → Webhooks → „Webhook hinzufügen“

FeldBeschreibung
URLIhr Endpunkt (HTTPS empfohlen). Interne Adressen wie localhost oder private Netze werden abgelehnt.
EreignisseWelche Ereignisse den Webhook auslösen
SecretWird beim Anlegen erzeugt und bei SilentChat verschlüsselt gespeichert; damit prüfen Sie die Signatur. Angezeigt wird es nur einmal — über „Geheimnis rotieren“ erhalten Sie ein neues, das Sie dann kopieren.

Header jeder Zustellung

HeaderInhalt
X-Webhook-SignatureHMAC-SHA256 des Request-Bodys mit Ihrem Secret, hexadezimal
X-Webhook-IDEindeutige Zustell-ID — dieselbe wie id im Body. Kommt eine ID zweimal, ist es eine Wiederholung.
X-Webhook-EventDas Ereignis, z. B. message.new
X-Webhook-TimestampZeitpunkt des Versands (Unix-Sekunden)

Signatur prüfen

Berechnen Sie HMAC-SHA256 über den unveränderten Request-Body mit Ihrem Secret und vergleichen Sie das Ergebnis (hexadezimal) mit X-Webhook-Signature. Stimmt es nicht überein, verwerfen Sie die Anfrage.

Wiederholungen

Antwortet Ihr Endpunkt mit 2xx, gilt die Zustellung als erfolgreich. Bei einem Netzwerkfehler, 5xx, 408 oder 429 versucht SilentChat es erneut — nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 8 Stunden, insgesamt 6 Versuche. Andere 4xx-Antworten werden nicht wiederholt.

Scheitert eine Zustellung nach allen Versuchen, zeigt der Webhook den Hinweis „Zustellung scheitert“, bis wieder eine Zustellung gelingt.

Protokoll

Unter Protokoll sehen Sie jede Zustellung mit Status (ausstehend, zugestellt, fehlgeschlagen), Antwortcode und Anzahl der Versuche. Einträge werden nach 30 Tagen gelöscht — sie enthalten Nachrichteninhalte.

Webhook testen

Webhooks → [Webhook] → „Test senden“ schickt sofort ein Test-Ereignis (event: test) an Ihre URL — ein Versuch, ohne Wiederholung.