Solución de problemas
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.
Antes de conectar
Sección titulada «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
Sección titulada «El número no está en la app WhatsApp Business»- Síntoma:
422coex_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
Sección titulada «La ventana de Meta terminó sin número»- Síntoma:
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ó
Sección titulada «La sesión expiró»- Síntoma:
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
Sección titulada «Faltaron permisos»- Síntoma:
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
Sección titulada «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
Sección titulada «Cuenta baneada o señalada»- Síntoma:
403account_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
Sección titulada «Número ya conectado»- Síntoma:
409connection_already_existsowaba_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
Sección titulada «El número ya está con otro socio»- Causa: en coexistencia el número acepta un socio a la vez.
- Qué hacer:
- Haz una copia de seguridad de los chats en la app.
- En la app, ve a Ajustes > Cuenta > Plataforma de negocios > Desconectar.
- Conecta de nuevo con Messajo.
- El socio anterior recibe el aviso
PARTNER_REMOVEDde Meta.
La conexión quedó Pendiente
Sección titulada «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
Sección titulada «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
Sección titulada «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.updatedconreasoncoex_unlinked. - La cuenta quitó a Messajo como socio: la conexión queda Desconectada con
reasonpartner_removed.
Los motivos y qué hacer en cada estado están en Cuando la conexión se cae y en Motivos de la conexión.
No puedo editar perfil, nombre o username por la API
Sección titulada «No puedo editar perfil, nombre o username por la API»- Síntoma:
422coex_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
Sección titulada «Límites que parecen un bug»- Velocidad fija de 20 msg/s. Por encima,
429connection_rate_limitedconRetry-After. Consulta Límites. - Llamadas:
calling_not_supported_in_coex. Usa un número solo API. - Grupos:
group_not_supported. Usa un número solo API. - Un mensaje enviado desde el celular llega como
message.echoy no abre la ventana de 24 h: solo el mensaje del contacto la abre. Consulta Ventanas.