Do WhatsApp Business app para a API oficial: três caminhos para migrar sem perder contatos

Para migrar do WhatsApp Business app para a API oficial, você tem três caminhos: manter o app e conectar o mesmo número à API (coexistência), mover o número de vez para a API ou abrir um número novo só para a API. Os três funcionam. O que muda entre eles é o que acontece com o histórico de conversas, se a equipe pode continuar usando o celular e quanto trabalho dá avisar os clientes.

Se a sua maior preocupação é não perder contatos nem conversas, a coexistência costuma ser o caminho mais seguro, porque é o único em que a Meta prevê sincronizar contatos e parte do histórico. Se você quer tirar o atendimento do celular de uma vez, mover o número resolve, desde que você faça backup antes. E se o número atual é pessoal ou misturado, um número novo pode ser a saída mais limpa.

Os primeiros resultados da busca sobre o tema são de fornecedores: um compara app e API, outro trata de trocar de provedor de API e um terceiro afirma que o histórico do app não migra, sem citar a coexistência. Nenhum compara os três caminhos com base na documentação da Meta. Este guia faz isso, com o que muda na rotina da equipe, os limites da coexistência, os custos e um checklist. Todas as regras citadas foram conferidas na documentação oficial da Meta em 27/10/2026. A Meta muda essas regras com alguma frequência; confira antes de decidir.

Por que migrar

O app WhatsApp Business foi feito para uma pessoa atender pelo celular. Ele começa a apertar quando:

• várias pessoas precisam atender o mesmo número e ninguém sabe quem respondeu quem;
• você quer um agente de IA respondendo fora do horário e fazendo a triagem;
• as conversas precisam ir para um CRM, com etapa, histórico e responsável;
• você precisa mandar mensagens com modelo aprovado para quem pediu, como confirmação, lembrete ou retomada;
• o atendimento depende de um celular que pode quebrar, ser perdido ou sair da empresa com alguém.

A API oficial resolve isso porque o número passa a ser acessado por uma plataforma de atendimento, não por um aparelho. Em troca, vêm regras: janela de 24 horas para mensagens livres, modelos aprovados pela Meta fora dela e cobrança por mensagem. O guia completo da API do WhatsApp Business explica essas diferenças em detalhe.

Caminho 1: coexistência (o app e a API no mesmo número)

Na coexistência, a empresa conecta o número que já usa no app a uma plataforma de API, por meio de um parceiro da Meta que ofereça esse tipo de conexão, e continua usando o app no celular. As mensagens enviadas e recebidas são espelhadas entre o app e a API, segundo a documentação da Meta.

O que a Meta informa (consultado em 27/10/2026):

• o app precisa estar na versão 2.24.17 ou superior;
• os contatos que têm WhatsApp podem ser sincronizados;
• as conversas individuais dos últimos 6 meses podem ser sincronizadas, se a empresa autorizar o compartilhamento; ela pode recusar;
• conversas em grupo não são sincronizadas;
• mensagens enviadas pelo app continuam gratuitas; as enviadas pela API seguem os preços da API.

Limites da coexistência:

• listas de transmissão existentes passam a ser somente leitura;
• mensagens temporárias, de visualização única e localização em tempo real ficam desativadas nas conversas individuais;
• o WhatsApp para Windows e para relógios WearOS não funciona como aparelho conectado nesse modo;
• o número tem vazão fixa de 20 mensagens por segundo, o que pode pesar em envios muito grandes;
• se o celular principal ficar inativo por cerca de 14 dias, a conexão com a API pode cair.

A página da Meta não lista países ou regiões. Confirme com o provedor se a coexistência está disponível para o seu número antes de contar com ela.

Prós: mantém contatos e parte do histórico; a equipe não precisa largar o celular de um dia para o outro; o cliente não percebe mudança.

Contras: dois lugares respondendo ao mesmo cliente, se não houver regra clara; alguns recursos do app ficam limitados; depende de manter o celular principal ativo.

O que muda na rotina: o risco principal é duas pessoas, ou uma pessoa e a IA, responderem à mesma conversa ao mesmo tempo, uma pelo celular e outra pela plataforma. Combine antes quem atende por onde. Uma regra simples: o atendimento do dia a dia passa para a plataforma, e o celular fica para casos pontuais. O guia sobre vários atendentes no mesmo WhatsApp ajuda a organizar quem assume cada conversa.

