Resumen

Las webhooks en el Constructor de Chatbots de Wati te permiten enviar y recibir datos en tiempo real entre tu chatbot y aplicaciones externas utilizando solicitudes API GET o POST. Esta función permite interacciones dinámicas del chatbot, como la obtención de detalles del usuario, la verificación de datos o la integración con servicios de terceros.

Nota: La función Nodo Webhook del Chatbot solo está disponible en los planes Pro y Business.

Instrucciones

Cómo usar Webhooks en el Constructor de Chatbots

1. Añadir una Webhook a tu Chatbot

Abre el Constructor de Chatbots de Wati.
Arrastra y suelta el icono de Webhook en el flujo de trabajo del chatbot.
Conéctalo a un paso relevante del chatbot.

2. Configurar el Nodo Webhook

URL y Método

Elige un método de solicitud: GET o POST.
Introduce el endpoint de URL 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}}
```

Personalizar encabezados

Los encabezados te permiten incluir detalles adicionales en tu solicitud, como el tipo de contenido o la autorización.
Los encabezados son opcionales y están desactivados por defecto.
Deben seguir un formato de clave-valor.

Ejemplo:

Clave = Content-Type
Valor = application/json

Personalizar el cuerpo

El cuerpo de la solicitud es donde incluyes los datos que se envían a la API externa.
El cuerpo es opcional y está desactivado por defecto.
Cuando está habilitado, el cuerpo siempre debe estar en formato JSON.

Establecer tus variables de prueba

Define variables de prueba manualmente para simular respuestas de la API mientras configuras tu webhook.

3. Probar la solicitud de webhook

Haz clic en Probar la solicitud para comprobar si la llamada a la API funciona como se espera.

4. Guardar respuestas de API como variables

Puedes capturar valores de la respuesta de la API y almacenarlos en variables o atributos personalizados.
Si la API devuelve JSON con pares clave-valor, puedes extraer y guardar valores específicos.

Ejemplo: guardar "result": "success" de una respuesta de API:

{   "result": "success" }

Almacenar valores dentro de un objeto

Usa el formato: objectKey.keyName.
Ejemplo: Para almacenar QuoteId de la siguiente respuesta, usa Result.QuoteId.

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

Almacenar valores dentro de un array de objetos

Para extraer y almacenar un valor de un array de objetos, usa el formato:
```
$.[0].objectKey.keyName[0].value
```
Ejemplo: Para capturar el valor de current_status, usa:

$.[0].tracking_data.shipment_track[0].current_status

JSON de ejemplo:

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

5. Usar enrutamiento de respuesta

El enrutamiento de respuesta te permite dividir las acciones del chatbot basándose en los códigos de estado de la respuesta.
Puedes definir diferentes flujos del 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 de los usuarios de forma dinámica.

Preguntas Frecuentes (FAQs)

Preguntas generales

1. ¿Qué son las webhooks en el Constructor de Chatbots de Wati?

Las webhooks permiten que tu chatbot envíe o reciba datos en tiempo real de aplicaciones externas utilizando solicitudes API GET o POST. Esto te ayuda a crear respuestas de chatbot dinámicas y personalizadas.

2. ¿Qué planes admiten la función de webhook?

Las webhooks están totalmente disponibles en los planes Pro y Business.

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

Abre el Constructor de Chatbots, arrastra el icono de Webhook a tu flujo de trabajo y conéctalo al paso del chatbot donde deseas que ocurra la llamada a la API.

4. ¿Qué métodos y URLs puedo usar para las solicitudes de webhook?

Puedes usar solicitudes GET o POST. Introduce el endpoint de API requerido e inserta variables en la URL si deseas pasar datos dinámicos del usuario.

5. ¿Son necesarios los encabezados y el cuerpo de la solicitud?

No, ambos son opcionales. Añade encabezados solo si la API necesita detalles adicionales como autorización o tipo de contenido. Habilita el cuerpo solo cuando debas enviar datos JSON a la API externa.

Pruebas y manejo de respuestas

6. ¿Cómo pruebo si mi webhook está funcionando?

Utiliza la opción Probar la solicitud para confirmar que la llamada a la API está funcionando como se espera durante la configuración.

7. ¿Puedo almacenar valores de la respuesta de la API?

Sí, puedes guardar los valores devueltos en variables o atributos personalizados. Esto funciona para respuestas simples, objetos JSON anidados y arrays.

8. ¿Cómo extraigo valores de objetos o arrays anidados?

Utiliza la notación de puntos para objetos (por ejemplo: Result.QuoteId) y el formato de array para listas (por ejemplo: $.[0].tracking_data.shipment_track[0].current_status).

9. ¿Qué es el enrutamiento de respuesta?

El enrutamiento de respuesta te permite definir diferentes flujos del chatbot basándose en los códigos de estado de la API, de modo que el chatbot pueda responder de manera diferente a las llamadas a la API exitosas o fallidas.

Cómo usar webhooks en el creador de chatbots de Wati