Webhooks

Use webhooks to receive message events immediately in your system.

Two webhook types are available:

1. Delivery status webhook for outgoing messages.
2. Incoming message webhook for SMS and other supported channels.

1. Delivery status webhook

Configure this webhook in device settings to receive status updates without polling the API.

{
  "sms_id": int,
  "status_id": int,
  "status_message": string,
  "sendto": string,
  "senttime": datetime,
  "channel_id": int,
  "device_id": int
}

• 1 - Ausstehende SMS
• 2 - SMS per Telefon angenommen
• 3 - Warteschlange zum Senden. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2."
• 5 - Eingehende SMS
• 6 - SMS per Telefon gesendet
• 7 - SMS wurde gesendet
• 8 - SMS wurde NICHT geliefert
• 9 - SMS überhaupt nicht gesendet. Generischer Fehler. (Lies was mit diesem Fehler zu tun ist hier)
• Andere, weniger häufige Fehler:
• 10 - SMS nicht gesendet - No Service
• 11 - SMS nicht gesendet - Null PDU
• 12 - SMS nicht gesendet - Radio Off
• 100, 101 - SMS nicht gesendet - NOT ALLOWED. (Berechtigungen für das Senden von SMS in der Anwendung wurden nicht gewährt)

2. Incoming message webhook

Configure this webhook to forward incoming messages to your CRM, helpdesk or backend.

{
  "address": string,
  "date": datetime,
  "date_sent": datetime,
  "body": string,
  "internal_id": int,
  "channel_id": int,
  "sms_id": int,
  "device_id": int,
  "device_name": string
}