Ir al contenido principal

Cómo usar Bring Your Own AI (BYOA) para conectar y administrar tus propios agentes de IA en Wati

Actualizado hoy

Resumen

¿Quieres implementar tu propio agente de IA personalizado en Wati? Con la función Trae tu propia IA (BYOA), puedes integrar tu agente de IA directamente en Wati como un operador de IA. Esto permite que tu agente trabaje junto a tus operadores humanos, recibiendo, respondiendo y gestionando conversaciones de clientes como un miembro más de tu equipo.

Nota:

  • La función BYOA se ofrece como un complemento de pago (100 USD/mes) para los clientes de Wati.

  • Si ya estás usando Astra y quieres conectarlo con Wati a través de BYOA, no se requiere el complemento adicional. Solo necesitas tener el plan Pro o Business de Wati para habilitar esta integración.

¡Puedes encontrarlo en tu página de Gestión de Usuarios en Wati!

Instrucciones

Sigue esta guía para entender cómo tu agente de IA puede enviar y recibir mensajes, gestionar el contexto del chat e interactuar con Wati usando APIs.

Añade tu agente de IA personalizado a Wati

Puedes registrar tu agente de IA como un operador de IA en Wati. Una vez añadido, tu agente recibirá un token de acceso dedicado que le permitirá interactuar con las APIs públicas de Wati, como enviar mensajes, actualizar contactos o resolver chats.

Tu operador de IA aparecerá en la lista de operadores de la bandeja de entrada del equipo, y podrás asignarle conversaciones manualmente o a través de automatizaciones de Wati.

Por ejemplo, puedes crear una regla de automatización para asignar automáticamente todos los chats nuevos a tu operador de IA.

Cómo tu agente de IA recibe mensajes de clientes

Para recibir mensajes, proporciona una URL de webhook a Wati. Wati enviará eventos de mensajes relevantes a tu agente de IA a través de este webhook.

Tu agente de IA no se verá abrumado con datos innecesarios: Wati solo envía eventos de conversaciones asignadas específicamente a tu agente de IA. Las conversaciones gestionadas por operadores humanos no activarán eventos de webhook para tu agente.

Eventos de webhook compatibles

Actualmente, tu agente de IA puede recibir 2 tipos de eventos de webhook:

  • Chat Asignado – Se activa cuando se asigna un chat a tu agente de IA.

  • Mensaje Asignado Recibido - Se activa cuando hay un nuevo mensaje entrante para conversaciones asignadas a tu Agente de IA.

Cómo tu agente de IA puede responder a los clientes

Una vez que tu agente esté registrado, se generará un token de acceso dedicado. Puedes usar este token de acceso dedicado con las APIs públicas de Wati para enviar mensajes, actualizar información de contacto o gestionar estados de chat.

Puedes encontrar la lista completa de APIs en la documentación de la API de Wati.

Aquí tienes los endpoints más comunes para empezar:

  1. /sendSessionMessage

    • Enviar una respuesta a un cliente.

  2. /getContacts

    • Recuperar detalles de contacto (como número de teléfono y atributos personalizados) cuando se asigna una conversación a tu agente de IA.

  3. /updateContactAttributes

    • Almacenar nueva información recopilada durante una conversación como atributos de contacto en Wati.

  4. /updateChatStatus

    • Actualizar el estado del chat una vez que tu agente de IA resuelva una conversación.

  5. /assignOperator

    • Reasignar un chat a un operador humano si tu agente de IA no puede manejarlo.

Acceso al historial de conversaciones

Cuando tu agente de IA se asigna a un chat, puede recuperar el contexto histórico utilizando el endpoint de la API /getMessages. Esto ayuda a tu IA a generar respuestas más precisas y contextuales basadas tanto en mensajes pasados como recientes.

Gestión de mensajes multimedia

Si un cliente envía una imagen, un documento o una nota de voz, Wati incluirá un nombre de archivo en el evento de webhook. Tu agente de IA puede usar la API /getMedia para descargar el archivo y procesarlo de manera adecuada.

Dónde encontrar a tu operador de IA

Después de la configuración, tu operador de IA aparece en la lista de operadores de la bandeja de entrada del equipo, donde se le pueden asignar chats como a cualquier otro miembro del equipo.

También puedes usar las automatizaciones de Wati para dirigir mensajes automáticamente a tu operador de IA.

Preguntas Frecuentes (FAQs)

General

1. ¿Qué es la función Bring Your Own AI (BYOA) en Wati?

La función Bring Your Own AI (BYOA) te permite integrar tu agente de IA personalizado en Wati como un operador de IA que puede recibir, responder y gestionar conversaciones de clientes junto con operadores humanos.

2. ¿Es la función BYOA gratuita?

La función BYOA se ofrece como un complemento de pago que cuesta 100 USD al mes para los clientes de Wati.

3. ¿Hay requisitos de plan para usar BYOA con Astra?

Para conectar Astra con Wati usando BYOA, debes tener el plan Pro o Business de Wati.

4. ¿Dónde se encuentra la función BYOA en Wati?

La función BYOA está disponible en la página de Gestión de Usuarios en Wati.

Configuración y Asignación

5. ¿Cómo se añade y utiliza un agente de IA personalizado en Wati?

Puedes registrar tu agente de IA personalizado como un operador de IA en Wati. Una vez registrado, el agente recibe un token de acceso dedicado para interactuar con las APIs de Wati y aparece en la bandeja de entrada del equipo, donde las conversaciones se pueden asignar manualmente o mediante reglas de automatización.

6. ¿Se pueden asignar chats automáticamente al agente de IA?

Sí, puedes crear reglas de automatización en Wati para asignar automáticamente nuevos chats al operador de IA.

Gestión de Mensajes y Webhooks

7. ¿Cómo recibe el agente de IA los mensajes de los clientes?

El agente de IA recibe mensajes a través de una URL de webhook proporcionada a Wati, la cual envía eventos de mensajes relevantes para las conversaciones asignadas al agente de IA.

8. ¿Qué eventos de webhook soporta el agente de IA?

El agente de IA soporta dos eventos de webhook: “Chat Asignado”, que se activa cuando un chat se asigna al agente, y “Mensaje Asignado Recibido”, que se activa cuando se recibe un nuevo mensaje en una conversación asignada.

9. ¿El agente de IA recibe eventos de todas las conversaciones?

No, el agente de IA solo recibe eventos de webhook de las conversaciones que se le asignan específicamente.

APIs y Capacidades

10. ¿Cómo puede el agente de IA interactuar con los clientes y gestionar chats?

El agente de IA utiliza su token de acceso dedicado con las APIs públicas de Wati para enviar mensajes, recuperar detalles de contacto, actualizar atributos de contacto, gestionar el estado del chat, reasignar chats a operadores humanos, acceder al historial de conversaciones utilizando el endpoint /getMessages y descargar archivos multimedia utilizando el endpoint /getMedia.

¿Ha quedado contestada tu pregunta?