Kern-APIs
Nachrichtenstatus, Verlauf & erneutes Senden
Eine Nachricht nachschlagen, den Zustellverlauf durchsuchen, erneut senden oder eine wartende Nachricht abbrechen.
Eine einzelne Nachricht abrufen
curl https://api.wezend.com/v1/messages/msg_01H8... \
-H "X-API-Key: $WEZEND_API_KEY"
{
"message_id": "msg_01H8...",
"status": "delivered",
"channel": "sms",
"to": "+4512345678",
"fallback_used": false,
"sent_at": "2026-07-08T10:00:01.000Z",
"delivered_at": "2026-07-08T10:00:04.000Z",
"cost": 0.045,
"currency": "EUR"
}
Was die Status bedeuten
| Status | Bedeutung |
|---|---|
queued | Angenommen und wartet auf einen Worker. Das Kontingent ist hier bereits gezählt. |
sending | An einen Vendor übergeben, noch keine Antwort. |
sent | Der Vendor hat sie angenommen. Kein Beweis für die Ankunft. |
delivered | Bestätigt durch einen Zustellbericht (SMS/RCS) oder durch Engagement und Bounce-Feedback (E-Mail). |
bounced | Nur E-Mail — der empfangende Server hat sie abgewiesen. |
failed | Aufgegeben. failed_reason nennt den Grund, in einer Sprache, die man Nutzenden zeigen kann. |
suppressed | Nie gesendet: die empfangende Person steht auf Ihrer Sperrliste für diesen Kanal — oder das Konto hat seine E-Mail-Adresse noch nicht bestätigt, dann steht es in failed_reason. |
scheduled | Wartet auf ihren scheduled_at-Zeitpunkt. |
cancelled | Eine geplante Nachricht, die Sie vor dem Lauf abgebrochen haben. |
E-Mail-delivered hinkt nach — beabsichtigt. SMS und RCS erhalten einen Zustellbericht des Carriers, delivered kommt also Sekunden nach sent. E-Mail hat kein Äquivalent: sie gilt als zugestellt aufgrund von Engagement und dem Fehlen eines Bounces, nicht aufgrund eines SMTP-Handshakes. Ein erfolgreicher E-Mail-Versand steht daher eine Weile auf sent, und eine Kampagne mit delivered: 0 wenige Minuten nach dem Versand ist normal — nicht defekt.
failed_reason ist für Menschen geschrieben. Ein Transportfehler liest sich handlungsleitend — „vorübergehend nicht zustellbar, bitte später erneut" — statt interne Details offenzulegen; der zugrunde liegende Fehler bleibt in unseren Logs.
Verlauf durchsuchen
GET /v1/messages/history unterstützt die Query-Parameter search (trifft auf Empfänger, Body oder die Message-ID des Anbieters zu), status, channel, page und limit (max. 100/Seite).
Erneut senden
POST /v1/messages/:id/resend erzeugt eine neue Nachricht an denselben Empfänger mit demselben Inhalt — sie durchläuft dieselben Guthaben-, Suppression- und Budgetprüfungen wie ein regulärer Versand. Wenn Sie stattdessen sehen wollen, was mit der ursprünglichen passiert ist, liefert GET /v1/messages/:id/timeline die geordneten Schritte — in der Warteschlange, versandt, die Antwort des Vendors, jede Zustellbestätigung — und das ist der schnellste Weg, eine Vendor-Ablehnung von einem Empfänger zu unterscheiden, der nie reagiert hat.
Eine geplante Nachricht abbrechen
DELETE /v1/messages/:id bricht eine Nachricht ab, die noch queued ist (d. h. über scheduled_at vorgeplant und noch nicht versendet). Gibt 409 zurück, wenn sie bereits gesendet wurde.
Eine Plattform. Jede Kundeninteraktion.
Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.
Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA