Migração para a API oficial do WhatsApp: requisitos, riscos e o que acontece com suas conversas

Guia completo da migração para a API oficial do WhatsApp: pré-requisitos, verificação do portfólio, coexistência e como evitar conversas perdidas.

16/09/2026

A migração para a API oficial do WhatsApp parece simples quando vista de fora. Você conecta o número, aprova alguns modelos de mensagem e começa a atender. Na prática, é um projeto com pré-requisitos, riscos e decisões que não têm volta fácil. Este guia reúne o que a Meta documenta, o que vemos acontecer nas migrações do dia a dia e o que costuma pegar empresas de surpresa.

O que muda quando você sai do app para a API oficial

O WhatsApp Business app foi pensado para uma pessoa atendendo em um celular. A API oficial, hoje oferecida pela Meta como Cloud API, foi pensada para operação: vários atendentes, automações, integração com CRM e envio em escala com regras claras.

Essa troca traz ganhos reais. Você passa a ter histórico centralizado, relatórios, chatbots e disparos com modelos aprovados. Em compensação, entra em um ambiente com regras próprias. Existe a janela de atendimento de 24 horas, existem limites de envio e existe cobrança por mensagem nas situações previstas pela Meta.

Pré-requisitos para migrar para a API oficial

Antes de mexer no número, vale conferir cada item abaixo. Boa parte dos atrasos em migrações vem de um detalhe desta lista que ficou para depois.

Portfólio empresarial na Meta

Toda conta da API fica dentro de um portfólio empresarial, o antigo Business Manager. É ali que ficam a conta do WhatsApp Business (WABA), os números, os modelos de mensagem e as permissões de acesso. Quem conduz a migração precisa ter acesso de administrador a esse portfólio.

Um erro comum é criar um portfólio novo só para o WhatsApp, separado do que já gerencia a página do Facebook, o Instagram e os anúncios. Isso fragmenta ativos e complica a verificação. Na maioria dos casos, o melhor caminho é usar o portfólio que a empresa já tem, desde que ele esteja em nome da pessoa jurídica correta.

Verificação da empresa

A verificação do portfólio empresarial é o ponto que mais trava projetos. Tecnicamente, a Meta permite usar a Cloud API sem verificação. O problema está no limite. Portfólios não verificados começam com um teto de 250 contatos únicos por 24 horas para mensagens iniciadas pela empresa.

Para uma operação real, esse teto acaba rápido. A verificação libera os níveis seguintes de envio, que sobem conforme a qualidade do número e o volume usado. Desde outubro de 2025, esses limites valem para o portfólio inteiro, compartilhados entre todos os números conectados a ele.

Para verificar, a Meta pede documentos que comprovem a existência da empresa e o vínculo com o nome informado. No Brasil, costumam entrar cartão CNPJ, contrato social ou documentos equivalentes. Ajuda muito ter um site com domínio próprio, com o mesmo nome e endereço dos documentos. Divergência entre razão social, nome fantasia e o que aparece no site é um dos motivos mais frequentes de reprovação.

Nome de exibição aprovado

O nome que aparece para o cliente passa por análise da Meta. Ele precisa ter relação clara com a marca da empresa e seguir as diretrizes de nome de exibição. Nomes genéricos, com excesso de palavras-chave ou sem ligação com o site costumam ser recusados. Sem o nome aprovado, o número opera com restrições.

Número e acesso a ele

Você vai precisar receber um código de verificação por SMS ou ligação no número que será migrado. Parece óbvio, mas não é raro o número estar em um chip antigo, em um aparelho de um ex-colaborador ou em uma linha fixa sem acesso fácil a ligações.

Se o número já esteve em outra plataforma da API, entra mais um cuidado. A verificação em duas etapas precisa estar desativada no provedor anterior. Em alguns casos, a Meta também impõe um período de espera antes de liberar o número para uma nova conexão. Se o seu número já passou por bloqueio, vale ler também nosso guia sobre banimento no WhatsApp.

Os caminhos possíveis de migração

Existem hoje dois caminhos principais para quem usa o WhatsApp Business app. A escolha entre eles define o que acontece com seu histórico e com as conversas em andamento.

Caminho 1: migração completa, com exclusão da conta do app

A documentação da Meta é direta: para usar na Cloud API um número que já está no WhatsApp Business app, é preciso excluir a conta do app ou usar um parceiro que suporte a conexão do número do app. Se você excluir a conta e registrar o número na API, o histórico de mensagens se perde. Além disso, o número deixa de funcionar no app enquanto estiver registrado na API.

A própria Meta orienta a fazer backup das conversas antes. Esse backup fica com você, no aparelho ou na nuvem do celular. Ele não aparece dentro da plataforma de atendimento que vai operar o número pela API.

Caminho 2: coexistência entre app e API

A Meta também oferece a conexão de números do WhatsApp Business app sem apagar a conta, chamada de coexistência. Nesse modelo, a empresa continua usando o app no celular e, ao mesmo tempo, opera o número por uma plataforma conectada à API. Segundo a documentação oficial, as mensagens dos últimos seis meses podem ser sincronizadas, e o que é enviado em um lado aparece no outro.

A coexistência resolve muita dor, mas tem limitações que precisam entrar na decisão:

• O app precisa estar na versão 2.24.17 ou superior, e a conexão tem de ser feita por um parceiro técnico habilitado pela Meta.
• Listas de transmissão do app ficam desativadas e as existentes passam a ser só leitura.
• Mensagens temporárias, visualização única e localização em tempo real deixam de funcionar nas conversas individuais.
• Grupos não são sincronizados com a plataforma.
• Dispositivos vinculados são desconectados no momento da conexão e precisam ser vinculados de novo. WhatsApp para Windows não é suportado nesse modelo.
• A velocidade de envio fica fixa em 20 mensagens por segundo.
• Se o celular principal ficar inativo por cerca de 14 dias, a conexão pode ser encerrada pela Meta.

Há também um prazo técnico curto. Depois da conexão, a plataforma tem 24 horas para sincronizar contatos e histórico. Se isso não acontecer, o processo precisa ser refeito do zero. Por isso a coexistência exige uma plataforma com integração bem feita e alguém acompanhando o processo na hora.

O que acontece com as conversas em andamento

Este é o ponto que mais gera reclamação de clientes finais, e quase nunca é explicado antes da migração.

O intervalo em que o número fica fora do ar

Na migração completa, existe um intervalo entre a exclusão da conta no app e a ativação na API. Nesse período, o número não está registrado em lugar nenhum. A Meta informa que as mensagens enviadas nesse intervalo ficam em fila nos servidores do WhatsApp.

Do lado do cliente, a experiência nem sempre é tranquila. Na prática, vemos três situações comuns:

• Mensagens em conversas já abertas ficam com um único tique, sem confirmação de entrega, e o cliente acha que foi ignorado.
• Quem tenta abrir uma conversa nova por link, QR Code ou botão do site pode receber o aviso de que o número não está no WhatsApp.
• Foto de perfil e informações comerciais podem sumir temporariamente, o que leva alguns clientes a pensar que o contato foi trocado ou que a empresa fechou.

Quando tudo corre bem, esse intervalo dura minutos. Quando algo trava, como documento reprovado, código que não chega ou número preso em outro provedor, ele pode durar dias. É por isso que a ordem das etapas importa tanto.

A janela de 24 horas começa do zero

Na API oficial, você só pode responder livremente dentro de uma janela de 24 horas aberta pela mensagem do cliente. Fora dela, é preciso usar um modelo de mensagem aprovado.

A documentação da coexistência deixa claro um efeito colateral. Se o cliente mandou mensagem pouco antes da conexão com a API, a janela não foi aberta. A empresa só consegue responder com um modelo aprovado. Na prática, a equipe abre a conversa na nova plataforma, tenta responder um cliente que escreveu ontem e a mensagem não sai. Se ninguém avisou a equipe, isso vira chamado de suporte no primeiro dia.

Histórico e contexto do atendimento

Na migração completa, o atendente começa sem nenhuma conversa anterior. O cliente escreve como se a empresa lembrasse de tudo, e quem está atendendo não tem o contexto. Na coexistência, o histórico recente pode ser trazido, mas mídias antigas chegam de forma parcial. A documentação da Meta indica que só os arquivos de mídia das duas últimas semanas vêm com o conteúdo completo.

Como reduzir o impacto na operação

Uma migração bem conduzida começa bem antes do dia da troca. Ela começa com um diagnóstico. Qual caminho faz sentido para o seu volume? A equipe depende de listas de transmissão ou de grupos? O portfólio já está verificado? Quem tem acesso ao número?

Nas migrações que acompanhamos na CodenTech, a regra que mais evita dor de cabeça é simples: nada é desligado antes de todos os pré-requisitos estarem aprovados. Portfólio verificado, nome de exibição aprovado, modelos de mensagem já liberados e plataforma de atendimento pronta para receber. Só depois disso o número é movido.

Algumas práticas que ajudam:

• Escolha um horário de baixo movimento para a troca e evite véspera de campanha.
• Avise os clientes mais ativos com antecedência, por exemplo em uma mensagem de status ou nas redes sociais.
• Aprove antes da migração um modelo de retomada de conversa, para responder quem escreveu durante a transição.
• Exporte ou registre as conversas em aberto e as pendências importantes, para a equipe não perder o fio.
• Treine os atendentes na janela de 24 horas antes do primeiro dia na nova plataforma.
• Teste os links, QR Codes e botões de WhatsApp do site depois da ativação. Nosso gerador de link de WhatsApp ajuda a revisar esses pontos de entrada.

Quanto custa operar pela API oficial

A migração em si não tem custo cobrado pela Meta. O que passa a existir é a cobrança por mensagem, que depende da categoria (marketing, utilidade, autenticação ou atendimento) e das regras vigentes. As regras de preço da Meta mudam com frequência, e há mudanças previstas para outubro de 2026. Antes de fechar o orçamento, confira a tabela oficial de preços da Meta, e não apenas a informação repassada pelo provedor.

Vale lembrar que nenhuma plataforma elimina esse custo. O que uma boa operação faz é usar a janela gratuita de atendimento com inteligência, evitar disparos desnecessários e manter a qualidade do número alta para não travar o crescimento. É esse o tipo de gestão que o CodenDesk ajuda a organizar no dia a dia.

Checklist rápido antes de migrar

1. Portfólio empresarial correto, com acesso de administrador.
2. Empresa verificada pela Meta, com documentos e site consistentes.
3. Nome de exibição dentro das diretrizes.
4. Acesso ao número para receber o código de verificação.
5. Verificação em duas etapas desativada, se o número veio de outro provedor.
6. Decisão tomada entre migração completa e coexistência.
7. Backup das conversas do app.
8. Modelos de mensagem aprovados, incluindo um de retomada.
9. Equipe treinada na janela de 24 horas.
10. Plano de comunicação com clientes para o dia da troca.