WhatsApp Coexistence: cómo usar la app y la API con el mismo número

Durante mucho tiempo, las empresas que querían profesionalizar su atención por WhatsApp tenían que elegir entre dos caminos: seguir utilizando la aplicación WhatsApp Business en el teléfono o migrar el número a una solución basada en API.

Esta decisión genera un conflicto operativo. La aplicación es sencilla, conocida y útil para la atención individual, mientras que la API ofrece integración, automatización, escalabilidad y mayor control.

WhatsApp Coexistence surgió para reducir este conflicto.

WhatsApp Coexistence permite ampliar el uso de un mismo número dentro de diferentes estructuras de atención y automatización.

Sin embargo, en este contenido hablaremos de dos formas diferentes de utilizar la coexistencia en WhatsApp:

• La primera es Meta Coexistence, donde la empresa utiliza WhatsApp Business App y, al mismo tiempo, la API de Coexistence con el mismo número.
• La segunda es Coexistence Oficial + Z-API, donde la empresa utiliza la API de Coexistence junto con Z-API.

Entender esta diferencia es fundamental para elegir la arquitectura adecuada y definir correctamente el papel de cada tecnología dentro de la operación. A continuación, veremos cómo funciona cada modelo, qué posibilidades ofrece y qué aspectos conviene considerar antes de implementarlo.

¿Qué es WhatsApp Coexistence (CoEX)?

WhatsApp Coexistence (CoEX) permite utilizar un número que ya está activo en WhatsApp Business App también dentro de una estructura basada en API, sin necesidad de abandonar la aplicación.

Con Meta Coexistence, la empresa mantiene WhatsApp Business App y utiliza al mismo tiempo la API de Coexistence con el mismo número.

Esto permite conservar una rutina que el equipo y los clientes ya conocen mientras la empresa empieza a incorporar automatizaciones, integraciones y recursos basados en API.

Uno de los principales beneficios es precisamente mantener el número que los clientes ya conocen, reduciendo el impacto de un cambio de canal o de contacto.

Aun así, la implementación depende de criterios de elegibilidad, onboarding y funcionalidades disponibles para cada configuración.

Coexistence no significa que cualquier API pueda operar automáticamente junto con WhatsApp Business App. Es importante entender qué arquitectura se está utilizando y cuáles son las reglas aplicables.

Las dos formas de coexistencia que abordamos en esta guía

En este contenido, separaremos dos escenarios:

Modelo	Qué permanece activo	Objetivo
Meta Coexistence	WhatsApp Business App + API de Coexistence	Utilizar la app y la infraestructura oficial de API con el mismo número
Coexistence Oficial + Z-API	API de Coexistence + Z-API	Combinar la infraestructura oficial con los recursos de integración y automatización de Z-API

En Meta Coexistence, el foco está en utilizar conjuntamente la aplicación y la infraestructura oficial.

En Coexistence Oficial + Z-API, la arquitectura combina la API de Coexistence con Z-API, que ofrece API REST, webhooks y recursos de integración con WhatsApp.

Son dos escenarios distintos y deben evaluarse por separado. Antes de la implementación, es importante confirmar cómo se conectará el número, qué sistemas participarán en la operación y qué funcionalidades estarán disponibles en cada configuración.

Consulta también: las nuevas reglas de precios de WhatsApp Business en 2026 y cómo proteger tu operación.

Meta Coexistence: WhatsApp Business App y API de Coexistence

En Meta Coexistence, un número que ya se utiliza en WhatsApp Business App se conecta a WhatsApp Business Platform mediante el flujo de Coexistence, manteniendo la aplicación activa.

Después de la conexión, la empresa puede seguir utilizando Business App para conversaciones individuales y, al mismo tiempo, utilizar la API de Coexistence para automatizaciones, integraciones y atención mediante sistemas conectados.

El onboarding se realiza a través del Embedded Signup de Meta y puede incluir confirmación desde la propia aplicación y vinculación del número.

El principal resultado es mantener el mismo número en dos entornos complementarios: la aplicación utilizada por el equipo y la infraestructura oficial de API.

¿Qué ocurre con el historial y los contactos?

Durante el onboarding, la empresa puede autorizar la sincronización de contactos y del historial de mensajes.

El modelo permite sincronizar hasta aproximadamente seis meses de conversaciones individuales anteriores, aunque existen limitaciones para determinados contenidos y archivos multimedia.

Los mensajes enviados posteriormente desde WhatsApp Business App también pueden reflejarse en la aplicación conectada mediante los eventos de sincronización de Coexistence.

Sin embargo, las conversaciones grupales de Business App no se sincronizan con esta capa de API.

Por eso, antes de activar la integración, conviene identificar qué información debe seguir estando disponible y confirmar qué datos serán sincronizados por el proveedor utilizado.

¿La aplicación deja de funcionar?

No. Mantener WhatsApp Business App activo es precisamente una de las principales características de Meta Coexistence.

Sin embargo, algunas funcionalidades cambian después de la conexión. Las listas de difusión dejan de funcionar con normalidad, los mensajes temporales y de visualización única se desactivan en las conversaciones individuales y el uso compartido de ubicación en tiempo real también presenta restricciones.

Otras funciones, como llamadas y determinadas herramientas comerciales, pueden seguir estando disponibles en la aplicación sin que necesariamente se sincronicen con la plataforma conectada mediante API.

Los dispositivos vinculados también pueden desconectarse durante el onboarding y necesitar una nueva vinculación posteriormente.

¿Cómo funciona Meta Coexistence en la práctica?

El proceso puede resumirse en seis etapas.

1. Verificación de elegibilidad

La empresa confirma si el número, la cuenta y WhatsApp Business App cumplen los requisitos del flujo de Coexistence.

También es necesario utilizar una solución preparada para realizar el onboarding mediante la infraestructura proporcionada por Meta.

2. Conexión de la cuenta existente

Durante el Embedded Signup, el usuario elige conectar a la infraestructura oficial el número que ya utiliza en WhatsApp Business App.

3. Confirmación desde la aplicación

El flujo solicita la confirmación de la conexión desde WhatsApp Business App, que puede incluir una vinculación mediante código QR, según la implementación utilizada.

4. Consentimiento para la sincronización

La empresa puede autorizar la sincronización de contactos e historial.

Esta etapa debe gestionarse con atención, ya que involucra información relacionada con los clientes.

5. Configuración de la integración

Después del onboarding, la plataforma completa la configuración necesaria para enviar y recibir eventos de la API.

A partir de ese momento, la aplicación puede utilizar mensajes y webhooks para conectar WhatsApp con sistemas de atención, CRM y automatizaciones.

6. Operación en coexistencia

Una vez finalizada la configuración, Business App y la API de Coexistence pasan a formar parte de la operación del mismo número.

Lo ideal es definir claramente qué tipos de conversaciones permanecerán en la aplicación y cuáles serán gestionadas por la plataforma conectada.

¿Cuáles son las ventajas de Meta Coexistence?

La primera ventaja es mantener el número que los clientes ya conocen. Esto reduce la fricción de un cambio de canal y evita tener que comunicar un nuevo número de contacto.

La segunda es permitir una transición gradual hacia una operación basada en API. La empresa puede incorporar integraciones y automatizaciones sin retirar inmediatamente la aplicación de la rutina del equipo.

Otra ventaja es combinar distintas formas de atención. Business App puede seguir utilizándose en conversaciones individuales, mientras que la API participa en flujos automatizados, integraciones y operaciones realizadas por otros sistemas.

Para pequeñas y medianas empresas, esto puede facilitar la adopción de una estructura más organizada sin exigir una transformación completa del proceso de una sola vez.

El valor de Coexistence no está tanto en duplicar canales, sino en permitir que la aplicación y la API cumplan funciones diferentes dentro de una misma operación.

Consulta también: API oficial de WhatsApp vs. Z-API: diferencias, costos y riesgos en 2026.

¿Qué es Coexistence Oficial + Z-API?

Coexistence Oficial + Z-API es una arquitectura en la que la empresa utiliza la API de Coexistence de Meta y, al mismo tiempo, incorpora Z-API a su estructura de integración y automatización.

