SMS-Webhook-Ereignisse und Payloads

Die fünf Ereignisse und die Form der Daten, die Sie jeweils erhalten.

Zuletzt aktualisiert 18. Oktober 2026

SMS empfangen

Wird ausgelöst, wenn das Android-Gerät eine SMS empfängt. Das ist die Grundlage für Chatbots und automatische Antworten.

{
  "event": "received",
  "createdAt": "2026-08-14T10:30:45.123Z",
  "data": {
    "id": "msg_01H8Z",
    "from": "+14155550100",
    "message": "Donnerstagvormittag, wenn möglich.",
    "receivedAt": "2026-08-14T10:30:44.000Z",
    "conversationId": "conv_9f21",
    "deviceId": "dev_oppo_cph2577",
    "inReplyTo": {
      "id": "msg_01H8X",
      "reference": "appointment_8841",
      "body": "Ihr Termin am 10.08. um 11:15 Uhr ist bestätigt.",
      "sentAt": "2026-08-14T09:02:11.000Z"
    }
  }
}

SMS gesendet

Wird ausgelöst, wenn das Telefon die Nachricht an das Netz übergibt. sent, delivered und failed haben alle dieselbe Form.

{
  "event": "sent",
  "createdAt": "2026-08-14T10:31:02.400Z",
  "data": {
    "id": "msg_01H8X",
    "status": "sent",
    "to": "+14155550100",
    "deviceId": "dev_oppo_cph2577",
    "segments": 1,
    "encoding": "GSM-7",
    "reference": "appointment_8841",
    "createdAt": "2026-08-14T09:02:10.000Z",
    "deliveredAt": null,
    "error": null
  }
}

SMS zugestellt

Wird ausgelöst, wenn der Mobilfunkanbieter die Zustellung beim Empfänger bestätigt. Erst dieses Ereignis bestätigt wirklich, dass die Nachricht angekommen ist.

SMS fehlgeschlagen

Wird ausgelöst, wenn der Versand fehlschlägt. Das Feld error enthält den Grund.

{
  "event": "failed",
  "createdAt": "2026-08-14T10:31:15.789Z",
  "data": {
    "id": "msg_01H8Y",
    "status": "failed",
    "to": "+14155550188",
    "deviceId": "dev_oppo_cph2577",
    "segments": 1,
    "encoding": "GSM-7",
    "reference": null,
    "createdAt": "2026-08-14T10:30:02.000Z",
    "deliveredAt": null,
    "error": "invalid number"
  }
}

Wird ausgelöst, wenn sich jemand abmeldet. Die gesamte Nachricht muss aus einem der Schlüsselwörter bestehen, unabhängig von Groß- und Kleinschreibung: STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT, SAIR oder PARAR. „Bitte STOP“ zählt nicht. Ab dann liefert jeder Versand an diese Nummer 403 recipient_opted_out.

{
  "event": "opted_out",
  "createdAt": "2026-08-14T10:32:00.000Z",
  "data": {
    "phoneNumber": "+14155550100",
    "at": "2026-08-14T10:32:00.000Z",
    "keyword": "STOP"
  }
}