Pular para o conteúdo
apiwpp
Termo

O que é Baileys

Baileys é uma biblioteca open source em TypeScript que conecta um número ao WhatsApp pelo protocolo do WhatsApp Web, por WebSocket, sem abrir um navegador. É a base de várias APIs não oficiais, mas sozinha não traz API HTTP, fila nem webhooks.

Atualizado em

O Baileys é uma biblioteca open source, escrita em TypeScript, que fala o protocolo do WhatsApp Web diretamente. Ela se conecta aos servidores do WhatsApp por WebSocket, como um aparelho conectado, sem abrir um navegador, e permite que um programa em Node.js envie e receba mensagens em nome de um número comum.

Por usar o mesmo protocolo do WhatsApp Web, o Baileys entra na categoria das APIs não oficiais: não passa pela plataforma da Meta, não exige aprovação e não tem vínculo com o WhatsApp.

O que o Baileys faz e o que não faz

O Baileys cuida da parte mais difícil de reproduzir: o pareamento por QR code ou por código, a criptografia de ponta a ponta das mensagens e a troca de eventos com o WhatsApp. Com ele, o seu código recebe as mensagens como eventos e envia texto, mídia e outros tipos de conteúdo.

Ele é uma biblioteca, e não um serviço. Isso quer dizer que tudo em volta fica por sua conta:

Por isso o Baileys serve de base para vários servidores open source, como a Evolution API, e para serviços gerenciados de API de WhatsApp.

Self-hosted ou gerenciado

Quem quer usar o protocolo do WhatsApp Web num sistema tem dois caminhos.

Self-hosted: você usa o Baileys, ou um servidor pronto construído sobre ele, e hospeda tudo. O software é grátis e o controle é total, mas o custo aparece em servidor, banco de dados, proxies, atualizações e tempo de engenharia para operar.

Gerenciado: um serviço opera o protocolo e entrega a API pronta. Na apiwpp, que também conecta o número pelo protocolo do WhatsApp Web, isso inclui a sessão salva e criptografada, a fila anti-bloqueio com aquecimento de 14 dias, webhooks assinados com HMAC-SHA256 e novas tentativas, proxy brasileiro por número e uma página de status pública. O preço é por número conectado, por mês.

O risco de restrição do número é o mesmo nos dois caminhos, porque o protocolo é o mesmo. O que muda é quem constrói e opera as camadas que reduzem esse risco. A comparação completa está em WPPConnect e Baileys: montar a própria API ou usar a apiwpp e no guia Evolution API, Baileys e WPPConnect.

Perguntas frequentes

O Baileys é gratuito?

Sim, a biblioteca é open source e não cobra licença. O custo de quem usa está na infraestrutura e na operação: servidor, banco, proxies, monitoramento e manutenção a cada mudança do protocolo.

Qual é a diferença entre Baileys e Evolution API?

O Baileys é a biblioteca que fala o protocolo, e você escreve o serviço em volta dela. A Evolution API é um servidor open source que usa o Baileys e já entrega rotas HTTP, mas que você ainda precisa hospedar e operar.

Usar o Baileys evita o bloqueio do número?

Não. O Baileys só implementa o protocolo; ele não controla o ritmo de envio. Evitar a restrição depende de espaçar os envios, aquecer o número e falar com quem espera a mensagem, e nada garante que um número nunca será restringido.

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.

Proxy é um servidor intermediário por onde uma conexão passa antes de chegar ao destino. Para o destino, a conexão parece vir do endereço IP do proxy. Num número de WhatsApp conectado por API, esse IP é um dos sinais que o WhatsApp observa.

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.

Conecte seu primeiro número hoje.

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