Baileys, Venom ou API oficial: qual usar para bot de WhatsApp

Escolher entre Baileys, Venom ou API oficial para um bot de WhatsApp envolve três decisões: como integrar, onde manter a aplicação e como estimar o custo das mensagens. A biblioteca muda a arquitetura do serviço. A cobrança da Meta segue suas próprias regras, e a hospedagem continua sendo uma despesa separada.

Cobrança revisada em 28/09/2026: a documentação oficial anuncia mudanças para 1º de outubro. Portanto, não é correto projetar os próximos meses supondo que todo atendimento reativo será gratuito. A consulta às versões das bibliotecas, identificada abaixo, permanece como registro de 19/08/2026; não foi reapresentada como levantamento atual.

O que muda entre as formas de integração

Baileys conecta por WebSocket, enquanto Venom e whatsapp-web.js usam automação de navegador. São projetos não oficiais. A Cloud API é a integração oferecida pela Meta e trabalha com requisições HTTP e webhooks. Consulte as referências dos próprios projetos: Baileys, Venom, whatsapp-web.js e Cloud API.

Essas arquiteturas exigem cuidados diferentes. Uma aplicação com sessão precisa preservar esse estado entre reinícios. Uma aplicação que executa Chromium precisa acomodar o navegador e suas dependências. Um webhook precisa receber eventos, validar requisições e lidar com repetição de entregas sem duplicar a ação do bot.

Antes de escolher, descreva o fluxo esperado: quem envia a primeira mensagem, quais respostas o bot dá, quando precisa chamar uma pessoa e o que acontece se houver falha. Essa descrição revela requisitos que uma comparação baseada apenas em memória ou facilidade de instalação deixa de fora.

Versões das bibliotecas: registro da consulta anterior

A tabela a seguir documenta a consulta feita em 19/08/2026, na publicação original. Ela permite entender as observações daquele momento e não indica a versão recomendada para instalar agora.

Biblioteca	Versão identificada naquela consulta	Ponto observado em 19/08/2026
Baileys	7.0.0-rc14 na linha consultada	Havia uma versão candidata e uma linha legacy separada
whatsapp-web.js	1.34.7	Operação com Chromium via Puppeteer
venom-bot	5.3.0 no npm	A versão publicada diferia da reescrita apresentada no repositório

Para um projeto novo ou uma atualização, confira novamente o registro, as notas de versão e os avisos de segurança. Não copie uma versão deste artigo para o ambiente de produção apenas porque ela aparece na tabela. Compare o pacote que será instalado com a documentação daquela mesma versão e teste o fluxo completo em um ambiente separado.

Fixar dependências e manter o lockfile ajuda a identificar o que foi publicado. Também é necessário definir quem acompanha atualizações e como reverter um deploy. Uma instalação bem-sucedida não demonstra, sozinha, que todos os recursos usados pelo seu bot continuam funcionando.

O que a Meta cobra até setembro e a partir de outubro

A documentação de preços da Meta, consultada diretamente em 28/09/2026, distingue as regras em vigor das próximas alterações. A documentação de mensagens sem template detalha a mudança das mensagens de serviço.

Tipo de mensagem entregue	Até 30/09/2026	A partir de 01/10/2026, conforme anunciado
Serviço, sem template, dentro da janela de atendimento	Sem cobrança de mensagem	Franquia mensal de 1.000 mensagens por número comercial; excedente tarifado
Template de utilidade dentro da janela de atendimento	Sem cobrança de mensagem	Passa a ser tarifado
Templates fora das condições gratuitas	Cobrança conforme categoria e mercado	Conferir a tabela de tarifas vigente em outubro

A janela de atendimento dura 24 horas desde a última mensagem do usuário. Ela permite enviar mensagens sem template; permissão de envio e gratuidade são condições diferentes. A franquia de serviço é compartilhada entre mensagens individuais e de grupo e não acumula para o mês seguinte. Sem forma de pagamento, a documentação atual prevê entrega dentro da franquia, mas não depois de esgotá-la.

Há ainda a janela de ponto de entrada gratuito: em condições específicas de anúncio de clique para WhatsApp ou botão de Página do Facebook, uma resposta em até 24 horas abre 72 horas de gratuidade. Isso não elimina a exigência de janela de atendimento aberta para mensagens sem template. Não aplique essa exceção a toda conversa.

Como estimar a conta sem prometer custo zero

Separe sua previsão em três componentes:

Componente	O que levantar	Onde conferir
Hospedagem	Recursos da aplicação, armazenamento e serviços auxiliares	Plano contratado para manter o app no ar
Mensagens	Entregas por categoria, mercado e condição de cobrança	Tabela e relatórios da Meta
Provedor ou ferramenta intermediária	Mensalidade, licença ou cobrança adicional, se houver	Proposta e contrato do serviço escolhido

