Como sair da API não oficial do WhatsApp sem perder a base

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:

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 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 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.
• 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.

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.

Quer migrar para a API oficial com a base, os templates e a retomada em ondas cuidados por uma squad? Fale com a ztgrowth.