Migrar para API Oficial WhatsApp sem Perder Histórico

Quem decide migrar para API oficial WhatsApp quase sempre trava na mesma pergunta: o que acontece com as conversas que estão hoje no celular? Desde que a Meta liberou o modo de coexistência, dá para fazer a troca sem apagar nada. Mas existem três caminhos, e só um deles preserva o histórico. Este guia mostra qual escolher, o passo a passo, quanto custa e quando é melhor esperar.

TL;DR

• Existem três rotas: coexistência (mesmo número no app e na API), migração total do número (apaga a conta do app) e número novo. Só a coexistência traz o histórico para a API.
• Na coexistência, a Meta sincroniza as conversas individuais dos últimos 180 dias. Mídia, só a dos últimos 14 dias. Grupos não vêm.
• Na migração total, a documentação da Meta é direta: o histórico de mensagens é perdido. Faça backup antes.
• Desde 1º de outubro de 2026, as respostas dentro da janela de 24 horas passaram a ser cobradas depois de 1.000 mensagens grátis por número por mês. Isso entra na conta da migração.
• Com o Voyia, a plataforma de API oficial da Agathas Web, você conecta o número atual, mantém o celular funcionando e paga as mensagens da Meta sem markup.

Por que migrar para API oficial WhatsApp agora (e não depois)

O WhatsApp Business App foi feito para uma pessoa atendendo de um celular. Quando a empresa precisa de três atendentes no mesmo número, de chatbot fora do horário ou de relatório de conversas sem resposta, o app vira gargalo.

O atalho comum é a API não oficial, que "espelha" o WhatsApp Web. Funciona até o número ser bloqueado, e em 2026 a onda de bloqueios ficou difícil de ignorar. Detalhamos o cenário no texto sobre o banimento de WhatsApp Business em 2026 no Brasil.

Três fatos mudaram a conta em 2026:

1. A coexistência acabou com o "ou um ou outro". Antes, entrar na API exigia abrir mão do app e do histórico. Hoje o mesmo número roda nos dois.
2. O faturamento em reais chegou. Desde 1º de julho de 2026, contas de WhatsApp Business (WABA) de clientes no Brasil podem ser cobradas em BRL. As elegíveis precisam migrar para BRL até 30 de junho de 2027.
3. O preço mudou de novo em outubro. As mensagens de serviço deixaram de ser 100% gratuitas.

Em 18 anos de Agathas Web, migrando servidores, AVAs Moodle e sites de hospedagem gerenciada, aprendi que migração planejada custa pouco e migração às pressas, depois de um bloqueio, custa caro. Decidir migrar para API oficial WhatsApp enquanto o número ainda está saudável é o que permite escolher a rota que preserva o histórico.

As 3 rotas para sair do app e o que cada uma faz com o histórico

Quem vai migrar para API oficial WhatsApp precisa escolher a rota antes de qualquer passo técnico.

Rota 1: coexistência (o número fica no app e na API)

Você conecta o número que já usa no WhatsApp Business App à Cloud API, pelo fluxo oficial de cadastro da Meta (o Embedded Signup), escaneando um QR Code com o celular. O app continua funcionando, e a API passa a receber as mesmas conversas. É a única rota que importa o histórico para a plataforma.

Rota 2: migração total do número

É a forma mais radical de migrar para API oficial WhatsApp, e funciona assim: você apaga a conta do WhatsApp no aplicativo e registra o número direto na Cloud API. A própria documentação da Meta avisa que, nesse caso, o histórico de mensagens existente é perdido, e que o número só volta a funcionar no app se for desregistrado da API. Depois de apagar a conta, o número pode levar até 3 minutos para ficar disponível.

Rota 3: número novo

Você mantém o número antigo no app e cria um número limpo só para a API. O histórico fica intocado no celular antigo. O custo é avisar os clientes e conviver com dois números por um tempo.

Critério	Coexistência	Migração total	Número novo
Histórico na API	Sim, 180 dias de conversas 1:1	Não, é perdido	Não, fica no app antigo
Celular continua atendendo	Sim	Não	Sim, no número antigo
Grupos	Só no app	Perdidos	Só no app antigo
Taxa de envio	Fixa em 20 mensagens/segundo	Escala conforme a qualidade	Escala conforme a qualidade
Listas de transmissão	Ficam só leitura	Substituídas por templates	Substituídas por templates
Risco para o cliente final	Nenhum, mesmo número	Nenhum, mesmo número	Precisa ser avisado
Melhor para	PME com equipe que ainda vive no celular	Operação de volume alto e automação pesada	Quem quer separar marcas ou linhas

Para a maioria das PMEs, a coexistência é o ponto de partida.

O que a coexistência preserva, e o que fica de fora

Quem decide migrar para API oficial WhatsApp pela coexistência costuma ouvir do vendedor que "não perde nada". Não é bem assim. Pela documentação da Meta para integração de usuários do Business App:

O que vem para a API

