> ## 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.

# Coexistência do WhatsApp

> Conecte um número que já usa o WhatsApp Business App e adicione mais números à mesma conta.

## Como conectar um número do WhatsApp Business App?

Na coexistência, o número continua ativo no WhatsApp Business App e também
passa a enviar e receber pela API oficial da Meta. Use esse fluxo quando o
número já está no app e você não quer perder o histórico nem o atendimento
pelo celular.

Para um número novo, que não está no WhatsApp, use o card **Cloud API**. A
conexão manual, com token e IDs, está em
[WhatsApp Oficial](https://docs.bevits.com/pt-BR/send-methods/whatsapp-oficial.md).

### Pré-requisitos

* Você precisa ser **owner** ou **administrador** da conta na Bevits, com
  permissão de integrações.
* Um celular com o **WhatsApp Business App** instalado e o número ativo.
  Tenha o aparelho em mãos: o pareamento é feito com um QR code lido no app.
* Acesso à conta Meta que administra o **portfólio de negócio** da empresa.
* Pop-ups liberados no navegador.

> [!TIP]
>
> Se a conta já tem dois números conectados, confira o limite do portfólio na
> seção **Conectar mais números** antes de começar.

## Passo a passo

**1. Abra as configurações de WhatsApp**

Na Bevits, clique no seu e-mail no canto inferior esquerdo e vá em
**Configurações** → **WhatsApp** → **API Oficial** → **Configurar**.

**2. Escolha o card Coexistência**

Em **Nova conexão**, clique em **Conectar em Coexistência**.

![Tela do WhatsApp Oficial com o card Coexistência destacado](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-2-card-coexistencia.png)

**3. Entre com a conta Meta**

Faça login na conta Meta que administra o portfólio de negócio. Escolha o
mesmo portfólio dos outros números. Se a Meta pedir a conta do WhatsApp
Business (WABA), use a mesma ou crie uma nova: as duas opções funcionam na
Bevits.

**4. Informe o número**

Digite o número que está ativo no WhatsApp Business App, com DDI e DDD.

![Janela da Meta pedindo o número de telefone](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-4-numero.png)

Confirme se o perfil que aparece é o da empresa certa. A Meta lê o perfil
direto do app.

> [!NOTE]
>
> A ordem das telas pode variar. Se o número for pedido antes do portfólio,
> informe e continue: o fluxo é o mesmo.

**5. Pareie o celular**

O pareamento acontece em duas telas: a janela da Meta, no computador, e o
**WhatsApp Business**, no celular.

Na janela da Meta, o pareamento começa no QR code:

![Janela da Meta com o QR code e as instruções para o celular](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-qr.png)

No celular, abra o **WhatsApp Business** e toque na mensagem da conta oficial
do Facebook Business. Toque em **Conectar** e siga as instruções até o app
abrir a câmera. Aponte para o QR code.

Se a câmera falhar ou se a janela estiver aberta no próprio celular, clique
em **Usar um código de acesso**:

![Janela da Meta com o código de verificação e o botão Copiar](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-codigo-acesso.png)

Copie o código de verificação que aparece na janela e cole no app, no campo
que pede o código de acesso.

Durante o pareamento, o app pergunta se você quer compartilhar o histórico de
conversas. Permita o compartilhamento: é o que leva os contatos e o histórico
da conta para a API oficial.

Se o QR code expirar, feche a janela e repita o passo 2.

**6. Conclua e confira a conexão**

Ao final do pareamento, o número aparece em **Conexões oficiais**.

Clique em **Templates** para sincronizar os templates da WABA.

> [!NOTE]
>
> O primeiro número conectado vira o **padrão**. Para trocar, clique em
> **Tornar padrão** no número que deve enviar as campanhas.

## Conectar mais números

A Bevits não limita a quantidade de números oficiais por conta. Repita o
processo para cada número novo.

O limite é da Meta e vale para o **portfólio de negócio**:

![Portfólio não verificado aceita 2 números; verificado, até 20](https://bucket.bevits.com/docs/whatsapp-coexistencia/limite-portfolio.png)

* **Portfólio não verificado:** 2 números registrados, somando todas as contas
  do WhatsApp Business do portfólio.
* **Portfólio verificado:** até 20 números.

Se o terceiro número aparecer como **Pendente** ou **Falhou** no WhatsApp
Manager, verifique o negócio na Meta Business Suite. A verificação libera o
limite maior.

Cada número de coexistência precisa de um celular com o app ativo. Abra o
WhatsApp Business em cada aparelho pelo menos uma vez a cada 13 dias para manter
a conexão.

## O que não funciona

* **Usar a conta Meta da Bevits ou de outra empresa.** O portfólio precisa ser
  da sua empresa. Contas de fora podem bloquear o portfólio.
* **Conectar um número que já está na API oficial.** A coexistência só funciona
  para número que está no WhatsApp Business App.
* **Usar um número do WhatsApp comum.** A coexistência exige o WhatsApp Business
  App. Registre o número no app antes; ele deixa de funcionar no WhatsApp comum.
* **Manter o selo azul (OBA).** A coexistência não suporta o selo de conta
  oficial. Use Meta Verified for Business.

## Problemas comuns

| Sintoma | O que fazer |
| - | - |
| O número fica **Pendente** ou **Falhou** no WhatsApp Manager | O portfólio atingiu o limite de 2 números. Verifique o negócio na Meta Business Suite. |
| A janela da Meta não abre | Libere pop-ups no navegador e clique de novo em **Conectar em Coexistência**. |
| O QR code não escaneia | Use o código de acesso: copie o código da janela e cole no app. |
| O QR code expira antes de escanear | Feche a janela e repita o passo 2. O código vale só para a sessão. |
| A Meta diz que o número já está na API | Esse número não pode usar coexistência. Use outro número. |
| Não encontro **Configurações** → **WhatsApp** → **API Oficial** | Peça a um owner ou administrador com permissão de integrações para liberar o acesso. |
| A conexão caiu depois de alguns dias | Abra o WhatsApp Business no celular. O app precisa de uso pelo menos a cada 13 dias. |

Para dúvidas sobre a conexão, fale com a gente em **[hey@bevits.com](mailto:hey@bevits.com)** ou use o
chat de suporte na plataforma.


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