# Como sair da API não oficial do WhatsApp sem perder a base > Como sair da automação não oficial para a API oficial do WhatsApp sem perder a base: opt-in, templates, número e retomada em ondas. - Fonte: https://www.ztgrowth.com.br/guia/migrar-api-nao-oficial-whatsapp/ - Formato: Guias - Publicado em: 2026-11-02 - Atualizado em: 2026-11-02 **Resposta curta:** a sua base não está no WhatsApp. Ela está nos dados da loja: telefone, histórico de pedidos e o registro de quem aceitou receber mensagens. Para trocar a automação não oficial pela API oficial sem perder essa base, faça quatro coisas, nesta ordem: levante os contatos a partir da loja, separe quem deu opt-in, reescreva as mensagens como templates aprovados e volte a falar com a base em ondas, começando por quem mais espera ouvir da marca. A API oficial acaba com o banimento típico da automação não oficial, mas qualidade baixa continua limitando o número. ## Por que a automação não oficial cai Ferramenta não oficial é o aplicativo comum do WhatsApp com um robô por cima, ou uma extensão de navegador que manda mensagens em massa. Ela fica fora do sistema da Meta: não tem template, não tem limite, não tem aviso. Quando a rejeição cresce, o número simplesmente cai, e a loja descobre no dia em que as mensagens param de sair. Na API oficial (WhatsApp Business Platform), as regras são outras e estão à vista: | | Automação não oficial | API oficial | | --- | --- | --- | | Mensagem ativa | Qualquer texto, para qualquer contato | Só com template de mensagem aprovado pela Meta | | Volume | Sem regra, até o número cair | [Limite de mensagens](https://www.ztgrowth.com.br/glossario/limite-de-mensagens/) por portfólio, que sobe em degraus (250, 2.000, 10.000, 100.000 e ilimitado) | | Aviso de risco | Nenhum | Qualidade do número em verde, amarelo ou vermelho | | Resposta ao cliente | Livre | Livre dentro da janela de 24 horas depois da última mensagem dele | | Custo | Assinatura da ferramenta | A Meta cobra por mensagem entregue, conforme a categoria. Tabela na [página de preços da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) | A troca não é só de ferramenta. É sair de um canal onde tudo é permitido até o dia em que nada funciona para um canal com regra clara. Quem migra tentando fazer na API o que fazia no robô bate no limite e derruba a qualidade nas primeiras semanas. ## Passo a passo da migração ### 1. Levante a base a partir da loja, não do aparelho A agenda do celular e a lista da ferramenta antiga são a parte menos confiável da base: misturam cliente, fornecedor, número que não existe mais e gente que nunca comprou. O que vale é o cadastro da loja: quem comprou, quando, o quê e se aceitou receber mensagens. Exporte clientes e pedidos da plataforma de e-commerce e use o telefone do cadastro como chave. Se a ferramenta antiga guardava alguma informação que a loja não tem (por exemplo, quem pediu para não receber mais mensagens), leve isso junto. Pedido de saída feito na ferramenta antiga continua valendo. ### 2. Separe quem deu opt-in Ter o telefone na base não é consentimento. A Meta exige que o cliente tenha aceitado receber mensagens da marca no WhatsApp. Divida a base em três grupos: - **Opt-in claro.** Marcou a opção no checkout, no cadastro ou pediu no próprio chat. Pode receber template. - **Sem registro de opt-in.** Comprou, mas nunca aceitou receber mensagens no WhatsApp. Peça o opt-in por outro canal antes (e-mail, site, checkout), dizendo o que a pessoa vai receber. - **Pediu para sair.** Não recebe nada automático, mesmo que tenha comprado ontem. É a etapa que mais dá vontade de pular, porque o grupo sem opt-in costuma ser o maior. Também é a que mais protege o número: lista sem consentimento é o caminho mais curto para denúncia. ### 3. Reescreva as mensagens como templates Mensagem ativa, fora da janela de 24 horas, só sai por template aprovado. Não copie o texto do robô antigo. Reescreva cada mensagem que a loja manda (confirmação de pedido, carrinho, Pix, promoção) como um template com: - **A categoria certa.** Aviso de pedido, pagamento e entrega é utilidade. Oferta, cupom e convite para voltar é marketing. Usar utilidade para mensagem promocional tem punição em escada, que pode chegar à restrição da conta. O guia [template de marketing ou utilidade](https://www.ztgrowth.com.br/guia/template-marketing-ou-utilidade-whatsapp/) explica a diferença. - **Variáveis no lugar do texto fixo.** Nome, número do pedido e link entram como variáveis, e o mesmo template serve para todos os clientes. - **Uma saída fácil nas mensagens de marketing.** Um botão "não quero receber" evita que o cliente bloqueie o número para parar de receber. Submeta os templates antes de desligar a ferramenta antiga, para que a migração não fique parada esperando aprovação. ### 4. Decida o número Há dois caminhos: - **Levar o número que os clientes já conhecem.** O cliente reconhece o contato e as conversas continuam no mesmo lugar para ele. O número precisa sair da ferramenta antiga e ser conectado à API pelo fluxo de cadastro da Meta. As condições para isso dependem da situação do número e são conferidas no onboarding. - **Começar com um número novo.** Exige avisar os clientes do novo contato: no site, no e-mail, na confirmação de pedido e na embalagem. Avise antes de mandar a primeira mensagem, para o cliente não estranhar um número desconhecido falando em nome da marca. Nos dois casos, quem decide é a loja, e a decisão vem antes da primeira mensagem ativa. ### 5. Volte a falar com a base em ondas O limite começa em 250 pessoas diferentes por dia e sobe em degraus. Mesmo que não começasse, mandar para todo mundo no primeiro dia concentra o risco: uma mensagem ruim chega à base inteira de uma vez. Uma ordem que funciona: 1. **Mensagens de utilidade primeiro.** Confirmação de pedido e código de rastreio geram pouca rejeição, porque o cliente espera receber. 2. **Depois as jornadas.** Carrinho abandonado e Pix não pago falam com quem está comprando agora, no momento em que a mensagem faz sentido. 3. **Por último as campanhas**, começando por quem comprou nos últimos meses e tem opt-in claro, e crescendo em ondas. ### 6. Acompanhe a qualidade nas primeiras semanas A qualidade do número aparece no WhatsApp Manager e muda rápido. Se cair para amarelo, pause o marketing, veja qual envio coincidiu com a queda e reveja segmento, frequência e texto. O guia [como fazer disparos sem bloquear o número](https://www.ztgrowth.com.br/guia/disparo-whatsapp-sem-bloqueio/) detalha o que olhar. ## Erros comuns - **Importar a agenda do celular e disparar.** Número velho, contato pessoal e quem nunca comprou entram juntos, e a rejeição vem no primeiro dia. - **Tratar telefone como consentimento.** Comprou no site não é o mesmo que aceitou receber mensagens no WhatsApp. - **Copiar o texto do robô como template.** Mensagem escrita para escapar do filtro da ferramenta antiga é exatamente a que gera denúncia. - **Cadastrar promoção como utilidade.** A Meta reclassifica, e o uso indevido repetido leva a restrições. - **Mandar a campanha grande no primeiro dia.** Bate no limite e concentra o risco numa mensagem que ainda não foi testada. - **Trocar de número sem avisar.** O cliente recebe mensagem de um número desconhecido em nome da marca e bloqueia. - **Achar que a API oficial é garantia contra bloqueio.** Ela elimina o banimento da automação não oficial, mas a Meta continua medindo a reação das pessoas. ## Como a ztgrowth faz A ztgrowth opera inteira na API oficial da Meta e é Provedor de Tecnologia verificado da Meta. Numa migração: - **Conexão pelo fluxo da Meta.** O número é conectado à API pelo cadastro da própria Meta (Embedded Signup), a partir do portal. Números adicionais da marca entram pelo mesmo caminho. - **Go-live acompanhado pela squad.** Do contrato à conversa real com cliente em menos de 7 dias, com integração, templates e jornadas configurados pela squad junto com o time da loja. Ver [Provisioning](https://www.ztgrowth.com.br/produtos/provisioning/). - **Base a partir da loja.** Clientes e pedidos vêm da integração com Shopify, VTEX ou Wake, e a importação por planilha (CSV) cobre o que estiver fora dela. - **Opt-out respeitado.** Quem pediu para sair fica registrado no cliente e sai dos envios automáticos. Número que a Meta informa como inexistente no WhatsApp é marcado à parte: não é opt-out, e a marcação some quando a pessoa escreve para a loja. - **Retomada com freio.** Campanhas saem em ondas, com travas de entrega, opt-out e queda de interação. A plataforma pausa as campanhas quando a qualidade do número deixa o verde e quando os envios do dia chegam ao limite. Para ver como fica a operação de campanhas depois da migração, veja [WhatsApp Marketing oficial](https://www.ztgrowth.com.br/lp/whatsapp-marketing/). ## Perguntas frequentes ### Vou perder meus contatos ao sair da ferramenta não oficial? Não, se a base vier da loja. Telefone, pedidos e consentimento ficam no cadastro da loja e no CRM, não no aparelho. O que precisa de cuidado é o opt-in: contato sem registro de consentimento não deve receber template até aceitar. ### Posso continuar com o mesmo número? É a decisão do passo 4. A conexão com a API é feita pelo fluxo de cadastro da Meta, e as condições para levar um número que já está em uso são conferidas no onboarding. Se a loja preferir um número novo, o trabalho é avisar os clientes antes da primeira mensagem. ### Preciso pedir opt-in de novo para a base inteira? Para quem já deu opt-in claro para receber mensagens da marca no WhatsApp, não. Para quem só tem o telefone cadastrado, sim: ter o número não é consentimento. ### Quanto tempo leva a migração? Na ztgrowth, o go-live leva menos de 7 dias, do contrato à primeira conversa real. A retomada da base em ondas leva mais, porque depende do limite do portfólio e da qualidade do número. ### Quanto custa mandar mensagem pela API oficial? A Meta cobra por mensagem entregue, e o preço depende da categoria do template e do país de quem recebe. A tabela vigente está na [página de preços da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing). --- Quer migrar para a API oficial com a base, os templates e a retomada em ondas cuidados por uma squad? [Fale com a ztgrowth](https://www.ztgrowth.com.br/lp/whatsapp-marketing/).