En este modelo pueden participar diferentes componentes: el número de WhatsApp, la capa oficial de Coexistence y Z-API, con su API REST y sus webhooks.

Z-API puede conectar WhatsApp con sistemas internos, CRMs, herramientas de automatización, plataformas de atención o agentes de IA.

Lo más importante es definir claramente qué componente recibe, procesa y envía cada mensaje, evitando conflictos entre automatizaciones y conversaciones atendidas por personas.

¿Por qué combinar la API de Coexistence con Z-API?

Esta combinación puede tener sentido cuando la empresa busca mayor flexibilidad para integrar WhatsApp con sus propios sistemas y flujos de automatización.

Integración con sistemas propios

Empresas de software, SaaS y compañías con plataformas propias pueden integrar Z-API directamente con sus productos.

Los eventos recibidos desde WhatsApp pueden enviarse por webhook a la aplicación, que decide cómo procesar la conversación y qué acción ejecutar.

Automatización de procesos

Una empresa puede conectar distintos eventos de negocio con sus flujos de comunicación.

Una confirmación de pago, una actualización de pedido o un nuevo lead, por ejemplo, pueden generarse en el ERP, e-commerce o CRM y activar un mensaje mediante Z-API.

El evento pertenece al sistema de origen; Z-API participa como capa de comunicación a través de WhatsApp.

Atención conectada con el CRM

La integración también puede utilizar mensajes y webhooks para sincronizar información con el CRM.

La aplicación puede registrar interacciones, actualizar la etapa de una oportunidad, iniciar follow-ups o derivar una conversación al equipo comercial.

Agentes de IA y automatización conversacional

Z-API también puede funcionar como capa de entrada y salida en una arquitectura con inteligencia artificial.

En este escenario, Z-API transporta los mensajes, mientras que el modelo de IA, las bases de conocimiento, las reglas de negocio y los sistemas integrados determinan cómo se procesará la conversación.

¿Cómo circulan los mensajes dentro de esta arquitectura?

Cuando un cliente envía un mensaje, el evento puede pasar por diferentes capas configuradas por la empresa.

El backend recibe los eventos disponibles, identifica al contacto, consulta los sistemas necesarios y decide si la conversación debe responderse automáticamente o derivarse a una persona.

Z-API ofrece webhooks para mensajes recibidos, cambios de estado y desconexiones. También es posible configurar la recepción de eventos relacionados con mensajes enviados por el propio número.

En una arquitectura con varios componentes, es fundamental controlar el origen y el estado de cada mensaje para evitar respuestas duplicadas.

Evento	Tratamiento recomendado
El cliente envía un mensaje	Registrar el evento e identificar el flujo responsable
Mensaje enviado manualmente	Registrar el origen y pausar automatizaciones que puedan entrar en conflicto
Mensaje enviado por automatización	Registrar el flujo responsable y actualizar los sistemas necesarios
Solicitud de atención humana	Pausar la automatización de esa conversación y realizar el handoff
Fallo o cambio de estado	Registrar el estado y aplicar la regla de tratamiento definida
Desconexión	Alertar a la operación y evaluar qué flujos deben interrumpirse

Z-API también cuenta con un webhook específico de desconexión, que permite que la aplicación reaccione cuando una instancia queda fuera de servicio.

Profundiza en el tema: Descubre cómo utilizar webhooks de WhatsApp para crear automatizaciones en tiempo real con Z-API.

¿Cuándo puede tener sentido esta combinación?

Coexistence Oficial + Z-API puede evaluarse cuando una empresa ya utiliza la infraestructura oficial, pero quiere conectar WhatsApp con sistemas y automatizaciones adicionales.

Esto puede ser relevante para empresas de software, plataformas SaaS, agencias de automatización y compañías con procesos propios de atención o ventas.

En estos escenarios, es importante definir claramente las responsabilidades sobre credenciales, datos, mensajes, automatizaciones y soporte.

Las empresas con atención híbrida también pueden utilizar diferentes capas para organizar interacciones humanas y automáticas.

