Webhooks de SMS: le llamamos nosotros, no al revés
Con un webhook su software no tiene que preguntarnos continuamente si hay algo nuevo. En cuanto llega un SMS o cambia un estado de entrega, hacemos al momento un HTTP POST a la dirección que usted indique. Siempre por HTTPS, configurable por canal, y quien no tenga servidor puede hacer que se envíe simplemente a un buzón de correo.
Dos tipos de webhook
A menudo se confunden, pero son independientes y se configuran por separado: uno trata de los mensajes que llegan y el otro de lo que ocurre con los mensajes que usted envía.
| SMS entrante | Estado de entrega (DLR) | |
|---|---|---|
| Cuándo | Alguien envía un mensaje a su número o a su shortcode | Cambia el estado de un mensaje que usted envió |
| Dónde se configura | Por canal, en Channels & Webhooks dentro de su cuenta | Por mensaje, como URL de notificación en la llamada a la API |
| Carga útil | msgid timestamp sender message keyword | msgid status |
| Alternativa sin servidor | Reenviar a una dirección de correo | Consultar el estado en el panel |
Qué enviamos a su endpoint
Con un mensaje entrante hacemos un HTTP POST a su dirección con los siguientes campos. Su endpoint solo tiene que aceptarlos y procesarlos.
| Campo | Significado |
|---|---|
msgid | ID único del mensaje: úselo para evitar procesarlo dos veces |
timestamp | Momento en que el mensaje llegó a nosotros |
sender | El número de móvil del remitente |
message | El texto completo del mensaje |
keyword | El canal o keyword por el que llegó el mensaje |
En un estado de entrega la carga útil es más corta: el ID del mensaje y el código de estado. El significado de cada código está en la página sobre los informes de entrega.
POST https://uw-server.be/sms/inkomend msgid=8471203×tamp=2026-05-12+14%3A31%3A08 &sender=32496123456&message=JA&keyword=afspraak Configurar un webhook en 4 pasos
Preparar el endpoint
Disponga de una dirección HTTPS accesible públicamente, con un certificado válido, capaz de aceptar un HTTP POST.
Elegir el canal
En su cuenta vaya a Channels & Webhooks y elija el canal o keyword al que debe aplicarse el aviso.
Introducir la dirección
Introduzca la dirección sin el esquema; nosotros enviamos siempre por HTTPS. Si su puerto no es el 443, indíquelo.
Probar
Envíe un SMS a su número virtual o a su shortcode y compruebe que su endpoint recibe el POST.
Qué debe cumplir su endpoint
Si a su endpoint no llega nada, compruebe en este orden: ¿es la dirección accesible desde fuera?, ¿es válido el certificado? y ¿deja pasar su firewall nuestra llamada? En el registro de trace de su cuenta ve qué se ha enviado exactamente.
¿Sin servidor? Envíelo a un buzón
Un webhook presupone que tiene algo con lo que recibirlo. Si no lo tiene, elija sin más, por canal, el reenvío a una dirección de correo: cada mensaje entrante llega entonces como correo, a usted o al compañero que deba ocuparse.
También puede desactivar el aviso por completo y consultar los mensajes solo en su panel: en la vista de conversación aparecen justo al lado de lo que usted mismo envió.
