Migrar número do WhatsApp Business para a API: o que preparar

Migrar número do WhatsApp Business para a API: o que preparar

Para migrar um número do WhatsApp Business app para a API oficial, você precisa decidir primeiro entre dois caminhos: desligar o app e passar tudo para a API, ou manter app e API ativos no mesmo número com o recurso de coexistência da Meta. Em qualquer caso, antes de mexer no número é preciso preservar o histórico, definir quem atende o quê, ter a empresa verificada e escrever um plano de volta. O resto é execução em ordem, com um piloto curto antes de colocar todo o atendimento no novo fluxo.

Principais pontos

• A migração muda a forma de operar o número, não só a tecnologia: a API não tem a tela do app, então a equipe precisa de uma ferramenta de atendimento.
• Coexistência reduz o risco para quem não pode parar de usar o app, mas tem limitações de recursos que devem ser conferidas na documentação vigente da Meta.
• Histórico de conversas não deve ser tratado como garantido: exporte e guarde o que a empresa precisa antes de qualquer passo.
• Equipe, permissões e regras de transferência para humano precisam estar prontas antes do dia da troca, não depois.
• Um plano de volta escrito, com chip, aparelho e códigos de acesso à mão, é o que transforma a migração em uma decisão reversível.

O que muda quando o número sai do app e vai para a API?

No app, o atendente abre o celular ou o WhatsApp Web, vê as conversas, as etiquetas e as respostas rápidas e simplesmente responde. Na API oficial, o número passa a ser operado por software: as mensagens chegam por webhook em um sistema, e a equipe responde por uma plataforma de atendimento, um CRM ou um painel construído sob medida. Essa mudança de interface é a que mais pega as empresas de surpresa.

Também mudam as regras de conversa. Mensagens que a empresa inicia fora da janela de atendimento exigem templates aprovados e consentimento do contato. Vale ler com calma o texto sobre mensagens ativas no WhatsApp, templates e opt-in antes de planejar campanhas ou lembretes no novo formato.

Por fim, muda quem é responsável por quê. Com o app, a conta é de quem tem o aparelho. Com a API, existem conta empresarial na Meta, ativos de negócio, tokens e provedores. Se isso ficar na mão de uma única pessoa ou de um fornecedor sem contrato claro, o número vira refém de um acesso.

Migração completa ou coexistência: como decidir?

A coexistência é um recurso oficial da Meta que permite usar o mesmo número no WhatsApp Business app e na API ao mesmo tempo. Ela existe justamente para empresas que já atendem pelo celular e não querem parar a operação. Os requisitos, as limitações e o que é sincronizado mudam com o tempo, então a regra é simples: confirme tudo na documentação oficial da WhatsApp Business Platform antes de decidir.

Um guia de decisão que funciona na prática:

• Se a equipe atual é pequena, depende muito do celular e quer ganhar automação aos poucos, comece avaliando coexistência.
• Se a empresa vai atender com várias pessoas, em fila, com distribuição e relatórios, e o app deixará de fazer sentido, a migração completa tende a ser mais limpa.
• Se há uso intenso de recursos que só existem no app, liste cada um e confira se continua disponível no modo escolhido. Não presuma.
• Se o número é crítico e a empresa não tolera nenhuma parada, prefira o caminho que permite voltar mais rápido, mesmo que o ganho de automação venha mais devagar.
• Se o número ainda é uma conta pessoal do WhatsApp, resolva isso antes. Conta pessoal e conta empresarial seguem caminhos diferentes.

Não existe resposta única. O critério é o custo de errar: quanto o negócio perde se o número ficar fora do ar por algumas horas, e quanto perde se a equipe tiver que trabalhar sem uma função que usava todo dia.

O que acontece com o histórico de conversas?

Essa é a pergunta que mais gera ansiedade, e a resposta honesta é que depende do caminho escolhido e das regras vigentes. Em uma migração em que o número é registrado na API e deixa de funcionar no app, não conte com o histórico aparecendo automaticamente no novo sistema. Dependendo do fluxo de cadastro, a Meta pode oferecer sincronização de parte do histórico, mas o escopo e as condições devem ser verificados na documentação no momento da migração.

