Hermes Agent + WhatsApp: seu Projeto Pessoal Controlado por Mensagens

Usar o WhatsApp para conversar com uma IA é uma coisa. Usá-lo como interface para um agente que trabalha no seu projeto é outra: além da conversa, entram ferramentas, acesso a arquivos, regras e verificação dos resultados. O infográfico organiza essa preparação em seis passos.

Este guia explica o caminho de um projeto pessoal, com base na documentação oficial do Hermes Agent consultada em 12/10/2026. Não é uma instalação executada para o leitor nem uma integração pronta com qualquer blog. O WhatsApp será a interface de mensagens; o projeto continuará precisando de acesso e ferramentas adequados.

1. Prepare o ambiente e preserve os dados

Linux e WSL2 no Windows são caminhos de instalação documentados. Eles não são as únicas opções: o guia também apresenta instalação nativa no Windows. Escolha o procedimento correspondente ao seu sistema, em vez de misturar comandos de plataformas diferentes.

Se o Hermes inteiro rodar em Docker, o guia oficial utiliza armazenamento persistente montado em /opt/data para configurações, sessões, skills e memórias. Não confunda esse cenário com usar Docker apenas como ambiente de execução das ferramentas.

Cuidados de projeto: mantenha backups, disponibilize somente as pastas necessárias e não coloque dados persistentes importantes apenas na camada descartável de um container.

2. Configure o modelo e o provedor

Depois de instalar pelo guia oficial, hermes setup abre a configuração interativa. hermes model permite configurar o provedor e escolher o modelo.

hermes setup
hermes model

Configurações e credenciais têm papéis diferentes. A documentação separa opções de funcionamento em config.yaml de chaves e segredos, mantidos no arquivo de ambiente do perfil. Use os assistentes de configuração e nunca cole credenciais em artigos, repositórios ou conversas.

Decisão prática: escolha o modelo conforme a tarefa e acompanhe o consumo do provedor. Ter um agente instalado não significa que toda chamada de IA será gratuita.

3. Conecte o agente ao seu projeto

Antes de enviar pedidos pelo celular, defina o escopo: qual pasta pode ser usada, quais arquivos podem ser criados e como testar o resultado. Uma integração por API precisa das operações e permissões apropriadas; não nasce apenas porque o WhatsApp foi vinculado.

A orientação oficial para uma máquina pessoal ou de trabalho é reduzir a superfície de acesso e usar controles compatíveis com o risco. Regras de bloqueio são guardrails, não uma sandbox completa contra um processo adversarial.

Exemplo de especificação: “Você pode criar rascunhos nesta pasta. Não altere produção, não envie mensagens a terceiros e não publique sem aprovação”. Em um projeto real, complemente essas instruções com controles técnicos na integração.

4. Vincule o WhatsApp: entenda qual conexão você está usando

O caminho por QR code do infográfico utiliza uma ponte baseada em Baileys, que emula uma sessão do WhatsApp Web. Essa conexão não é a API oficial do WhatsApp Business e pode resultar em restrições na conta.

O comando hermes whatsapp inicia o assistente de vinculação. Ele apresenta o QR code, que deve ser escaneado no WhatsApp em Dispositivos conectados → Conectar um dispositivo. A documentação recomenda um número dedicado e uso conversacional, sem spam ou envio automatizado a pessoas que não iniciaram contato.

hermes whatsapp

O Hermes também documenta a WhatsApp Business Cloud API, caminho oficial da Meta. Essa alternativa não usa o pareamento por QR code: exige uma conta Meta Business e uma URL pública HTTPS para receber eventos por webhook. Não confunda a VPS onde o agente roda com o tipo de API usada para conectar o WhatsApp.

5. Restrinja contatos, ferramentas e ações

No caminho Baileys, configure uma lista de usuários autorizados ou o mecanismo de pareamento indicado na documentação. Evite liberar todos os remetentes em um agente que acessa arquivos e ferramentas. Grupos também precisam de regras próprias de acesso.

Proteger uma chave de API não basta: também é necessário proteger a sessão de WhatsApp, limitar permissões e revisar quais ferramentas o agente pode usar. O modelo de segurança do Hermes inclui aprovação de comandos perigosos e controles sobre arquivos sensíveis, mas isso não substitui uma política da aplicação.

Aprovação não deve ser presumida para toda ação. O guia informa que o modo smart pode aprovar comandos considerados de baixo risco. Para publicar um artigo, enviar uma mensagem ou mudar produção, estabeleça uma aprovação explícita no fluxo do seu projeto.

6. Inicie o gateway e teste um pedido pequeno

O gateway conecta o Hermes às plataformas de mensagens. A documentação apresenta execução em primeiro plano e formas de operação como serviço. O comando do infográfico, hermes gateway run, pertence a esse componente.

hermes gateway run
# Em outro terminal, consulte o estado:
hermes gateway status

Como primeiro teste, peça um arquivo de rascunho, confira se ele realmente foi criado e teste a entrega pelo canal. Verifique conteúdo, caminho, formato e permissão antes de ampliar o escopo. Uma resposta dizendo “concluído” não prova, por si só, que a operação aconteceu.

O gateway possui suporte para entrega de mídias. Isso não significa que qualquer arquivo terá a mesma apresentação em todas as plataformas: valide o tipo de arquivo e o comportamento do adaptador que você escolheu.

Exemplo: mensagem, rascunho, aprovação e publicação

O exemplo do infográfico é uma integração a implementar, não uma funcionalidade automática de qualquer blog. Considere este cenário fictício:

1. Mensagem: “Crie um rascunho sobre pipelines de dados. Não publique ainda”.
2. Preparação: o agente usa as ferramentas autorizadas para consultar fontes e criar o conteúdo no ambiente de trabalho.
3. Revisão: você recebe o rascunho e confere texto, imagens e fontes.
4. Aprovação: você autoriza aquela publicação específica, no ambiente combinado.
5. Execução: a integração publica e o agente verifica o endereço e o resultado antes de confirmar a entrega.

Separe criar conteúdo, disponibilizar uma prévia e publicar em produção. São operações diferentes e não precisam compartilhar as mesmas permissões.

Local ou na nuvem: quem mantém o serviço funcionando?

Em uma execução local, mantenha a máquina com internet e o gateway ativo. Se o processo terminar, uma configuração anterior não basta para continuar recebendo pedidos. A documentação oferece instalação do gateway como serviço para operação contínua.

Hospedar o agente em uma VPS muda onde o processo fica executando, não elimina a necessidade de mantê-lo ativo. Planeje persistência, atualizações, backups, segurança e custos. A escolha de hospedagem também não transforma a ponte Baileys em uma integração oficial da Meta.

Comece com um pedido pequeno, acesso limitado e resultado verificável. Amplie a autonomia somente quando os controles e o fluxo de aprovação estiverem claros.