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:
- lendo um QR code, que a API devolve pronto para exibir no seu sistema;
- digitando no celular um código de pareamento de 8 caracteres.
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:
- não há aprovação de conta nem de mensagens: você envia texto livre, mídia, localização e templates próprios;
- o número continua sendo um WhatsApp comum, com as conversas no celular;
- a cobrança é do serviço, e não da Meta. Na apiwpp, é por número conectado, por mês, com mensagens ilimitadas dentro dos limites da fila;
- não existe selo de conta oficial nem vínculo com a Meta. A apiwpp não é afiliada ao WhatsApp nem à Meta.
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:
- cada número tem uma fila com ritmo: 3 mensagens por minuto, 60 por hora e 200 por dia, com intervalo aleatório de 3 a 8 segundos;
- o número envia para no máximo 100 destinatários novos a cada 24 horas; acima disso, o envio responde
429com o cabeçalhoRetry-After; - um número recém-conectado passa por 14 dias de aquecimento, com limites que crescem por etapa;
- cada número sai por um proxy brasileiro, e o bloqueio temporário de novas conversas é detectado e avisado no evento
connection.status.
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.
Outros termos
Todos: Glossário →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.