Coexistence de WhatsApp no funciona: soluciona errores de vinculación, huecos de sincronización y desconexiones

Coexistence de WhatsApp no funciona: comprueba esto primero

La mayoría de los fallos de Coexistence se reducen a seis requisitos, y comprobarlos todos lleva un par de minutos. Los cinco primeros son de Meta; el último tiene que ver con cómo la configuración de Whapi abre la ventana de Meta.

«Error while pairing Cloud API» y otros errores de vinculación

«Error while pairing Cloud API» significa que la WhatsApp Business App y la Cloud API no terminaron de vincularse. Meta no documenta esa frase por sí sola, pero su referencia de errores de registro enumera los mensajes concretos que puede mostrar este proceso, y cada uno tiene una solución conocida:

Soluciona un error de vinculación paso a paso

1. 1

   Actualiza la WhatsApp Business App

   Instala la última versión de la WhatsApp Business App desde la App Store o Google Play. Meta exige la versión 2.24.17 o posterior para Coexistence.
2. 2

   Desconecta cualquier plataforma empresarial anterior

   En la WhatsApp Business App, abre Ajustes > Cuenta > Plataforma empresarial. Si aparece una plataforma, selecciónala y toca Desconectar; después espera 15 minutos, como indica Meta.
3. 3

   Usa el teléfono donde está registrado el número

   Mantén abierta la WhatsApp Business App en el teléfono principal de este número, con una conexión a internet estable, hasta que termine la conexión.
4. 4

   Empieza de nuevo desde Whapi en un ordenador

   Abre Whapi en tu panel de Shopify desde un ordenador, permite las ventanas emergentes, haz clic en Conectar WhatsApp y elige Conectar una WhatsApp Business App.
5. 5

   Busca el mensaje exacto que muestra Meta

   Si la conexión vuelve a fallar, lee el mensaje de la ventana de Meta y búscalo en la tabla de errores de vinculación. Cada uno tiene su propia solución.
6. 6

   Envía el mensaje al soporte de Whapi

   Si ninguna solución funciona, escribe al soporte de Whapi con una captura del error. Si el número no puede usar Coexistence, Whapi también puede funcionar con un número aparte conectado solo a la API.

El código QR o el código de verificación no funcionan

El vínculo se completa dentro de la WhatsApp Business App, así que un código que «no hace nada» suele significar que falta completar el paso en la app. En el proceso de Meta, después de introducir tu número:

1. Meta muestra un código en la ventana de registro.
2. Tu WhatsApp Business App recibe un mensaje de la cuenta oficial de Facebook Business. Toca Conectar.
3. Toca Conectar con la plataforma empresarial.
4. Elige si quieres compartir el historial de tus chats y confirma.
5. Introduce o escanea el código para terminar.

Si el mensaje de Facebook no llega, comprueba que el teléfono está conectado y la app abierta, y vuelve a iniciar la conexión. También puedes abrir en la app la pantalla Ajustes > Cuenta > Plataforma empresarial y conectar desde ahí. Si Meta dice «You have guessed too many times», espera unas 12 horas antes de reintentarlo, como aconseja Meta. «You have requested your code too many times» también significa que debes esperar antes de pedir otro código.

Coexistence se desconecta una y otra vez

Meta desconecta la parte de la API de Coexistence por motivos concretos y documentados, y le indica a la plataforma conectada cuál se aplicó. Tu WhatsApp Business App sigue funcionando; solo se detienen las automatizaciones hasta que reconectas.

Tras un cambio de teléfono o una reinstalación, Meta muestra tus productos conectados anteriormente con una opción preseleccionada mientras te registras. Si la dejas marcada, Meta restablece la conexión en segundo plano, normalmente en unos minutos. Durante ese tiempo no se pueden enviar mensajes de la API, y los dispositivos vinculados, como WhatsApp Web, hay que volver a vincularlos a mano. Por eso conviene evitar reinstalar la app o cambiar de teléfono en pleno día de muchas ventas.

Dispositivos vinculados, WhatsApp Web y Windows

Coexistence funciona con hasta cuatro dispositivos vinculados. Meta admite todas las apps complementarias salvo WhatsApp para Windows y WhatsApp para WearOS.

• Al conectar, Meta desvincula todos los dispositivos vinculados. Vuelve a vincular después los que necesites.
• Los mensajes de un cliente que use una app complementaria no admitida pueden no llegar a la plataforma conectada, y tus mensajes vistos en un dispositivo no admitido muestran un texto provisional que pide al cliente abrir su teléfono principal.
• Meta también puede notificar el error 131060 la primera vez que un cliente nuevo te escribe, a menudo desde un anuncio Click to WhatsApp. Meta indica que suele resolverse en segundos; revisa ese mensaje en la WhatsApp Business App.

Cada dispositivo vinculado es otra sesión que debe mantenerse activa, así que vincula solo los que uses. Si varias personas atienden a los clientes, el Team Inbox de Whapi da acceso a cada agente sin dispositivos vinculados adicionales.

El historial de chats o los contactos no se sincronizaron

Meta permite que la plataforma conectada sincronice una sola vez tus contactos y los últimos 6 meses de chats individuales, dentro de las 24 horas posteriores a la conexión, y solo si aceptaste compartir el historial de chats en la app.

• Los chats de grupo nunca se sincronizan.
• Si elegiste no compartir el historial, no se comparte ningún chat anterior.
• Mantén la WhatsApp Business App abierta y con conexión mientras se sincroniza. Meta indica que puede tardar varios minutos, según la cantidad de historial.
• Si pasa la ventana de 24 horas o la sincronización falla, Meta exige desconectar y volver a conectar antes de poder sincronizar el historial.

Los mensajes nuevos son distintos: todo lo que envías desde la WhatsApp Business App después de conectar se replica en la plataforma conectada, y los mensajes automáticos aparecen en el historial de chats de la app.

Funciones que cambian en la WhatsApp Business App

Conectar con la API desactiva algunas funciones de la WhatsApp Business App y deja el resto como está. Así enumera Meta los cambios:

Para los mensajes masivos cuando las listas de difusión están desactivadas, envía difusiones de WhatsApp desde Whapi como plantillas de Marketing aprobadas a los clientes que han dado su consentimiento.

Mensajes de la app y mensajes de Whapi

Los mensajes que envías desde la WhatsApp Business App siguen siendo gratuitos. Los mensajes enviados a través de la Cloud API, como las confirmaciones de pedido de Whapi, se cobran a las tarifas por mensaje de Meta que aparecen en la página de precios de WhatsApp Business API. La ventana de atención al cliente de 24 horas solo se aplica a los mensajes de la API. Un número usado a la vez con la app y con la API tiene una capacidad de envío fija de 20 mensajes por segundo.

Reconectar Coexistence desde Whapi

Cuando se corta la conexión, reconecta desde Whapi y deja instalada la WhatsApp Business App, porque una reinstalación vuelve a desconectar la API. En el panel de Whapi dentro de Shopify, un número conectado muestra un estado verde. Si no es así, haz clic en Conectar WhatsApp, elige Conectar una WhatsApp Business App y sigue los pasos en la app.

Para terminar Coexistence por completo, desconecta en la WhatsApp Business App, en Ajustes > Cuenta > Plataforma empresarial. Meta no permite que una plataforma dé de baja un número que se usa a la vez con la app y con la API, así que la desconexión siempre se hace en la app.