Cómo conectar un agente de IA de n8n con WhatsApp

En este artículo, veremos cómo conectar un bot o agente de IA de n8n con WhatsApp. Para ello, usaremos las API y los webhooks que proporciona Chakra Chat.

Al terminar, deberías tener un agente de chat de n8n completamente funcional que responda las consultas de los usuarios en tu número de WhatsApp conectado a la nube.

Requisitos previos

A) Supondremos que ya tienes una cuenta de n8n cloud o que tienes n8n alojado en algún lugar accesible desde la internet pública.

B) También necesitas tener una cuenta de Chakra Chat y haber conectado WhatsApp. Si aún no lo has hecho, sigue estos pasos

1. Regístrate en Chakra Chat
2. Conecta WhatsApp

Ten en cuenta también que puedes crear este bot con una cuenta gratuita de Chakra Chat. 🎉

C) También necesitarás una cuenta de OpenAI y una clave de OpenAI, ya que usaremos OpenAI como nuestro proveedor de IA. Puedes registrarte para obtener una cuenta de desarrollador de OpenAI desde esta página

Paso 1. Configura un activador de webhook en n8n

1.1 Primero, inicia sesión en tu cuenta de n8n y crea un flujo de trabajo haciendo clic en el botón "Crear flujo de trabajo", en la esquina superior derecha del panel principal de n8n

1.2 Haz clic en el nodo "Agregar primer paso" y selecciona el activador "Al recibir una llamada de webhook"

1.3 Configura la URL de prueba del webhook en ChakraHQ

1.3.1 La página de configuración del activador de webhook debería estar abierta. Haz clic en la URL de prueba del webhook para copiarla al portapapeles

1.3.2 Abre tu cuenta de Chakra Chat, ve a la página de Configuración de WhatsApp y haz clic en la pestaña Más

1.3.3 Desplázate hacia abajo y haz clic en el interruptor debajo de "Habilitar webhook de paso".

1.3.4 Pega la URL de prueba del webhook de n8n que copiaste en el cuadro de entrada debajo de "URL del webhook de paso"

1.3.5 Haz clic en el botón Guardar en la esquina superior derecha de la página de configuración de WhatsApp para guardar la configuración

1.4 ¡Muy bien! Ahora probaremos nuestra integración.

1.4.1 Vuelve a n8n y cambia el método HTTP del activador a POST desde la página de configuración del webhook

1.4.2 Haz clic en el botón "Escuchar evento de prueba"

1.4.3 Debemos enviar un mensaje al número de WhatsApp desde el número de WhatsApp de otro usuario final para generar un evento de prueba del webhook

1.4.4 Ahora deberías ver en la página de configuración del activador de n8n el evento del webhook correspondiente al mensaje que acabas de enviar, como en la siguiente captura de pantalla. Si no ves ningún evento, revisa todos los pasos anteriores y verifica tu configuración

1.4.5 Muy bien, ya podemos configurar un agente de IA. Haz clic en "Volver al lienzo" y guarda rápidamente todo el progreso que llevas en el flujo de trabajo.

Paso 2. Configura un agente de IA

Ahora configuraremos un agente de IA de OpenAI en n8n.

2.1 Haz clic en el botón más junto al activador de webhook en el editor de flujos de trabajo de n8n. Se abrirá un panel a la derecha con opciones de nodos. Haz clic en "IA" para ver todas las opciones de nodos de IA

2.2 Haz clic en Agente de IA para seleccionar y agregar un nodo de agente de IA

2.3 La página de configuración del nodo Agente de IA debería estar abierta

2.4 Haz clic en el menú desplegable de "Origen de la instrucción (mensaje del usuario)". De forma predeterminada, está configurado para recibir la entrada del chat, pero debemos conectarlo a la entrada del activador de webhook. Para ello, haz clic en la opción "Definir abajo"

2.5 La pestaña Entrada, a la izquierda, muestra el objeto JSON completo enviado mediante el webhook. Busca el mensaje que enviaste en la entrada de la izquierda, haz clic en él y arrástralo al cuadro de texto de la instrucción.

2.6 Ahora configuremos el modelo de chat. Haz clic en el botón más debajo de la opción "Modelo de chat" en la parte inferior de la página

2.7 Se abrirá un submenú a la derecha con una lista de modelos de IA disponibles. Busca OpenAI y haz clic para seleccionarlo.

2.8 La página de configuración del subnodo de OpenAI debería estar abierta. Aquí debemos configurar las credenciales de OpenAI. Si ya están disponibles, selecciónalas; de lo contrario, haz clic en crear nuevas credenciales e ingresa una clave de API de OpenAI.

2.9 Ahora podemos volver al lienzo haciendo clic en "Volver al lienzo" y luego en "Ejecutar flujo de trabajo" para probar la configuración hasta ahora. Esto hará que el flujo de trabajo comience a escuchar eventos en el webhook de prueba.

2.10 Abre la cuenta de WhatsApp de un usuario final y envía un mensaje a tu número de WhatsApp conectado. No recibirás una respuesta, pero deberías ver los registros de la respuesta de OpenAI en el nodo Agente de IA. El nodo Agente de IA también debería tener un borde verde, lo que indica que se ejecutó correctamente

Si la ejecución no se realizó correctamente, revisa la configuración repitiendo los pasos anteriores.

