Coexistencia
Normalmente, conectar un número a la Cloud API desactiva la aplicación de WhatsApp Business en ese dispositivo. La coexistencia es el modo en que ambos funcionan juntos: el equipo sigue atendiendo desde el móvil y la API opera en el mismo número.
Cuándo tiene sentido
Tiene sentido cuando la operación ya funciona en la aplicación y quieres automatizar parte de ella sin migrarlo todo de golpe — envíos automáticos por la API, atención humana por el móvil.
No lo tiene cuando nadie va a usar más el móvil. El modo dedicado es más simple y no tiene las limitaciones de abajo.
Cómo conectar
En el panel, al Conectar número, elige Coexistencia. El flujo es el mismo Embedded Signup de Meta, con dos peticiones extra en el móvil del responsable:
- Autorizar la integración.
- Autorizar el compartir historial de conversaciones y contactos.
El segundo paso es opcional para el cliente y definitivo para ti: si lo rechaza, no hay forma de volver a pedirlo sin rehacer todo el onboarding.
Qué cambia en el día a día
| Modo dedicado | Coexistencia | |
|---|---|---|
| Aplicación WhatsApp Business | desactivada | sigue funcionando |
| Mensajes enviados desde el móvil | — | te llegan como smb_message_echoes |
| Mensajes recibidos | webhook messages | webhook messages, en ambos lados |
| Historial anterior | no existe | sincronizable en las primeras 24h |
| Contactos del dispositivo | no existen | sincronizables en las primeras 24h |
Ecos de los mensajes del móvil
Todo lo que el equipo escribe en la aplicación te llega en el evento
smb_message_echoes, con el mismo formato que messages.
Suscríbete a él si tu sistema mantiene la conversación completa — sin él solo ves lo que escribe el cliente y lo que envía la API, y el historial queda con huecos.
{
"field": "smb_message_echoes",
"value": {
"message_echoes": [
{
"from": "5541987111527",
"to": "5541999999999",
"id": "wamid.HBgN...",
"type": "text",
"text": { "body": "¡Claro, ahora lo compruebo!" }
}
]
}
}
Cambios de contacto
Añadir, renombrar o eliminar un contacto en el móvil genera un evento
smb_app_state_sync. Eso sigue ocurriendo indefinidamente, no solo en la
sincronización inicial.
Limitaciones
La ventana de 24 horas sigue vigente. Una respuesta enviada desde el móvil abre la ventana también para la API — ambas comparten la misma conversación.
Los grupos no pasan por la API. La aplicación sigue accediendo a grupos; la Cloud API no los ve. Los mensajes de grupo no generan webhook.
Las llamadas siguen en la aplicación. Las llamadas de voz y vídeo no se exponen por la API.
La calidad del número es una sola. Un envío masivo mal recibido por la API tumba la calidad que la atención humana también usa.
Sincronizar el historial
El paso más delicado y el que menos perdona: tienes 24 horas y un solo intento. Está en Sincronizar historial.
Dar marcha atrás
Desconectar el número en el panel devuelve toda la operación a la aplicación. El historial que estaba en el móvil nunca salió de allí.
El camino inverso — pasar de coexistencia a modo dedicado — exige rehacer el onboarding y desactiva la aplicación en ese dispositivo.