Nachrichten senden

POST /v1/messages/send ist der eine Endpoint für alle Kanäle.

Pflichtfelder

to, channel (einer von sms, rcs, whatsapp, email, voice) und message sind erforderlich — oder übergeben Sie ein channels-Array anstelle von channel/fallback (siehe unten).

Kanal-Fallback

Geben Sie eine geordnete fallback-Liste an oder das neuere channels-Array mit dem primären Kanal an erster Stelle:

{
  "to": "+4512345678",
  "channels": ["whatsapp", "sms"],
  "message": "Ihre Bestellung wurde versandt."
}

Schlägt die WhatsApp-Zustellung fehl, versucht die Plattform es automatisch per SMS erneut — ohne separaten API-Aufruf.

Kanalspezifische Felder

• E-Mail: Setzen Sie subject und htmlmessage (oder den älteren Alias html) für den HTML-Body. message ist der Klartext-Fallback.
• WhatsApp: Übergeben Sie ein whatsapp-Objekt, z. B. { "template": "order_shipped" }, für Template-Nachrichten außerhalb des 24-Stunden-Sitzungsfensters.
• Voice: Übergeben Sie ein voice-Objekt (z. B. { "voice": "female", "language": "da-DK" }) für TTS-Parameter.
• Absender-ID: sender muss eine in Einstellungen → Absender-IDs freigegebene Absender-ID für SMS/RCS sein — es sei denn, für Ihr Konto ist allow_unverified_sender für Systemintegrationen aktiviert.

Zeitplanung und Webhooks pro Nachricht

scheduled_at (ISO-Zeitstempel) verzögert den Versand. webhook_url empfängt Zustellstatus-Updates für genau diese Nachricht — siehe Webhooks.

Frequenzgrenzen für Marketing

Übergeben Sie eine category (z. B. "newsletter"), damit dieser Versand auf die Frequenzgrenze dieser Kategorie angerechnet wird, die kontoweit in der Sendepolicy konfiguriert wird — unabhängig von der globalen kanalübergreifenden Grenze und etwaigen Grenzen pro Kanal.

Antwort

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

Ein 402 bedeutet unzureichendes Guthaben oder eine fehlende Zahlungsmethode; 403 bedeutet, dass das Konto gesperrt ist, auf Aktivierung wartet oder die Absender-ID nicht freigegeben ist; 409 bedeutet, dass die empfangende Person diesen Kanal abbestellt hat.