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 - SMS In Attesa
• 2 - SMS presi per telefono
• 3 - In coda per l'invio. 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 - Sms In Arrivo
• 6 - SMS inviati per telefono
• 7 - Gli SMS sono stati spediti
• 8 - SMS NON consegnato
• 9 - SMS non SENT affatto - Errore generico. (Leggi cosa fare con questo errore qui)
• Altri errori meno comuni:
• 10 - SMS Non Inviato - No Service
• 11 - SMS Non Inviato - Null PDU
• 12 - SMS Non Inviato - Radio Off
• 100, 101 - SMS Non Inviato - NOT ALLOWED. (Non sono state concesse autorizzazioni per l'invio di SMS nell'applicazione)

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
}