Este guia existe para responder uma única pergunta:

👉 “Qual FAQ de WhatsApp eu devo ler antes de integrar meu número?”

Antes de iniciar qualquer integração ou migração, leia esta página.
Ela evita perda de número, bloqueios, erros de configuração e retrabalho.

🧠 Visão geral: existem 2 pontos importantes antes de conectar seu número

A integração do WhatsApp ao Cloud Chat envolve os seguintes pontos principais:

1. Identificar se o número é novo ou já existente e, a partir disso, garantir que todos os pré-requisitos da Meta estejam validados antes de iniciar a integração

2. Escolher o modelo de integração (com ou sem coexistência)

Cada cenário possui uma documentação específica.

📌 Primeiro passo: Número novo ou número existente?

🆕 Número novo

Nunca foi usado em:

• Aplicativo do WhatsApp Business

• Outro Tech Provider (exemplo: Cloud Chat)

• Outra WABA na Meta

⚠️ Integração é um processo sensível.
Se feito incorretamente, pode gerar bloqueio ou perda do número.

👉 Leia obrigatoriamente antes de migrar:
Pré-requisitos obrigatórios antes de conectar um número novo de WhatsApp

🔄 Número existente (migração)

Já foi usado em:

• Aplicativo do WhatsApp Business

• Outro Tech Provider (exemplo: Cloud Chat)

• Outra WABA na Meta

⚠️ Migração é um processo sensível.
Se feito incorretamente, pode gerar bloqueio ou perda do número.

👉 Leia obrigatoriamente antes de migrar:
Pré-requisitos obrigatórios para migração de número WhatsApp

📥 Importação de histórico de tickets (via API) em caso de migração

Após a migração concluída, é possível realizar a importação de tickets de outro help desk diretamente via API do Cloud Chat.

Isso é indicado para empresas que:

• Estão migrando de outro sistema de atendimento

• Querem trazer tickets antigos para fins de consulta, auditoria ou continuidade operacional

A importação é realizada via endpoint específico da API do Cloud Chat, enviando os dados estruturados dos tickets (contato, datas, mensagens e identificadores).

👉 Leia a documentação técnica completa com exemplos de requisição e estrutura obrigatória:
Import de histórico de tickets

📌 Segundo passo: Escolher o modelo de integração — Com ou Sem Coexistência

Antes de iniciar a conexão, você precisa decidir como o número irá operar no dia a dia da sua operação.

🔒 Integração SEM coexistência (API exclusiva)

O número funciona exclusivamente via API oficial da Meta (WABA) dentro do Cloud Chat.

Após a conexão:

• Todas as mensagens passam a ser enviadas e recebidas apenas pelo Cloud Chat (ou outros sistemas conectados à API)

• Não é mais possível usar o número no aplicativo do WhatsApp Business.

Ideal para empresas que:

• Operam 100% via help desk

• Utilizam automações e bots

• Não precisam do WhatsApp no celular

• Buscam maior estabilidade e controle operacional

💡 Se você ainda precisa usar o número no celular, esse não é o modelo ideal.

👉 Leia o passo a passo completo de como realizar a integração:
Como conectar um número do WhatsApp via API oficial (sem coexistência)

🔁 Integração COM coexistência (Celular + API simultaneamente)

O número funciona ao mesmo tempo:

• No aplicativo WhatsApp Business App (celular)

• Na API oficial (WABA) via Cloud Chat

Isso permite manter parte da operação no celular enquanto o Cloud Chat opera em paralelo.

📥 Histórico de mensagens

Ao realizar a integração com coexistência, o histórico de conversas dos últimos 6 meses é automaticamente sincronizado e importado para dentro do Cloud Chat.

Isso permite continuidade no atendimento, mantendo o contexto das conversas recentes já realizadas pelo celular.

⚠️ Importante: existe uma limitação técnica nessa sincronização, os anexos (imagens, vídeos, áudios e documentos) não são importados para o Cloud Chat.

Workaround: caso seja necessário acessar anexos antigos, eles devem ser consultados diretamente no próprio celular, dentro do aplicativo WhatsApp Business.

📌 Onde a coexistência aparece no celular?

No WhatsApp Business App, na área de Dispositivos Conectados.
O Cloud Chat aparecerá como um dispositivo adicional conectado via API.

⚠️ O que acontece se alguém desconectar?

Se alguém com acesso ao celular remover manualmente o dispositivo conectado:

• O Cloud Chat deixará imediatamente de receber mensagens

• Será necessário refazer todo o processo de integração

⚠️ Limitação importante da coexistência

Mensagens enviadas por aplicativos não suportados pela Meta não são refletidas no Cloud Chat.

Exemplos de apps não suportados:

• WhatsApp Desktop (Windows)

• WhatsApp em WearOS

Essas mensagens continuam visíveis no celular principal, mas não geram webhook, portanto não aparecem no Cloud Chat.

👉 Para entender em detalhes por que isso acontece, como diagnosticar e quais são as alternativas, acesse:
Mensagens não aparecem no Cloud Chat? Entenda a limitação da coexistência

Ideal para empresas que:

• Ainda precisam operar pelo celular

• Têm vendedores, consultores ou account managers usando o app móvel

• Querem automatizar o atendimento de forma gradual

• Desejam testar a API sem abrir mão do app

👉 Leia o passo a passo completo de como realizar a integração:
Como conectar um número do WhatsApp com coexistência (celular + API)

❌ Erros comuns que este guia evita

• Iniciar integração sem validar status da WABA

• Não desativar Two-Step Verification antes da migração

• Não entender a limitação do WhatsApp Desktop em coexistência

• Confundir número novo com número migrado

• Não validar forma de pagamento quando necessária