SMS-webhooks — wij bellen ú, niet omgekeerd
Met een webhook hoeft uw software ons niet voortdurend te vragen of er iets nieuws is. Zodra er een SMS binnenkomt of een afleverstatus verandert, doen wij meteen een HTTP POST naar een adres dat u opgeeft. Altijd over HTTPS, per kanaal instelbaar — en wie geen server heeft, laat het gewoon naar een mailbox sturen.
Twee soorten webhooks
Ze worden vaak door elkaar gehaald, maar ze staan los van elkaar en worden apart ingesteld: de ene gaat over berichten die binnenkomen, de andere over wat er gebeurt met berichten die u verstuurt.
| Inkomende SMS | Afleverstatus (DLR) | |
|---|---|---|
| Wanneer | Iemand stuurt een bericht naar uw nummer of shortcode | De status van een bericht dat u verstuurde verandert |
| Waar ingesteld | Per kanaal, bij Channels & Webhooks in uw account | Per bericht, als notificatie-URL in de API-aanroep |
| Payload | msgid timestamp sender message keyword | msgid status |
| Alternatief zonder server | Doorsturen naar een e-mailadres | Status raadplegen in het dashboard |
Wat wij naar uw endpoint sturen
Bij een inkomend bericht doen wij een HTTP POST naar uw adres met de volgende velden. Uw endpoint hoeft die enkel te aanvaarden en te verwerken.
| Veld | Betekenis |
|---|---|
msgid | Uniek ID van het bericht — gebruik dit om dubbele verwerking te vermijden |
timestamp | Tijdstip waarop het bericht bij ons binnenkwam |
sender | Het gsm-nummer van de afzender |
message | De volledige tekst van het bericht |
keyword | Het kanaal of keyword waarop het bericht binnenkwam |
Bij een afleverstatus is de payload korter: het bericht-ID en de statuscode. De betekenis van elke code staat op de pagina over afleverrapporten.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Een webhook instellen in 4 stappen
Endpoint klaarmaken
Zorg voor een publiek bereikbaar HTTPS-adres met een geldig certificaat dat een HTTP POST kan aanvaarden.
Kanaal kiezen
Ga in uw account naar Channels & Webhooks en kies het kanaal of keyword waarvoor de melding moet gelden.
Adres invullen
Vul het adres in zonder scheme; wij versturen altijd over HTTPS. Wijkt uw poort af van 443, geef die dan mee.
Testen
Stuur een SMS naar uw virtueel nummer of shortcode en controleer of uw endpoint de POST ontvangt.
Waar uw endpoint aan moet voldoen
Komt er niets binnen bij uw endpoint, controleer dan in deze volgorde: is het adres van buitenaf bereikbaar, is het certificaat geldig, en laat uw firewall onze aanroep door? In de tracelog van uw account ziet u wat er precies verstuurd is.
Geen server? Stuur het naar een mailbox
Een webhook veronderstelt dat u iets hebt om hem te ontvangen. Hebt u dat niet, dan kiest u per kanaal gewoon voor doorsturen naar een e-mailadres: elk inkomend bericht komt dan als mail binnen, bij u of bij de collega die het moet opvolgen.
U kunt de melding ook helemaal uitzetten en de berichten enkel in uw dashboard bekijken — in de conversatieweergave staan ze meteen naast wat u zelf verstuurde.
