> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bevits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Coexistencia de WhatsApp

> Conecta un número que ya usa la app WhatsApp Business y agrega más números a la misma cuenta.

## ¿Cómo conectar un número de la app WhatsApp Business?

Con la coexistencia, el número sigue activo en la app WhatsApp Business y también
envía y recibe mensajes por la API oficial de Meta. Usa este flujo cuando el
número ya está en la app y no quieres perder el historial ni la atención por el
celular.

Para un número nuevo, que no está en WhatsApp, usa la tarjeta **Cloud API**.
La conexión manual, con token e IDs, está en
[WhatsApp Oficial](https://docs.bevits.com/es/send-methods/whatsapp-oficial.md).

### Requisitos

* Tienes que ser **owner** o **administrador** de la cuenta en Bevits, con
  permiso de integraciones.
* Un celular con la **app WhatsApp Business** instalada y el número activo en
  ella. Ten el aparato a mano: el emparejamiento usa un código QR leído en la
  app.
* Acceso a la cuenta de Meta que administra el **portafolio de negocio** de la
  empresa.
* Ventanas emergentes habilitadas en el navegador.

> [!TIP]
>
> Si la cuenta ya tiene dos números conectados, revisa el límite del portafolio
> en la sección **Conectar más números** antes de empezar.

## Paso a paso

**1. Abre la configuración de WhatsApp**

En Bevits, haz clic en tu correo en la esquina inferior izquierda y ve a
**Configuración** → **WhatsApp** → **API Oficial** → **Configurar**.

**2. Elige la tarjeta Coexistencia**

En **Nueva conexión**, haz clic en **Conectar en Coexistencia**.

![Pantalla de WhatsApp Oficial con la tarjeta Coexistencia resaltada](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-2-card-coexistencia.png)

**3. Inicia sesión con la cuenta de Meta**

Inicia sesión con la cuenta de Meta que administra el portafolio de negocio.
Elige el mismo portafolio de los otros números. Si Meta pide la cuenta de
WhatsApp Business (WABA), usa la misma o crea una nueva: las dos opciones
funcionan en Bevits.

**4. Informa el número**

Escribe el número que está activo en la app WhatsApp Business, con código de
país y de área.

![Ventana de Meta pidiendo el número de teléfono](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-4-numero.png)

Confirma que el perfil que aparece sea el de la empresa correcta. Meta lee
el perfil desde la app.

> [!NOTE]
>
> El orden de las pantallas puede variar. Si Meta pide el número antes del
> portafolio, ingrésalo y continúa: el flujo es el mismo.

**5. Empareja el celular**

El emparejamiento ocurre en dos pantallas: la ventana de Meta, en la
computadora, y **WhatsApp Business**, en el celular.

En la ventana de Meta, el emparejamiento empieza en el código QR:

![Ventana de Meta con el código QR y las instrucciones para el celular](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-qr.png)

En el celular, abre **WhatsApp Business** y toca el mensaje de la cuenta
oficial de Facebook Business. Toca **Conectar** y sigue las instrucciones
hasta que la app abra la cámara. Apunta al código QR.

Si la cámara falla o si la ventana está abierta en el mismo celular, haz clic
en **Usar un código de acceso**:

![Ventana de Meta con el código de verificación y el botón Copiar](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-codigo-acesso.png)

Copia el código de verificación que aparece en la ventana y pégalo en la app, en
el campo que pide el código de acceso.

Durante el emparejamiento, la app pregunta si quieres compartir el historial
de conversaciones. Permítelo: es lo que lleva los contactos y el historial de
la cuenta a la API oficial.

Si el código QR vence, cierra la ventana y repite el paso 2.

**6. Termina y revisa la conexión**

Al terminar el emparejamiento, el número aparece en **Conexiones oficiales**.

Haz clic en **Templates** para sincronizar las plantillas de la WABA.

> [!NOTE]
>
> El primer número conectado se vuelve el **predeterminado**. Para cambiarlo,
> haz clic en **Hacer predeterminado** en el número que debe enviar las
> campañas.

## Conectar más números

Bevits no limita la cantidad de números oficiales por cuenta. Repite el
proceso para cada número nuevo.

El límite es de Meta y aplica al **portafolio de negocio**:

![Portafolio no verificado acepta 2 números; verificado, hasta 20](https://bucket.bevits.com/docs/whatsapp-coexistencia/limite-portfolio.png)

* **Portafolio no verificado:** 2 números registrados, sumando todas las
  cuentas de WhatsApp Business del portafolio.
* **Portafolio verificado:** hasta 20 números.

Si el tercer número aparece como **Pendiente** o **Fallido** en WhatsApp
Manager, verifica el negocio en Meta Business Suite. La verificación libera el
límite mayor.

Cada número de coexistencia necesita un celular con la app activa. Abre WhatsApp
Business en cada aparato al menos una vez cada 13 días para mantener la
conexión.

## Lo que no funciona

* **Usar la cuenta de Meta de Bevits o de otra empresa.** El portafolio tiene
  que ser de tu empresa. Las cuentas de fuera pueden bloquear el portafolio.
* **Conectar un número que ya está en la API oficial.** La coexistencia solo
  funciona para un número que está en la app WhatsApp Business.
* **Usar un número de WhatsApp normal.** La coexistencia exige la app WhatsApp
  Business. Registra el número en la app primero; deja de funcionar en WhatsApp
  normal.
* **Mantener el check azul (OBA).** La coexistencia no admite el check de cuenta
  oficial. Usa Meta Verified for Business.

## Problemas comunes

| Síntoma | Qué hacer |
| - | - |
| El número queda **Pendiente** o **Fallido** en WhatsApp Manager | El portafolio alcanzó el límite de 2 números. Verifica el negocio en Meta Business Suite. |
| La ventana de Meta no abre | Habilita las ventanas emergentes en el navegador y haz clic de nuevo en **Conectar en Coexistencia**. |
| El código QR no se escanea | Usa el código de acceso: copia el código de la ventana y pégalo en la app. |
| El código QR vence antes de escanearlo | Cierra la ventana y repite el paso 2. El código solo vale para esa sesión. |
| Meta dice que el número ya está en la API | Ese número no puede usar coexistencia. Usa otro número. |
| No encuentro **Configuración** → **WhatsApp** → **API Oficial** | Pide a un owner o administrador con permiso de integraciones que habilite el acceso. |
| La conexión se cayó después de unos días | Abre WhatsApp Business en el celular. La app necesita uso al menos una vez cada 13 días. |

Para dudas sobre la conexión, escríbenos a **[hey@bevits.com](mailto:hey@bevits.com)** o usa el chat de
soporte en la plataforma.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.