Beskedstatus, historik & gensendelse

Hent en enkelt besked

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"
}

Hvad hver status betyder

Email-delivered halter — det er by design. SMS og RCS får en leveringskvittering fra operatøren, så delivered ankommer sekunder efter sent. Email har ingen tilsvarende: den tælles som leveret ud fra engagement og fraværet af en bounce, ikke ud fra et SMTP-håndtryk. En succesfuld email-afsendelse står derfor på sent et stykke tid, og en kampagne der viser delivered: 0 minutter efter afsendelse er normalt — ikke i stykker.

failed_reason er skrevet til et menneske. En transportfejl læses som noget handlingsbart — "midlertidigt ikke leverbar, prøv igen om lidt" — frem for at afsløre interne detaljer; den underliggende fejl bliver i vores logs til diagnose.

Søg i historik

GET /v1/messages/history understøtter search (matcher modtager, body eller vendor message-ID), status, channel, page og limit (maks. 100/side) query-parametre.

Gensend

POST /v1/messages/:id/resend opretter en ny besked til samme modtager med samme indhold — den gennemgår de samme saldo-, suppression- og budgettjek som en ny afsendelse. Vil I i stedet se, hvad der skete med den oprindelige, returnerer GET /v1/messages/:id/timeline de ordnede trin — i kø, afsendt, leverandørens svar, hver leveringskvittering — og det er den hurtigste måde at skelne en leverandør-afvisning fra en modtager, der aldrig engagerede sig.

Annullér en planlagt besked

DELETE /v1/messages/:id annullerer en besked, der stadig er queued (dvs. planlagt frem via scheduled_at og endnu ikke sendt). Returnerer 409, hvis den allerede er sendt.