• Conversas individuais dos últimos 180 dias, a partir do momento da conexão.
• Mídia enviada nos últimos 14 dias. Fotos, áudios e documentos mais antigos aparecem como marcadores, sem o arquivo.
• Contatos com número de WhatsApp, numa sincronização única. Mudanças depois disso chegam por webhook.
• Mensagens novas, espelhadas nos dois sentidos: o que a equipe responde no celular aparece na plataforma, e vice-versa.

O que não vem (ou deixa de funcionar)

• Grupos não são sincronizados.
• Mensagens temporárias, de visualização única e localização em tempo real são desativadas nas conversas 1:1.
• Listas de transmissão ficam desativadas: as existentes viram só leitura e não dá para criar novas.
• Ferramentas do app como catálogo, status, mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas não passam pela API.
• Chamadas de voz e vídeo seguem só no celular.
• Dispositivos vinculados (WhatsApp Web e Desktop) são desconectados na conexão. O WhatsApp para Windows não é compatível com a coexistência.

Dois detalhes que derrubam migrações

O primeiro: a sincronização do histórico precisa começar em até 24 horas depois da conexão, e cada etapa só roda uma vez. Se a plataforma falhar nessa janela, refazer exige desconectar o número e repetir o processo.

O segundo: o celular principal precisa continuar vivo. Se o app ficar inativo por cerca de 14 dias, a Meta desconecta a coexistência. Já explicamos essa rotina no guia sobre o modo de coexistência do WhatsApp.

Passo a passo: como migrar para API oficial WhatsApp sem perder histórico

O roteiro abaixo é o que seguimos quando ajudamos uma empresa a migrar para API oficial WhatsApp pela rota da coexistência.

Antes (D-7 a D-1)

1. Atualize o WhatsApp Business App no celular principal. A versão mínima exigida é a 2.24.17.
2. Confirme que é uma conta Business, não o WhatsApp pessoal.
3. Faça backup completo no Google Drive (Android) ou iCloud (iPhone). É o seu seguro se algo der errado.
4. Exporte as conversas críticas que tenham mais de 180 dias. A função "Exportar conversa" gera um arquivo de texto por chat. Ela tem limite (10 mil mensagens recentes com mídia, 40 mil sem), então priorize contratos e clientes de alto valor.
5. Configure o Portfólio Empresarial da Meta (antigo Gerenciador de Negócios) com dados reais da empresa, CNPJ e um administrador com verificação em duas etapas.
6. Liste o que a equipe usa do app hoje: etiquetas, respostas rápidas, catálogo, listas de transmissão. Tudo isso precisa ser recriado na plataforma.
7. Avise a equipe sobre a data e o fim do WhatsApp Web nos computadores.

Durante (D-0)

1. Escolha um horário de baixo movimento, com o celular principal carregado e no Wi-Fi.
2. Inicie a conexão pela plataforma de API e escolha conectar um app WhatsApp Business existente.
3. Selecione o portfólio, informe o número e escaneie o QR Code com o celular principal.
4. Autorize o compartilhamento do histórico. Se você recusar, a Meta não oferece uma segunda chance sem refazer tudo.
5. Mantenha o app aberto até a sincronização terminar. Dependendo do volume, leva alguns minutos.

Depois (D+1 a D+14)

1. Confira se conversas antigas e contatos apareceram na plataforma.
2. Recrie respostas rápidas, etiquetas e fluxos de chatbot.
3. Submeta os templates (mensagens-modelo) que substituirão as listas de transmissão. Eles passam por aprovação da Meta.
4. Defina quem abre o app no celular principal pelo menos uma vez por semana. Não deixe isso para a memória de ninguém.

Quanto custa migrar para API oficial WhatsApp em 2026

O custo de migrar para API oficial WhatsApp tem três camadas, e confundir uma com a outra é o erro mais comum nos orçamentos que recebemos para revisar.

Camada 1: mensagens cobradas pela Meta

Desde 1º de julho de 2025 a Meta cobra por mensagem-modelo entregue, com preço que varia por categoria (marketing, utilidade, autenticação) e pelo país do destinatário. Marketing é a categoria mais cara. Utilidade e autenticação têm desconto por volume mensal.

Em 1º de outubro de 2026 veio a mudança mais relevante do ano:

• As mensagens de serviço (respostas livres dentro da janela de 24 horas que o cliente abre ao escrever) passaram a ser cobradas, com 1.000 mensagens grátis por número de telefone por mês. A franquia não acumula.
• Os templates de utilidade enviados dentro da janela também passaram a ser cobrados, sem franquia.
• A janela gratuita de anúncios (Click to WhatsApp) continua gratuita.

Os valores em reais estão na tabela oficial de preços da plataforma WhatsApp Business da Meta, revisada com frequência.

Camada 2: a plataforma

É a mensalidade da ferramenta (caixa de entrada, chatbot, relatórios). A pegadinha: muitas plataformas cobram margem sobre cada mensagem da Meta, e no volume de uma operação de vendas essa margem pesa mais que a mensalidade.

Camada 3: a implantação

Portfólio, conexão do número, templates, chatbot e treinamento, feitos pela própria empresa ou contratados.

