1. Introdução
O WhatsApp Coexistence é uma solução fornecida pela Meta que permite que empresas conectem seu número ativo do WhatsApp Business App à WhatsApp Cloud API — sem perder conversas, contatos ou precisar registrar o número novamente.
Este guia cobre:
O que é o Coex
Pré-requisitos antes do onboarding
Configuração passo a passo
Problemas comuns e solução de erros
Perguntas frequentes para iniciantes
Boas práticas após o onboarding
2. Visão Geral do Produto — O que é o WhatsApp Coexistence?
O Coex permite que empresas:
Conectem o WhatsApp Business App à Cloud API
Continuem usando o Business App normalmente
Sincronizem mensagens e contatos em uma plataforma Cloud API
Evitem o novo registro do número
Evitem a perda do selo de verificação (se aplicável)
Benefícios da Coexistência do WhatsApp Business App
Use o mesmo número de telefone tanto no WhatsApp Business App quanto na API.
Sincronização em tempo real de mensagens e contatos: mensagens enviadas/recebidas no app aparecem na caixa de entrada da API e vice-versa.
Combine atendimento humano com automação: use o app móvel para conversas 1:1 e a API para envios em massa (Broadcast) e Workflows escaláveis.
Preserve o histórico de conversas e contatos sem perda de dados.
Mantenha acesso à interface familiar do WhatsApp Business App.
Este é o método mais seguro para migrar para a Cloud API sem perda de dados.
3. Pré-requisitos (Requisitos Obrigatórios Antes de Iniciar)
Para garantir uma experiência de onboarding tranquila, confirme o seguinte:
1. Você já deve ter uma conta/número do WhatsApp Business OU um novo número
O número deve estar registrado no WhatsApp Business App — números pessoais do WhatsApp não são suportados.
2. WhatsApp Business App versão 2.24.17 ou superior
Versões antigas falharão durante o processo de vinculação via QR Code.
3. Requisitos de saúde do número de telefone
O número deve ter:
Atividade regular no WhatsApp
Nenhuma restrição da Meta
Nenhuma violação de políticas
Números inativos ou restritos frequentemente falham na configuração.
4. Você deve ter uma Página do Facebook Business
→ E você deve ter acesso de administrador.
5. Seu número não deve ser da Nigéria ou África do Sul (sujeito às regulamentações da Meta)
7. Você possui uma Conta do Meta Business
8. Seu número comercial é elegível e não está atualmente vinculado a outro provedor de WhatsApp API
4. Guia de Configuração — Processo de Onboarding Passo a Passo
→ Insira seu e-mail aqui e faça login na sua conta
→ Insira o OTP que será enviado para sua caixa de entrada do Gmail
Após inserir o OTP, você será redirecionado para a página Get Started.
→ Agora, clique em “Add Number” → para prosseguir com o cadastro incorporado
→ Em seguida, uma página de login aparecerá, solicitando suas credenciais do Facebook.(Se seu login estiver salvo, você pode clicar em “Continue as”, conforme mostrado abaixo.)
→ Após continuar com sua conta do Facebook, você será redirecionado para a página de permissões. Clique em “Continue” para prosseguir.
→ Após clicar, uma janela aparecerá onde você deverá preencher os detalhes da sua empresa corretamente.
→ Agora, escolha/crie um portfólio de negócios.
NOTA: Sempre crie uma NOVA conta WABA para coexistência, garantindo uso limpo e fluxo saudável.
Escolha seu Método de Onboarding
Você verá duas opções:
Conectar seu número existente do WhatsApp Business
Começar com um novo número de contato do WhatsApp
Selecione de acordo com sua preferência e necessidade.
Restrições:
O número não deve estar vinculado a nenhum outro parceiro
O número deve ser novo ou já existir como WhatsApp Business
O número não deve estar bloqueado pela Meta
Conectar seu número existente do WhatsApp Business
→ Escolha o código do país, insira seu número e clique em “Next”
→ Em seguida, uma mensagem do WhatsApp será enviada ao seu número.
Você deve clicar em “Scan QR Code” para escanear o QR Code exibido na tela principal.
Escolher se deseja Importar o Histórico de Conversas
Após escanear o QR Code:
Todos os contatos são importados automaticamente
Você pode optar por importar (conforme sua preferência):
Até 6 meses de conversas 1:1
Até 2 semanas de mídia
Conversas em grupo não são importadas
Após verificar sua conta, o processo continuará e levará algum tempo para concluir a conexão.
Solução de Problemas
Problema 1: Falha na Integração
Motivos comuns:
Versão antiga do WhatsApp
Inatividade do número
Restrições da Meta
Falta de acesso administrativo à Página do Facebook
Solução: Use outro número com uso ativo do WhatsApp Business e sem violações anteriores.
Problema 2: Histórico de Conversas Não Importado
Se a importação falhar:
Abra o WhatsApp Business App
Vá para: Configurações → Ferramentas Comerciais → Plataforma WhatsApp Business
Toque em Desconectar
Reinicie o onboarding do Coex
Se você pulou manualmente a importação inicialmente, será necessário realizar o offboarding completo e repetir o processo. Em alguns casos, os chats não são restaurados se a opção incorreta foi escolhida durante o primeiro cadastro e as conversas antigas foram alteradas ou excluídas.
Problema 3: Número com Restrições da Meta
Sintomas:
O onboarding do Coex falha instantaneamente
O QR Code não finaliza
Nenhuma mensagem “Conectar à Plataforma Business” aparece
Solução: Use um novo número que tenha:
Zero violações de política
Atividade legítima e frequente no WhatsApp Business
Perguntas Frequentes (FAQs)
P. Posso usar um número pessoal do WhatsApp?
R. Não. Apenas números do WhatsApp Business App são permitidos.
P. Minhas conversas permanecerão no aplicativo do telefone?
R. Sim. Nada é excluído do WhatsApp Business App.
P. Posso continuar usando o WhatsApp Business App após o Coex?
R. Sim. Você continuará usando normalmente.