## Visión general

El **Coexistence** permite que un número conectado por la **WhatsApp Cloud API** siga usándose
**también en la app oficial de WhatsApp Business** en el teléfono, al mismo tiempo que la plataforma
atiende. Es la "coexistencia" entre la aplicación y la API: lo que ocurre de un lado aparece del otro.

En la práctica, el Coexistence hace tres cosas:

- **Sincroniza el historial** de conversaciones existentes de la app hacia la plataforma.
- **Sincroniza los contactos** de la app hacia la plataforma.
- Refleja los **echoes** — los mensajes que un agente envió **desde la app oficial** también aparecen
  en la conversación de la plataforma, manteniendo un historial completo y único.

> **La activación desvincula los dispositivos vinculados.** Al activar la coexistencia, Meta
> **desvincula todos los dispositivos vinculados** de WhatsApp Business — incluida una bandeja de
> **WhatsApp Web** que ya estuviera emparejada en ese número. Por eso, conecta **siempre la
> Coexistencia primero**, espera la sincronización de Meta (puede tardar hasta **~24 horas**) y **solo
> entonces** conecta/vincula WhatsApp Web. El reemparejamiento **no pierde nada**: se reutiliza la
> misma bandeja — número, conversaciones, contactos e historial se mantienen.

## Requisitos previos

- Una bandeja de **WhatsApp Cloud** ya conectada (vía Embedded Signup).
- El número debe estar en **modo de coexistencia** habilitado en Meta para ese número.
- Coexistence es un recurso de **WhatsApp Cloud** — **no** aplica al WhatsApp Web (QR).
- En algunos entornos, la sincronización debe ser habilitada por la operación.

## Paso a paso

1. Conecta (o confirma) la bandeja de **WhatsApp Cloud** por Embedded Signup.
2. Asegúrate de que el número tenga la **coexistencia** habilitada en Meta.
3. Tras la conexión, la plataforma inicia la **sincronización del historial** de conversaciones
   recientes.
4. Los **contactos** de la app oficial se importan a la base de contactos.
5. A partir de ahí, los mensajes enviados desde la **app oficial** aparecen automáticamente en las
   conversaciones (echoes), y todo lo que el equipo envía desde la plataforma también llega a la app.

## Configuración y opciones

### Foto de la bandeja de entrada

La foto del perfil comercial se sincroniza con una bandeja Cloud sin avatar después del registro, durante las comprobaciones periódicas de salud o al consultar el perfil en la pestaña Estado de la cuenta. En una bandeja híbrida unificada, la identidad visible es la bandeja Cloud. Se conserva cualquier foto ya configurada. La sincronización se realiza en segundo plano; si Meta no proporciona la imagen o falla la descarga, permanece el icono del canal.


- **Historial**: la sincronización trae las conversaciones recientes disponibles en la app; los
  mensajes muy antiguos pueden no venir, según lo que Meta ponga a disposición.
- **Contactos**: la importación crea/actualiza contactos desde la agenda de la cuenta en WhatsApp. Quien
  oculta su número detrás de un nombre de usuario llega identificado por su ID de WhatsApp vinculado a la
  empresa (BSUID), en el historial y en la agenda. El mismo contacto no se duplica cuando empieza a conversar.
  El nombre de usuario se guarda en el perfil de WhatsApp del contacto y nunca reemplaza su nombre. Un contacto
  que llegó sin nombre y quedó con el ID como nombre muestra el nombre del perfil en cuanto WhatsApp lo envía.
- **Echoes**: los mensajes enviados desde el teléfono se marcan como salientes en la conversación,
  preservando la autoría de la operación.
- **Multimedia**: los adjuntos sincronizados también quedan disponibles en la conversación.

## Casos de uso

- Seguir atendiendo casos urgentes desde el teléfono sin perder el registro en la plataforma.
- Migrar de una operación 100% en la app oficial a la plataforma sin perder el historial.
- Mantener un equipo híbrido (algunos en la app, otros en la plataforma) con historial unificado.

## Consejos, límites y buenas prácticas

- La sincronización de historial es **puntual** (ocurre en la conexión/activación) — los mensajes
  nuevos llegan en tiempo real después de eso.
- En el día a día, prefiere atender desde la plataforma para aprovechar asignación, automatizaciones e
  informes.
- Como el historial depende de lo que Meta ponga a disposición, trátalo como **mejor esfuerzo**, no
  como un respaldo completo.
- La sincronización inicial de Meta puede tardar hasta **~24 horas**; considera la bandeja lista solo
  cuando esté recibiendo y enviando con normalidad.
- **Abre la app WhatsApp Business al menos una vez cada ~14 días** en el teléfono del número. Sin eso,
  la coexistencia pierde salud y puede dejar de sincronizar.

## Solución de problemas

- **El historial no apareció**: confirma que la coexistencia está habilitada en Meta para el número y
  espera a que termine la sincronización.
- **Los mensajes de la app no aparecen (echoes)**: verifica que el número esté realmente en
  coexistencia y que la bandeja Cloud esté conectada.
- **Contactos faltantes**: la importación refleja la agenda disponible al momento de la sincronización;
  los nuevos contactos aparecen a medida que conversan.
