Para conectar un número a la API Oficial de WhatsApp dentro de Clint utilizando el modo de Coexistencia (Coex), algunos requisitos técnicos y configuraciones deben estar correctamente ajustados.
⚠️ Este artículo se aplica exclusivamente a los casos en que el número será conectado en modo de coexistencia en Clint.
¿Qué puede impedir la conexión?
La falla en la conexión puede ocurrir por diferentes motivos. A continuación, los más comunes:
La coexistencia ya está activa en otra plataforma: Si el número ya está en uso simultáneo en la app de WhatsApp Business y en otra API, pueden existir limitaciones para la conexión o migración entre WABAs.
Forma de pago o línea de crédito vinculada a la WABA: Si la cuenta de WhatsApp (WABA) ya tiene una forma de pago o línea de crédito vinculada, esto puede impedir la conexión con Clint.
¿Cómo proceder?
Si te encuentras en uno de los escenarios anteriores, existen tres caminos posibles:
Opción 1 - Migrar el número a otro portafolio en Meta
Esta opción mantiene tu número actual. Quitas la WABA del portafolio actual y la vinculas a otro portafolio que no tenga forma de pago configurada.
Con esto, Clint logra realizar la vinculación a la línea de crédito y concluir la conexión.
📌 Cuándo tiene sentido:
Quieres mantener el número que ya usas
Ya tienes otro portafolio en Meta sin forma de pago vinculada
Paso a paso para migrar el número a otro portafolio en Meta:
1) Pon el número offline en la app de WhatsApp Business
Antes de quitar la WABA del portafolio, el número debe estar offline.
En la app de WhatsApp Business:
Accede a Configuración > Cuenta > Plataforma de WhatsApp Business
Selecciona la plataforma a la que el número está conectado y haz clic en Desconectar
⚠️ Atención: No desinstales la app. Solo asegúrate de que no esté en uso en ese momento.
2) Accede al Meta Business Suite y localiza tu WABA
Accede a business.facebook.com
En el menú lateral, ve a Configuración > Cuentas > Cuentas de WhatsApp Business
Haz clic en la WABA del número que deseas migrar
3) Quita la WABA del portafolio actual
Dentro de la WABA, haz clic en el ícono de tres puntos (⋯) en la esquina superior
derecha y selecciona "Quitar del portafolio empresarial".
⚠️ Atención: Esta acción quita la WABA del portafolio actual, pero no elimina la cuenta ni el número. No se perderá ninguna conversación ni plantilla.
4) Accede al portafolio de destino y vincula la WABA
Aún en el Meta Business Suite, cambia al portafolio que recibirá
la WABA (usa el selector de cuentas en la parte superior de la página)
Ve a Configuración > Cuentas > Cuentas de WhatsApp Business
Haz clic en + Agregar y selecciona "Vincular una cuenta de WhatsApp Business"
Sigue las instrucciones de Meta para completar la vinculación.
⚠️ Atención: Asegúrate de que el portafolio de destino no tenga forma de pago vinculada. De lo contrario, el bloqueo se repetirá.
5) Regresa a Clint para concluir la conexión
Con la WABA en el nuevo portafolio, realiza nuevamente la conexión en Clint.
Opción 2 - Conectar un número diferente
Esta es la opción más rápida. En vez de ajustar la configuración actual, tú
conectas un número de teléfono que no tenga forma de pago vinculada a la WABA ni Co-Ex activo.
📌 Cuándo tiene sentido:
Tienes flexibilidad para usar otro número en la operación
Quieres empezar a usar la API Oficial cuanto antes
Paso a paso para conectar un número diferente:
1) Elige el número que será conectado
El número debe cumplir uno de los criterios abajo:
Nunca fue registrado en ninguna WABA anteriormente
Está registrado en una WABA sin forma de pago directa y sin Co-Ex activo
⚠️ Atención: Si el número elegido aún no está activo en la app de WhatsApp Business, será necesario realizar la configuración inicial del número.
2) Garantiza acceso al número para la verificación
Durante el proceso, necesitarás recibir un código de verificación por
SMS o llamada. Asegúrate de tener acceso al número en el momento
de la conexión.
3) Inicia la conexión desde el panel de Clint
Accede a Configuración > Canales > WhatsApp API Oficial
Haz clic en Agregar número
Sigue el flujo de Embedded Signup, serás dirigido a la
autenticación en Meta.
4) Completa el Embedded Signup
Durante el Embedded Signup vas a:
Iniciar sesión en Facebook con la cuenta administradora del portafolio
Seleccionar o crear la WABA donde el número será registrado
Ingresar el número de teléfono
Verificar con el código recibido por SMS o llamada
5) Espera la activación
Después del Embedded Signup, Clint realiza automáticamente la vinculación a la
línea de crédito. La activación suele ser inmediata, pero puede tardar algunos minutos.
Opción 3 - Convertir a API Oficial y reconectar el número actual
Esta opción elimina el modo de coexistencia, convirtiendo el número a
API Oficial exclusiva. Con esto, la restricción de migración entre WABAs
se elimina y el proceso de conexión puede rehacerse correctamente.
📌 Cuándo tiene sentido:
Quieres mantener el número actual
Estás dispuesto a descontinuar el uso de la app de WhatsApp Business en este número
⚠️ Atención: Después de la conversión, ya no será posible usar la app de WhatsApp Business con este número. Toda la gestión de mensajes pasará a hacerse exclusivamente a través de Clint.
¿Qué cambia con la eliminación del Co-Ex?
En el modo Co-Ex, el número funciona tanto en la app de WhatsApp Business como
en la API al mismo tiempo. Al eliminar el Co-Ex, el número pasa a operar
solo vía API.
Paso a paso para convertir a API Oficial y reconectar el número actual:
1) Haz una copia de seguridad de tus conversaciones (opcional)
Si quieres preservar el historial de la app de WhatsApp Business antes de continuar:
En la app, accede a Configuración > Conversaciones > Copia de seguridad de conversaciones
Guarda en Google Drive o almacenamiento local.
2) Elimina tu cuenta en la app de WhatsApp Business
En la app, accede a Configuración > Cuenta > Eliminar mi cuenta
Confirma la eliminación
🚨 Importante: este paso elimina la cuenta de la app de WhatsApp Business para ese número.
Por lo general, esto puede desvincular el número de la app, exigir un nuevo proceso de verificación e interrumpir la recepción/envío de mensajes por la aplicación.
Después de la eliminación, el acceso al historial en la app puede quedar indisponible para este número.
⚠️ Atención: Evita conflictos.
Después de que el Co-Ex sea eliminado y el número opere solo vía API:
No mantengas la app de WhatsApp Business activa con el mismo número
No intentes verificar/reactivar ese número en la app
Si la app sigue instalada y configurada con el mismo número, pueden ocurrir conflictos de sesión/verificación que dificulten la reconexión por Clint.
3) Inicia la reconexión desde el panel de Clint
Con el Co-Ex eliminado, el proceso puede rehacerse normalmente:
Accede a Configuración > Canales > WhatsApp API Oficial
Haz clic en Agregar número y sigue el flujo de Embedded Signup.
Utiliza el mismo número de teléfono.
4) Espera la vinculación
Después del Embedded Signup, Clint realiza automáticamente la vinculación a la
línea de crédito.
Comparativo de las opciones
| Opción 1 | Opción 2 | Opción 3 |
Mantiene el número actual | ✅ Sí | ❌ No | ✅ Sí |
Mantiene la app de WhatsApp Business | ✅ Sí | ✅ Sí (en otro número) | ❌ No |
Velocidad | Media | Rápida | Media |
Requiere otro portafolio en Meta | ✅ Sí | ❌ No | ❌ No |
¿Aún tienes dudas?
Si no sabes qué opción se adapta mejor a tu caso, contacta al soporte de Clint.
Nuestro equipo evaluará la situación e indicará el camino más adecuado para tu operación.