Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

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.

Empezar prueba gratis3 días gratis. No se cobra nada hasta que termine la prueba.
+1 415 555 0188
app de WhatsApp BusinessEl equipo atiende desde el teléfono, como antes
Cloud APITus sistemas, o un asistente de IA, en la misma línea
Ambas superficies ven el mismo hilo. Lo que envía la API aparece en la app, y lo que el equipo escribe en la app llega como un evento smb_message_echoes, así que el software nunca responde encima de una persona que ya respondió.
No guardamos mensajes por defectoBusiness App + Cloud APIMCP para Claude y ChatGPTEn vivo en 2 minutos

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.

AntesUn número, una elección
Conservar la app

El equipo atiende desde el teléfono. Nada se puede automatizar, integrar ni medir.

Sin API
Migrar a la API

El software alcanza el número. La app Business deja de funcionar en él y el equipo cambia de herramienta.

Sin app
AhoraUn número, ambos
Un número
app de WhatsApp BusinessCloud API

Meta 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.

Conserva el teléfonoUn negocio con un número

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 números, una cuentaUna agencia, consultoría o desarrollador

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.

  1. 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.

    Requiere
    Un endpoint HTTPS que devuelva hub.challenge en el GET de Meta
    Tiempo
    Alrededor de un minuto
    Obtienes
    Un destino que Meta puede verificar en cuanto el número se conecta
    Todavía no hay nada conectado. Esto decide dónde llegarán los mensajes.
    Proveedor en el caminoGuardado en sus servidores
    Meta
    Su plataformaRecibe y guarda los mensajes
    TúUna copia, cuando ellos quieran
    EasyCoexistenceSolo configuración
    Meta
    Tu endpointAún sin verificar
    NosotrosFijamos la ruta, no estamos en ella
  2. Ejecuta 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.

    Requiere
    Acceso al Portafolio Comercial, y el teléfono con el número
    Tiempo
    De dos a tres minutos
    Obtienes
    La Cloud API conectada a un número que la app sigue usando
    Aparece la segunda superficie. La primera no se elimina.
    Tras una migraciónUna superficie
    El número
    Solo Cloud APILa app Business, muerta en este número
    Con CoexistenceDos superficies
    El número
    App de WhatsApp BusinessLos mismos chats y el mismo historial
    Cloud APIEn la misma línea
  3. Apunta 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.

    Requiere
    El endpoint del paso uno, ya verificado por Meta
    Tiempo
    Se aplica en cuanto termina la incorporación
    Obtienes
    Mensajes entregados de Meta a ti, sin nosotros en la ruta de mensajes
    Qué eventos van adónde una vez activo el override.
    Eventos operativosSe entregan a nosotros
    account_updateCambios de estado de la conexión
    phone_number_quality_updateCalidad y throughput
    account_review_updateResultados de las revisiones
    Ruta de mensajesSe entregan a ti
    messagesTodo lo que envía un cliente
    smb_message_echoesLo que el equipo envía desde la app
    Tu servidorDirectamente, nunca a través de nosotros
  4. Mantenlo 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.

    Requiere
    La app abierta en el dispositivo principal de vez en cuando
    Tiempo
    Continuo
    Obtienes
    Una conexión vigilada, y una ruta que sobrevive a una reconexión
    Qué restablece una reconexión por sí sola, y qué hay que volver a poner.
    Restablecido por MetaAutomático
    EnvíoLa Cloud API vuelve a funcionar
    Eventos operativosEl monitoreo se reanuda
    Perdido con la appHay que volver a aplicarlo
    Tu override de webhookDesinstalado con la app
    Entrega de mensajes a tiSe detiene en silencio
    Lo 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.
Texto librede 0 a 24 horas después de su último mensajeSolo plantillasdespués, hasta que vuelva a escribir
El reloj se reinicia cada vez que el cliente envía algo. Es la regla que rompe integraciones en producción, porque las pruebas siempre ocurren segundos después de un mensaje, cuando el texto libre todavía funciona.

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.

Entregados directo a tu endpointLa ruta de mensajes. Por defecto, nunca pasa por nosotros.
  • messagesTodo lo que un cliente envía al número
  • smb_message_echoesLo que tu equipo envía desde la app de WhatsApp Business
Entregados a nosotrosLa ruta operativa. De esto está hecho el monitoreo.
  • account_updateEstado de la conexión: removida, offboarded, reconectada, restringida
  • phone_number_quality_updateCambios de calidad y throughput
  • account_alertsAlertas que Meta levanta contra la cuenta
  • account_review_updateResultados de una revisión de Meta
  • business_capability_updateCambios de límite de mensajes y capacidades
  • phone_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.

El número fue desconectadoWebhook, autoritativo

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 conexión quedó inactiva catorce díasEstado propio

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.

Tu ruta de webhook desapareció al reconectarReaplicado automáticamente

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.

El token de acceso dejó de funcionarDos tokens, una respuesta

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.

La calidad bajóConsultado

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.

2 minutes

Tiempo típico para conectar un número, escaneando un código en la app de WhatsApp Business.

24 hours

Cuánto tiempo la respuesta de un cliente mantiene abierta la ventana de texto libre.

20 msg/s

Throughput de envío de un número Coexistence, fijado por Meta y no ampliable.

6 months

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.

Sigue leyendo