Caminho 2: mover o número de vez para a API

Aqui, o número sai do app e passa a funcionar só na API. A documentação da Meta diz que, para usar um número do app na API, é preciso apagar a conta do app ou conectar o número por um parceiro que suporte o uso do app (que é o caminho 1).

O que a Meta informa (consultado em 27/10/2026):

• ao apagar a conta do app e registrar o número na API, o histórico de mensagens é perdido;
• a própria Meta recomenda fazer backup do histórico no app antes;
• depois disso, o número só volta a funcionar no app se for desconectado da API;
• o número precisa receber SMS ou ligação para a verificação.

Prós: o atendimento sai do celular de vez; uma só porta de entrada; sem os limites da coexistência.

Contras: o histórico não vai junto para a API; os contatos ficam só na agenda do celular, se estiverem salvos lá; a troca precisa ser planejada para não deixar clientes sem resposta.

O que muda na rotina: a equipe deixa de usar o app naquele número e passa a atender só pela plataforma. Combine o dia e o horário da troca, de preferência num período de pouco movimento, e avise a equipe para não reinstalar o app no número.

Como não perder o que importa: antes de apagar a conta, exporte as conversas mais importantes pelo próprio app, salve a lista de contatos e anote, para cada cliente em negociação, em que pé está a conversa. Essas anotações podem ir para o CRM antes da troca.

Caminho 3: abrir um número novo para a API

Neste caminho, o número atual continua no app, e um número novo é registrado direto na API. Para a Meta, o número precisa ser da empresa, ter código de país e de área e receber SMS ou ligação. Números que já estão em uso no WhatsApp precisam ser apagados antes, então o número novo não pode estar ativo em outra conta.

Prós: nenhum risco para o número atual; dá para testar a API com calma; separa o atendimento da empresa de um número pessoal ou misturado.

Contras: os clientes conhecem o número antigo; é preciso avisá-los e atualizar site, anúncios, cartões e assinaturas de e-mail; por um tempo, haverá conversas chegando nos dois números.

O que muda na rotina: o número antigo precisa de alguém de olho durante a transição, com uma resposta que indique o número novo. Se você pretende ter números diferentes por área ou unidade, o guia sobre vários números de WhatsApp na mesma empresa ajuda a planejar. A Meta informa que portfólios novos começam com até dois números registrados, ampliados para vinte quando a empresa é verificada ou chega ao limite de 2.000 mensagens.

Comparação rápida

O que acontece com histórico e contatos

Histórico. Só a coexistência prevê levar conversas antigas para a API: as individuais dos últimos 6 meses, e só se a empresa autorizar. Grupos não vão. Nos outros dois caminhos, o histórico fica no app (caminho 3) ou é perdido ao apagar a conta (caminho 2), a menos que você exporte antes. Alguns fornecedores dizem que o histórico nunca migra; outros falam em prazos diferentes. A referência segura é a documentação da Meta, e ela pode mudar.

Contatos. "Não perder contatos" tem dois sentidos:

• o cliente continuar achando você: garantido na coexistência e ao mover o número, porque o número é o mesmo; no número novo, depende de você avisar;
• você continuar tendo a lista: na coexistência, os contatos com WhatsApp podem ser sincronizados; nos outros caminhos, salve a lista antes.

Permissão não migra junto. Ter o contato de alguém na lista não é o mesmo que ter permissão para mandar mensagens de marketing. Na API, a política do WhatsApp pede permissão (opt-in) antes de a empresa iniciar conversas, e quem pede para parar precisa ser respeitado. Antes de qualquer envio para a base que veio do app, separe quem já deu permissão de quem só conversou uma vez. O guia sobre disparo em massa sem bloqueio mostra como fazer isso.

Dados pessoais. Levar conversas e contatos para uma plataforma é tratar dados pessoais em outro sistema. Atualize o aviso de privacidade, defina quem tem acesso e leve só o que for necessário. O guia sobre LGPD no atendimento pelo WhatsApp traz o passo a passo.

Limites e custos (conferidos na Meta em 27/10/2026)

