Messaggi in arrivo (richiamate)
Quando gli utenti inviano un messaggio in entrata al tuo bot Viber o ad altri canali configurati, SMSBAT inoltra questi messaggi al tuo server tramite Webhook (Callback).
Formato webhook
Le richiamate vengono inviate all'URL webhook configurato tramite una richiesta HTTP POST con un payload JSON.
Esempio di corpo richiesta
{
"idUuid": "123e4567-e89b-12d3-a456-426614174000",
"alphaName": "ViberBotName",
"phoneNumber": "380936670003",
"text": "Hello, I need help with my order",
"dt": "2025-01-20T14:30:00.000Z"
}
Parametri
| Campo | Digitare | Descrizione |
|---|---|---|
idUuid |
stringa | Identificatore univoco per il messaggio in arrivo |
nomealfa |
stringa | Il nome del tuo brand/bot che ha ricevuto il messaggio |
numero di telefono |
stringa | Numero di telefono del mittente |
| "testo" | stringa | Il contenuto testuale del messaggio in arrivo |
dt |
dataora | Timestamp di quando è stato ricevuto il messaggio |
Configurazione
Per iniziare a ricevere messaggi in arrivo: 1. Fornisci l'URL del tuo webhook (HTTPS richiesto) al tuo account manager SMSBAT o configuralo nella dashboard. 2. Il tuo endpoint deve accettare richieste POST con "Content-Type: application/json". 3. Il tuo server dovrebbe rispondere con "200 OK" dopo aver ricevuto con successo il payload.
Nota: Se il tuo server non risponde con
200 OKo va in timeout, SMSBAT potrebbe tentare di riprovare la consegna in base alla configurazione del tuo account.