Ir al contenido

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.

  • 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: 422 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • Síntoma: 403 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.
  • Síntoma: 409 connection_already_exists o 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.
  • 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.
  • 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.

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 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 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: 422 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.
  • Velocidad fija de 20 msg/s. Por encima, 429 connection_rate_limited con Retry-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.echo y no abre la ventana de 24 h: solo el mensaje del contacto la abre. Consulta Ventanas.