🔄 Funcionalidade de coexistência (Integração de usuários do WhatsApp Business)

🔄 Funcionalidade de Coexistência — Integração Avançada do WhatsApp Business com o ChatBot

Guia Completo, Profissional e Detalhado para Lojista ou Fornecedor

A Funcionalidade de Coexistência do ChatBot foi projetada para permitir que empresas que já utilizam o aplicativo WhatsApp Business conectem seu número existente à API Oficial em Nuvem da Meta através do Cadastro Integrado — sem perder configurações, histórico, conversas, preferências e rotinas já estabelecidas.

Esse recurso cria uma ponte inteligente que possibilita ao Lojista ou Fornecedor utilizar, simultaneamente:

✨ O aplicativo WhatsApp Business, para conversas individuais tradicionais.
⚙️ A API em Nuvem via ChatBot, para automações, chatbots, campanhas, fluxos e mensagens estruturadas.

Tudo isso com sincronização de histórico, estabilidade operacional e conformidade total com as diretrizes Meta.

🧩 O que é Coexistência?

A Coexistência é um recurso que permite que empresas com contas já ativas no aplicativo WhatsApp Business migrem para a API em nuvem sem interrupções nem perda de dados.

Com a Coexistência habilitada, sua empresa pode:

🔗 1. Conectar um número existente do aplicativo WhatsApp Business à API Cloud

Sem necessidade de migrar ou apagar a conta atual.

💬 2. Utilizar mensagens duplas

• No aplicativo WhatsApp Business → conversas individuais

• Na API do ChatBot → automações, chatbots e modelos de mensagem

🔄 3. Manter o histórico de mensagens sincronizado

O usuário vê no aplicativo tudo o que foi enviado pela API, e vice-versa.

📲 4. Conectar usando QR Code

A conexão é extremamente simples: basta escanear o código QR exibido pelo fluxo integrado.

⭐ Por que isso é tão importante para empresas?

Muitas empresas já possuem:

✔ Conversas ativas e histórico no WhatsApp Business
✔ Número comercial verificado com reputação
✔ Catálogo, foto de perfil, horário comercial configurado
✔ Equipe treinada no app WhatsApp Business
✔ Processos internos que dependem do app

A Coexistência resolve o maior medo das empresas:

“Se eu conectar meu número à API, vou perder minha conta atual?”
➡️ A resposta é: Não. Com Coexistência, nada disso se perde.

O ChatBot atua como uma extensão avançada, sem substituir o aplicativo original.

🛠️ Como funciona o processo de Coexistência

O processo é dividido em dois fluxos:

🧑‍💼 PARA O LOJISTA OU FORNECEDOR — Uso Prático da Coexistência

Após o administrador habilitar o recurso no plano, o Lojista ou Fornecedor poderá conectar sua conta da seguinte forma:

🚀 Passo a Passo Completo do Processo de Conexão

1️⃣ Acesse o Cadastro Integrado

No painel do ChatBot:

• Faça login como Lojista ou Fornecedor

• Localize o botão: “Conectar com o Facebook”

• Clique para iniciar o fluxo Meta Embbed

2️⃣ Janela Pop-Up Meta

O Meta abrirá automaticamente um pop-up solicitando:

• Autenticação Facebook

• Permissões

• Seleção do negócio

• Configurações do WhatsApp Business

3️⃣ Digite o Número de WhatsApp Business

Informe o número que você já usa no aplicativo WhatsApp Business.

4️⃣ Escaneie o QR Code

O pop-up exibirá um QR.

No celular:

📱 Abra o WhatsApp Business
📩 Veja a mensagem automática recebida
📷 Toque em “Escanear Código QR”
📌 Escolha se deseja compartilhar ou não o histórico

5️⃣ Aguarde a sincronização

A sincronização começa automaticamente:

• Conversas antigas

• Estado da conta

• Mensagens recentes

• Estrutura do WhatsApp Business

6️⃣ Conclusão

Você será redirecionado ao ChatBot, já com o status:

🟢 Conectado com Sucesso

Agora você pode usar:

✔ automação via API
✔ WhatsApp Business App simultaneamente

🎯 Benefícios da Coexistência

🌐 Preserva toda a estrutura existente

Não é preciso apagar nada.

🧭 Uso simultâneo

App tradicional + API Cloud automatizada.

🗂️ Histórico protegido

Nenhuma conversa será perdida.

🪄 Transição suave

Sem necessidade de migração técnica.

📝 Requisitos Essenciais

Para ativar a coexistência, o Lojista ou Fornecedor deve:

• Utilizar WhatsApp Business App 2.24.17+

• Usar número com código de país suportado

• Ter API Cloud habilitada

• Utilizar Cadastro Integrado com sessão ativada

• Ter fluxo ativo no ChatBot

🌍 Países que NÃO suportam coexistência

❌ Nigéria 🇳🇬
❌ África do Sul 🇿🇦

Se o número estiver registrado nestes países, a coexistência não funcionará.

🖼️ Guia Visual — Processo Completo

📌 Passo 1

Selecionar opção “Conectar conta existente WhatsApp Business”

📌 Passo 2

Inserir número → Gerar QR Code

📌 Passo 3

Receber mensagem no WhatsApp

📌 Passo 4

Escolher sobre compartilhamento de histórico

📌 Passo 5

Escanear QR Code

📌 Passo 6

Configuração concluída →

🟢 Sincronização iniciada
🟢 Coexistência habilitada
🟢 App + API funcionando ao mesmo tempo

⚠️ Limitações Importantes

• Velocidade limitada a 20 mensagens por segundo

• Pode haver conflitos caso o número já tenha vínculo com outro provedor

• Não funciona com números da Nigéria e África do Sul

• Algumas funcionalidades ainda serão lançadas futuramente, como sincronização de contatos

💸 Preços e Cobranças Meta

• Uso do app WhatsApp Business → Gratuito

• Uso da API Cloud → Cobrada pela Meta

Consulte as tabelas oficiais de preços da API WhatsApp Business.

🧩 Janela de Atendimento – Comportamento Oficial

• A janela inicia quando o usuário envia mensagem, não quando você envia.

• Mensagens enviadas antes da conexão → só podem ser modelos.

• Após nova mensagem do cliente → janela regular se abre.

⏱️ Tempo Médio de Sincronização

A sincronização varia conforme:

• Tamanho do histórico

• Qualidade da internet

• Capacidade do seu servidor

• Volume de webhooks recebidos

Média: alguns minutos até dezenas, dependendo do volume.

🛠️ Problemas Comuns e Soluções

❌ QR Code não funciona

✔ Atualize o WhatsApp Business
✔ Verifique a internet
✔ Tente novamente em alguns minutos

❌ Não recebi a mensagem no WhatsApp

✔ Confira o código do país
✔ Verifique se é realmente WhatsApp Business
✔ Aguarde ~2 min

❌ Sincronização muito lenta

✔ Mantenha o app aberto
✔ Garanta boa conexão
✔ Espere até 24h em históricos grandes

❌ Erro de permissão

✔ Revisar webhooks ativados no Meta App
✔ Verificar credenciais do negócio

⚠️ Notas Técnicas de Implementação

• Webhooks obrigatórios:
  messages, message_echoes, smb_message_echoes, smb_app_state_sync, history

• 24 horas para finalizar importações

• Taxa de envio limitada a 20 mps

• Versão mínima 2.24.17

• Número não pode ser da Nigéria ou África do Sul

🎬 Pronto para Avançar?

Esse recurso é essencial para empresas que desejam evoluir para automações profissionais sem abrir mão da experiência tradicional do WhatsApp Business.