Documentación
Todo sobre conectar tu número, mantener la conexión saludable y usarlo desde tu IA o desde tu propio sistema.
¿Qué es EasyCoexistence?
EasyCoexistence pone el número comercial que ya usas en la WhatsApp Business Platform (Cloud API) mediante Coexistencia, la función oficial de Meta, y luego monitorea la conexión a toda hora para que nunca muera en silencio.
- La app de tu teléfono sigue funcionando exactamente igual. La Coexistencia agrega la API a su lado, sin reemplazar nada.
- Sin migración y sin perder chats: tu historial se queda en el teléfono.
- Conecta todos los números que quieras en una sola cuenta.
- Tus conversaciones nunca pasan por nuestros servidores. Los mensajes entrantes pueden enrutarse desde Meta directo a tu propio sistema.
Conectar un número
- Crea tu cuenta y abre el panel.
- Haz clic en “Conectar un número”. Se abre la ventana de Meta; inicia sesión con la cuenta de Facebook que administra tu negocio.
- Ingresa tu número comercial y escanea el código QR con la app WhatsApp Business de tu teléfono.
- Listo, normalmente en menos de 2 minutos. El número aparece en tu panel con su salud en vivo.
¿Tu número es elegible? Lee esto primero
Meta impone algunas reglas antes de permitir la Coexistencia. La mayoría de las conexiones fallidas choca con una de estas:
- El número debe estar en la app WhatsApp Business, versión 2.24.17 o más reciente. Las cuentas de WhatsApp personal no pueden conectarse.
- El número necesita actividad de conversación real y reciente en ambos sentidos. Los números nuevos o inactivos son rechazados.
- El número no puede estar vinculado a otra plataforma o proveedor de API (herramientas de envío masivo, CRMs, automatización). Desconéctalo allí primero y vuelve a intentar.
- La verificación en dos pasos o un emparejamiento de dispositivo pendiente también pueden bloquear el proceso.
Si Meta dice que el número está “registrado en una cuenta de WhatsApp existente”, NO borres la cuenta de WhatsApp del teléfono; el número debe seguir activo en la app. Libéralo de la otra plataforma.
Qué cambia en la app (lo que cedes)
Activar la Coexistencia desactiva algunas funciones de la app, todas en chats individuales (1:1). Conócelas antes de conectar:
- Los mensajes temporales se desactivan en los chats 1:1.
- Los mensajes de vista única se desactivan en los chats 1:1.
- La ubicación en tiempo real se desactiva en los chats 1:1.
- Listas de difusión: no se pueden crear nuevas, y las existentes quedan en solo lectura.
- Al conectar, todos los dispositivos vinculados se desconectan y hay que vincularlos de nuevo. WhatsApp para Windows y WearOS dejan de ser compatibles.
- Los grupos, llamadas, catálogo y estados siguen funcionando en la app, pero no aparecen del lado de la API.
- El número pasa a tener un tope combinado de 20 mensajes por segundo en la API. El uso diario no se ve afectado.
Úsalo desde tu IA (un conector por cuenta)
Toda tu cuenta usa una única URL de conector. Sirve para todos los números que conectes, ahora y en el futuro: tu IA ve todos tus números y elige el correcto para cada tarea.
- Claude (web o escritorio): Configuración → Conectores → Agregar conector personalizado, luego pega la URL.
- ChatGPT: Configuración → Conectores → Avanzado, activa el modo Desarrollador y agrega la URL.
- Claude Code (terminal): claude mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp
- Cuando se te pida, inicia sesión con tu email y contraseña de EasyCoexistence y autoriza el acceso.
Luego solo pide: “envía un mensaje desde mi número”, “crea una plantilla de promoción”, “¿mi número está saludable?”, “enruta los mensajes entrantes a mi sistema”.
Qué puede hacer tu IA (tools)
- list_numbers: todos tus números con estado, calidad y nivel.
- get_number_health: instantánea en vivo desde Meta más la línea de tiempo de eventos recientes.
- send_message: respuesta libre dentro de la ventana de atención de 24 horas.
- create_template, get_template_status, list_templates: crear y seguir plantillas de mensaje.
- send_template: iniciar conversaciones con una plantilla aprobada.
- get_api_credentials: IDs, endpoints y token para integrar tu propio sistema.
- set_webhook_destination: enrutar mensajes entrantes directo de Meta a tu webhook.
- get_connect_link: cómo conectar otro número.
- get_docs: esta documentación, para que tu IA responda dudas sobre el producto.
Reglas de envío (de Meta, no nuestras)
- Responder es libre: a quien te escribió en las últimas 24 horas puedes contestarle directamente.
- Iniciar una conversación requiere una plantilla pre-aprobada.
- En Coexistencia, las plantillas solo se envían por la API; la app del teléfono no puede enviarlas.
- Los mensajes de marketing los cobra Meta al medio de pago de tu propia cuenta de WhatsApp Business. Nunca recargamos el precio de los mensajes.
- Meta limita el caudal de la API en números con Coexistencia; el uso diario de la app no se ve afectado.
Conecta tu propio sistema
La página de cada número en el panel muestra la URL base de la API, los IDs de cuenta y de teléfono y el token de acceso: todo lo que n8n, un CRM o código propio necesitan para enviar por la Cloud API oficial. Para recibir, pídele a tu IA que enrute los mensajes entrantes a tu webhook (set_webhook_destination): Meta los entrega directo en tu endpoint, sin tocar nunca nuestros servidores.
Monitoreo y la regla de los 7 días
Vigilamos cada número conectado a toda hora (estado de la conexión, calidad y nivel de mensajería) mediante webhooks de Meta y chequeos periódicos. Si la app comercial del teléfono pasa unos 7 días sin abrirse, Meta puede cortar la Coexistencia en silencio. En cuanto algo se rompe, tu panel lo muestra con el motivo. Regla de oro: sigue usando la app con normalidad.
Qué NO es EasyCoexistence
- No es un inbox ni un chatbot. Las conversaciones siguen en tu app, en tu IA o en tu sistema; no agregamos otro panel donde vivir.
- No es una herramienta de envío masivo. Las reglas de Meta siguen vigentes: respuestas en la ventana de 24 horas, plantillas para iniciar conversaciones.
- No es un producto de Meta. Somos un Tech Provider independiente que usa Coexistencia, la función oficial de la plataforma.
- No es un intermediario de tus mensajes. Nunca leemos ni almacenamos el contenido de tus conversaciones.
¿Y si EasyCoexistence dejara de existir mañana? A tu número no le pasa nada: la app sigue funcionando, el historial permanece en tu teléfono y la conexión con la API puede deshacerse en cualquier momento. Un puente, no una jaula.
Preguntas frecuentes
¿Cuánto cuesta?
US$ 9 por número conectado, al mes, con los primeros 7 días gratis. Una cuenta puede tener todos los números que quieras y cada uno cuesta lo mismo, así que cinco números son US$ 45. Quitar un número detiene su cobro al final del ciclo actual. Los costos de mensajería de Meta (plantillas de marketing, por ejemplo) son aparte y siempre los cobra Meta directamente a tu propia cuenta.
Mi número aparece como desconectado. ¿Y ahora?
Primero abre la app en tu teléfono (la causa más común es la regla de los 7 días). Luego repite el flujo de conexión con el mismo número: Meta lo reconoce, muestra una opción premarcada para restaurar los productos anteriores y completa la reconexión sola en pocos minutos.
¿Cómo desconecto mi número?
En la página del número, en el panel, en Quitar este número. Revocamos nuestro propio acceso en Meta, el monitoreo se detiene de inmediato y el cobro de ese número termina con el ciclo actual. Desconectar nunca afecta la app: los chats y el historial siguen en tu teléfono, y puedes reconectar después repitiendo el flujo de conexión.
Mi plantilla no se envía. ¿Por qué?
La causa más común: tu cuenta de Meta aún no tiene un medio de pago. Los envíos de plantillas (sobre todo marketing) los cobra Meta a tu propia cuenta; registra una tarjeta en WhatsApp Manager, en facturación, e intenta de nuevo. Verifica también que la plantilla esté aprobada (pídele el estado a tu IA).
¿Mis conversaciones antiguas aparecerán en mi sistema o en mi IA?
Solo si tú quieres. Durante la conexión, Meta pregunta si deseas sincronizar el historial con el lado de la API, y puedes rechazarlo. En cualquier caso, EasyCoexistence nunca lee ni almacena el contenido: el historial se queda en tu teléfono, y los mensajes nuevos solo llegan a tu propio sistema si configuras el enrutamiento.
¿Funciona con un número fijo?
Sí. Si el número fijo está activo en la app WhatsApp Business, se conecta con normalidad (tenemos clientes con números fijos conectados).
¿Cómo revoco accesos?
Para quitarle el acceso a un agente de IA, elimina el conector en la configuración del propio agente. Para quitarnos el acceso a nosotros, desconecta el número (pregunta anterior). Los tokens de acceso se guardan cifrados y nunca se exponen a terceros.
Guías
Las explicaciones largas a las que todo lo demás apunta.
- WhatsApp MCP server for Claude, ChatGPT and CursorConnect Claude, ChatGPT or Cursor to a real WhatsApp number over MCP. Official Cloud API, eleven tools, no linked-device workaround and no ban risk.
- WhatsApp Coexistence: the app and the API on one numberCoexistence runs the WhatsApp Business app and the Cloud API on the same number at once. What it changes, what it does not, and how a number gets connected.
- Unofficial WhatsApp APIs: what actually gets numbers bannedUnofficial WhatsApp gateways sign in as a linked device, which breaks Meta's terms. What that costs, and what the official route looks like instead.
- WhatsApp Cloud API or Coexistence: which one a number needsBoth are Meta's. One takes the number onto the API alone, the other runs the API beside the WhatsApp Business app. Which to pick, and what each costs you.
- WhatsApp webhooks: routing messages straight to your serverHow WhatsApp webhooks work, what Meta sends, and how to route incoming messages directly to your own endpoint instead of through a provider's platform.
- WhatsApp Coexistence for agencies and consultanciesConnect client WhatsApp numbers without migrating them or retraining their staff. One account, many numbers, each in the client's own Business Portfolio.
- What being a Meta Tech Provider means, and why it mattersA Tech Provider connects other businesses' WhatsApp numbers through its own Meta app. What the status requires, and what it changes for the client.
- WhatsApp Coexistence glossaryPlain definitions for the vocabulary around WhatsApp Coexistence: WABA, Business Portfolio, phone number id, templates, quality rating, Tech Provider and MCP.
Integraciones
Alcanzar un número conectado desde la herramienta que ya usas.
- Connect WhatsApp to n8n on the official Cloud APIRoute WhatsApp messages into an n8n workflow over Meta's official Cloud API, on a number the business still answers from the phone. No linked device.
- Connect WhatsApp to Claude with a custom connectorAdd EasyCoexistence as a custom connector and Claude can read, send and wire a real WhatsApp number over Meta's official Cloud API. One OAuth sign in.
- Connect WhatsApp to Make on the official Cloud APIRoute WhatsApp messages into a Make scenario over Meta's official Cloud API. Why Make uses the webhook path rather than our MCP server.
- Connect WhatsApp to Zapier on the official Cloud APITrigger a Zap from an incoming WhatsApp message over Meta's official Cloud API, and send replies back with a webhook action.
- Connect WhatsApp to ChatGPT with a custom connectorAdd EasyCoexistence as a connector in ChatGPT and it can read, send and wire a real WhatsApp number over Meta's official Cloud API.
- Connect WhatsApp to Cursor over MCPAdd EasyCoexistence to Cursor's MCP settings and send WhatsApp messages, manage templates and wire webhooks without leaving the editor.
- Connect WhatsApp to Claude Code over MCPOne command adds EasyCoexistence to Claude Code, so an agent can send WhatsApp messages, manage templates and wire webhooks from the terminal.
- Send and receive WhatsApp from PythonReceive WhatsApp messages in a Python web handler and send replies through Meta's official Cloud API, on a number a team still answers from the phone.
- Send and receive WhatsApp from Node.jsReceive WhatsApp messages in a Node handler and send replies through Meta's official Cloud API, on a number a team still answers from the phone.
Comparaciones
Las decisiones que la gente sopesa antes de elegir.
- EasyCoexistence vs a BSP inboxA BSP gives you a shared inbox and sits in the message path. Coexistence keeps the phone and routes messages to your own systems. When each one is right.
- EasyCoexistence vs building it yourselfEverything here is Meta's documented API, so you can build it. What that actually takes, and the part that is not the building.
- EasyCoexistence vs 360dialogBoth charge per number and neither marks up Meta's fees. The difference is the price and what the fee is for. Prices as published in September 2026.
- EasyCoexistence vs WATIWATI is a shared team inbox priced per user. EasyCoexistence is a connection priced per number. Which one you need depends on whether you have a team or a system.
- EasyCoexistence vs respond.iorespond.io is a multichannel inbox with workflows and AI agents, priced per month with user and contact limits. EasyCoexistence is a connection priced per number.
- EasyCoexistence vs DualhookBoth route WhatsApp webhooks directly from Meta and neither stores messages. Where the two differ, and where Dualhook is ahead. Verified September 2026.
Primeros pasos
Conectar un número y qué pasa después.
- Coexistence referenceWhat Coexistence is, how messages flow, what it costs, what it cannot do, eligibility, and how to roll it back. The short reference version.
- Connecting a number, step by stepWhat happens when you connect a number through Coexistence, what the business owner has to do, and what is decided once and cannot be changed.
- A number stopped working: how to find out whyA checklist in the order these failures actually happen: token, webhook override, inactivity disconnection, quality, and account restriction.
- What changes in the WhatsApp Business app after connectingEverything that stays the same on the phone after a number is connected through Coexistence, and the three things that genuinely change.
La plataforma de Meta
Las cuentas, identificadores y verificaciones que hay debajo de cada número.
- Display names on a WhatsApp business numberThe name customers see above a conversation. How approval works, what gets rejected, and which webhook reports the decision.
- Meta Business Portfolio, and what sits inside itThe company level container in Meta Business Manager. What it holds, why it matters for a client's number, and how it differs from a WABA.
- Two step verification on a WhatsApp numberThe six digit PIN set on a WhatsApp Business number, which operations require it, and what to do when nobody remembers it.
- The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.
Enviar mensajes
Qué se puede enviar, cuándo, y qué revisa Meta antes.
- The 24 hour customer service windowWhat the customer service window is, when it opens and closes, what may be sent inside and outside it, and why replies inside it are free.
- Which WhatsApp conversations Meta charges forReplies inside the customer service window are free. What Meta charges for, who it bills, and why a provider cannot mark it up.
- WhatsApp message templatesWhat templates are, the three categories, how variables work, how review goes, and why on Coexistence they can only be sent through the API.
- Template categories: utility, marketing and authenticationThe three template categories, what belongs in each, how they differ on billing and review, and why the wrong category is a reliable rejection.
Webhooks
Cómo llegan los eventos a tus sistemas, y qué contienen.
- The account_alerts webhookMeta's general alerting channel for a business account. What arrives here, and why it is a prompt to look rather than a state change.
- The account_review_update webhookMeta reports the outcome of an account review here. What the decision field carries, and why a rejection is worth treating as a degraded connection.
- The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.
- The business_capability_update webhookHow messaging limit changes arrive. What the tier means, why it moves in both directions, and how it differs from throughput.
- WhatsApp webhook fields, and which ones go whereThe eight webhook fields a Coexistence connection uses, what each carries, and which are routed to your endpoint versus kept for monitoring.
- The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.
- The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.
- Verifying a WhatsApp webhook endpointMeta calls your endpoint with a GET challenge before delivering anything. What it sends, what to return, and why a wrong answer fails silently.
El conector MCP
Alcanzar un número desde un asistente de IA.
- MCP or a webhook: which one you actually needMCP acts when asked. A webhook reacts when something happens. Why an assistant cannot answer customers on its own, and why most systems need both.
- MCP tools referenceAll eleven tools the EasyCoexistence MCP connector exposes, what each takes, and which are gated when billing lapses.
Códigos de error
Cada error que nuestros usuarios encuentran de verdad, desde la referencia publicada por Meta.
190access token expired368account restricted by policy130429throughput limit reached131026message undeliverable131031account restricted or data mismatch131042business account payment issue131047re-engagement message131048spam rate limit hit131049message blocked for ecosystem health132000parameter count mismatch132001template does not exist132015template paused for quality133010phone number not registered2593107synchronization limit exceeded2593108sync outside the 24 hour window
Soporte
¿Tienes una duda que no está aquí? Escríbenos a matheus@tonelotto.com.