El valor de esta arquitectura está en la flexibilidad, pero requiere una orquestación clara para que cada tecnología tenga un papel bien definido dentro de la operación.

¿Cuándo puede no ser la mejor opción utilizar Coexistence?

Si la empresa solo necesita automatizaciones sencillas y no necesita mantener WhatsApp Business App, añadir diferentes capas puede generar una complejidad innecesaria.

Coexistence también requiere una gobernanza clara sobre quién responde, qué sistema controla cada flujo y cuándo deben pausarse las automatizaciones.

Sin estas reglas, una operación híbrida puede generar respuestas duplicadas, pérdida de contexto y conflictos entre la atención humana y la automatización.

Otro punto es el costo operativo. La empresa debe considerar no solo el precio de las APIs, sino también implementación, integración, monitoreo, mantenimiento, soporte y capacitación del equipo.

Limitaciones y puntos de atención

Estos son los principales aspectos que debes considerar al utilizar Coexistence:

Throughput y volumen

Actualmente, los números que operan en Coexistence tienen un límite de 20 mensajes por segundo en la Cloud API.

Las operaciones de alto volumen deben considerar este límite, así como la capacidad de los demás componentes de la arquitectura, como backend, CRM, colas y automatizaciones.

Ventana de atención

Las reglas de Cloud API siguen aplicándose en modo Coexistence.

La ventana de atención de 24 horas se abre cuando el cliente envía un mensaje después del onboarding. Fuera de esta ventana, los envíos mediante Cloud API deben seguir las reglas aplicables a las plantillas.

Los mensajes enviados desde WhatsApp Business App no crean, amplían ni modifican la ventana de atención de Cloud API.

Esta diferencia debe tenerse en cuenta al diseñar las automatizaciones.

Funcionalidades no compartidas

No todo lo que funciona en Business App se sincroniza con la API.

Los grupos y las llamadas pueden seguir disponibles en la aplicación, pero no se reflejan en la capa de Coexistence. Por otro lado, las listas de difusión, los mensajes temporales, el contenido de visualización única y la ubicación en tiempo real tienen restricciones en modo Coexistence.

Antes de implementar, haz una lista de las funcionalidades esenciales para tu operación y confirma cómo se comporta cada una.

Sincronización e historial

Cuando está autorizada, la sincronización inicial puede incluir hasta 180 días de historial, con limitaciones adicionales para determinados contenidos y archivos multimedia.

También existe una ventana operativa después del onboarding para realizar la sincronización inicial. Por eso, esta etapa debe planificarse y supervisarse durante la implementación.

Reglas de uso y calidad

Coexistence no modifica las responsabilidades de la empresa con respecto a la calidad de las comunicaciones, la privacidad y las políticas de WhatsApp.

Incorporar más tecnología no convierte automáticamente una mala estrategia de comunicación en una operación segura o eficiente.

¿Cómo planificar una implementación segura?

Sigue estos pasos para implementar Coexistence de forma más segura:

1. Define el objetivo operativo

Comienza por la necesidad que justifica utilizar Coexistence.

¿El objetivo es mantener a los vendedores utilizando la aplicación? ¿Integrar un CRM? ¿Automatizar notificaciones? ¿Crear un agente de IA?

Cuanto más claro sea el objetivo, más sencillo será definir la función de cada componente.

2. Mapea los entornos

Define qué se gestionará mediante Business App, qué pasará por la API de Coexistence y qué función tendrá Z-API.

Evita permitir que varios sistemas respondan al mismo evento sin reglas claras de prioridad.

3. Define la fuente de verdad

Establece qué sistema concentra cada tipo de información.

El CRM puede ser la fuente principal de los contactos, mientras que el ERP o la plataforma de e-commerce gestionan pedidos, stock y pagos.

Una fuente de verdad claramente definida reduce las inconsistencias entre sistemas.

4. Crea reglas de handoff

Define cuándo una automatización debe transferir la conversación a una persona.

Los casos sensibles, las excepciones o las solicitudes explícitas de atención humana deben seguir un flujo de handoff que preserve el contexto ya recopilado.

