Como Implantar O Hermes Agent No WhatsApp

O WhatsApp é o app de mensagens que dois bilhões de pessoas abrem todo dia, então parece o lugar óbvio para colocar o seu agente de IA. Aí você começa a configuração e descobre que é o canal mais difícil para implantar um agente pessoal - e a Meta passou 2026 deixando-o ainda mais difícil.

Este guia percorre o que realmente é preciso para o Hermes Agent conversar pelo WhatsApp: as credenciais e o webhook que você precisa, os custos e limites que pegam as pessoas de surpresa, e a resposta honesta sobre se você deveria sequer fazer isso.

Antes De Começar: WhatsApp Não É Telegram

Se você leu Como Implantar O Hermes Agent No Telegram, esqueça o prazo de cinco minutos. O WhatsApp dá duas formas de entrar, e ambas têm pegadinha:

A WhatsApp Business Cloud API oficial (operada pela Meta). É o caminho suportado e durável. Exige uma conta Meta Business, verificação do negócio, um número de telefone dedicado, um webhook público e cobrança por mensagem.
Bibliotecas não oficiais (WAHA, Baileys e similares) que automatizam o WhatsApp Web. Gratuitas e rápidas, mas violam os termos do WhatsApp e carregam um risco real de banimento permanente do número - mais sobre isso adiante.

Para uma implantação na qual você possa confiar, você quer a Cloud API oficial. Toda a seção de configuração assume esse caminho.

O Que Você Precisa Para Implantar O Hermes No WhatsApp

Uma implantação funcional tem quatro credenciais e uma peça de infraestrutura. Reúna todas antes de mexer na configuração do Hermes.

1. Uma conta Meta Business e um app da Cloud API

Faça login no Meta for Developers, crie um app do tipo Business e adicione o produto WhatsApp a ele. A Meta fornece um número de teste em um sandbox imediatamente, para você experimentar antes de verificar um negócio real.

2. Um phone number ID e um WhatsApp Business Account ID

Dentro da configuração de WhatsApp do app, registre o número de telefone comercial pelo qual as mensagens vão fluir. A Meta então mostra dois valores que você deve guardar: o Phone Number ID e o WhatsApp Business Account (WABA) ID. Eles identificam por qual número e qual conta o Hermes envia - não são o número de telefone em si.

3. Um token de acesso permanente

O token temporário que a Meta mostra na tela de configuração expira em 24 horas, o que serve para um primeiro teste e é inútil para uma implantação. Para algo real, crie um System User em Business Settings, atribua a ele o seu app e a sua conta de WhatsApp com controle total, e gere um token permanente. Essa é a credencial que o Hermes usa para autenticar cada envio.

4. Um endpoint de webhook público

Esta é a parte que o Telegram não precisa. O WhatsApp envia as mensagens recebidas para uma URL que você hospeda, então o Hermes precisa de um endpoint HTTPS público com um certificado válido. Você registra a URL mais um verify token de sua escolha no Meta Business Manager, e a Meta faz um aperto de mão único chamando o seu endpoint com um valor hub.challenge que você deve devolver. Uma vez verificado, cada mensagem recebida chega como um webhook que o seu gateway deve responder com um HTTP 200 em menos de 30 segundos.

Conectando O WhatsApp Ao Hermes

Com as quatro peças em mãos, o lado do Hermes parece familiar se você já configurou o gateway do Telegram. No config.yaml, adicione o seu provedor e as credenciais do WhatsApp:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here

whatsapp_phone_number_id: "123456789012345"
whatsapp_business_account_id: "987654321098765"
whatsapp_access_token: EAAG...your-permanent-token
whatsapp_verify_token: a-long-random-string-you-choose
whatsapp_allowed_users: "15551234567"

Dois campos merecem atenção. O whatsapp_verify_token deve coincidir exatamente com o valor que você digitou no Meta Business Manager ao registrar o webhook, caso contrário o aperto de mão falha em silêncio. O campo whatsapp_allowed_users é a sua trava de segurança: o Hermes só responde aos números listados aqui (em formato internacional completo, sem +), de modo que um desconhecido que escreva para o seu número comercial não consiga queimar os seus créditos de modelo.

Iniciar O Gateway

Suba o gateway de mensagens do mesmo jeito que faria para qualquer canal:

hermes gateway start --detach

O gateway expõe a rota do webhook, valida a assinatura da Meta em cada requisição, encaminha o corpo da mensagem para o runtime do Hermes e publica a resposta do agente de volta pela Cloud API. Confirme que está vivo com hermes gateway status e envie uma mensagem de teste de um número autorizado.

Os Custos E Limites Que Ninguém Menciona

É aqui que o WhatsApp diverge nitidamente de uma plataforma de bots gratuita, e onde muitas implantações se desfazem em silêncio.

O WhatsApp passou para preços por mensagem em meados de 2025. Cada mensagem que o seu agente inicia é cobrada por categoria e país do destinatário, cerca de 0,004 a 0,046 dólares para mensagens de utilidade e até uns 0,14 dólares para mensagens de marketing em países de custo mais alto. A própria API oficial fica numa faixa de 0-99 dólares por mês antes dessas tarifas por mensagem, e a maioria das equipes adiciona uma margem de um Business Solution Provider por cima.

