Definition
Ein Webhook ist ein HTTP-Request, den eine Plattform an eine von Ihnen angegebene URL sendet, sobald ein Ereignis eintritt – etwa wenn eine Nachricht zugestellt, gelesen oder nicht zugestellt wird oder eine Kundenantwort eingeht. So erfährt Ihr System sofort davon, ohne Polling.
Sie registrieren einen Endpunkt (zum Beispiel https://example.com/hooks/messaging). Tritt ein Ereignis ein, sendet die Plattform einen POST-Request mit einem JSON-Body, der es beschreibt: Message-ID, Status, Zeitstempel, Kanal und Fehlerdetails. Ihr Server sollte schnell mit einem 2xx-Code antworten und das Ereignis asynchron verarbeiten.
Planen Sie für die Praxis: Webhooks können verspätet, in falscher Reihenfolge oder mehrfach eintreffen. Deduplizieren Sie anhand von Message-ID und Status, setzen Sie einen Status nie zurück (etwa von READ auf DELIVERED) und sorgen Sie für einen wiederholungssicheren, idempotenten Handler.
Sicherheit: Akzeptieren Sie nur HTTPS, prüfen Sie bei jedem Request eine Signatur oder ein Shared Secret und vertrauen Sie dem Payload erst nach erfolgreicher Prüfung. Branchenkonventionen wie die Standard-Webhooks-Spezifikation beschreiben gängige Muster für Signaturen und Wiederholungen.
Im Messaging speisen Webhooks Zustellberichte, Leseraten, eingehende Antworten, Abmeldungen und Entscheidungen über Channel-Fallback.
OmniChannels.ai sendet Webhooks für Zustellstatus (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED), kanalübergreifend in einem einheitlichen Format.
Beispiel
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}