3. Envía la respuesta de la IA al usuario

Ahora que nuestro agente de IA puede responder a las consultas recibidas por chat, empecemos a enviar esas respuestas por WhatsApp

3.1 En el editor de flujos de trabajo de n8n, haz clic en el botón + a la derecha del nodo Agente de IA. Se abrirá el menú de selección de nodos. En la barra de búsqueda, escribe "solicitud HTTP" y haz clic en el tipo de nodo Solicitud HTTP .

3.2 Configura el nodo Solicitud HTTP para enviar un mensaje mediante la API de envío de mensajes de WhatsApp.

Encontrarás los detalles de esta API en la documentación de la API. La configuración debería ser similar a la siguiente

• Método: POST

URL: https://api.chakrahq.com/v1/ext/plugin/whatsapp/{{chakraPluginId}}/api/v22.0/{{whatsappPhoneNumberId}}/messages

• Encabezados:

Authorization: Bearer {{chakraAccessToken}}

• Cuerpo: Debe ser de tipo JSON

• Cuerpo: El objeto JSON completo debería ser así

Encontrarás en tu cuenta de Chakra Chat los datos necesarios para configurar la API anterior. A continuación, se describe brevemente cada uno

Cómo encontrar chakraPluginId

En la página de configuración de WhatsApp de Chakra Chat, busca el ícono de tres puntos junto al botón Guardar, en la esquina superior derecha. Haz clic en él y luego en el botón "Copiar ID del plugin". El ID del plugin se copiará. Puedes pegarlo donde lo necesites

Cómo encontrar WhatsAppPhoneNumberId

En la página de configuración de WhatsApp de Chakra Chat, haz clic en el ícono de engranaje junto a "📞 Número de teléfono de WhatsApp. s". En el panel que se abre, encontrarás el ID de Meta de cada número de teléfono en la columna de número de teléfono

Cómo obtener chakraAccessToken

Para poder usar las API de Chakra, primero debes crear una clave de API para tu caso de uso en la sección Claves de API de Chakra Chat.

Crea una clave de API

Para crear una clave de API, debes proporcionar la siguiente información:

• Nombre: nombre de la clave. Elige un nombre descriptivo para que sea más fácil administrar las claves.
• Descripción (opcional): descripción del acceso de las claves de API
• Rol: elige un role para la nueva clave de API. La clave heredará los privilegios del rol asignado y estará limitada por ellos. Asegúrate de que las claves de API expuestas públicamente tengan el rol con los menores privilegios necesarios para realizar la tarea.

Después de crear una clave de API, encontrarás chakraAccessToken en la sección "Tokens de acceso" de la clave de API creada.

3.3 Después de configurar la solicitud HTTP, vuelve al lienzo y haz clic en el botón Ejecutar paso que aparece encima del nodo Solicitud HTTP. Si todo está configurado correctamente, el nodo debería ejecutar el paso sin problemas y deberías recibir la respuesta de prueba de OpenAI en la cuenta de WhatsApp del usuario final 🥳

4. Publica tu flujo de trabajo

4.1 Guarda tu flujo de trabajo y márcalo como activo

4.2 Haz doble clic en el webhook y haz clic en Production URL debajo de webhook URLs. Luego, haz clic en la URL para copiarla

4.3 Ahora abre tu cuenta de Chakra Chat y ve a la página de configuración de WhatsApp. Luego, haz clic en la pestaña More. Pega la URL del webhook que copiaste en el cuadro de entrada debajo de "URL del webhook de transferencia."

4.4 Haz clic en Guardar en la esquina superior derecha de la página para guardar esta configuración. Ahora, los eventos de WhatsApp se enviarán a la URL del webhook de producción.

Conclusión

¡Eso es todo! Ahora puedes probar tu bot y luego modificar el agente para resolver casos de uso más complejos. El agente de IA descrito arriba es bastante básico. Para casos de uso prácticos, tendrás que agregar otros elementos, como memoria o procesamiento de imágenes. Pero el principio básico sigue siendo el mismo

Apéndice

A. Agrega una condición if para filtrar los eventos que no sean mensajes

Por lo general, el webhook de transferencia recibirá muchos eventos de WhatsApp. Algunos serán eventos de mensajes y otros podrían ser eventos de estado o de facturación. Lo ideal sería agregar un nodo de condición if después del nodo Webhook para filtrar los eventos que no sean mensajes.

Después de hacer lo anterior, asegúrate de cambiar la expresión de la instrucción del usuario en el nodo AI Agent para seleccionar correctamente los datos del webhook. Ahora se verá más o menos así

{{ $('Webhook').item.json.body.entry[0].changes[0].value.messages[0].text.body }}

B. Usa la memoria para llevar un seguimiento de una conversación

En algún momento, querrás usar la memoria para llevar un seguimiento de una conversación con un usuario. Los eventos de mensajes también incluyen el número de teléfono del usuario final, que sirve como una excelente clave para agrupar todos los mensajes

C. Accede a los archivos multimedia enviados por los usuarios

Es posible que quieras procesar imágenes o documentos que envíen tus usuarios. En ese caso, los eventos del webhook de WhatsApp generalmente incluirán un ID de archivo multimedia de WhatsApp. Puedes obtener el archivo multimedia asociado con este ID mediante la API de visualización de archivos multimedia