Un número.La app y la API, al mismo tiempo.
Coexistence es el modo oficial de Meta para ejecutar la app de WhatsApp Business y la Cloud API en un mismo número a la vez. El equipo sigue atendiendo desde el teléfono, con los mismos chats y el mismo historial, mientras el software envía y recibe en esa misma línea.
easyCoexistence conecta el número a través del Embedded Signup de Meta, lo vigila con los webhooks de Meta y sus propias comprobaciones, y te envía por correo el motivo y la solución si Meta lo desconecta.
La elección que existía, y ya no
Coexistence no es una API nueva. Es la eliminación de una bifurcación que impedía a casi cualquier negocio pequeño automatizar nada.
El equipo atiende desde el teléfono. Nada se puede automatizar, integrar ni medir.
Sin APIEl software alcanza el número. La app Business deja de funcionar en él y el equipo cambia de herramienta.
Sin appMeta conecta la Cloud API a un número que la app de WhatsApp Business sigue usando. Ambas superficies quedan activas en la misma línea, y cada una ve lo que la otra envía.
Quién opera un número así
Dos grupos, que quieren cosas opuestas del mismo recurso, y por eso la conexión importa más que cualquier panel encima de ella.
Un equipo pequeño, un número impreso en una furgoneta o un escaparate, y noches respondiendo las mismas cuatro preguntas. No están reemplazando a nadie. Quieren que las confirmaciones, los recordatorios y la primera respuesta fuera de horario ocurran sin una persona, mientras el teléfono sigue sirviendo para todo lo demás.
Muchos clientes, cada uno con un número que nadie puede migrar ni tocar. Necesitan que esos números sean alcanzables por los sistemas que construyen, y añadir el siguiente sin una llamada comercial. Coexistence es la única vía oficial hacia un número que el personal del cliente sigue atendiendo a mano.
Cómo un número acaba en ambos, y adónde van los eventos de mensajes
Cuatro pasos. El único que toca el teléfono es un escaneo, y el que decide tu arquitectura es el primero.
Ten el endpoint listo antes de que empiece la incorporación
Meta verifica un destino antes de entregarle nada. Llama a tu URL con un GET que lleva hub.mode=subscribe, tu hub.verify_token y un hub.challenge, y tu endpoint tiene que devolver el hub.challenge tal cual lo recibió.
El destino debe ser HTTPS, y el token de verificación es obligatorio. Validamos ambos antes de hacer la llamada, así que una URL mal formada falla en nuestra puerta en lugar de parecer conectada y no entregar nada.
Todavía no hay nada conectado. Esto decide dónde llegarán los mensajes. Proveedor en el caminoGuardado en sus servidoresSu plataformaRecibe y guarda los mensajesTúUna copia, cuando ellos quieranEasyCoexistenceSolo configuraciónTu endpointAún sin verificarNosotrosFijamos la ruta, no estamos en ellaEjecuta el Embedded Signup de Meta y escanea en la app
Se abre la ventana emergente de la propia Meta. Eliges el Portafolio Comercial, la cuenta de WhatsApp Business y el número ya registrado en la app de WhatsApp Business, y luego apruebas la conexión en el teléfono escaneando un código.
Aquí también eliges si compartir el historial de chats existente. Es una decisión única de la incorporación y no se puede cambiar después. La app Business sigue funcionando en cuanto termina el escaneo.
Aparece la segunda superficie. La primera no se elimina. Tras una migraciónUna superficieSolo Cloud APILa app Business, muerta en este númeroCon CoexistenceDos superficiesApp de WhatsApp BusinessLos mismos chats y el mismo historialCloud APIEn la misma líneaApunta los eventos de mensajes a tu propio sistema
Meta permite que una app sobrescriba adónde se entregan los webhooks de una cuenta de WhatsApp Business concreta. Fijamos ese override en tu URL, lo que lleva los dos campos de la ruta de mensajes, messages y smb_message_echoes, directamente de Meta a ti.
Nosotros conservamos los campos operativos, porque de ellos está hecho el monitoreo: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update y phone_number_name_update. Así el panel sigue siendo útil mientras el contenido de las conversaciones nunca pasa por nosotros.
Qué eventos van adónde una vez activo el override. Eventos operativosSe entregan a nosotrosRuta de mensajesSe entregan a timessagesTodo lo que envía un clientesmb_message_echoesLo que el equipo envía desde la appTu servidorDirectamente, nunca a través de nosotrosMantenlo activo, y sobrevive a una reconexión
Meta desconecta un número Coexistence tras unos catorce días sin actividad en el dispositivo principal. Esa desconexión se puede revertir reconectando, y la registramos como un estado propio en lugar de tratarla como un cliente que se va.
Lo que pilla a la gente desprevenida es lo que una desconexión le hace a la ruta. Meta guarda el destino como un override en la suscripción de nuestra app a la cuenta, así que un PARTNER_REMOVED desinstala la app y se lleva el override con ella. Reconectar restablece el envío y el monitoreo, pero no tu destino. Lo volvemos a poner automáticamente, porque el primer número que topó con esta regla se reconectó sin problemas y dejó de entregar en silencio al servidor del cliente.
Qué restablece una reconexión por sí sola, y qué hay que volver a poner. Restablecido por MetaAutomáticoEnvíoLa Cloud API vuelve a funcionarEventos operativosEl monitoreo se reanudaPerdido con la appHay que volver a aplicarloTu override de webhookDesinstalado con la appEntrega de mensajes a tiSe detiene en silencioLo volvemos a aplicarEn cada reconexión
Por qué se opera un número así
- Conservar el número que ya está impreso en furgonetas, recibos y la web, y el flujo de trabajo móvil a su alrededor.
- Añadir envío por API, procesamiento de webhooks y plantillas sin mover a nadie a una herramienta nueva.
- Mantener el tráfico de mensajes fuera de la bandeja compartida de un proveedor, para que las conversaciones no vivan en la plataforma de otra empresa.
- Dar a una agencia una forma de tener muchos números de clientes en una cuenta, cada uno conectado en el Portafolio Comercial del propio cliente.
Elegibilidad y límites prácticos
- El número debe estar ya activo en la app de WhatsApp Business. Un número en WhatsApp normal hay que moverlo allí primero.
- Compartir el historial de chats es una decisión única del onboarding y no se puede cambiar después.
- Los chats de grupo quedan fuera de la API en números Coexistence, en cualquier proveedor.
- El dispositivo principal necesita actividad periódica. Meta desconecta tras unos catorce días sin ella.
- Las rutas de verificación y distintivo de Meta difieren para números Coexistence, y la disponibilidad regional cambia con su política.
Qué enrutamos hacia ti, y qué nos quedamos
Meta permite que una app sobrescriba dónde entrega sus webhooks una cuenta de WhatsApp Business. Apuntamos ese override a tu URL, lo que divide los eventos en dos.
messagesTodo lo que un cliente envía al númerosmb_message_echoesLo que tu equipo envía desde la app de WhatsApp Business
account_updateEstado de la conexión: removida, offboarded, reconectada, restringidaphone_number_quality_updateCambios de calidad y throughputaccount_alertsAlertas que Meta levanta contra la cuentaaccount_review_updateResultados de una revisión de Metabusiness_capability_updateCambios de límite de mensajes y capacidadesphone_number_name_updateAprobaciones y rechazos del nombre visible
Si un número no tiene override configurado, sus eventos de mensaje caen en nuestro callback por defecto, donde el handler los descarta sin persistirlos. Eso está garantizado en código y no prometido en una política: no existe una ruta de almacenamiento que el contenido de las conversaciones pueda tomar.
La regla de los catorce días, y lo que rompe que nadie menciona
Meta desconecta una conexión Coexistence tras unos catorce días sin actividad en el dispositivo principal. Es reconectable, así que lo guardamos como estado propio en lugar de contarlo como un cliente que se fue.
La consecuencia cara viene después. El destino de tus mensajes no es un ajuste del número, es un override en la suscripción de nuestra app a la cuenta de WhatsApp Business. Una desconexión desinstala la app, y el override se va con ella. Reconectas, el envío vuelve, el monitoreo vuelve, y los mensajes dejan de llegar a tu servidor sin que nada reporte un error.
Nosotros reaplicamos el override en cada reconexión. Ese comportamiento existe porque ocurrió: un número topó con esta regla, reconectó limpio y dejó de entregar en silencio.
Un handshake que falla en ese momento, porque tu servidor estaba caído o el token cambió, queda registrado en la línea de tiempo de la conexión y el destino se conserva en vez de descartarse, así que guardarlo otra vez lo arregla.
Qué se rompe en silencio, y cómo lo detectamos
La app de WhatsApp Business sigue funcionando en casi todos los fallos de abajo, y por eso nadie se entera. Estos son los que vigilamos, y cómo.
Detectado desde el webhook account_update de Meta, en concreto PARTNER_REMOVED, en lugar de inferirlo de un campo que pasa a falso. Deliberadamente no leemos is_on_biz_app para esto, porque es legítimamente falso en números que no son Coexistence y provocaba desconexiones falsas.
La regla de inactividad del dispositivo principal de Meta. Es reconectable, así que se registra como estado propio y no como un cliente que se fue, y reconectar restaura envío y monitoreo.
El destino vive como override en la suscripción de nuestra app a la cuenta, así que una desconexión lo desinstala. El envío vuelve al reconectar y la entrega a tu servidor no. Lo reaplicamos cada vez, porque a un número le pasó exactamente esto: reconectó limpio y dejó de entregar en silencio.
Guardamos el token del cliente y nuestro System User token contra la misma cuenta. Cuando uno es rechazado, el otro lee la cuenta y resuelve cuál de los dos se rompió, así que un token revocado deja de parecer un número perdido.
Consultada a Meta periódicamente. Una calificación RED marca la conexión como degradada, y calidad, tier de mensajería y nivel de throughput se guardan en cada comprobación, así que un declive es visible antes de costar un envío.
Conectar un número y vigilar un número son productos distintos. El segundo es la razón de que este exista.
Tiempo típico para conectar un número, escaneando un código en la app de WhatsApp Business.
Cuánto tiempo la respuesta de un cliente mantiene abierta la ventana de texto libre.
Throughput de envío de un número Coexistence, fijado por Meta y no ampliable.
Cuánto historial de chats sincroniza Meta con la API cuando un número se conecta.
Preguntas frecuentes
¿Mi equipo tiene que dejar de usar el teléfono?
No. Ese es justamente el sentido de Coexistence. La app de WhatsApp Business sigue funcionando en el mismo número, con los mismos chats, y la API corre junto a ella.
¿Voy a perder mis conversaciones actuales?
No. Se quedan en la app, y Meta sincroniza alrededor de seis meses de historial con la API cuando el número se conecta, así que el software empieza con contexto y no vacío.
¿Se puede deshacer?
Sí. Un número se puede desconectar, y la app sigue como siempre. Nada del número en sí queda alterado de forma permanente por conectarlo.
¿Es lo mismo que las APIs no oficiales de WhatsApp?
No, y la diferencia decide si el número sobrevive. Coexistence es la función oficial de Meta sobre la Cloud API. Los gateways no oficiales manejan WhatsApp Web como dispositivo vinculado, lo que incumple los términos y hace que se baneen números.
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratis3 días gratis. No se cobra nada hasta que termine la prueba.