Webhooks entrantes (Inbound Webhooks)

Un webhook entrante (Inbound Webhook) es una herramienta potente para recibir datos desde cualquier lugar hacia el chatbot mediante una petición POST. Con los webhooks entrantes, tu bot incluso puede iniciar una conversación con un usuario que nunca le habló antes. Por ejemplo, cuando un cliente llena su información de contacto en tu web, envías los datos a un webhook entrante de un chatbot (digamos un bot de SMS), y el bot puede enviarle un mensaje de confirmación a su teléfono. Si el webhook está en un bot de voz, ¡el bot incluso puede llamar al cliente de inmediato!

​

Crear un webhook entrante

Está disponible en casi todos los canales. En tu Constructor de Flujos, ve a Herramientas → Webhooks entrantes. Haz clic en New Inbound Webhook, dale un nombre y haz clic en Save. Verás la interfaz de edición:

​

Dirección del webhook (Webhook Address)

Esta zona te muestra a dónde enviar los datos y el método, que es POST. Cada webhook entrante tiene una URL única en todo el sistema de Botky.

​

Ejemplo del JSON recibido

Esta zona muestra un JSON de ejemplo como referencia. Describe la estructura de los datos que recibiremos, y lo necesitamos para encontrar los valores de identificación del usuario y los datos a guardar. Hay 2 formas de obtener un JSON de ejemplo:

1. Escribirlo/pegarlo manualmente aquí.
2. Escuchar datos en tiempo real de una prueba en vivo.

​

Valores para identificar a un usuario

Cada vez que el webhook recibe datos, primero revisa las rutas que especifiques aquí para ver si encuentra un usuario existente en el chatbot. Si el usuario no está en el sistema, el chatbot creará un nuevo perfil. Así es como el chatbot inicia una conversación sin haber hablado antes con el usuario. Sin embargo, algunos canales no permiten que el chatbot inicie la conversación primero, por temas de privacidad y spam. Por ejemplo, tu bot de SMS puede enviar mensajes mientras tengas el número del destinatario, pero tu chatbot de Facebook Messenger no puede enviar mensajes a un usuario que nunca le habló antes.

​

Proceso de identificación del usuario

​

Zona de mapeo

La lista de mapeo muestra qué valor debe guardarse en qué campo personalizado. Cuando obtengas un JSON de ejemplo en la zona anterior, haz clic en Preview Payload para abrir la herramienta de mapeo.

​

Registros del webhook (Logs)

Cada petición se guarda en Logs. Haz clic en un registro para ver el JSON recibido.

​

Límite del webhook entrante

Por defecto, el límite es de 500 peticiones por 24 horas. Si superas el límite, tienes la opción de ampliar a más peticiones por día. Estas son las opciones:

​

Depurar el error de máximo de peticiones

Si no estás recibiendo los datos en el webhook entrante, o no los encuentras en los logs, es muy posible que hayas alcanzado el límite diario. Para probarlo, envía la petición al webhook desde Postman o desde una Solicitud externa de Botky, y revisa la información en el header: Como ves, hay un rate-limit-remaining: si es 0, significa que ya alcanzaste el límite y deberías ampliarlo.

​

Demo: confirmación de reserva

Una herramienta perfecta para probar tu webhook entrante ya viene incorporada: consigue un chatbot (cualquier canal) y pruébalo en un paso de Acción. Abre otra página de Botky en paralelo, deja la edición del webhook en la Página 1 y selecciona una Solicitud externa en la Página 2. Sigue los pasos 1 a 8 de la captura: Proporciona los datos que se enviarán al chatbot y haz clic en Test: obtendrás un error de “webhook inactive” porque aún no lo hemos activado. Está bien, haz clic en Done en la Página 1 y verás los datos guardados. Baja un poco y sigue los pasos 1, 2, 3 para indicarle al sistema dónde están los valores phone y email en el JSON: Finalmente, mapea el resto de los datos al chatbot: Guarda la edición de tu webhook entrante: Entra al subflujo y enviémosle un mensaje al usuario del bot: Publica el flujo y hagamos una prueba en vivo con la solicitud externa otra vez: Esta vez corre sin error porque activamos el webhook y usamos un número real. Ve a Logs y verás que se creó un nuevo perfil de usuario con éxito. Del lado del usuario:

​

Preguntas frecuentes

​

¿El webhook entrante no funciona en tu dominio personalizado?

Si los webhooks entrantes bajo tu dominio personalizado dejan de funcionar mientras que bajo el dominio de Botky funcionan bien, el problema podría estar en tu configuración de Cloudflare. A veces Cloudflare detecta automáticamente las peticiones a tu dominio y las clasifica como ataques de bots, bloqueándolas por un intervalo de tiempo. Para evitarlo, ve a los ajustes de tu panel de Cloudflare, en la pestaña de seguridad, y desactiva “Bot Fight Mode”.