Crea un bot de WhatsApp con Claude Code o Codex, en el número que conservas en la app
Añade un servidor MCP de WhatsApp a Claude Code o Codex y deja que el agente de programación haga la configuración. Lee las credenciales de Cloud API del número, genera un receptor de webhook, dirige hacia él los mensajes entrantes y envía una respuesta de prueba a alguien que escribió en las últimas 24 horas. El resultado es tu propio agente, que se ejecuta como código tuyo en tu servidor.
easyCoexistence conecta el número de WhatsApp Business que conservas en la app con la Cloud API de Meta mediante Coexistencia, y da a Claude Code y Codex más de 30 herramientas MCP con las que construir: credenciales, enrutamiento, plantillas, envíos de prueba y automatizaciones.
Flag de Claude Code que carga un servidor en todos tus proyectos; el alcance local predeterminado lo carga solo donde se añadió.
Comando de Codex que guarda el inicio de sesión OAuth de un servidor; sin credencial, Codex puede conectarse sin autenticación.
Lo que debe usar un destino de webhook directo, que además debe devolver hub.challenge en el handshake GET de Meta.
Cuánto espera el paso Llamar a mi webhook la respuesta {"reply"} de tu endpoint antes de que el paso falle.
Ventana de atención al cliente tras el último mensaje del usuario; fuera de ella, Meta solo acepta mensajes de plantilla.
Throughput fijo de un número que se usa a la vez con la app de WhatsApp Business y con la Cloud API.
¿Qué necesita un agente de programación para crear un agente de WhatsApp?
Cuatro cosas. La primera es un número de WhatsApp Business conectado a la Cloud API de Meta mediante Coexistencia, de modo que la app sigue en el teléfono mientras el código envía y recibe mensajes. La segunda, una conexión MCP desde Claude Code o Codex a ese número, que permite al agente de programación leer credenciales, cambiar el enrutamiento y enviar mensajes de prueba sin que tengas que abrir un panel. La tercera, una dirección HTTPS pública para el receptor, ya sea de un host donde despliegues o de un túnel mientras desarrollas. Y la cuarta, una clave de modelo para el agente que estás construyendo.
Distingue bien los dos agentes. Claude Code o Codex es el constructor y solo actúa mientras trabajas con él en la terminal. El programa que escribe es el que responde a los clientes, y sigue funcionando después de que cierres la sesión.
¿Cómo se añaden las herramientas de WhatsApp a Claude Code y Codex?
Ambos se configuran con una URL desde la terminal e inician sesión con OAuth, así que ninguna clave acaba guardada en un archivo. En Claude Code, añade el servidor con --scope user para que se cargue en todos los proyectos. Después inicia claude, ejecuta /mcp, elige easycoexistence e inicia sesión en el navegador. En Codex, añade el servidor y ejecuta codex mcp login, que guarda el inicio de sesión; codex mcp list muestra lo que está configurado. Codex guarda la entrada en ~/.codex/config.toml, un archivo que también leen la app de escritorio de ChatGPT y la extensión de Codex para el IDE.
Para comprobar que funciona, pide algo que solo las herramientas pueden responder, como "lista mis números de WhatsApp". El agente llama a list_numbers y obtiene el connection_id de cada número, que es el dato que piden todas las demás herramientas.
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list¿Qué ruta debe construir el agente?
Hay tres rutas que llevan el mensaje de un cliente hasta tu código, y se diferencian en cuánto trabajo le dejan al código. Para una primera versión, el paso Llamar a mi webhook es la más corta. easyCoexistence descarta los duplicados, se aparta cuando respondes desde el teléfono y comprueba la ventana de 24 horas antes de llamar a tu endpoint, así que tu código solo tiene que escribir la respuesta. Pasa a una Forward URL o a un destino directo cuando el agente necesite todos los eventos, y no solo los mensajes que selecciona una automatización.
¿Qué debes pedirle al agente de programación?
Dale desde el principio la ruta, el lenguaje y las reglas, y pídele un plan antes de que escriba código. Indícale qué llamadas a herramientas puede hacer por su cuenta: leer credenciales y documentación no tiene riesgo, mientras que cambiar adónde van los mensajes afecta al número en producción. get_docs devuelve la documentación de easyCoexistence, incluido cómo un receptor autentica las entregas, para que el agente lea las reglas en lugar de adivinarlas. Una petición como esta produce un receptor que puedes revisar de una sola vez:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.¿Cómo se conecta el receptor y cómo se prueba?
Inicia el servidor en un lugar donde Meta y easyCoexistence puedan alcanzarlo por HTTPS, y deja que el agente se encargue del enrutamiento. En la ruta Forward URL, el agente llama a set_inbound_mode con tu URL en un número en modo Automatizaciones activadas. El secreto de reenvío se devuelve una sola vez y el agente lo escribe en tu .env. En la ruta directa, el endpoint tiene que responder primero al handshake GET de Meta. Después, el agente llama a set_webhook_destination con la URL, un secreto aleatorio largo en su ruta y tu token de verificación.
Para probarlo, escribe al número de la empresa desde tu propio teléfono y sigue los logs: el receptor debe ver el evento, el modelo debe responder y la respuesta debe aparecer en el chat. Como acabas de escribir, la ventana de 24 horas está abierta, así que el agente de programación también puede probar send_message con tu propio número.
¿El agente terminado sigue necesitando el servidor MCP?
No. El servidor MCP es la herramienta del constructor y tiene la sesión iniciada con tu cuenta. El agente que despliegas envía mensajes a través de la Graph API de Meta con el send_endpoint y el access_token que devolvió get_api_credentials. Ese es el token propio del negocio, limitado a sus activos de WhatsApp, y el agente recibe los mensajes por la ruta que configuraste. Si access_token llegó como null, al reconectar el número desde el panel se genera uno, sin sustituir un token que ya funcione.
Conserva la conexión MCP para el trabajo en torno al agente: crear plantillas con create_template, consultar get_number_health cuando algo no vaya bien y leer el registro de ejecución de cualquier automatización que pase mensajes a tu código.
Cómo configurarlo
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
Errores comunes
- Guardar un túnel temporal como destino directo durante las primeras 24 horas. La importación única que hace Meta de los contactos y de hasta 6 meses de chats se envía a esa URL y se pierde cuando se cierra el túnel.
- Configurar un destino directo en un número que ejecuta automatizaciones. El número pasa a modo directo y sus automatizaciones se detienen. Para mantener ambas cosas, usa una Forward URL en modo Automatizaciones activadas.
- Subir a git el .env que escribió el agente. Añádelo antes a .gitignore, porque cualquiera que tenga el access token puede escribir a los clientes en nombre del negocio.
- Probar send_message con un contacto que no ha escrito en las últimas 24 horas. Meta rechaza el texto libre fuera de la ventana, así que escribe primero al número desde tu propio teléfono.
Después, tu agente se ejecuta en tu propio servidor, y cada número se monitoriza 24/7 con alertas. De US$ 9 a US$ 0.75 por número al mes, un precio que baja a medida que añades números, con los primeros 3 días gratis.
Preguntas frecuentes
¿Funciona en Cursor u otras herramientas de programación?
Sí. Cualquier cliente MCP que se conecte a servidores remotos por Streamable HTTP con OAuth puede usar la misma URL, incluidos Cursor, VS Code, Gemini CLI y Antigravity. Lo único que cambia de un cliente a otro es el formato de configuración.
¿En qué lenguaje debe programar el agente?
En cualquier lenguaje que pueda servir HTTPS y calcular un HMAC-SHA256. Node.js y Python son las opciones habituales. En la página del agente con Node.js y Python hay ejemplos probados para ambos, con verificación de firma, gestión de duplicados y la pausa cuando respondes desde el teléfono.
¿Necesito una app de Meta propia o pasar el App Review?
No. El número se une a la Cloud API a través de la app de Meta de easyCoexistence y permanece en el Portafolio Comercial del propio negocio. El token con el que envía tu código es del propio negocio, así que no interviene ninguna app de Meta tuya.
¿Puede el agente de programación crear las plantillas que necesita el agente?
Sí, con create_template, y después con get_template_status hasta que Meta responda, normalmente en minutos y como máximo en unas 24 horas. Tu agente necesita una plantilla aprobada para iniciar una conversación o para escribir cuando ya se ha cerrado la ventana de 24 horas.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el