Como migrar para a API Oficial do WhatsApp sem perder o número

Se você quer saber como migrar para a API Oficial do WhatsApp sem trocar de número, sem apagar conversas e sem tirar o aplicativo do celular da equipe, a resposta em 2026 tem nome: Coexistência. É o modo de conexão da Meta em que o mesmo número funciona, ao mesmo tempo, no app WhatsApp Business e na API Oficial — e a migração inteira se resume a escanear um QR Code.

Neste tutorial mostramos o processo completo, do jeito que fazemos com os escritórios que entram no Sábio Adv: o que preparar antes, o passo a passo da conexão, o que acontece com o histórico e os contatos, e as limitações que você precisa conhecer antes de ativar. No vídeo abaixo, a migração é feita ao vivo dentro da plataforma.

O que é a Coexistência do WhatsApp

Até pouco tempo atrás, migrar um número para a WhatsApp Cloud API significava abrir mão do aplicativo: o número era registrado na API e parava de funcionar no celular. Para muitos escritórios, esse era o maior bloqueio — o advogado não queria “perder” o WhatsApp que já usava todos os dias.

A Coexistência resolve exatamente isso. Ao conectar o número via QR Code, o app permanece ativo, e a API Oficial passa a operar em cima do mesmo número. As mensagens novas aparecem nos dois lugares: no celular e na plataforma de atendimento. Você responde de onde preferir, sem perder o contexto da conversa.

Para o escritório de advocacia, isso significa colocar IA de atendimento, equipe com múltiplos atendentes e CRM em produção sem mudar o número que já está no cartão de visita, no site e no Google.

Por que migrar para a API Oficial do WhatsApp

Antes do “como”, vale fixar o “porquê”. A API Oficial (WhatsApp Business Platform) é o canal que a própria Meta disponibiliza para empresas conectarem sistemas ao WhatsApp — diferente das integrações não oficiais, que simulam um WhatsApp Web e vivem sob risco de banimento do número.

No vídeo, mostramos a migração no cenário mais comum: um escritório que usa o aplicativo WhatsApp Business no dia a dia e quer ativar a IA do Sábio Adv nesse mesmo número. É para esse cenário que a Coexistência foi desenhada.

Se a sua dúvida ainda é qual tipo de conexão escolher — Cloud direta ou Coexistência —, temos uma página comparando as duas em detalhe: API Oficial do WhatsApp: Cloud vs Coexistência. Este artigo aqui foca no tutorial de migração.

Requisitos antes de começar a migração

A conexão em si leva minutos, mas ela só flui bem se a preparação estiver em dia. Confira cada item antes de iniciar:

• Aplicativo WhatsApp Business atualizado: a Coexistência exige o app WhatsApp Business (não o WhatsApp comum) na versão 2.24.17 ou superior. Atualize pela loja de aplicativos antes de começar.
• Número ativo no app: o número precisa estar em uso no WhatsApp Business há pelo menos 7 dias. Números recém-criados ou recém-migrados de aparelho podem ser recusados no cadastro.
• Gerenciador de Negócios da Meta: você precisa de um Business Manager (o painel em business.facebook.com) com acesso de administrador. É nele que a Meta registra a conta do WhatsApp Business (WABA) da sua empresa.
• Plataforma com suporte a Coexistência: a conexão é feita pelo Cadastro Incorporado (Embedded Signup) dentro da plataforma que vai operar a API — no nosso caso, o Sábio Adv.
• Dados da empresa em mãos: razão social, CNPJ e site ajudam a preencher o cadastro da Meta sem travar. A verificação da empresa não é obrigatória para começar, mas amplia limites depois.

Como migrar para a API Oficial do WhatsApp: passo a passo

Com os requisitos em dia, a migração via Coexistência segue o fluxo abaixo — o mesmo que executamos no vídeo, de ponta a ponta:

1. 1

   Inicie a conexão na plataforma

   Dentro do Sábio Adv, abra a área de conexão do WhatsApp e escolha a opção de API Oficial com Coexistência. A plataforma abre o Cadastro Incorporado da Meta em uma janela segura, logada na sua conta do Facebook.

2. 2

   Vincule o Gerenciador de Negócios

   Selecione (ou crie) o Business Manager da sua empresa e a conta do WhatsApp Business. É aqui que a Meta associa o número à WABA do escritório. Confirme razão social e dados básicos quando solicitado.

3. 3

   Escaneie o QR Code com o WhatsApp Business

   A Meta exibe um QR Code. No celular, abra o WhatsApp Business em Configurações → Dispositivos conectados e escaneie. Esse é o momento em que o número passa a coexistir: continua no app e entra na API.

4. 4

   Autorize a sincronização de contatos e conversas

   O app pergunta se você deseja compartilhar histórico e contatos com a plataforma. Autorize para que as conversas recentes (em geral, dos últimos 6 meses) apareçam no painel — assim a equipe não começa do zero.

5. 5

   Teste o envio e o recebimento

   Envie uma mensagem de teste para o número e responda pela plataforma; depois responda outra pelo celular. Confirme que as duas pontas exibem a mesma conversa. Se algo não sincronizar, desconecte e refaça o passo 3.

