Verfolgung
Nachrichtenstatus und Zustellberichte
| status | Bedeutung | Endgültig | Belastet |
|---|---|---|---|
| scheduled | Wartet auf send_at. | No | Ja, bei Stornierung erstattet |
| queued | Akzeptiert und wartet auf den nächsten Durchlauf der Warteschlange (alle zwei Sekunden). | No | Yes |
| sent | An das Netzwerk übergeben; wartet auf den Zustellbericht. | No | Yes |
| delivered | Das Endgerät hat die Zustellung bestätigt. | Yes | Yes |
| failed | Konnte nicht zugestellt werden; Fehler gibt den Grund an. | Yes | Nein, erstattet |
| canceled | Der geplante Batch wurde storniert. | Yes | Nein, erstattet |
Fehlercodes bei Nachrichten
| error.code | Bedeutung |
|---|---|
| network_error | Die Nachricht konnte nicht an das Netzwerk übergeben werden. Der Betrag wurde dem Guthaben wieder gutgeschrieben. |
| undeliverable | Das Netzwerk meldete, dass das Endgerät nicht erreichbar war. |
| canceled | Der geplante Batch wurde vor dem Start storniert. |
Rückerstattungen
Wenn eine Nachricht fehlschlägt, wird der volle Betrag dem Guthaben im selben Durchlauf gutgeschrieben, als Rückerstattungseintrag in der Buchung mit Batch-Nennung. Das Batch-Feld refunded zeigt den laufenden Gesamtbetrag.
Webhooks oder Abfragen
Webhooks sind der schnelle Weg: Jeder endgültige Status ruft Ihren Endpunkt auf, sobald er feststeht. Für kleine Mengen oder zur Überprüfung können Sie GET /v1/messages/{id} oder GET /v1/batches/{id} abfragen; das Rate-Limit lässt Platz für beides.