Pular para o conteúdo
apiwpp
Termo

O que é API não oficial do WhatsApp

API não oficial do WhatsApp é um serviço que conecta um número comum pelo protocolo do WhatsApp Web, como um aparelho conectado, e expõe envio e recebimento de mensagens por HTTP. Não passa pela Meta: não exige aprovação, mas o número pode ser restringido.

Atualizado em

Uma API não oficial do WhatsApp é um serviço que liga o seu sistema a um número de WhatsApp comum sem passar pela plataforma da Meta. O número é conectado da mesma forma que você conecta o WhatsApp Web no computador: lendo um QR code no celular. A partir daí, o serviço envia e recebe mensagens em nome desse número e oferece tudo isso por chamadas HTTP e webhooks.

"Não oficial" descreve o caminho técnico, não a legalidade do uso. Quer dizer que o acesso não é feito pela API que a Meta vende para empresas, a WhatsApp Cloud API, e sim pelo mesmo protocolo que o WhatsApp Web usa.

Como funciona

O número entra como um aparelho conectado, o mesmo recurso que o WhatsApp oferece em Aparelhos conectados > Conectar um aparelho. Na apiwpp, você conecta o número de dois jeitos:

Depois disso, a sessão fica salva e criptografada nos servidores. Reinícios e atualizações não pedem um QR code novo, e o celular não precisa ficar ligado. O seu sistema envia com POST /connections/{id}/send e recebe as respostas por webhook.

Diferença para a API oficial

A diferença principal está em quem controla o acesso. Na Cloud API, a Meta aprova a conta, aprova os modelos de mensagem usados fora da janela de atendimento e cobra por mensagem. Numa API não oficial:

A comparação completa, critério por critério, está em apiwpp ou API oficial.

Riscos e como são reduzidos

O risco real de uma API não oficial é o número ser restringido pelo WhatsApp. O WhatsApp observa comportamentos típicos de robô: muitas mensagens em pouco tempo, envios para quem nunca falou com o número, denúncias. Nenhum serviço pode garantir que um número nunca será bloqueado, e desconfie de quem promete isso.

O que um bom serviço faz é tornar o comportamento do número parecido com o de uma pessoa. Na apiwpp, por padrão:

Mesmo assim, a regra de ouro é de uso: fale com quem já é cliente ou pediu para receber. Para campanhas em massa para listas frias, a API oficial é a escolha honesta. O guia como evitar o bloqueio do número detalha as boas práticas.

Quando faz sentido

Uma API não oficial é uma boa escolha para notificações, lembretes, atendimento e integração de sistemas com clientes que já conversam com a empresa, quando você quer começar sem burocracia e com custo previsível por número. Para decidir entre os dois modelos, leia API oficial ou não oficial do WhatsApp.

Perguntas frequentes

A API não oficial tem ligação com o WhatsApp ou a Meta?

Não. Ela usa o mesmo protocolo do WhatsApp Web, mas não é um produto da Meta, e a apiwpp não é afiliada ao WhatsApp nem à Meta. Por isso o número pode ser restringido pelo WhatsApp: use um número dedicado à integração e respeite o ritmo de envio.

Preciso deixar o celular ligado?

Não. O número funciona como um aparelho conectado, e a sessão fica salva nos servidores. O celular só é necessário para conectar o número pela primeira vez ou para conectar de novo depois de um logout.

Posso usar a API não oficial com um número que já uso no celular?

Sim, o número continua funcionando no celular, como acontece com o WhatsApp Web. Se quiser que o seu sistema saiba do que foi digitado no aparelho, ative o evento opcional message.outgoing, que informa a origem de cada mensagem enviada: pela API ou pelo celular.

A API não oficial envia mensagens com botões?

Hoje a apiwpp envia texto, mídia, localização, templates com variáveis e reações. Enquetes e administração de grupos estão em desenvolvimento, e mensagens interativas com botões não fazem parte da oferta atual.

WhatsApp Cloud API é a API oficial do WhatsApp para empresas, hospedada pela Meta como parte da WhatsApp Business Platform. Exige conta comercial, usa modelos de mensagem aprovados para iniciar conversas e é cobrada pela Meta por mensagem.

Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora.

HMAC é um código calculado a partir de uma mensagem e de um segredo compartilhado, com uma função de hash como SHA-256. Quem tem o segredo recalcula o código e confirma que a mensagem veio de quem diz e não foi alterada no caminho.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.