WhatsApp Cloud API — modo coexistência

🔄 Conexão tradicional vs. Coexistência

Ao conectar um número via WhatsApp Cloud API, você pode escolher entre dois modos:

• Conexão tradicional (Cloud API oficial): o número passa a operar exclusivamente pela API. Indicado para números novos ou dedicados ao atendimento.

• Coexistência: conecta um número que já está no WhatsApp Business, permitindo continuar usando o app e a API ao mesmo tempo, sem perder o histórico de conversas.

Comparativo

🟢 Tradicional (Cloud API)

🔵 Coexistência

Número

Novo ou dedicado exclusivamente à API

Número existente do app WhatsApp Business

Uso no app WhatsApp Business

O número deixa de funcionar no app

Continua funcionando no app e na API

PIN de verificação (6 dígitos)

Necessário

❌ Não necessário

Registro do número na Meta

Feito durante a conexão

Já registrado (etapa pulada)

Histórico de conversas

Não é importado

Importa até ~1 mês de conversas e contatos

Como conectar

Digitar o número e verificar

Escanear um QR Code pelo app

💡 Quando usar cada um? Use Coexistência quando a marca já atende pelo app do WhatsApp Business e quer manter o atendimento no celular enquanto começa a usar a plataforma. Use a conexão tradicional para números novos ou quando o atendimento será feito 100% pela Skeelo CRM.

⚠️ Requisitos da Coexistência

• App WhatsApp Business atualizado (versão 2.24.17 ou superior).

• O número não pode já estar registrado em outra conta de WhatsApp Cloud API.

• Recurso indisponível em algumas regiões (ex.: União Europeia, Reino Unido, entre outras). Consulte a disponibilidade da Meta para o país do número.

---

📲 Como conectar via Coexistência

Siga o passo a passo abaixo para conectar um número que já está no app do WhatsApp Business.

Pré-requisitos

• Acesso ao app WhatsApp Business no celular que usa o número.

• Permissão para conectar novos números no projeto.

• Número compatível com a Coexistência (ver requisitos acima).

Passo a passo

1. Acesse o componente de WhatsApp do projeto e inicie uma nova conexão Business API.

2. Na tela de conexão, em Tipo de conexão, selecione a opção "Coexistência (conectar app do WhatsApp Business existente)".

3. Clique em "Conectar via Meta" e clique em " Continuar".

4. Selecione um Porftólio empresarial e selecione " Conectar um app do Whatsapp Business".

5. Siga o passo-a-passo da Meta até a exibição do QR Code.

6. No celular, abra o WhatsApp Business e escaneie o QR Code

• Acesse Configurações → Conta → Plataforma de Whatsapp Business.

• Siga o passo-a-passo e aponte a câmera para o QR Code exibido na tela. Você pode optar ou não por compartilhar o seu histórico de conversas

Após o escaneamento do QR Code, o número será conectado e aparecerá como uma sessão ativa na plataforma. ✅

O que acontece depois

• 📥 Importação do histórico: as conversas e contatos recentes (até ~1 mês) são importados automaticamente e passam a aparecer na caixa de entrada. A importação pode levar alguns minutos.

• 🔄 Uso simultâneo: o número continua funcionando normalmente no app do WhatsApp Business. As mensagens enviadas pelo app também aparecem na plataforma, e vice-versa

⚠️ Importante

• A sincronização do histórico tem um limite de chamadas por número na Meta. Evite refazer a conexão várias vezes seguidas.

• Se precisar reconectar, desconecte primeiro a integração no app do WhatsApp Business ( Configurações → Dispositivos conectados) antes de repetir o processo.