Introdução
A Coexistência do WhatsApp permite que empresas conectem seu número ativo do WhatsApp Business App à API do WhatsApp Cloud — sem perder conversas, contatos ou exigir re-registro. Este guia aborda:- O que é Coexistência
- Pré-requisitos antes do onboarding
- Processo de configuração passo a passo
- Problemas comuns e soluções
- Perguntas frequentes para iniciantes
- Melhores práticas após o onboarding
O que é a Coexistência do WhatsApp?
A Coexistência (Coex) permite que empresas:- Conectem o WhatsApp Business App à API Cloud
- Continuem usando o Business App normalmente
- Sincronizem mensagens e contatos em uma plataforma de API Cloud
- Evitem re-registrar o número
- Preservem o selo de Verificado (se aplicável)
- Usar o mesmo número de telefone no Business App e na API
- Sincronização de mensagens e contatos em tempo real
- Combinar interação humana com automação
- Preservar histórico de conversas e contatos
- Manter acesso à interface familiar do WhatsApp Business App
Este é o método mais seguro para migrar para a API Cloud sem perder dados.
Pré-requisitos
Antes de iniciar o processo de onboarding, certifique-se de atender a estes requisitos:Conta do WhatsApp Business Obrigatória
Seu número deve estar registrado no WhatsApp Business App. Números pessoais do WhatsApp não são suportados.
WhatsApp Business App Versão 2.24.17 ou Superior
Versões anteriores falharão durante a vinculação do QR. Atualize seu app antes de continuar.
Requisitos de Saúde do Número
Seu número deve ter:
- Atividade regular no WhatsApp
- Sem restrições da Meta
- Sem violações de políticas
- Uso ativo e genuíno antes e depois da conexão de Coexistência (conversas reais 1:1 e atividade consistente por pelo menos 3–7 dias)
Página do Facebook Business com Acesso de Administrador
Você precisa de acesso de administrador a uma Página do Facebook Business para completar a configuração.
Processo de Onboarding Passo a Passo
Configuração Inicial
Inserir OTP
Digite o código OTP enviado para seu email.
Clique em Adicionar Número
Clique no botão Adicionar Número para continuar com a conexão do seu número do WhatsApp.
Login com Facebook
Faça login com sua conta do Facebook. Você pode clicar em Continuar como se seu login do Facebook já estiver salvo.
Escolha Seu Método de Onboarding
Você tem duas opções:- Conectar número existente do WhatsApp Business — Recomendado para a maioria dos usuários
- Começar com um novo número de contato do WhatsApp
Conectar Número Existente do WhatsApp Business
Inserir Número de Telefone
Selecione seu código de país e insira seu número de telefone, depois clique em Próximo.
Escanear Código QR
Uma mensagem do WhatsApp será enviada para seu número. Clique em Escanear Código QR e escaneie o código exibido com seu WhatsApp Business App.
Escolher Importação do Histórico de Conversas
Após escanear o código QR, configure suas preferências de importação:
- Contatos: Todos os contatos são importados automaticamente
- Conversas 1:1: Opcional — Importe até 6 meses de histórico de conversas
- Mídia: Opcional — Importe até 2 semanas de arquivos de mídia
- Conversas em Grupo: Não são importadas
Solução de Problemas
Problema 1: Integração Falhou
Razões comuns:- Versão antiga do WhatsApp
- Inatividade do número
- Restrições da Meta
- Sem acesso de administrador à Página do Facebook
Problema 2: O Histórico de Conversas Não Foi Importado
Se a importação falhar, siga estes passos:Navegar para Configurações
Vá para Configurações → Ferramentas de Negócio → Plataforma WhatsApp Business.
Problema 3: O Número Tem Restrições da Meta
Sintomas:- O onboarding de Coexistência falha instantaneamente
- O código QR não completa
- A mensagem “Conectar à Plataforma Business” não aparece
Perguntas Frequentes
Posso usar um número pessoal do WhatsApp?
Posso usar um número pessoal do WhatsApp?
Não. Apenas números do WhatsApp Business App são permitidos para Coexistência.
Minhas conversas permanecerão no app do meu telefone?
Minhas conversas permanecerão no app do meu telefone?
Sim. Nada é excluído do WhatsApp Business App. Suas conversas existentes permanecem intactas.
Posso continuar usando o WhatsApp Business App após Coex?
Posso continuar usando o WhatsApp Business App após Coex?
Sim. Você pode continuar usando o WhatsApp Business App normalmente enquanto também se beneficia da integração com a API Cloud.