Webhooks einrichten
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“
| Feld | Beschreibung |
|---|---|
| URL | Ihr Endpunkt (HTTPS empfohlen). Interne Adressen wie localhost oder private Netze werden abgelehnt. |
| Ereignisse | Welche Ereignisse den Webhook auslösen |
| Secret | Wird 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
| Header | Inhalt |
|---|---|
X-Webhook-Signature | HMAC-SHA256 des Request-Bodys mit Ihrem Secret, hexadezimal |
X-Webhook-ID | Eindeutige Zustell-ID — dieselbe wie id im Body. Kommt eine ID zweimal, ist es eine Wiederholung. |
X-Webhook-Event | Das Ereignis, z. B. message.new |
X-Webhook-Timestamp | Zeitpunkt 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.