- **El envío falló con "WhatsApp cambió su ID"**: cuando un contacto cambia de número o de nombre de
  usuario, Meta reemplaza su ID de WhatsApp vinculado a la empresa (BSUID), y el ID anterior deja de recibir
  mensajes. La plataforma vincula el ID nuevo al mismo contacto en cuanto Meta avisa el cambio. Si el ID
  nuevo ya pertenece a otro contacto, o el aviso todavía no llegó, la plataforma rechaza el envío antes de
  que salga, y no se envía nada. Espera el próximo mensaje del contacto o fusiona el contacto duplicado e
  inténtalo de nuevo.
- **La bandeja de WhatsApp Web quedó en "sesión cerrada" tras activar la coexistencia**: es el
  comportamiento esperado — la activación desvincula todos los dispositivos vinculados. Genera un nuevo
  QR en la pantalla de conexión de la bandeja de WhatsApp Web y **empareja de nuevo**; no se pierde nada.
- **La bandeja Cloud desapareció de la lista de vinculación después de reconectar por Meta**: corregido.
  La reconexión por Embedded Signup ahora guarda la misma marca de coexistencia que ya guardaba la
  creación; antes se perdía en la reautorización y la bandeja dejaba de ofrecerse para vincular.
  Cualquier bandeja en esa situación se repara sola en la **próxima reconexión** — no hay que recrear nada.
- **La lista de vinculación no muestra la bandeja que esperaba**: la lista ahora ofrece solo lo que la
  vinculación aceptará de verdad. Una bandeja Cloud común (token pegado a mano, sin la app WhatsApp
  Business en el teléfono) no es coexistencia y por eso no aparece — antes aparecía y el clic terminaba
  en un error sin explicación.
- **Orden de conexión**: conecta primero la **Coexistencia (Cloud)**, espera a que termine la
  sincronización de Meta y solo entonces conecta la bandeja de **WhatsApp Web en el mismo número**. Si lo
  haces al revés, la bandeja Web muestra un aviso de que el número ya tiene otra bandeja — es solo un
  aviso, y desaparece cuando vinculas las dos.

- **La bandeja Cloud pidió reconexión y el motivo aparece en la pestaña Estado de la cuenta**: Meta avisó que
  desconectó el número de la API. Los motivos posibles son: la app WhatsApp Business no se abrió en el
  teléfono durante unos **14 días**; la conexión con la API estuvo unos **30 días** sin actividad; el
  número se registró de nuevo en otro dispositivo; el cliente cambió de número; el número se registró
  en WhatsApp común; o la cuenta fue desactivada o eliminada. Resuelve la causa en el teléfono y vuelve a
  conectar la bandeja con Embedded Signup. Los administradores también reciben un correo con el motivo.
- **"Meta está reconectando la API"**: el número cambió de dispositivo o se registró de nuevo. Mientras
  Meta reconecta, lo que es automático y suele tardar unos minutos, los mensajes por la API no se envían
  ni se reciben. Mientras tanto, las campañas de la bandeja se pausan y **se reanudan solas**, enviando
  solo a los contactos que aún esperan; los mensajes programados esperan; y una bandeja híbrida envía por
  WhatsApp Web. Una respuesta enviada por la API mientras tanto falla al instante con ese motivo, sin llegar a
  WhatsApp; reenvíala después de la reconexión. Lo mismo vale para la encuesta de satisfacción, que queda
  como fallida, para la solicitud de permiso de llamada y para las reacciones: la reacción se rechaza y no
  aparece como enviada en la conversación. Cuando Meta termina, la bandeja vuelve sola.
- **Salud de la cuenta muestra una restricción de la cuenta**: Meta restringió la cuenta de WhatsApp, y el
  evento lista cada restricción y cuándo termina. Mientras la empresa no pueda iniciar conversaciones, las
  campañas quedan pausadas; reanúdalas después de la fecha indicada. Una infracción de políticas también
  aparece ahí.
- **Salud de la cuenta indica que Meta envía los eventos de cuenta o de plantillas a otra dirección**: la
  URL de callback de la app en el App Dashboard de Meta apunta a otro lugar, así que los cambios de la
  cuenta y los estados de las plantillas no llegan a la plataforma. Pide al equipo de operaciones que la
  apunte a la dirección `/webhooks/whatsapp` de la plataforma.
- **El historial llegó antes de que la bandeja terminara de conectarse**: la plataforma guarda el
  historial, los contactos y los echoes que Meta envía durante la conexión hasta por **24 horas** y los
  importa en cuanto la bandeja está lista.
- **Después de la reconexión, WhatsApp Web dejó de funcionar**: Meta solo reconecta la API; WhatsApp Web
  y los demás dispositivos vinculados **no vuelven solos**. En la bandeja híbrida, la plataforma avisa por
  correo y en la pestaña Estado de la cuenta: genera un nuevo código QR en la bandeja de WhatsApp Web y vincúlala de
  nuevo.

## Ver también

- [Enrutamiento de conversaciones de WhatsApp: Agente de Meta y otros socios](/hc/ajuda/articles/inboxes-channels-whatsapp-conversation-routing-es)
- [WhatsApp Cloud con Embedded Signup](/hc/ajuda/articles/inboxes-channels-whatsapp-cloud-embedded-signup-es)
- [Bandeja híbrida de WhatsApp: Coexistencia (Cloud) + WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-es)
- [WhatsApp Inbox Suite: Plantillas, Flows y Llamadas](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-es)
- [WhatsApp Hub: grupos, comunidades, canales y estados](/hc/ajuda/articles/inboxes-channels-whatsapp-hub-grupos-comunidades-canais-status-es)
- [Visión general de bandejas de entrada y canales](/hc/ajuda/articles/inboxes-channels-overview-es)