Skicka meddelanden

POST /v1/messages/send är den enda endpointen för alla kanaler.

Obligatoriska fält

to, channel (en av sms, rcs, whatsapp, email, voice) och message är obligatoriska — eller skicka en channels-array i stället för channel/fallback (se nedan).

Kanalfallback

Ange en ordnad fallback-lista, eller den nyare channels-arrayen med primärkanalen först:

{
  "to": "+4512345678",
  "channels": ["whatsapp", "sms"],
  "message": "Din order har skickats."
}

Om WhatsApp-leveransen misslyckas gör plattformen automatiskt ett nytt försök via SMS — utan något separat API-anrop.

Kanalspecifika fält

• E-post: sätt subject, och htmlmessage (eller det äldre aliaset html) för HTML-bodyn. message är fallbacken i klartext.
• WhatsApp: skicka ett whatsapp-objekt, t.ex. { "template": "order_shipped" }, för mallmeddelanden utanför 24-timmarsfönstret för sessioner.
• Voice: skicka ett voice-objekt (t.ex. { "voice": "female", "language": "da-DK" }) för TTS-parametrar.
• Avsändar-ID: sender måste vara ett avsändar-ID som godkänts i Inställningar → Avsändar-ID:n för SMS/RCS — såvida inte ditt konto har allow_unverified_sender aktiverat för systemintegrationer.

Schemaläggning och webhooks per meddelande

scheduled_at (ISO-tidsstämpel) fördröjer utskicket. webhook_url tar emot leveransstatusuppdateringar för just det här meddelandet — se Webhooks.

Frekvenstak för marknadsföring

Skicka med en category (t.ex. "newsletter") för att låta utskicket räknas mot den kategorins frekvenstak, som konfigureras kontoövergripande i sändningspolicyn — oberoende av det globala kanalöverskridande taket och eventuella tak per kanal.

Svar

{
  "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 otillräckligt saldo eller saknad betalningsmetod; 403 betyder att kontot är avstängt, väntar på aktivering, eller att avsändar-ID:t inte är godkänt; 409 betyder att mottagaren har avregistrerat sig från den kanalen.