Por isso, trate o histórico como um ativo que a empresa precisa proteger por conta própria:

• Defina o que realmente importa guardar: combinados de preço, prazos prometidos, pedidos em aberto, reclamações, dados de garantia.
• Exporte as conversas relevantes pelos recursos do próprio app e guarde em local controlado, com acesso restrito.
• Registre no CRM os contatos ativos com nome, última interação e situação, para que a equipe não recomece do zero.
• Salve as respostas rápidas, o catálogo e as etiquetas atuais em um documento, porque eles precisarão ser reconstruídos no novo fluxo.

Há também a dimensão da LGPD. Histórico de atendimento contém dados pessoais, e guardá-lo sem finalidade e sem prazo é um risco. Defina por quanto tempo a empresa mantém essas conversas, quem acessa e como atende pedidos de exclusão. A ANPD reúne orientações oficiais sobre o tema, e vale alinhar com quem cuida de privacidade na empresa antes de exportar tudo para uma pasta compartilhada.

Como preparar a equipe de atendimento?

A migração falha mais por pessoas do que por tecnologia. O atendente que respondia no celular agora vai usar um painel, e se ele não souber onde está a conversa de ontem, vai voltar a usar o celular pessoal, e a empresa perde o controle.

Preparar a equipe significa resolver quatro coisas antes do dia da troca:

• Ferramenta: escolha onde a equipe vai atender e teste com conversas reais de exemplo, não só com mensagens de teste.
• Papéis: defina quem vê todas as conversas, quem vê só a própria fila e quem administra a conta. Princípio do menor acesso, como descrito no guia de autorização da OWASP.
• Regras de atendimento: horário, tempo esperado de resposta, o que fazer com áudio, imagem e documento, e quando passar para outra pessoa.
• Transferência humana: se houver automação ou agente de IA, escreva quando ele para e entrega a conversa, e como o atendente enxerga o que já foi dito.

Se a ideia é conectar um agente de IA ao número, o texto sobre como integrar IA no WhatsApp da empresa explica o desenho geral. E, como a migração é um bom momento para revisar hábitos, vale ler também sobre como evitar o banimento do número ao usar agente de IA, porque envio sem consentimento e volume abrupto são causas comuns de problema.

Passo a passo para migrar sem parar o atendimento

A ordem abaixo funciona como roteiro de trabalho. Cada passo deve ter um responsável e um critério claro de pronto.

• Passo um: inventarie o número. Anote quem o usa, em quais aparelhos, quais fluxos dependem dele (site, anúncios, assinatura de e-mail, cartão impresso) e se há verificação em duas etapas ativa. Localize o PIN, se existir.
• Passo dois: confirme a base empresarial. A conta na Meta, os administradores e a verificação da empresa precisam estar em ordem. O texto sobre verificação de empresa na Meta para WhatsApp detalha esse processo.
• Passo três: escolha o provedor ou a integração direta e confira o que ele oferece para o caminho escolhido, migração completa ou coexistência.
• Passo quatro: salve o histórico e os ativos, como descrito acima, e peça a quem for responsável que valide o que foi guardado.
• Passo cinco: prepare templates e mensagens de saída. Submeta para aprovação com antecedência, porque a aprovação pode levar tempo.
• Passo seis: configure a ferramenta de atendimento, os papéis e o webhook, e teste em um número de homologação, não no número de produção.
• Passo sete: faça a troca em um horário de baixo movimento, com a equipe presente e o plano de volta impresso ao lado.
• Passo oito: acompanhe as primeiras conversas uma a uma, comparando com o que o app fazia. Registre falhas de entrega, mensagens sem resposta e dúvidas da equipe.

Cenário ilustrativo: uma loja de móveis planejados

Imagine uma loja pequena de móveis planejados em que duas pessoas atendem pelo mesmo número no celular da empresa. Os clientes mandam fotos do ambiente, medidas e áudios. A dona quer incluir um terceiro atendente e um agente de IA que faça a primeira triagem fora do horário, sem perder o número que já está nos cartões e no perfil do Instagram.

