Conecta tu app existente de WhatsApp Business (modo coexistencia)

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

Esta conexión o método también se conoce como WhatsApp Business QR Connection o WhatsApp Business App connection.

Requisitos previos

Antes de conectar, asegúrate de cumplir los siguientes requisitos:

• WhatsApp Business App: debes estar usando la aplicación WhatsApp Business, separada de WhatsApp Messenger estándar.

• Última versión instalada: asegúrate de que la app de WhatsApp Business esté actualizada a la última versión desde la tienda oficial de aplicaciones.

• Meta Business Manager: se requiere una cuenta activa de Meta Business Manager.

• Cumplimiento: el código de país del número telefónico y el tipo de negocio deben cumplir las políticas de WhatsApp Business y Commerce.

Aviso importante (para evitar errores)

Las WABAs 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 equivale a un negocio.

Las WABAs de Embedded Signup no tienen esta restricción: soportan múltiples números telefónicos por WABA. Por eso agregar números adicionales funciona bien cuando el cliente se incorpora mediante el flujo normal de Embedded Signup.

Qué significa esto para el cliente de OneChat: el error

"Cannot add phone number to WhatsApp Business Account"

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

El cliente tiene dos opciones:

1. Crear una nueva WABA mediante Embedded Signup normal: si el cliente necesita gestionar 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 soportará múltiples números telefónicos mediante la API.

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

Cómo conectar

Navega a WhatsApp Cloud en tu plataforma y presiona el botón: "Connect WhatsApp Cloud."

TODO_IMAGE[att_0_for_1322188806.png]: revisar imagen desde Confluence.

Elige tu Business Manager. Selecciona el tipo de conexión: "Connect the WhatsApp Business App."

Verás dos tipos de pantallas de onboarding:

TODO_IMAGE[att_1_for_1322188806.png]: revisar imagen desde Confluence.

TODO_IMAGE[att_2_for_1322188806.png]: revisar imagen desde Confluence.

Nota sobre números existentes ya vinculados

Si ya tienes un número conectado a 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 automáticamente en tu dashboard. No se requiere 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 Facebook Business Account.

TODO_IMAGE[att_3_for_1322188806.png]: revisar imagen desde Confluence.

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

TODO_IMAGE[att_4_for_1322188806.jpeg]: revisar imagen desde Confluence.

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

TODO_IMAGE[att_5_for_1322188806.jpeg]: revisar imagen desde Confluence.

Toca el botón Confirm en la app para permitir que el negocio tenga la opción de compartir su historial de chats contigo.

TODO_IMAGE[att_6_for_1322188806.jpeg]: revisar imagen desde Confluence.

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

TODO_IMAGE[att_7_for_1322188806.jpeg]: revisar imagen desde Confluence.

Cuando termines, la conexión quedará completa. Luego solo debes agregar tu método de pago y vincular tu número al bot. Después de eso, todo estará listo para usarse.

Nota importante

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