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

> Coexistência, mover o número ou número novo: como migrar do WhatsApp Business app para a API oficial, o que acontece com o histórico e checklist.

Publicado em 2026-10-27 por Equipe Franco. Fonte: https://papofranco.online/blog/migrar-whatsapp-business-para-api-oficial

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](https://papofranco.online/blog/janela-de-24-horas-whatsapp) para mensagens livres, [modelos aprovados pela Meta](https://papofranco.online/blog/template-whatsapp-aprovado-pela-meta) fora dela e cobrança por mensagem. O [guia completo da API do WhatsApp Business](https://papofranco.online/blog/whatsapp-business-api-guia-completo) 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](https://papofranco.online/blog/varios-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](https://papofranco.online/blog/varios-numeros-de-whatsapp-na-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

| | Coexistência | Mover o número | Número novo |
|---|---|---|---|
| Mantém o número | Sim | Sim | Não |
| Equipe pode usar o app | Sim, com limites | Não | Sim, no número antigo |
| Histórico vai para a API | Conversas individuais dos últimos 6 meses, se autorizado | Não | Não |
| Contatos | Podem ser sincronizados | Ficam na agenda do celular | Ficam no número antigo |
| Precisa avisar clientes | Não | Não | Sim |
| Principal cuidado | Regra de quem responde por onde | Backup antes de apagar | Divulgar o número novo |

## 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](https://papofranco.online/blog/disparo-em-massa-whatsapp-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](https://papofranco.online/blog/lgpd-no-atendimento-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](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) 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](https://papofranco.online/blog/qualificacao-de-leads-no-whatsapp) 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](https://papofranco.online) e leia outros guias no [blog](https://papofranco.online/blog).