Meldingsstatus, historikk og resending

Hent en enkelt melding

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

Hva hver status betyr

E-post-delivered henger etter — det er med vilje. SMS og RCS får en leveringskvittering fra operatøren, så delivered kommer sekunder etter sent. E-post har ingen tilsvarende: den telles som levert ut fra engasjement og fraværet av en bounce, ikke ut fra et SMTP-håndtrykk. En vellykket e-postutsendelse står derfor på sent en stund, og en kampanje som viser delivered: 0 minutter etter utsending er normalt — ikke ødelagt.

failed_reason er skrevet for et menneske. En transportfeil leses som noe handlingsbart — "midlertidig ikke leverbar, prøv igjen snart" — framfor å avsløre interne detaljer; den underliggende feilen blir i loggene våre.

Søk i historikken

GET /v1/messages/history støtter query-parameterne search (matcher mottaker, body eller leverandørens message-ID), status, channel, page og limit (maks. 100/side).

Send på nytt

POST /v1/messages/:id/resend oppretter en ny melding til samme mottaker med samme innhold — den går gjennom de samme saldo-, suppression- og budsjettsjekkene som en helt ny sending. Vil du i stedet se hva som skjedde med den opprinnelige, returnerer GET /v1/messages/:id/timeline de ordnede trinnene — i kø, sendt, leverandørens svar, hver leveringskvittering — og det er raskeste måten å skille et leverandøravslag fra en mottaker som aldri engasjerte seg.

Avbryt en planlagt melding

DELETE /v1/messages/:id avbryter en melding som fortsatt er queued (dvs. planlagt frem i tid via scheduled_at og ennå ikke sendt). Returnerer 409 hvis den allerede er sendt.