Conecta tu app existente de WhatsApp Business (Modo Coexistencia)

La coexistencia te permite usar tu app de WhatsApp Business en un teléfono y conectar el mismo número a la WhatsApp Cloud API al mismo tiempo.

_xfa7s9oyble1Requisitos previos

Antes de conectar, asegúrate de que se cumplan los siguientes requisitos:

1. App de WhatsApp Business: Debes estar usando la aplicación WhatsApp Business (separada de la app estándar WhatsApp Messenger).

2. Última versión instalada: Asegúrate de que la app de WhatsApp Business esté actualizada a la versión más reciente desde la tienda oficial de aplicaciones.

3. Meta Business Manager: Se requiere una cuenta activa de Meta Business Manager.

4. Cumplimiento: El código de país del número telefónico y el tipo de tu negocio deben cumplir con las Políticas de WhatsApp Business y de Comercio.

Aviso importante (para evitar errores)

Las WABA de coexistencia están diseñadas arquitectónicamente con una relación 1:1 entre la WABA y el número telefónico. Esto se debe a que el modelo SMB (WhatsApp Business App) asume que un número telefónico = un negocio.

Las WABA de Embedded Signup no tienen esta restricción: admiten múltiples números telefónicos por WABA, por lo que agregar números adicionales funciona correctamente cuando el cliente se incorpora mediante el flujo normal de Embedded Signup.

Lo que esto significa para el cliente de OneChat: el error

"No se puede agregar el número telefónico a la cuenta de WhatsApp Business"

es un comportamiento esperado cuando la WABA fue creada mediante el flujo de coexistencia.

El cliente tiene dos opciones:

1. Crear una nueva WABA mediante el Embedded Signup normal: si el cliente necesita administrar múltiples números telefónicos a través de OneChat, debe incorporar una nueva WABA usando el flujo estándar de Embedded Signup (no coexistencia). Esta nueva WABA admitirá múltiples números telefónicos mediante la API.

2. Seguir usando coexistencia para el primer número + crear una WABA separada para números adicionales: el cliente puede mantener su WABA de coexistencia para el número original (lo que conserva el acceso dual de WhatsApp Business App + Cloud API) y crear una WABA estándar separada para cualquier número adicional.

_burgl76eks26Cómo conectar

Ve a WhatsApp Cloud en tu plataforma y presiona el botón:

"Conectar WhatsApp Cloud". Elige tu Business Manager. Selecciona el tipo de conexión: "Conectar la app de WhatsApp Business".

Verás dos tipos de pantallas de incorporación:

Nota sobre números vinculados existentes

Si ya tienes un número conectado a la Cloud API y quieres agregar otro número usando Coexistencia:

Simplemente conecta el nuevo número de WhatsApp Business App.

Después de conectarlo, ambos números aparecerán en tu panel automáticamente.

No se requiere ninguna configuración adicional. Ingresa el número telefónico de tu WhatsApp Business App. Se enviará un código de verificación dentro de la app de WhatsApp Business desde la cuenta de Facebook Business.

Después de la verificación, ahora escanea el código QR o ingresa el código. Recibirás ambos mensajes en tu WhatsApp.

Toca el botón Connect to the Business Platform para continuar con el proceso de incorporación.

Toca el botón Confirm en la app para darle al negocio la opción de compartir contigo su historial de chats.

Escanea el código QR o pega el código de verificación.

Una vez hecho esto, la conexión estará completa. Luego, solo agrega tu método de pago y vincula tu número al bot. Después de eso, todo estará listo para comenzar.

Nota importante

La app de WhatsApp Business en tu teléfono debe permanecer activa. NO elimines ni desinstales la cuenta de WhatsApp Business.