A loja decide avaliar coexistência, porque não pode ficar sem atender no sábado, que é o dia mais movimentado. Antes de ligar, exporta as conversas com orçamentos em andamento, registra no CRM cada cliente com projeto aberto e escreve três regras para a automação: coletar ambiente e medidas, nunca informar prazo de entrega, e passar para uma pessoa quando houver reclamação ou pedido de desconto. Na primeira semana, o agente só atua fora do horário, e a equipe revisa todas as conversas na segunda-feira.

O exemplo é apenas ilustrativo, mas mostra o padrão: decisão guiada pelo risco, histórico salvo, regras de automação curtas e um período de observação antes de expandir.

Como montar o plano de volta?

Plano de volta é a parte que a maioria das empresas pula, e é a que dá tranquilidade para executar o resto. A pergunta é: se amanhã de manhã o atendimento pela API não estiver funcionando, o que fazemos nos primeiros minutos?

Um plano mínimo inclui:

• Acesso físico ao chip e ao aparelho, para receber código de verificação por SMS ou ligação, caso o número precise ser registrado de novo.
• O PIN de verificação em duas etapas guardado em local seguro, com mais de uma pessoa autorizada a acessá-lo.
• Um critério objetivo de acionamento, por exemplo: mensagens sem entrega por um período definido, ou falha no painel que impeça a resposta ao cliente.
• Um responsável por decidir a volta, com nome e substituto.
• Uma mensagem pronta para clientes e para a equipe, explicando que o atendimento está em ajuste e por qual canal alternativo falar.
• A confirmação, na documentação da Meta, do que acontece com o histórico e com as conversas criadas durante o período na API caso o número volte ao app.

Também vale definir de antemão o que significa parar de vez. Se o piloto não atingir o combinado, a empresa deve conseguir encerrar sem constrangimento. O texto sobre como medir um piloto de automação com IA ajuda a escolher o critério de decisão.

Como esse trabalho se encaixa no método de mapear, limitar, pilotar e transferir

Mapear é o inventário do número e do histórico: quem usa, para quê, com quais dados. Limitar é decidir o que a automação e cada pessoa podem ver e fazer, incluindo o que a IA nunca responde sozinha. Pilotar é migrar um fluxo real, com registro de decisões e uma métrica combinada, antes de mover o restante. Transferir é entregar a operação documentada à equipe, e então decidir entre expandir, ajustar ou parar. Nenhuma dessas etapas depende de promessa de resultado: cada uma produz um registro que sustenta a próxima decisão.

Perguntas frequentes

Posso migrar o número sem perder as conversas antigas? Depende do caminho e das regras vigentes da Meta, por isso não trate a preservação como garantida. Exporte e guarde o que a empresa precisa antes de qualquer alteração e confirme na documentação o que pode ser sincronizado no seu fluxo.

A equipe consegue continuar usando o app depois da migração? Com o recurso de coexistência, o uso do app e da API no mesmo número é previsto, mas com limitações de recursos que devem ser conferidas na documentação. Em uma migração completa, o app deixa de ser o canal de atendimento e a equipe passa a usar a ferramenta ligada à API.

Preciso verificar a empresa na Meta antes de migrar? A verificação da empresa costuma ser parte do caminho para operar com a API de forma estável, e deixá-la para depois pode atrasar o projeto. Comece por ela, confirme os requisitos atuais e mantenha mais de um administrador cadastrado na conta empresarial.

Dá para voltar para o app se algo der errado? Em geral é possível registrar o número novamente no app, mas o que acontece com o histórico e com as conversas feitas na API deve ser confirmado antes. Por isso o plano de volta precisa incluir chip, aparelho, PIN e um responsável pela decisão, tudo definido antes do dia da troca.

Fontes

• Meta: documentação da WhatsApp Business Platform (Cloud API)
• ANPD: Autoridade Nacional de Proteção de Dados
• OWASP: guia de autorização