Webhook para reenvio de respuestas de palabra clave

Se entiende por respuesta, o petición a la palabra clave, cada vez que un usuario manda un SMS con la palabra clave contratada al número 91919.

Cada palabra clave contratada puede tener asignado un webhook al cuál se reenviará la información recibida con una petición tipo  GET 

Para activarlo, tendrás que dirigirte a la sección de “Palabra Clave”, posteriormente das clic al botón de “Configurar” y finalmente, clic a “Integraciones”.

Lo primero que tienes que hacer para agregar un webhook, es probar el endpoint en donde enviaremos unos datos de prueba con la estructura del objeto para verificar su funcionamiento y que puedas completar tu integración.

El objeto se genera de forma dinámica con el contenido del mensaje que envía el cliente a la palabra clave.

Recibirá una petición  GET  con número de teléfono, nombre de la agenda donde está registrado el contacto, fecha en que respondió y el texto con el que respondió el usuario, sin procesar y separado según los espacios en blanco.

Parámetros a enviar
Atributo Descripción Tipo de Dato
type Tipo de acción a procesar en tu URL.
  keyword_request   Respuesta de contacto
  Text  
agenda Nombre de la agenda   Text  
contact_number Número del contacto   Number  
contact_response Mensaje de respuesta por parte del destinatario.   Text  
date Fecha y hora en que se realizó el registro del conctacto   AAAAMMDDHHMMSS     Text  
elem0... elemN Mensaje de respuesta por parte del destinatario, desglosado por cada espacio en blanco. La cantidad de elementos a enviar es variable y comienza la numeración desde el 0. Ej.   elem0  ,   elem1   ...   elemN     Text  

Webhook para reenvío de respuestas de palabra clave

Forma correcta de definir la URL para confirmación de entrega:

  1. Define el endpoint a donde enviaremos los datos.
  2. Antes de poder guardar la información es necesario probar el endpoint.
  3. Un ejemplo del objeto de prueba que enviamos para la prueba.
Llamada GET a tu endpoint
https://dominio.com/path/to/url?type=keyword_request&agenda=agenda_name&contact_number=000000000000&contact_response=abcdefg&date=2021122316562&elem0=AAAAAA&elem1=BBBBBB&elem2=CCCCCC