Ir al contenido principal

Constructor avanzado de chatbots: uso de Webhook Node

Actualizado hace más de 2 semanas

Resumen

Los webhooks en el Constructor de Chatbots de Wati te permiten enviar y recibir datos en tiempo real entre tu chatbot y aplicaciones externas usando solicitudes API de tipo GET o POST. Esta función permite interacciones dinámicas del chatbot, como obtener detalles del usuario, verificar datos o integrarte con servicios de terceros. Nota: La función Webhook solo está disponible en los planes Pro & Business. Si estás en el plan Standard, puedes crear y guardar chatbots con webhooks, pero necesitarás actualizarte para usarlos en flujos de trabajo de Acción de Palabra Clave o Acción Predeterminada.

Instrucciones

El Advanced Chatbot Builder está disponible solo en los planes Pro & Business.

Cómo usar webhooks en el Constructor de Chatbots

1. Agregar un webhook a tu chatbot

  1. Abre el Constructor de Chatbots de Wati.

  2. Arrastra y suelta el ícono Webhook en el flujo de trabajo del chatbot.

  3. Conéctalo a un paso relevante del chatbot.

2. Configurar el nodo de webhook

URL y método

  • Elige un método de solicitud: GET o POST.

  • Ingresa la URL del punto final de la API externa.

  • Haz que la URL sea dinámica insertando variables usando el botón Variables. Ejemplo:

https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}

Personaliza los encabezados

  • Los encabezados proporcionan detalles adicionales de la solicitud, como el tipo de contenido o la autorización.

  • Los encabezados son opcionales y están desactivados por defecto.

  • Los encabezados siguen un formato de clave-valor. Ejemplo:

  • Clave = Content-Type

  • Valor = application/json

Personalizar el cuerpo

  • El cuerpo de la solicitud contiene los datos enviados a la API externa.

  • El cuerpo es opcional y está desactivado por defecto.

  • Deberá estar siempre en formato JSON.

Establecer tus variables de prueba

  • Define variables de prueba manualmente para simular respuestas de API durante la configuración.

3. Probar la solicitud del webhook

  • Haz clic en Probar la solicitud para verificar si la llamada a la API funciona correctamente.

4. Guardar respuestas de la API como variables

  • Puedes almacenar respuestas de la API en variables o atributos personalizados.

  • Si la API devuelve una respuesta JSON con pares clave-valor, puedes extraer y almacenar valores específicos. Ejemplo: Almacenar "result": "success" desde una respuesta de API:

json { "result": "success"}

Almacenar valores dentro de un objeto

  • Usa el formato: objectKey.keyName.

  • Ejemplo: Para almacenar QuoteId de la respuesta a continuación, usa Result.QuoteId.

json { "Result": { "QuoteId": "xxxxx", "QuoteNumber": "xxxxxx", "PolicyNumber": null }, "MessageValidation": null, "QuoteReferrals": null}

Almacenar valores dentro de un conjunto de objetos

  • Usa el formato: $.[0].objectKey.keyName[0].value.

  • Ejemplo: Para almacenar current_status, usa $.[0].tracking_data.shipment_track[0].current_status.

json [ { "tracking_data": { "track_status": 1, "shipment_track": [ { "id": 1278937320, "current_status": "Delivered" } ] } }]

5. Usar el enrutamiento de respuestas

  • El enrutamiento de respuestas te permite dividir las acciones del chatbot según los códigos de estado de las respuestas.

  • Puedes definir diferentes flujos de chatbot según la respuesta de la API.

Al integrar Webhooks, puedes mejorar la funcionalidad del chatbot con datos externos, automatizar flujos de trabajo y mejorar las interacciones con los usuarios de manera dinámica.

Preguntas Frecuentes (FAQ)

Preguntas Generales

1. ¿Qué es un webhook en el Constructor de Chatbots de Wati?

→ Un webhook es un mecanismo que permite que tu chatbot envíe y reciba datos en tiempo real de aplicaciones externas usando solicitudes API de tipo GET o POST. Esto habilita interacciones dinámicas, como obtener detalles del usuario, verificar datos o integrarte con servicios de terceros.

2. ¿Quién puede usar webhooks en el Constructor de Chatbots?

→ La función de webhooks solo está disponible en los planes Pro & Business. Si estás en el plan Standard, puedes crear y guardar chatbots con webhooks pero necesitarás actualizarte antes de usarlos en flujos de trabajo de Acción de Palabra Clave o Acción Predeterminada.

Configuración e instalación

3. ¿Cómo agrego un webhook a mi chatbot?

→ Para agregar un webhook:

  • Abre el Constructor de Chatbots de Wati.

  • Arrastra y suelta el ícono Webhook en el flujo de trabajo del chatbot.

  • Conéctalo a un paso relevante del chatbot.

4. ¿Cuáles son los métodos de solicitud disponibles en webhooks?

→ Puedes elegir:

  • GET: Obtiene datos de una fuente externa.

  • POST: Envía datos a una API externa.

5. ¿Puedo personalizar la URL de solicitud de webhook?

→ Sí. Puedes insertar variables en la URL usando el botón Variables para hacer que la solicitud sea dinámica. Ejemplo:https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}

Personalización de webhooks

6. ¿Cómo agrego encabezados a mi solicitud de webhook?

  • Los encabezados son opcionales y están desactivados por defecto.

  • Se establecen en pares de clave-valor. Ejemplo:

  • Clave: Content-Type

  • Valor: application/json

7. ¿Cómo personalizo el cuerpo de una solicitud de webhook?

  • El cuerpo es opcional y está desactivado por defecto.

  • Deberá estar siempre en formato JSON.

8. ¿Qué son las variables de prueba y por qué debería usarlas?

→ Las variables de prueba te permiten definir manualmente valores para simular una respuesta de API durante la configuración. Esto ayuda a garantizar que tu webhook esté configurado correctamente antes del despliegue.

Manejo de respuestas de API

9. ¿Cómo puedo guardar respuestas de API como variables?

  • Si una respuesta de API está en formato JSON con pares clave-valor, puedes almacenar los valores haciendo referencia a las claves. Ejemplo: Para almacenar "result": "success", usa:

json { "result": "success"}

Características avanzadas

10 ¿Qué es el enrutamiento de respuestas?

→ El enrutamiento de respuestas te permite dividir las acciones del chatbot según los códigos de estado de las respuestas. Puedes definir diferentes flujos de chatbot según la respuesta de la API.

11 ¿Puedo activar diferentes flujos de chatbot según las respuestas de la API?

→ Sí. Configurando el enrutamiento de respuestas, puedes crear múltiples flujos de chatbot que se activan según el código de estado de la API o valores específicos de la respuesta.

¿Ha quedado contestada tu pregunta?