6. 6

   Configure IA, equipe e templates

   Com o número conectado, ative o agente de IA, cadastre os atendentes e departamentos e crie os templates de mensagem para contato ativo. A migração termina quando o fluxo de atendimento inteiro roda no número oficial.

No vídeo mostramos cada uma dessas telas em tempo real — vale assistir antes de executar, principalmente o momento do QR Code, que é onde surgem mais dúvidas.

O que acontece com histórico, contatos e o app

Essa é a pergunta que todo escritório faz antes de migrar, então vamos por partes:

O histórico de conversas

Nada é apagado. Todo o histórico continua no celular, exatamente como estava. Na ativação, se você autorizar a sincronização, a plataforma importa as conversas recentes — a Meta trabalha com uma janela de aproximadamente 6 meses. Conversas mais antigas que isso permanecem apenas no aplicativo.

Os contatos

Os contatos salvos no app podem ser sincronizados para a plataforma na mesma autorização. A partir daí, cada conversa nova já chega identificada no painel e pode ser vinculada ao CRM do escritório.

O aplicativo no celular

Continua funcionando normalmente. A equipe pode responder pelo app quando estiver fora do escritório, e a mensagem aparece sincronizada na plataforma. O que muda é que agora existe uma camada profissional por cima do mesmo número: IA respondendo 24/7, filas de atendimento e métricas.

Limitações da Coexistência que você precisa conhecer

A Coexistência é o caminho mais suave para migrar para a API Oficial do WhatsApp, mas não é mágica. Estas são as limitações práticas documentadas pela Meta e observadas no dia a dia:

• Janela de sincronização do histórico: a importação de conversas antigas se limita, em geral, aos últimos 6 meses. O restante fica só no app.
• Throughput menor que a Cloud pura: o modo Coexistência trabalha com um teto na casa de 20 mensagens por segundo. Para atendimento e campanhas de escritório é mais do que suficiente; para disparos massivos, a conexão Cloud direta escala mais.
• Dispositivos vinculados: a conexão da API ocupa um dos slots de dispositivos conectados do app, e o uso do WhatsApp em computador (app desktop) pode não refletir tudo na plataforma. Prefira responder pelo celular ou pela própria plataforma.
• Exclusivo do app Business: números no WhatsApp comum (pessoal) precisam primeiro migrar para o aplicativo WhatsApp Business para poder ativar a Coexistência.
• Regras de mensagem ativa continuam valendo: fora da janela de 24 horas, o contato ativo pela API exige templates aprovados pela Meta, conforme a política do WhatsApp Business. Já explicamos esse mecanismo no artigo sobre templates da WhatsApp Business API.

E um ponto de conformidade que importa para advocacia: as conversas de clientes contêm dados pessoais, então o tratamento na plataforma deve observar a LGPD (Lei 13.709/2018) — base legal, controle de acesso por atendente e registro de consentimento quando aplicável.

Coexistência ou conexão Cloud direta?

As duas conexões terminam no mesmo lugar — a API Oficial da Meta —, mas o caminho e o dia a dia mudam:

O comparativo completo, com cenários de escritório e critérios de decisão, está na nossa página dedicada: API do WhatsApp: Cloud vs Coexistência — qual escolher. E se você optar pela conexão direta, o tutorial correspondente é o de como conectar a API Oficial do WhatsApp.

Erros comuns ao migrar para a API Oficial do WhatsApp

Estes são os tropeços que mais vemos em migrações de escritórios — todos evitáveis:

• Escanear o QR Code com o WhatsApp errado: a Coexistência funciona com o app WhatsApp Business. Escanear com o WhatsApp pessoal não conclui o cadastro.
• App desatualizado: versões anteriores à 2.24.17 não exibem o fluxo de Coexistência corretamente. Atualize antes.
• Fazer a conexão sem ser administrador do Business Manager: o cadastro trava no meio e cria contas duplicadas. Garanta o acesso antes.
• Recusar a sincronização de histórico na ativação: a autorização aparece uma vez no fluxo; se recusar, o painel começa sem o contexto das conversas recentes.
• Ignorar os templates: sem templates aprovados, a equipe não consegue iniciar conversas fora da janela de 24 horas e conclui, errado, que “a API não funciona”.
• Desconectar o app achando que precisa: na Coexistência, o app deve permanecer conectado. Remover o dispositivo desfaz a ponte com a API.

Perguntas frequentes

Referências

Fontes oficiais e documentação consultadas para este tutorial:

• Meta for Developers — WhatsApp Cloud API (documentação oficial)
• Meta for Developers — Embedded Signup (Cadastro Incorporado)
• WhatsApp Business — Políticas de mensagens e comércio
• Central de Ajuda do WhatsApp
• Lei Geral de Proteção de Dados (Lei 13.709/2018)

Conclusão

Migrar para a API Oficial do WhatsApp deixou de ser um salto no escuro. Com a Coexistência, o escritório mantém o número, o aplicativo e o histórico recente — e ganha, no mesmo dia, IA de atendimento, multiatendimento e CRM operando sobre uma conexão autorizada pela Meta.

O caminho é curto: preparar o Business Manager, atualizar o app, escanear o QR Code e autorizar a sincronização. O vídeo no topo mostra tudo em tempo real, e a equipe do Sábio Adv acompanha a migração dos escritórios do início ao fim.