API

API não oficial do WhatsApp: guia honesto (e quando não usar)

API não oficial do WhatsApp é um serviço que conecta o seu número ao WhatsApp Web em um servidor e expõe essa sessão por API, sem passar pela plataforma oficial da Meta. É mais rápida de começar e mais flexível, e tem um custo que a oficial não tem: o número pode ser restringido, porque os Termos do WhatsApp não preveem esse uso. Aviso de viés: o ZapZap vende uma API não oficial. Por isso este guia gasta tanto espaço com os riscos e com os casos em que você deve escolher a oficial.

Publicado em · Atualizado em · 6 min de leitura

Este artigo também está disponível em: English · Español

O que é a API não oficial, em duas frases

A API oficial é a WhatsApp Business Platform, da Meta: você registra um número na plataforma, passa pela verificação do negócio e usa templates aprovados para iniciar conversas. A não oficial é uma sessão do WhatsApp Web rodando em um servidor, pareada com o seu número por QR code, e uma camada de API por cima para enviar mensagens e receber eventos por webhook.

Cada número conectado é uma instância. Você mantém o número que já usa, com contatos e histórico, e escreve as mensagens livremente, sem aprovação prévia de modelo. Quem quiser os termos em ordem alfabética pode abrir o glossário de WhatsApp API.

O viés declarado: quem escreve este guia

O ZapZap API é um serviço de API não oficial. Ganhamos dinheiro quando você escolhe esse caminho, então leia o resto com isso em mente. Para compensar, o guia traz o que desfavorece a nossa categoria e aponta os casos em que não vendemos a melhor solução.

Se preferir comparar com outras ferramentas não oficiais, temos páginas com as fontes oficiais de cada projeto: WAHA, Baileys e Evolution API. Para o lado a lado com a oficial, veja ZapZap vs API oficial.

Os riscos reais

Bloqueio do número é o principal. Os Termos de Serviço do WhatsApp, na parte de uso aceitável, proíbem acessar os serviços por meios automatizados não autorizados e listam mensagens em massa e automáticas entre os usos vedados. Isso significa que a ação do WhatsApp sobre uma conta, quando acontece, está dentro do que os Termos preveem. Nenhum fornecedor sério consegue prometer que o número nunca será restringido, e quem promete está vendendo o que não controla.

Dependência de um protocolo que não é seu. Uma sessão de WhatsApp Web muda quando o WhatsApp muda, e a manutenção para acompanhar essas mudanças é trabalho contínuo do fornecedor. Pode haver instabilidade pontual e não existe um acordo de nível de serviço da Meta por trás.

Risco jurídico e de reputação. Mensagem para quem não pediu para receber é problema nos dois modelos, e a LGPD vale igual. Na oficial a plataforma barra parte disso; na não oficial a responsabilidade é inteiramente sua.

Número como ativo. Se o seu faturamento depende de um único número, perder esse número dói. Tratar o número como insubstituível é o erro que mais custa caro nesse modelo.

O que reduz o risco (sem eliminá-lo)

Não existe regra pública do WhatsApp com um número mágico de mensagens por dia, e quem afirma o contrário está repetindo experiência própria. O que a prática mostra é que o comportamento pesa mais do que a ferramenta: falar com quem já te conhece, evitar base fria, variar o texto, respeitar intervalos e dar saída fácil a quem não quer receber.

Aquecer o número antes de usar em volume ajuda o histórico de uso a parecer o de uma pessoa. As práticas de anti-bloqueio e o guia por que o WhatsApp bloqueia números detalham os gatilhos. Tudo isso reduz a chance de restrição. Nada disso a zera.

Quando a API oficial é a escolha certa

Escolha a oficial quando o número é o coração do negócio e perdê-lo seria inaceitável, quando você precisa de um canal homologado por exigência de contrato, compliance ou jurídico, quando o volume é de notificações transacionais em grande escala, ou quando a marca precisa do selo de conta oficial.

