Webhook SMS — siamo noi a chiamare te, non il contrario
Con un webhook il tuo software non deve chiederci di continuo se c'è qualcosa di nuovo. Non appena arriva un SMS o cambia uno stato di recapito, effettuiamo subito una HTTP POST verso un indirizzo che indichi tu. Sempre tramite HTTPS, configurabile per canale — e chi non ha un server se lo fa semplicemente inviare a una casella di posta.
Due tipi di webhook
Vengono spesso confusi, ma sono indipendenti e si configurano separatamente: uno riguarda i messaggi che arrivano, l'altro ciò che succede ai messaggi che invii.
| SMS in entrata | Stato di recapito (DLR) | |
|---|---|---|
| Quando | Qualcuno invia un messaggio al tuo numero o al tuo shortcode | Cambia lo stato di un messaggio che hai inviato |
| Dove si configura | Per canale, in Channels & Webhooks nel tuo account | Per messaggio, come URL di notifica nella chiamata API |
| Payload | msgid timestamp sender message keyword | msgid status |
| Alternativa senza server | Inoltro a un indirizzo e-mail | Consultare lo stato nella dashboard |
Che cosa inviamo al tuo endpoint
In caso di messaggio in entrata effettuiamo una HTTP POST verso il tuo indirizzo con i seguenti campi. Il tuo endpoint deve solo accettarli ed elaborarli.
| Campo | Significato |
|---|---|
msgid | ID univoco del messaggio — usalo per evitare elaborazioni doppie |
timestamp | Momento in cui il messaggio è arrivato da noi |
sender | Il numero di cellulare del mittente |
message | Il testo completo del messaggio |
keyword | Il canale o il keyword su cui è arrivato il messaggio |
In caso di stato di recapito il payload è più breve: l'ID del messaggio e il codice di stato. Il significato di ogni codice è indicato nella pagina sui rapporti di recapito.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Configurare un webhook in 4 passaggi
Prepara l'endpoint
Predisponi un indirizzo HTTPS pubblicamente raggiungibile con un certificato valido, in grado di accettare una richiesta HTTP POST.
Scegli il canale
Nel tuo account vai su Channels & Webhooks e scegli il canale o il keyword a cui deve applicarsi la notifica.
Inserisci l'indirizzo
Inserisci l'indirizzo senza lo schema; inviamo sempre tramite HTTPS. Se la tua porta è diversa dalla 443, indicala.
Prova
Invia un SMS al tuo numero virtuale o al tuo shortcode e verifica che il tuo endpoint riceva la POST.
A quali requisiti deve rispondere il tuo endpoint
Se al tuo endpoint non arriva nulla, controlla in quest'ordine: l'indirizzo è raggiungibile dall'esterno, il certificato è valido e il tuo firewall lascia passare la nostra chiamata? Nel trace log del tuo account vedi che cosa è stato inviato esattamente.
Nessun server? Fallo inviare a una casella di posta
Un webhook presuppone che tu abbia qualcosa per riceverlo. Se non ce l'hai, scegli semplicemente per ogni canale l'inoltro a un indirizzo e-mail: ogni messaggio in entrata arriva allora come e-mail, a te o al collega che deve occuparsene.
Puoi anche disattivare del tutto la notifica e consultare i messaggi solo nella tua dashboard — nella vista conversazione compaiono subito accanto a ciò che hai inviato tu.
