Webhook

Ein Webhook ist ein automatisierter HTTP-Callback, der Ihr System in Echtzeit über Ereignisse informiert – etwa wenn eine Nachricht empfangen, zugestellt oder gelesen wurde. Statt dass Ihre Software ständig nach Updates fragt (Polling), wird sie vom Server proaktiv benachrichtigt (Push).

Was ist ein Webhook?

Ein Webhook ist ein Event-basierter HTTP-POST-Request, den eine API an Ihre URL sendet, sobald ein bestimmtes Ereignis eintritt. Während Sie bei normalen API-Aufrufen Daten aktiv abfragen ("Hat sich was geändert?"), dreht der Webhook das Prinzip um: Der Service informiert Sie automatisch ("Gerade ist X passiert").

Im Messaging-Kontext bedeutet das: Wenn ein Kunde Ihnen eine WhatsApp-Nachricht schickt, sendet SendSeven einen POST-Request an Ihre Webhook-URL (z.B. https://ihreshop.de/webhooks/messages) mit allen Nachrichtendetails als JSON. Ihre Software empfängt die Daten sofort und kann reagieren – ohne ständiges Abfragen.

Webhooks nutzen Standard-HTTP: POST-Request mit JSON-Body, optional signiert mit HMAC-SHA256 für Sicherheit. Ihr Server antwortet mit HTTP 200 OK zur Bestätigung. Bei Fehlern (z.B. Server down) wiederholt die API den Request mit exponentiell steigenden Pausen (Retry-Logik).

Warum sind Webhooks wichtig?

Webhooks ermöglichen Echtzeit-Integration ohne Performance-Overhead:

Push statt Pull – Keine ständigen API-Abfragen, Ihr Server wird nur bei Events kontaktiert
Echtzeit-Reaktion – Sekunden statt Minuten zwischen Event und Aktion
Ressourcen-Effizienz – Keine unnötigen Requests, niedrigere Kosten
Event-Granularität – Unterschiedliche Webhooks für message.received, message.delivered, message.read, etc.
Asynchrone Workflows – Langwierige Prozesse im Hintergrund, ohne API-Timeouts

Typische Use Cases: Nachricht empfangen → CRM-Ticket erstellen, Nachricht zugestellt → Status im Dashboard updaten, Nachricht gelesen → Analytics tracken, Opt-out → Kontakt aus Marketing-Liste entfernen.

Praktisches Beispiel

Ihr E-Commerce-Shop nutzt WhatsApp für Support. Sie konfigurieren einen Webhook bei SendSeven:

Webhook-URL: https://shop.example.com/api/webhooks/messages
Events: message.received, message.delivered

Ein Kunde schreibt: "Wo ist meine Bestellung #12345?" SendSeven sendet sofort einen POST-Request an Ihre URL:

{
  "event": "message.received",
  "messageId": "msg_xyz789",
  "from": "+491701234567",
  "channel": "whatsapp",
  "text": "Wo ist meine Bestellung #12345?",
  "timestamp": "2026-02-19T14:45:30Z"
}

Ihre Shop-Software empfängt den Webhook, extrahiert die Bestellnummer, holt Tracking-Daten aus der Datenbank und sendet via REST API eine Antwort an den Kunden – vollautomatisch, in Sekunden.

Webhooks mit SendSeven

SendSeven bietet granulare Webhook-Events für alle 7 Kanäle: message.received, message.delivered, message.read, message.failed, contact.opt_in, contact.opt_out und mehr.

Setup im Dashboard: Webhook-URL eintragen, Events auswählen, Secret-Key für HMAC-Signatur erhalten. Für die Authentifizierung wird Ihr API-Key verwendet. Jeder Webhook-Request enthält einen X-SendSeven-Signature-Header – Sie validieren die Signatur, um sicherzustellen, dass der Request wirklich von SendSeven stammt.

Retry-Logik bei Fehlern (5 Versuche über 24 Stunden), Webhook-Logs im Dashboard, Test-Requests zum Debugging. Vollständige Dokumentation mit Code-Beispielen: Webhook-Guide