Exemplo fictício: em outubro, um único número entrega 1.800 mensagens de serviço individuais, sem mensagens de grupo ou condições especiais de gratuidade. Considerando a franquia anunciada de 1.000, restam 800 entregas para aplicar a tarifa correspondente. Isso não significa R$ 800 e não inclui templates, hospedagem ou provedor. O exemplo serve para mostrar a quantidade que entra no cálculo, sem inventar uma tarifa.

Outro projeto pode ter menos mensagens de serviço e muitos templates de utilidade. Nesse caso, usar apenas o volume total esconde a composição da despesa. Registre categorias separadamente e acompanhe mensagens entregues, não apenas tentativas de envio.

Para converter a previsão em orçamento, escolha a tabela do período, a moeda da conta e o mercado do destinatário. Some as parcelas aplicáveis e compare depois com o faturamento real. Se não houver histórico, documente suas hipóteses para revisá-las quando o app começar a operar.

E a cobrança em reais?

A página de preços da Meta também informa a localização de cobrança no Brasil para clientes qualificados. Ela estabelece migração das contas para BRL até 30/06/2027 e interrupção de entregas das contas não migradas a partir de 01/07/2027. Confira a elegibilidade e a situação de cada conta na Central de Cobrança; não presuma que pagar sua hospedagem em reais converte automaticamente a conta da Meta.

O que conferir na hospedagem do bot

Para Baileys, o ponto de atenção é a sessão: onde fica, quem tem acesso e como sobrevive a um redeploy. Evite depender exclusivamente de arquivos gravados no sistema temporário de um container. Defina também como a aplicação reconecta e como informa uma falha de autenticação. O guia de hospedagem de bot de WhatsApp aprofunda esse desenho operacional.

Com uma biblioteca que utiliza Chromium, confira dependências de sistema, inicialização do navegador e consumo de memória durante um fluxo representativo. Meça o comportamento, em vez de escolher um plano só pela memória em repouso. Quando precisar controlar a imagem de execução, consulte o guia de deploy com Dockerfile.

Na integração oficial, o aplicativo continua precisando de infraestrutura para o webhook e para as regras de negócio. Teste recebimento, resposta, persistência e tratamento de eventos repetidos. Armazene credenciais como segredos do ambiente e evite registrá-las nos logs. A infraestrutura da Meta não substitui o serviço que consulta sua agenda, cria um pedido ou encaminha o atendimento.

Como decidir para o seu caso

Se o WhatsApp participa do atendimento ao cliente, avalie primeiro a integração oficial e os requisitos de conta, templates e operação. Usá-la não significa imunidade a restrições: continuam existindo políticas, limites e condições de qualidade. Inclua falhas de entrega e encaminhamento para atendimento humano nos testes.

Se você está avaliando uma biblioteca não oficial para um experimento, confira as condições de uso aplicáveis e o suporte efetivo aos recursos necessários. Nenhuma escolha de hospedagem transforma uma integração não oficial em oficial ou garante a continuidade do número. Considere o custo de refazer o fluxo caso a integração deixe de funcionar.

Para comparar propostas, peça uma descrição do que está incluído em cada uma. “Bot de WhatsApp” pode significar apenas o código, a hospedagem, uma ferramenta completa de atendimento ou uma combinação desses serviços. Uma proposta sem discriminar esses componentes dificulta entender tanto o preço quanto a responsabilidade por uma falha.

Perguntas frequentes

Um bot que só responde mensagens continuará gratuito?

Não é uma premissa segura para o orçamento. A partir de 01/10/2026, a Meta anuncia cobrança de mensagens de serviço acima da franquia e de utilidade dentro da janela de atendimento. Além disso, hospedagem e eventual provedor têm suas próprias condições.

A mensalidade de hospedagem inclui as mensagens da Meta?

Não presuma isso. São componentes distintos. Confira a oferta contratada e quem fatura cada serviço. Um preço para manter o app no ar não informa, por si só, o custo das mensagens.

Dá para migrar de Baileys para a Cloud API?

Planeje mudanças na integração e no fluxo, não apenas a troca de um pacote. A aplicação passa a trabalhar com webhooks, credenciais, templates e requisitos da conta oficial. Teste os casos de uso e o encaminhamento de falhas antes de substituir a operação existente.

Qual versão de Baileys ou Venom devo instalar?

Confira a distribuição atual, suas notas e avisos de segurança. A tabela deste artigo é um registro de agosto, não uma recomendação atual de versão. Valide o pacote e os recursos utilizados antes de publicar.

Para colocar a aplicação no ar, consulte os planos da Upuai e defina o que precisa testar durante os 15 dias de teste. Inclua na validação o fluxo de mensagens e a estimativa das cobranças externas, além dos recursos de hospedagem.