Afsendelse af beskeder

POST /v1/messages/send er det ene endpoint til alle kanaler.

Påkrævede felter

to, channel (én af sms, rcs, whatsapp, email, voice) og message er påkrævet — eller send et channels-array i stedet for channel/fallback (se nedenfor).

Kanal-fallback

Angiv en ordnet fallback-liste, eller det nyere channels-array med primær kanal først:

{
  "to": "+4512345678",
  "channels": ["whatsapp", "sms"],
  "message": "Din ordre er afsendt."
}

Hvis WhatsApp-levering fejler, forsøger platformen automatisk igen via SMS — uden et separat API-kald.

Kanal-specifikke felter

• Email: sæt subject, og htmlmessage (eller det ældre alias html) til HTML-body'en. message er plain-text-fallbacken.
• WhatsApp: send et whatsapp-objekt, fx { "template": "order_shipped" }, til skabelonbeskeder uden for 24-timers sessionsvinduet.
• Voice: send et voice-objekt (fx { "voice": "female", "language": "da-DK" }) til TTS-parametre.
• Afsender-ID: sender skal være et afsender-ID godkendt i Indstillinger → Afsender-ID'er til SMS/RCS — medmindre jeres konto har allow_unverified_sender aktiveret til systemintegrationer.

Planlægning og pr.-besked-webhooks

scheduled_at (ISO-tidsstempel) udsætter afsendelsen. webhook_url modtager leveringsstatusopdateringer for netop denne besked — se Webhooks.

Frekvenslofter for marketing

Send en category med (fx "newsletter") for at lade denne afsendelse tælle mod den pågældende kategoris frekvensloft, som konfigureres kontodækkende i messaging policy — uafhængigt af det globale loft på tværs af kanaler og af eventuelle lofter pr. kanal.

Response

{
  "message_id": "3fa1e2c0-...",
  "status": "queued",
  "channel": "sms",
  "to": "+4512345678",
  "cost": 0.045,
  "currency": "EUR",
  "created_at": "2026-07-08T10:00:00.000Z"
}

En 402 betyder utilstrækkelig saldo eller manglende betalingsmetode; 403 betyder at kontoen er suspenderet, afventer aktivering, eller at afsender-ID'et ikke er godkendt; 409 betyder at modtageren er afmeldt den kanal.