# Problemas en la coexistencia

> Qué hacer cuando la conexión en coexistencia no termina, no sincroniza o se cae.

Cada síntoma de abajo sigue el mismo formato: qué ves, la causa y qué hacer. El paso a paso de la conexión está en [Conectar WhatsApp](/es/connect/whatsapp/).

## Antes de conectar

- El número está activo en la app WhatsApp Business **2.24.17 o más nueva**.
- Eres admin del portafolio de negocios en Meta.
- En el panel, eres dueño o admin, con 2FA activado.

## El número no está en la app WhatsApp Business

- **Síntoma:** `422` [`coex_not_on_business_app`](/es/errors#coex_not_on_business_app).
- **Causa:** en coexistencia el número tiene que estar en la app WhatsApp Business del celular, y este no está.
- **Qué hacer:** instala y activa el número en la app WhatsApp Business, o conecta en el modo **Número nuevo, solo por la API**.

## La ventana de Meta terminó sin número

- **Síntoma:** [`signup_incomplete`](/es/errors#signup_incomplete). La ventana creó o eligió la cuenta, pero no terminó con exactamente un número.
- **Qué hacer:** conecta de nuevo y elige (o agrega) el número en la ventana de Meta hasta el final.

## La sesión expiró

- **Síntoma:** [`signup_session_expired`](/es/errors#signup_session_expired) (`410`).
- **Causa:** la sesión de conexión dura 30 minutos y se agotó, o fue cancelada.
- **Qué hacer:** empieza de nuevo desde el panel o desde el enlace de conexión.

## Faltaron permisos

- **Síntoma:** [`signup_scope_mismatch`](/es/errors#signup_scope_mismatch).
- **Causa:** la ventana de Meta terminó sin los permisos para administrar y enviar mensajes por la cuenta.
- **Qué hacer:** conecta de nuevo y deja todos los permisos marcados.

## La ventana emergente no se abre

- **Causa:** el navegador bloqueó la ventana emergente de Meta.
- **Qué hacer:** permite las ventanas emergentes de la dirección del panel e inténtalo de nuevo. No cierres la página del panel mientras la ventana esté abierta.

## Cuenta baneada o señalada

- **Síntoma:** `403` [`account_flagged`](/es/errors#account_flagged).
- **Causa:** Meta baneó o señaló la cuenta. Messajo la rechaza antes de cambiar cualquier cosa en Meta.
- **Qué hacer:** resuélvelo con Meta en el Administrador de WhatsApp. Cuando esté liberada, conecta de nuevo.

## Número ya conectado

- **Síntoma:** `409` [`connection_already_exists`](/es/errors#connection_already_exists) o [`waba_owned_by_other_org`](/es/errors#waba_owned_by_other_org).
- **Causa:** el número ya tiene una conexión activa, en tu organización o en otra. Una cuenta de WhatsApp Business (WABA) pertenece a una sola organización.
- **Qué hacer:** usa la conexión existente. Para moverla a otra organización, desconéctala allí primero.

## El número ya está con otro socio

- **Causa:** en coexistencia el número acepta un socio a la vez.
- **Qué hacer:**
  1. Haz una copia de seguridad de los chats en la app.
  2. En la app, ve a **Ajustes > Cuenta > Plataforma de negocios > Desconectar**.
  3. Conecta de nuevo con Messajo.
- El socio anterior recibe el aviso `PARTNER_REMOVED` de Meta.

## La conexión quedó Pendiente

- **Causa:** falló un paso posterior a la suscripción. El panel muestra el motivo.
- **Qué hacer:** en la página de la conexión, **Completar conexión** rehace lo que faltó, sin abrir la ventana. La pestaña **Historial** muestra cada paso, incluso dónde ocurrió una cancelación en la ventana.

## No llegaron el historial o los contactos

Abre la pestaña **Sincronización** de la conexión.

| Estado | Qué hacer |
|---|---|
| **En cola** | Espera. Aún no se pidió, o se pedirá de nuevo tras un fallo |
| **Pedida a Meta** | Espera. Meta aceptó y está enviando los datos |
| **Completada** | Los datos llegaron: contactos en `contacts.sync`, chats en `history.batch` |
| **Rechazada** | La persona rechazó compartir el historial en el celular |
| **Venció el plazo de 24 h** | Meta solo acepta el pedido hasta 24 h después de conectar |

La sincronización se pide una sola vez. Si el pedido falla, Messajo reintenta a 1 min, 5 min, 15 min, 1 h, 3 h y 6 h, siempre dentro de las 24 h. Los grupos no se sincronizan.

## La conexión se cayó sola

- **La app tiene que abrirse cada ~14 días**, una regla de Meta para todo número en coexistencia.
- **El número salió de la app WhatsApp Business:** la conexión emite `connection.updated` con `reason` `coex_unlinked`.
- **La cuenta quitó a Messajo como socio:** la conexión queda **Desconectada** con `reason` `partner_removed`.

Los motivos y qué hacer en cada estado están en [Cuando la conexión se cae](/es/connect/whatsapp/#cuando-la-conexión-se-cae) y en [Motivos de la conexión](/es/webhooks/events/#motivos-de-la-conexión).

## No puedo editar perfil, nombre o username por la API

- **Síntoma:** `422` [`coex_not_supported`](/es/errors#coex_not_supported).
- **Causa:** en coexistencia Meta no deja que la API cambie el perfil, el nombre visible ni el username.
- **Qué hacer:** cámbialo en la app WhatsApp Business del celular, o usa un número solo API.

## Límites que parecen un bug

- **Velocidad fija de 20 msg/s.** Por encima, `429` `connection_rate_limited` con `Retry-After`. Consulta [Límites](/es/api/limits/).
- **Llamadas:** [`calling_not_supported_in_coex`](/es/errors#calling_not_supported_in_coex). Usa un número solo API.
- **Grupos:** [`group_not_supported`](/es/errors#group_not_supported). Usa un número solo API.
- **Un mensaje enviado desde el celular** llega como `message.echo` y **no abre** la ventana de 24 h: solo el mensaje del contacto la abre. Consulta [Ventanas](/es/api/limits/#ventanas).
