Traiga su propio agente de IA a WhatsApp: conecte cualquier framework (LangGraph, ADK, personalizado) con un endpoint webhook

Puede conectar casi cualquier agente de IA a WhatsApp sin reescribirlo. Ejecute su agente, creado con LangGraph, Google ADK, CrewAI o su propio código, detrás de un endpoint HTTPS y añádalo después en MonoChat como un AI Harness con el proveedor Personalizado: una URL de endpoint y un secreto compartido. Coloque un nodo AI Agent en un flujo, conecte su número de WhatsApp y su agente atenderá a los clientes en WhatsApp y en todos los demás canales que conecta MonoChat, con una bandeja de entrada compartida y traspaso a una persona alrededor.

Esta guía es para equipos que ya tienen un agente, o que quieren un control total sobre cómo funciona. Explica cuándo tiene sentido traer su propio agente, de qué se encarga su endpoint, la configuración en MonoChat y los detalles que importan en producción.

¿Por qué traer su propio agente?

La mayoría de las plataformas de mensajería con clientes incluyen un agente de IA integrado. Es cómodo hasta que:

• Su agente ya está creado. Sus desarrolladores dedicaron meses a un grafo de LangGraph o a una configuración multiagente de ADK, con evaluaciones y pruebas. Reconstruirlo dentro del creador de bots de un proveedor tira ese trabajo a la basura.
• Necesita su propia lógica. Reglas de precios, comprobaciones de elegibilidad, pasos de cumplimiento normativo o sistemas internos a los que solo llega su código.
• Quiere elegir el framework. Los frameworks evolucionan rápido. Hoy es LangGraph; el año que viene puede ser otro. Sus canales y su bandeja de entrada no deberían tener que cambiar con él.
• Los datos tienen que quedarse con usted. Algunas organizaciones quieren que el razonamiento del agente y las llamadas a herramientas se ejecuten en su propia infraestructura.

El Agent Harness de MonoChat está pensado para esto: traiga su propio framework de agentes y mantenga todo lo que lo rodea, los canales, la bandeja de entrada, las personas, en un solo lugar.

Cómo funciona el harness Personalizado

Piense en ello como un reparto del trabajo.

MonoChat se ocupa de la capa de conversación:

• Las conexiones oficiales con WhatsApp, Instagram, Messenger, TikTok, Telegram, chat web, SMS y voz (MonoChat es un Meta Business Partner oficial).
• El flujo que decide cuándo se llama al agente, mediante el nodo AI Agent.
• La bandeja de entrada de equipo compartida, donde una persona puede tomar el relevo con todo el historial.

Su endpoint se ocupa del agente:

• Recibir la conversación de MonoChat.
• Ejecutar su agente: su razonamiento, sus herramientas, su memoria.
• Devolver la respuesta del agente.

Entre ambos hay un secreto compartido, un valor que conocen ambas partes, para que su endpoint pueda verificar que una solicitud procede de su cuenta de MonoChat. MonoChat define el formato exacto de solicitud y respuesta que implementa su endpoint; si todavía no lo tiene, hable con nosotros y se lo facilitaremos a sus desarrolladores.

Qué debe hacer su endpoint

Sea cual sea el framework que use, un endpoint de agente listo para producción tiene varias tareas.

Verifique cada solicitud

Compruebe el secreto compartido en cada llamada y rechace todo lo que no coincida. Guarde el secreto en su gestor de secretos o en variables de entorno, no en el código, y rótelo si alguna vez queda expuesto.

Mantenga separada cada conversación

Los clientes escriben en paralelo. Asegúrese de que el estado, la memoria y los archivos de trabajo de su agente están limitados a una sola conversación, para que los datos de un cliente nunca se filtren en la respuesta a otro.

Responda con mensajes del tamaño de un chat

Los agentes creados para aplicaciones web tienden a escribir respuestas largas y con formato. WhatsApp se lee en el teléfono. Pida a su agente mensajes cortos, una pregunta cada vez, y evite el Markdown pesado en las respuestas.

Falle de forma visible, no en silencio

Si una herramienta agota el tiempo de espera o su proveedor de modelos devuelve un error, devuelva un fallo claro en lugar de una respuesta a medias. Un fallo predecible permite que el flujo haga lo correcto, por ejemplo traspasar la conversación a una persona.