Custos. Na API, a Meta cobra por mensagem entregue, modelo que vale desde 01/07/2025. Cada número tem uma franquia mensal de 1.000 mensagens de serviço gratuitas, que não acumula de um mês para o outro. As tarifas variam por categoria de mensagem e por país, e a página traz mudanças que valem desde 01/10/2026; consulte a página de preços da Meta para os valores atuais. Na coexistência, as mensagens enviadas pelo app continuam gratuitas, e as enviadas pela API seguem esses preços. Além das tarifas da Meta, a plataforma de atendimento que você escolher tem o próprio custo.

Limites que mudam com a migração:

• fora da janela de 24 horas, só modelos aprovados;
• até dois números por portfólio novo, como visto acima;
• na coexistência, os limites próprios desse modo (vazão de 20 mensagens por segundo, recursos do app desativados, celular principal ativo).

Checklist antes de migrar

1. Escolha o caminho com a tabela acima: quer manter o celular em uso? Precisa do histórico? O número é só da empresa?
2. Confirme com o provedor se ele oferece a coexistência para o seu número, se for o seu caminho.
3. Atualize o app para a versão exigida, no caso da coexistência.
4. Faça backup: exporte as conversas importantes e salve a lista de contatos, em qualquer caminho.
5. Anote as negociações em andamento e leve para o CRM antes da troca.
6. Garanta acesso ao número para receber o código por SMS ou ligação.
7. Separe quem tem permissão para receber mensagens da empresa.
8. Prepare os modelos de mensagem que você vai precisar fora da janela de 24 horas, como confirmação e retomada, e envie para aprovação.
9. Combine a rotina da equipe: quem responde pela plataforma, quem ainda usa o celular e o que fazer com conversas que chegarem no meio da troca.
10. Escolha um horário calmo para a troca e teste com um número interno antes.
11. Atualize o aviso de privacidade e o acesso de cada pessoa da equipe.
12. Se for número novo, prepare o aviso aos clientes e a atualização de site, anúncios e materiais.

Perguntas frequentes

Dá para usar o WhatsApp Business app e a API no mesmo número?

Sim, pela coexistência, conectando o número por um parceiro da Meta que ofereça essa opção. Alguns recursos do app ficam limitados, e as mensagens são espelhadas entre o app e a plataforma, segundo a documentação da Meta consultada em 27/10/2026.

Vou perder minhas conversas ao migrar?

Depende do caminho. Na coexistência, as conversas individuais dos últimos 6 meses podem ser sincronizadas, se você autorizar. Ao apagar a conta do app para mover o número, o histórico é perdido; faça backup antes.

Os clientes vão perceber a mudança?

Na coexistência e ao mover o número, o número continua o mesmo. Com um número novo, você precisa avisá-los.

Preciso de um provedor para usar a API?

Na prática, sim: a API é acessada por uma plataforma de atendimento ou por um parceiro da Meta. Para a coexistência, o parceiro precisa oferecer esse tipo de conexão.

Quanto custa a API do WhatsApp?

A Meta cobra por mensagem entregue, com valores por categoria e país, e cada número tem 1.000 mensagens de serviço gratuitas por mês. Os valores mudam; confira na página de preços da Meta. A plataforma de atendimento tem custo próprio.

Posso voltar para o app depois?

Se você moveu o número de vez, só depois de desconectá-lo da API. Na coexistência, o app continua funcionando.

Resumo

1. Há três caminhos: coexistência, mover o número ou abrir um número novo.
2. Só a coexistência prevê sincronizar contatos e conversas individuais dos últimos 6 meses, com sua autorização.
3. Mover o número exige apagar a conta do app, e o histórico é perdido sem backup.
4. Número novo protege o atual, mas exige avisar os clientes.
5. Na coexistência, combine quem responde pelo celular e quem responde pela plataforma.
6. Permissão para mensagens de marketing não migra com a lista de contatos.
7. Confira requisitos, limites e preços na documentação da Meta antes de decidir.

O PapoFranco usa a API oficial do WhatsApp, da Meta, e reúne vários números oficiais e outros canais numa caixa de entrada única, com o histórico de cada cliente e um dono para cada conversa. Na implantação, a equipe do PapoFranco entende o seu atendimento, conecta o WhatsApp oficial, monta o funil e escreve as regras da IA. Depois disso, um agente de IA responde 24 horas por dia, faz a triagem dos leads com uma pergunta por vez e passa o caso pronto para a pessoa certa, que pode assumir a conversa a qualquer momento. Conheça o PapoFranco e leia outros guias no blog.