Webhooks
Qué envía el webhook
Un webhook es una dirección de su lado a la que BulkGate informa de lo que ha ocurrido
con sus mensajes. El portal lo llama Informes de entrega, pero envía a él dos cosas a
la vez:
| Qué llega | Cómo reconocerlo |
|---|---|
| Informe de entrega | Un registro con el estado de un mensaje enviado y su smsID |
| SMS entrante (una respuesta) | Un registro con status 10, el remitente en from y el texto del mensaje |
Por tanto, no se trata de dos ajustes separados: una sola dirección gestiona tanto los informes de entrega como las respuestas.
El formato de los datos depende de si el envío masivo está activado:
| Modo | Cómo llegan los datos | Formato descrito en |
|---|---|---|
| predeterminado | Una solicitud por mensaje, mediante GET | Confirmación de entrega |
DLRs a granel - solicitud a granel |
Un lote de registros, mediante POST con application/json |
Confirmación de entrega masiva |
Dónde se configura el webhook
El lugar depende de la interfaz que utilice. Los dos primeros pasos son iguales en
todos los casos: en el menú del portal, haga clic en Módulos y APIs y abra la tarjeta
de su aplicación en Mis APIs y módulos.
| Interfaz | Dónde en el detalle de la aplicación |
|---|---|
| HTTP API | La pestaña Ajustes, la parte Web hooks, la tarjeta Informes de entrega |
Email > SMS |
Solo Informes de entrega de correo electrónico: los informes llegan por correo electrónico, no a una URL |
Cómo activar el webhook
La tarjeta muestra si hay algo configurado. Mientras no lo haya, muestra
No tienes configuración. y un botón Configurar.
El botón Configurar (o Editar, si ya tiene una configuración) abre la ventana
Configuración de informes de entrega.
Introduzca una dirección que empiece por http:// o https:// en el campo Informes de entrega de URL; el portal no acepta otra forma de escribirla. Con él van tres
casillas:
| Opción | Qué hace |
|---|---|
Desactivar la verificación de disponibilidad de URL |
El portal no comprueba que la dirección responda antes de guardar |
Informe solo cuando se produce un error |
Solo llega un informe cuando un mensaje falla |
DLRs a granel - solicitud a granel |
Los informes llegan en lotes en lugar de uno a uno |
La configuración se guarda con el botón Salvar.
El envío masivo es útil con volúmenes altos: en lugar de una solicitud por mensaje, llega una sola solicitud con un array de registros. El formato del lote se describe en Confirmación de entrega masiva.
Una vez configurado el webhook, la tarjeta muestra tres filas: URL con la dirección
y un icono para Informe solo cuando se produce un error y otro para DLRs a granel - solicitud a granel, que indican si están activados.
Cómo eliminar el webhook
La flecha junto al botón Editar abre un menú con la opción Borrar. La ventana de
confirmación Eliminar configuraciones advierte de que perderá la configuración de
sus informes de entrega y de que dejarán de llegar.
Al eliminar el webhook también dejan de llegar los mensajes entrantes: las respuestas a sus SMS no tienen adónde entregarse.
Gracias por su opinión.