WhatsApp Coexistence: usá la API sin dejar de usar WhatsApp Business

Qué problema resuelve

Antes de la convivencia, pasar un número a la API significaba sacarlo de la app: el equipo dejaba de atender desde el teléfono y había que migrar todo a un sistema nuevo. Con Coexistence no hay que elegir: el mismo número, la misma cuenta y las mismas conversaciones, en la app y en tu sistema a la vez.

Sirve cuando el número ya existe, ya tiene clientes que escriben y alguien los atiende desde el celular, y querés sumar automatización, un CRM o un bot sin cortar esa atención.

Cómo se conecta

El alta se hace con Embedded Signup, la ventana oficial de Meta. La persona dueña del número inicia sesión con Facebook, elige o crea su portafolio de negocio y, al final, escanea un código QR desde la app WhatsApp Business (Ajustes → Dispositivos vinculados). Hace falta una segunda pantalla: el código se muestra en la computadora y se escanea con el teléfono.

Podés hacer el alta vos desde el panel o mandarle a tu cliente un enlace de alta con tu marca, para que la haga él sin darte sus credenciales de Meta.

Paso a paso y lo que suele frenar el alta: Al conectar · dónde se escanea el QR.

Qué ve tu sistema

• Los mensajes que entran (message.received), con el mismo webhook para todos tus números.
• Lo que tu equipo escribe desde el teléfono (message.echo): el contenido de esos mensajes llega a tu sistema, y no consume el cupo de tu plan.
• El estado de cada envío (message.status: enviado, entregado, leído, fallido).
• Los mensajes que el contacto edita o borra (message.edited, message.revoked): la versión final, con el id del original.
• El historial de tus chats, si lo elegís al conectar (history.batch y history.completed), además del resumen que Meta comparte al conectar (history.synced).

Todos los eventos y su formato: Tipos de evento · Recibir el webhook.

El historial de tus conversaciones

WAIA Connect te entrega el historial si lo elegís al conectar. Antes de abrir la ventana de Meta te preguntamos «¿Querés que te entreguemos el historial de tus conversaciones?» y tenés que contestar sí o no; vale en todos los planes.

La elección es ahora: Meta comparte el historial una sola vez, cuando conectás el número, y si elegís que no, después no se puede pedir. Si decís que sí, WAIA Connect lo descarga y lo guarda cifrado; cuando la app de WhatsApp Business te pregunte, aceptá compartir el historial.

• Qué trae: hasta 6 meses, con los mensajes de las dos partes de cada conversación, sin grupos. El historial sigue en el teléfono: no se borra ni se mueve nada de ahí.
• Fotos, audios y documentos: llegan sin el archivo (como media_placeholder). Meta manda el archivo sólo de los últimos 14 días, aparte y no siempre; si llega, trae su id y se baja con GET /v1/media/{id} dentro de los 7 días. Cada uno dice cuál es su caso en connect.media: disponible hasta tal fecha, o no disponible y por qué (más de 14 días · Meta no pudo traerlo · esperando).
• Cómo te llega: por webhook, en el evento history.batch (una tanda de hasta 500 mensajes por evento, firmada como los demás) y history.completed cuando no queda nada; o por la API, con GET /v1/connections/{id}/history (por páginas) y POST /v1/connections/{id}/history/{batchId}/ack para confirmar cada tanda. Para recibirlo hace falta un webhook o usar la API.
• Cuánto lo guardamos: cifrado, 7 días como máximo. Se borra apenas te lo entregamos (un 2xx de tu webhook o la confirmación por la API); lo que no se entregó se borra a los 7 días igual. Si al quinto día todavía no lo recibiste, te avisamos en el panel y por correo, con la fecha en que se borra.
• A qué ritmo: va en una cola aparte, para no tapar los mensajes en vivo, y puede tardar horas. No cuenta como tráfico ni consume la cuota de tu plan.
• Una tanda puede llegar dos veces: deduplicá por batchId.
• Si nos quedáramos sin espacio, dejamos de guardar historial nuevo y te avisamos en el panel y con el evento history.dropped. El resumen history.synced sigue llegando como siempre.

Limitaciones de la convivencia (según Meta)

Son de Meta, no de WAIA Connect, y valen con cualquier proveedor. La documentación oficial de Meta dice que, después de conectar un número por convivencia:

• La app tiene que ser WhatsApp Business 2.24.17 o superior.
• Se desactivan las listas de difusión y los mensajes de «ver una vez»; no se soportan grupos, mensajes temporales, ubicación en tiempo real ni llamadas por la API.
• Meta comparte hasta 6 meses de historial, una sola vez, al conectar, y sin los grupos. Si lo elegiste, WAIA Connect se lo entrega a tu sistema (detalle arriba).
• El número queda con un tope de 20 mensajes por segundo.
• Los dispositivos vinculados se desvinculan al conectar y hay que volver a vincularlos; la documentación nombra excepciones por plataforma.
• Si el teléfono principal no se usa unos 14 días, Meta desconecta el número.

Los mensajes que se mandan desde la app siguen siendo gratis; los que salen por la API tienen el precio de Meta de siempre.

Cuánto cuesta

Tarifa plana por número conectado, sin tope de mensajes, con 14 días de prueba:

• Starter — US$ 12 por mes, 1 número
• Studio — US$ 25 por mes, 5 números
• Agencia — US$ 45 por mes, 12 números
• Escala — US$ 99 por mes, 30 números, y US$ 3 por cada número extra

Meta cobra aparte los mensajes que le corresponden, a la tarjeta de tu cuenta de Meta; WAIA Connect no les agrega recargo. Detalle en la ayuda.

Preguntas frecuentes

¿Puedo seguir contestando desde el celular después de conectar el número a la API?

Sí. Con Coexistence la app WhatsApp Business sigue funcionando en el teléfono, y lo que se escribe desde ahí le llega a tu sistema como evento message.echo.

¿Pierdo mis chats al conectar?

No: siguen en el teléfono, no se borra ni se mueve nada de ahí. Si al conectar elegís recibir el historial, WAIA Connect le pide a Meta hasta 6 meses y se lo entrega a tu sistema por webhook (history.batch) o por la API, dentro de 7 días. La elección es ahora: Meta lo comparte una sola vez, al conectar, y en la app tenés que aceptar compartirlo. Si no, desde que conectás recibís los mensajes nuevos.

¿Mi cliente tiene que darme su usuario de Facebook?

No. Le mandás un enlace de alta con tu marca, él hace el alta en la ventana de Meta con su propia sesión, y el número queda conectado a tu cuenta de WAIA Connect.

¿Qué no funciona en convivencia?

Según Meta: listas de difusión, mensajes de «ver una vez», grupos, mensajes temporales, ubicación en tiempo real y llamadas por la API. El número queda con un tope de 20 mensajes por segundo.

¿Es para mí si no voy a programar nada?

Probablemente no: WAIA Connect conecta WhatsApp a un sistema tuyo. Si querés una bandeja para atender con tu equipo y un asistente de IA, sin programar, eso es WAIA.

Fuentes

Consultadas el 28/09/2026.

• Meta — Onboarding WhatsApp Business app users (Coexistence)

Para seguir leyendo

• Cloud API o Coexistence: cuál elegir
• Embedded Signup: el alta oficial de Meta
• El límite de 300 chats nuevos de la app
• Documentación de la API
• Ayuda
• Política de privacidad