A oficial tem regras claras: segundo a documentação da Meta, a cobrança é por mensagem de template entregue desde 1º de julho de 2025, e fora da janela de 24 horas após a última mensagem do cliente só é possível enviar template aprovado. Em troca, você tem um canal sustentado pela própria Meta. Veja o guia da WhatsApp Business API para custos e caminhos.

Quando a não oficial faz sentido

Faz sentido para validar um canal rápido, para atendimento e vendas conversacionais com a sua própria base, para operações que vivem em grupos, e para quem quer custo previsível por número e começar no mesmo dia sem verificação de negócio. Também faz sentido como etapa de teste antes de decidir se vale migrar para a oficial.

Muitos negócios combinam os dois: oficial para o que precisa de selo e escala, não oficial para a conversa do dia a dia. O ZapZap cobra R$15 por número ativo por mês, pré-pago, sem cobrança por mensagem; os valores vigentes ficam em preços.

Como testar com risco baixo

Comece com um número secundário, não com o número principal da empresa. Conecte por QR code, fale primeiro com clientes que já conversaram com você, aumente o volume aos poucos e acompanhe respostas e denúncias. Se algo estranho aparecer, pare e reduza o ritmo antes de insistir.

Do lado técnico, a documentação mostra o primeiro envio em poucos minutos. Se o teste fizer sentido, escale com calma. Se a análise de risco indicar que o seu caso exige a oficial, é melhor saber disso antes de investir em um fluxo.

Resumo rápido

  • A API não oficial é uma sessão do WhatsApp Web exposta por API. Começa rápido e é flexível, mas não é canal homologado pela Meta.
  • O risco principal é a restrição do número. Os Termos do WhatsApp proíbem mensagens em massa e automáticas, e ninguém pode prometer que o número não será bloqueado.
  • O comportamento de envio pesa mais do que a ferramenta: base que já conhece você, texto variado, ritmo calmo e saída fácil para quem não quer receber.
  • A oficial é a escolha certa quando o número é insubstituível, quando há exigência de canal homologado ou quando o volume transacional é grande.
  • Teste com um número secundário antes de colocar a operação inteira em um único chip.

Perguntas frequentes

A API não oficial do WhatsApp é legal?

A questão central é contratual: esse uso não está previsto nos Termos de Serviço do WhatsApp, que podem levar à restrição do número. Já o envio de mensagem em si segue a lei como em qualquer canal: quem não consentiu em receber e o tratamento de dados pela LGPD continuam sendo sua responsabilidade. Em dúvida sobre o seu caso, consulte um advogado.

Qual a diferença entre API oficial e não oficial do WhatsApp?

A oficial é a plataforma da Meta, com verificação do negócio, templates aprovados e cobrança por mensagem. A não oficial conecta o seu número por uma sessão do WhatsApp Web e permite texto livre, sem aprovação prévia, mas sem a homologação da Meta e com risco de restrição do número.

Meu número pode ser bloqueado usando API não oficial?

Pode. Não existe fornecedor que consiga eliminar esse risco. Aquecer o número, falar com quem já te conhece, variar o texto e respeitar intervalos reduz a chance, mas não a zera. Por isso vale testar com um número secundário.

Quando devo escolher a API oficial?

Quando perder o número seria inaceitável, quando o contrato ou o jurídico exigem canal homologado, quando você envia notificações transacionais em grande volume ou quando precisa do selo de conta oficial. Nesses casos a oficial é a escolha certa, mesmo que seja mais burocrática.

Posso usar as duas ao mesmo tempo?

Pode, e muitos negócios fazem isso: a oficial para o que precisa de selo e escala, e a não oficial para atendimento e vendas conversacionais com flexibilidade.

Teste a via não oficial com um número secundário

Crie a conta, verifique o telefone e receba o crédito de boas-vindas, sem depositar (um por telefone, sujeito à campanha vigente). Conecte por QR code e rode seu primeiro envio hoje.