5. Trabaja con idempotencia y colas

Diseña el backend para evitar el procesamiento duplicado y gestionar eventos que puedan llegar fuera del orden esperado.

Las colas también ayudan a absorber picos de demanda y a separar la recepción del evento de la ejecución de procesos más largos.

En Z-API, la cola nativa organiza específicamente los mensajes enviados mediante su API y también ofrece un comportamiento configurable durante las desconexiones.

6. Monitorea la salud de la operación

Supervisa el estado de la conexión, errores de envío, estados de los mensajes, procesamiento de webhooks y fallos de los sistemas integrados.

Z-API, por ejemplo, ofrece un webhook específico para notificar desconexiones de la instancia. Cuanto antes se detecte un fallo, menor suele ser el impacto sobre la atención al cliente.

7. Prueba antes de escalar

Prueba mensajes recibidos, respuestas manuales, respuestas automáticas, archivos multimedia, nuevos contactos, handoffs, desconexiones y escenarios de recuperación.

También simula situaciones en las que una persona y una automatización intentan actuar sobre la misma conversación al mismo tiempo.

Checklist para evaluar la API de Coexistence y Z-API

Pregunta	Por qué importa
¿El número es elegible para Coexistence?	Evita iniciar una implementación incompatible
¿Quién gestiona el onboarding oficial?	Define requisitos y responsabilidades
¿Qué quedará bajo responsabilidad de la app?	Evita conflictos operativos
¿Qué será procesado por la API de Coexistence?	Define reglas y límites
¿Cuál será el papel de Z-API?	Organiza la arquitectura de integración
¿Cómo se deduplicarán los eventos?	Evita procesamiento y respuestas duplicadas
¿Cómo se activará la atención humana?	Define el handoff
¿Qué funcionalidades tienen limitaciones?	Evita expectativas incorrectas
¿Cómo se monitorearán errores y desconexiones?	Facilita la respuesta ante incidentes
¿Cómo se protegerán los datos y las credenciales?	Reduce riesgos de seguridad y privacidad
¿Cuál es el costo total de la operación?	Incluye integración, mantenimiento y soporte

¿Coexistence sirve para transición, operación híbrida o escala?

Puede cumplir diferentes objetivos, pero la empresa debe definir cuál de ellos es prioritario.

Como estrategia de transición, Coexistence permite adoptar una infraestructura basada en API sin retirar inmediatamente Business App de la operación diaria.

Como modelo híbrido, permite que la aplicación y los sistemas conectados participen en la atención con funciones diferentes.

Y cuando la empresa necesita integraciones adicionales, Z-API puede conectar WhatsApp con CRMs, sistemas propios, automatizaciones y otras aplicaciones.

Business App también puede ofrecer una alternativa de interacción manual en determinados escenarios, pero no debe considerarse un sustituto de un plan completo de continuidad y contingencia.

Independientemente de la arquitectura, la tecnología no sustituye el diseño operativo.

La empresa debe definir quién responde, cómo se registran las conversaciones, cuándo se pausa una automatización y cómo se gestionan los incidentes.

Coexistence exige flexibilidad y gobernanza

WhatsApp Coexistence ofrece una alternativa para empresas que quieren mantener la practicidad de WhatsApp Business App mientras incorporan recursos basados en API.

En Meta Coexistence, el mismo número participa tanto en Business App como en la infraestructura oficial de Coexistence, respetando los límites y reglas definidos para este modelo.

En Coexistence Oficial + Z-API, la empresa incorpora Z-API a la arquitectura para conectar WhatsApp con sistemas propios, CRMs, automatizaciones y aplicaciones de IA.

En ambos casos, una buena implementación depende de planificación, responsabilidades claramente definidas, control de eventos, monitoreo y protección de datos.

Z-API puede participar en esta arquitectura como una capa de integración entre WhatsApp y los sistemas que forman parte de la operación.

Si tu empresa ya utiliza WhatsApp Business App y quiere avanzar en integraciones y automatizaciones, evalúa cómo Z-API puede formar parte de la arquitectura de comunicación de tu negocio.