Novidades no Hermes v2026.7.7: WhatsApp Simplificado, Autocorreção no Windows e Mais

Olá, fãs do Hermes! A atualização mais recente chegou, e é grande. Focamos em facilitar ao máximo a configuração do WhatsApp, adicionamos melhorias sérias de estabilidade para usuários do Windows e refinamos algumas coisas nos bastidores. Vamos mergulhar.

WhatsApp: Agora com Ponte Integrada (Sem Precisa de Conta Meta)

Uma das adições mais empolgantes é a nova integração com o WhatsApp. O Hermes agora se conecta ao WhatsApp através de uma ponte integrada baseada no Baileys. Pense nisso como emular uma sessão do WhatsApp Web — sem conta de desenvolvedor Meta, sem verificação de negócios, sem complicação.

Início rápido: Basta executar hermes gateway setup e escolher WhatsApp para um passo a passo guiado.

Duas Maneiras de Usar

Modo	Como funciona	Melhor para
Número separado para o bot (recomendado)	Dedique um número de telefone ao bot. As pessoas enviam mensagem diretamente para esse número.	UX limpa, múltiplos usuários, menor risco de bloqueio
Conversa pessoal (self-chat)	Use seu próprio WhatsApp. Você envia mensagem para si mesmo para falar com o agente.	Configuração rápida, usuário único, testes

Um Alerta Importante

O WhatsApp não suporta oficialmente bots de terceiros fora da API Business. Usar esta ponte traz um pequeno risco de restrições na conta. Para se manter seguro:

Use um número de telefone dedicado para o bot (não o seu pessoal)
Não envie mensagens em massa ou spam — mantenha o tom de conversa
Não automatize mensagens de saída para pessoas que não falaram com você primeiro

Além disso, o WhatsApp atualiza periodicamente o protocolo Web, o que pode quebrar temporariamente a compatibilidade. Se o bot parar de funcionar após uma atualização do WhatsApp, basta baixar a versão mais recente do Hermes e parear novamente.

Configurando o WhatsApp: Passo a Passo

Passo 1: Execute o Assistente de Configuração

hermes whatsapp

O assistente vai:

Perguntar qual modo você quer (bot ou self-chat)
Instalar as dependências da ponte, se necessário
Exibir um código QR no seu terminal
Aguardar você escaneá-lo

Para escanear o código QR:

Abra o WhatsApp no seu celular
Vá em Configurações → Aparelhos conectados
Toque em Conectar um aparelho
Aponte a câmera para o código QR no terminal

Dica: Se o código QR parecer distorcido, verifique se o seu terminal tem pelo menos 60 colunas de largura e suporta Unicode.

Passo 2: Obtendo um Segundo Número de Telefone (Modo Bot)

Para o modo bot, você precisa de um número que ainda não esteja registrado no WhatsApp. Aqui estão suas opções:

Opção	Custo	Observações
Google Voice	Grátis	Somente EUA. Verifique o WhatsApp via SMS pelo aplicativo Google Voice.
Chip pré-pago	US$ 5–15 únicos	Ative, verifique, e o chip pode ficar guardado na gaveta. Mantenha ativo com uma ligação a cada 90 dias.
Serviços VoIP	Grátis–US$ 5/mês	TextNow, TextFree, etc. Alguns números são bloqueados — tente alguns.

Passo 3: Configure o Hermes

Adicione isto ao seu arquivo ~/.hermes/.env:

# Obrigatório
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" ou "self-chat"

# Controle de acesso — escolha UM:
WHATSAPP_ALLOWED_USERS=15551234567         # Números separados por vírgula (código do país, sem +)
# WHATSAPP_ALLOWED_USERS=*                 # OU permita todos
# WHATSAPP_ALLOW_ALL_USERS=true            # OU esta flag (igual a *)

Configurações opcionais de comportamento em ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair é o padrão global — remetentes desconhecidos de DM recebem um código de pareamento.
whatsapp.unauthorized_dm_behavior: ignore mantém o WhatsApp silencioso para DMs não autorizadas — geralmente melhor para um número privado.

Depois, inicie o gateway:

hermes gateway              # Em primeiro plano
hermes gateway install      # Instalar como serviço do usuário
sudo hermes gateway install --system   # Apenas Linux: serviço do sistema na inicialização

Persistência da Sessão

A ponte salva a sessão em ~/.hermes/platforms/whatsapp/session. Isso significa que:

As sessões sobrevivem a reinicializações — sem precisar escanear QR codes toda vez
Os dados da sessão incluem chaves de criptografia e credenciais do dispositivo
Não compartilhe nem faça commit deste diretório de sessão — ele concede acesso total à conta

Repareamento

Se a sessão quebrar (reset do celular, atualização do WhatsApp, desvinculação manual), você verá erros de conexão nos logs do gateway. Basta executar hermes whatsapp novamente para gerar um novo código QR e reparar.

Autocorreção e Estabilidade no Windows

Também adicionamos capacidades de autocorreção para o Windows. O gateway agora detecta e se recupera automaticamente de falhas comuns de serviço, reduzindo o tempo de inatividade e a intervenção manual. Isso faz parte do nosso compromisso contínuo em tornar o Hermes extremamente confiável em todas as plataformas.

Considerações Finais

Esta atualização tem tudo a ver com tornar o Hermes mais acessível e confiável. Seja configurando o WhatsApp pela primeira vez ou rodando um bot em produção, estamos aqui para ajudar. Como sempre, baixe a versão mais recente e nos conte como foi!

Boas automações! 🚀