Pior para um agente especificamente é a janela de atendimento ao cliente de 24 horas. Depois que um usuário te escreve, você pode responder livremente por 24 horas. Quando essa janela fecha você não pode enviar uma mensagem de formato livre - apenas um modelo pré-aprovado, e cada envio de modelo é cobrado. Um agente pessoal é proativo por natureza: ele te avisa com um resumo matinal, te diz que uma tarefa longa terminou, te lembra de uma fatura três dias depois. Cada uma dessas cai fora da janela, então no WhatsApp vira um envio de modelo pago. Detalhamos tudo em Telegram vs WhatsApp Para Um Agente De IA.

O Atalho Não Oficial (E Por Que Ele Sai Pela Culatra)

Pesquise "bot de WhatsApp grátis" e você vai encontrar WAHA, Baileys e uma dúzia de invólucros em torno do WhatsApp Web. Eles são genuinamente rápidos de montar e não custam nada em tarifas de mensagem. Também são uma armadilha para qualquer implantação que importe para você.

Essas bibliotecas são feitas por engenharia reversa e violam os termos de serviço do WhatsApp. A Meta opera um sistema de detecção de várias camadas - impressão digital de registro, análise de comportamento, denúncias de usuários, padrões de conteúdo - e endureceu a fiscalização contra chatbots de IA de terceiros no início de 2026. O resultado realista de rodar um gateway não oficial auto-hospedado em qualquer volume é um banimento permanente do número que você usou. Para um teste descartável em um SIM reserva, tudo bem. Para o número pelo qual os seus contatos de fato te encontram, não vale a pena.

Falhas Mais Comuns

O webhook nunca verifica. O verify token no config.yaml não coincide com o do Meta Business Manager, ou o seu endpoint não está acessível por HTTPS com um certificado válido. A Meta precisa devolver o hub.challenge com sucesso antes de enviar uma única mensagem.

As mensagens chegam mas o Hermes nunca responde. Ou o gateway não está rodando (hermes gateway status) ou o remetente não está em whatsapp_allowed_users. Verifique se o número está em formato internacional completo e sem +.

O token funciona por um dia e depois tudo para. Você implantou com o token temporário de 24 horas em vez do token permanente de System User. Gere o permanente de novo e atualize a sua configuração.

As mensagens proativas falham em silêncio. Você está tentando enviar fora da janela de 24 horas sem um modelo aprovado. Isso é uma regra da plataforma, não um bug - é a razão central pela qual os agentes sofrem no WhatsApp. A mentalidade de diagnóstico do guia de resolução de problemas do Telegram se transfere para qualquer gateway que você rode.

$Mesa escura de escritório em casa à noite, um telefone virado para cima mostrando um balão de mensagem verde, uma fraca luz de status de servidor piscando ao fundo$

Mantendo Tudo No Ar

Mesmo depois que o bot responde, você assume uma responsabilidade contínua que não existe em canais mais simples: um endpoint HTTPS público que precisa continuar no ar e com certificado válido, um token permanente que não pode vazar, aprovações de modelo para gerenciar e uma conta por mensagem para vigiar. O gateway funciona enquanto o processo e o endpoint estiverem saudáveis, e fica mudo no instante em que qualquer um deles cai. Em um notebook ou em um contêiner reciclado, isso acontece com mais frequência do que você gostaria.

O Telegram É O Melhor Lar Para Um Agente Pessoal

Afastando-se da mecânica de configuração, o veredito é difícil de contestar: para um agente de IA pessoal, o Telegram vence em todos os eixos que importam.

Aberto e gratuito. A Bot API do Telegram é pública, documentada e não custa nada por mensagem. A Cloud API do WhatsApp é fechada atrás da verificação do Meta Business e cobra por conversa.
Proativo por padrão. O seu agente pode te escrever assim que uma tarefa termina, toda manhã, ou três dias depois sobre uma fatura - sem janela de 24 horas, sem modelos pré-aprovados, sem taxa por mensagem.
No ar em minutos, não semanas. Sem verificação de empresa, sem número dedicado, sem um webhook público com certificado válido para manter vivo.
Sem risco de banimento. Você está sobre uma API suportada e de primeira classe - não sobre uma biblioteca de engenharia reversa a uma varredura de detecção de perder o seu número.

O WhatsApp pode ser feito funcionar se você realmente precisa desse canal específico e aceita o custo e a carga operacional. Para todo o resto, o Telegram é simplesmente a escolha padrão mais sensata.

Pule A Configuração: Rode O Seu Agente No Telegram Com O Hermify

O Hermify é um host gerenciado de Hermes Agent, e integra nativamente com o Telegram - o canal feito exatamente para esse tipo de agente pessoal sempre ativo. Você traz uma chave de modelo, o runtime é provisionado em infraestrutura gerenciada e você escreve para o seu agente como para qualquer outro contato. Sem servidor para cuidar, sem webhook para manter vivo, sem conta por mensagem.

Isso te dá um agente persistente que se lembra de você, executa skills agendadas e vive no seu bolso - funcionando assim que você termina o cadastro, não depois de uma fila de verificação do Meta.

Comece com o Hermify e o seu agente estará no ar no Telegram em minutos.