Webhooks SMS — c'est nous qui vous appelons, pas l'inverse
Avec un webhook, votre logiciel n'a pas besoin de nous demander en permanence s'il y a du nouveau. Dès qu'un SMS arrive ou qu'un statut de remise change, nous effectuons immédiatement un HTTP POST vers une adresse que vous indiquez. Toujours via HTTPS, configurable par canal — et si vous n'avez pas de serveur, faites-le simplement envoyer vers une boîte mail.
Deux types de webhooks
On les confond souvent, mais ils sont indépendants et se configurent séparément : l'un concerne les messages qui arrivent, l'autre ce qu'il advient des messages que vous envoyez.
| SMS entrant | Statut de remise (DLR) | |
|---|---|---|
| Quand | Quelqu'un envoie un message vers votre numéro ou shortcode | Le statut d'un message que vous avez envoyé change |
| Où le configurer | Par canal, sous Channels & Webhooks dans votre compte | Par message, comme URL de notification dans l'appel API |
| Payload | msgid timestamp sender message keyword | msgid status |
| Alternative sans serveur | Transfert vers une adresse e-mail | Consulter le statut dans le tableau de bord |
Ce que nous envoyons vers votre endpoint
Pour un message entrant, nous effectuons un HTTP POST vers votre adresse avec les champs suivants. Votre endpoint doit seulement les accepter et les traiter.
| Champ | Signification |
|---|---|
msgid | ID unique du message — utilisez-le pour éviter un double traitement |
timestamp | Moment où le message est arrivé chez nous |
sender | Le numéro de GSM de l'expéditeur |
message | Le texte complet du message |
keyword | Le canal ou mot-clé sur lequel le message est arrivé |
Pour un statut de remise, le payload est plus court : l'ID du message et le code de statut. La signification de chaque code se trouve sur la page sur les rapports de remise.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Configurer un webhook en 4 étapes
Préparer l'endpoint
Prévoyez une adresse HTTPS accessible publiquement, avec un certificat valide, capable d'accepter un HTTP POST.
Choisir le canal
Allez dans votre compte vers Channels & Webhooks et choisissez le canal ou le mot-clé auquel la notification doit s'appliquer.
Saisir l'adresse
Saisissez l'adresse sans scheme ; nous envoyons toujours via HTTPS. Si votre port diffère du 443, indiquez-le.
Tester
Envoyez un SMS vers votre numéro virtuel ou shortcode et vérifiez que votre endpoint reçoit le POST.
Les exigences pour votre endpoint
Si rien n'arrive sur votre endpoint, vérifiez dans cet ordre : l'adresse est-elle accessible de l'extérieur, le certificat est-il valide, et votre pare-feu laisse-t-il passer notre appel ? Dans le tracelog de votre compte, vous voyez exactement ce qui a été envoyé.
Pas de serveur ? Envoyez-le vers une boîte mail
Un webhook suppose que vous avez de quoi le recevoir. Si ce n'est pas le cas, choisissez simplement par canal le transfert vers une adresse e-mail : chaque message entrant arrive alors par mail, chez vous ou chez le collègue qui doit y donner suite.
Vous pouvez aussi désactiver complètement la notification et consulter les messages uniquement dans votre tableau de bord — dans la vue conversation, ils apparaissent directement à côté de ce que vous avez envoyé vous-même.
