Messages API-Statusrückrufe

Die Messages API sendet Statusrückrufe an Ihre Webhook-URL, um Sie zu informieren, wenn ein Ereignis den Status einer Nachricht ändert, z. B. wenn sie übermittelt, zugestellt oder abgelehnt wird.

Diese Rückrufe bieten einen konsistenten Einblick in den Nachrichtenlebenszyklus über alle unterstützten Kanäle, einschließlich SMS, MMS, RCSund Anwendungen: WhatsApp, Viberund Facebook Messenger.

Jedes Mal, wenn sich der Status einer Nachricht ändert, sendet Messages API einen Status-Callback an Ihren konfigurierten Webhook.
Dieser Rückruf enthält wichtige Informationen wie die UUID der Nachricht, den Kanal, den Zeitstempel, den Zustellungsstatus und ggf. Preis- und Netzwerk-Metadaten.

Unterschiedliche Kanäle unterstützen unterschiedliche Ereignisse und Ebenen der Einsicht. Zum Beispiel:

Kanal	Kostenpflichtiges Ereignis	Typischer Endstatus
WhatsApp, Viber, FB	Wenn `delivered`	`read`, `delivered`, `rejected`
RCS	Wenn `delivered`	`read`, `delivered`, `rejected`
SMS	Wenn `submitted`	`delivered`, `rejected`
MMS	Wenn `submitted`	`delivered`, `rejected`

Rückruf-Status

Statusrückrufe lesen

Für OTT-Kanäle wie WhatsApp und Viber kann die Messages API eine read Callback, wenn der Anbieter anzeigt, dass der Endnutzer die Nachricht auf seinem Gerät gelesen hat.

Eingereichte Statusrückrufe

Dieser Status bedeutet, dass Messages API eine Nachricht an einen Messaging-Anbieter weitergegeben hat.

Unzustellbarkeitsstatus Rückrufe

Dieser Status bedeutet, dass die Messages API keine Verbindung zum Messaging-Anbieter herstellen konnte. Dies kann auf einen Ausfall des Messaging-Anbieters oder ein anderes Ereignis zurückzuführen sein.

Abgelehnte Statusrückrufe

Eine Nachricht kann aus verschiedenen Gründen abgelehnt werden:

Messages API kann die Nachricht nicht verarbeiten (z. B. wegen ungültiger Parameter oder nicht unterstützter Medien).
Der Anbieter lehnt die Nachricht ab, z. B. beim Versand von MMS in ein nicht unterstütztes Land.
Die Time-to-live (TTL) der Nachricht läuft ab, bevor sie zugestellt werden kann.

In diesen Fällen ist eine rejected Callback wird mit einem Fehlerobjekt gesendet, das den Fehler beschreibt.

Beispiel Rückrufe

SMS (Mehrteilige Nachricht)

{
  "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "to": "447700900000",
  "from": "447700900001",
  "timestamp": "2023-05-01T14:00:00.000Z",
  "status": "submitted",
  "usage": {
    "currency": "EUR",
    "price": "0.0333"
  },
  "client_ref": "string",
  "channel": "sms",
  "destination": {
    "network_code": "12345"
  },
  "sms": {
    "total_count": "2"
  }
}

RCS (Abgelehnte Anfrage mit SMS-Failover)

Netzwerk-Codes

Messages API enthält eine network_code in Rückrufen, um den Betreiber zu identifizieren, der die Nachricht bearbeitet. Netzcodes sind Kombinationen aus Mobile Country Codes (MCC) und Mobile Network Codes (MNC) und gelten für SMS, RCS und MMS und stellen die genauesten Daten dar, die zum Zeitpunkt des Statusrückrufereignisses verfügbar sind.