Sea rápido

Los clientes esperan una respuesta en segundos. Mantenga el trabajo de larga duración fuera de la ruta de respuesta siempre que pueda, y haga que sus herramientas sean rápidas o asíncronas.

Paso a paso en MonoChat

1. Despliegue su agente detrás de HTTPS

Aloje su agente de LangGraph, ADK, CrewAI o personalizado en su propio servidor o nube, accesible por HTTPS. Implemente el formato de solicitud y respuesta de MonoChat y la comprobación del secreto compartido.

2. Añada un AI Harness con el proveedor Personalizado

En MonoChat, añada un AI Harness, elija Personalizado e introduzca la URL de su endpoint y el secreto compartido. Añade el harness una vez y puede usarlo en tantos flujos como quiera.

3. Añada un nodo AI Agent a un flujo

En el flujo que recibe las conversaciones entrantes, añada un nodo AI Agent y seleccione su harness personalizado. Use el flujo que lo rodea para lo que los flujos hacen mejor: el saludo, el enrutamiento por idioma o tema, el horario de atención y el camino hacia una persona.

4. Defina un presupuesto por ejecución

Cada nodo AI Agent admite límites de presupuesto por ejecución. Úselos como red de seguridad junto a los límites que ya aplica en su propio código.

5. Conecte WhatsApp y otros canales

Conecte su número de WhatsApp Business y luego asocie el mismo flujo a los demás canales que use. No hay trabajo de integración adicional por canal: su endpoint ve conversaciones, no API de canales.

6. Pruebe y luego póngalo en marcha

Reproduzca mensajes reales de clientes a través del flujo. Compruebe las llamadas a herramientas, los tiempos de respuesta, el tono y el traspaso. Vigile de cerca los primeros días de tráfico real y después amplíe lo que el agente puede hacer.

Notas sobre los frameworks

LangGraph. Un grafo de nodos y aristas encaja de forma natural con los recorridos de atención al cliente (clasificación, consulta, resolución, escalado). Envuelva el grafo compilado en un pequeño servicio HTTP, cargue el estado de la conversación en cada solicitud y devuelva el mensaje final.

Google ADK. Los árboles multiagente de ADK, con un coordinador y subagentes especialistas, se corresponden bien con los equipos de soporte, ventas y facturación. Exponga el agente raíz a través de su endpoint y deje que ADK enrute internamente.

CrewAI. Los equipos de agentes basados en roles funcionan bien en tareas con traspasos claros, como investigar y luego responder. Mantenga los equipos pequeños para el chat: cada agente adicional añade latencia.

Su propio código. Un simple bucle con una API de modelo y unas pocas funciones suele bastar. Usted mantiene el control total, y MonoChat le ofrece los canales y la bandeja de entrada.

Traspaso: decídalo en el flujo

Decida en el flujo qué conversaciones van a una persona y qué equipo las recibe, y escriba su agente para que le diga al cliente con honestidad cuándo no puede ayudar en lugar de adivinar. A continuación, el flujo traspasa la conversación al equipo adecuado en la bandeja de entrada compartida con todo el historial. La Política de Mensajería Empresarial de WhatsApp también espera que las respuestas automáticas ofrezcan una vía clara hacia una persona.

Mantenga también su agente dentro de su negocio. Desde el 15 de enero de 2026, WhatsApp excluye de la plataforma a los asistentes de IA de propósito general; los agentes que atienden a sus propios clientes están permitidos. Nuestra guía de la política de WhatsApp sobre chatbots de IA explica la regla.

Cuándo no crear el suyo

Un agente personalizado es la opción más flexible y también la que usted mantiene. Si empieza desde cero, una opción integrada le pone en marcha más rápido y sin nada que alojar:

• El harness integrado de MonoChat con sus modelos de IA de MonoChat.
• OpenAI Agents SDK, ejecutado dentro de MonoChat (guía).
• Claude Agent SDK o Pi, ejecutados en el agent runner de MonoChat (guía de Claude).
• Agentes alojados: OpenAI Agents API o Claude Managed Agents, con su propia clave.

Como todas las opciones usan el mismo nodo AI Agent, puede empezar con una y pasar más adelante a su propio agente sin tocar sus canales ni el traspaso. Compárelas en la página de Agent Harness.