Item	Quem cobra	Como é cobrado
Templates de marketing	Meta	Por mensagem entregue
Templates de utilidade e autenticação	Meta	Por mensagem, com desconto por volume
Mensagens de serviço	Meta	Grátis até 1.000 por número/mês, depois por mensagem
Mensagens enviadas pelo app no celular	Ninguém	Continuam gratuitas na coexistência
Plataforma de atendimento	Fornecedor	Mensalidade, às vezes com markup por mensagem
Implantação	Fornecedor ou equipe interna	Taxa única ou horas

Na coexistência, as mensagens que a equipe envia pelo app continuam gratuitas, o que ajuda quem quer migrar para API oficial WhatsApp sem estourar a franquia de serviço.

Quando NÃO migrar para API oficial WhatsApp (ainda)

Nem toda empresa precisa migrar para API oficial WhatsApp agora. Fique no app por enquanto se:

• Uma pessoa dá conta de todo o atendimento e a equipe não vai crescer neste ano.
• O negócio vive de grupos. Grupos não passam pela API, então a migração não resolve o seu problema principal.
• As listas de transmissão são o seu único canal de campanha e você não tem interesse em aprovar templates. Na API, campanha é template aprovado e pago por mensagem.
• O número está sob restrição ou acabou de ser bloqueado. Resolva isso primeiro: conectar um número problemático só transfere o problema.
• Ninguém vai cuidar do celular principal. Sem o app aberto pelo menos a cada duas semanas, a coexistência cai.

E há o caso inverso: se você hoje usa uma ferramenta não oficial que lê o WhatsApp Web, a pergunta já não é "quando", e sim "quanto tempo o número aguenta". O comparativo API oficial vs API não oficial do WhatsApp mostra por que esse risco não compensa.

Armadilhas comuns na migração

Estas são as falhas que mais aparecem quando a empresa tenta migrar para API oficial WhatsApp sem roteiro:

• Apagar a conta do app achando que é coexistência. É a forma mais rápida de perder o histórico inteiro.
• Recusar o compartilhamento do histórico na tela de conexão. A decisão é única.
• Esquecer os computadores com WhatsApp Web. Eles são desconectados, e quem respondia pelo desktop precisa de acesso à plataforma no dia seguinte.
• Prometer disparo em massa ilimitado. Na coexistência, a taxa de envio é fixa em 20 mensagens por segundo, e campanha exige template aprovado.
• Ignorar a cobrança das mensagens de serviço. Com a regra de outubro de 2026, uma operação de suporte com milhares de respostas por mês passa da franquia. Projete o volume antes.
• Webhook instável. Se a plataforma não recebe os eventos de forma confiável, mensagens do celular não aparecem no painel. É infraestrutura, não detalhe.

Pergunte ao fornecedor como ele monitora o webhook. É a mesma pergunta que fazemos sobre qualquer servidor de AVA Moodle que hospedamos: o que acontece quando algo para de chegar, e quem fica sabendo?

Como a Agathas Web resolve isso

O Voyia é a plataforma de atendimento e vendas da Agathas Web sobre a API oficial do WhatsApp, conectada direto à Meta. Ele foi desenhado para quem quer migrar para API oficial WhatsApp saindo do Business App sem recomeçar do zero.

O que está incluso:

• Caixa de entrada com vários atendentes, transferência entre eles e filas por equipe (a partir do plano Profissional).
• Chatbot no-code, respostas rápidas e templates com variáveis.
• Disparos em massa segmentados por tags, com templates aprovados.
• Integração com IA usando a sua própria chave (Claude, GPT, Gemini, DeepSeek), a partir do plano Profissional.
• Relatórios de entrega, leitura e tempo de resposta.
• App para iOS e Android, para a equipe atender de qualquer lugar.
• Suporte em português, cobrança em reais com nota fiscal e zero markup nas mensagens da Meta: você paga à Meta o que é da Meta.

Como funciona na prática: você contrata o plano, nós conduzimos a conexão do seu número à API oficial (pela rota que fizer sentido para a sua operação) e você configura equipe, contatos, templates e fluxos com os tutoriais do painel.

Como se contrata: os planos são mensais, sem fidelidade, por número de WhatsApp. Starter a R$ 149, Profissional a R$ 349 e Business a R$ 749 por mês. Starter e Profissional têm taxa de instalação e configuração, com valor informado pela equipe de vendas. Os detalhes de cada plano estão na página do Voyia, e lá mesmo você fala com o time comercial.

Conclusão: migre com rota definida, não no susto

Dá para migrar para API oficial WhatsApp sem perder histórico, desde que a rota seja a coexistência e que você faça a lição de casa antes: app atualizado, backup, exportação das conversas antigas e um responsável pelo celular principal. A migração total e o número novo também têm lugar, mas nenhum dos dois leva o histórico para a API.

Some a isso a nova cobrança das mensagens de serviço e a escolha da plataforma vira decisão financeira, não só técnica. Se quiser fazer essa troca com quem cuida da infraestrutura e não cobra margem nas mensagens, conheça o Voyia e peça uma conversa com a nossa equipe.