Comando hermes whatsapp — Referência Completa e Exemplos

Visão Geral

hermes whatsapp configura a ponte do WhatsApp (Baileys) e a pareia com sua conta do WhatsApp via código QR. É um assistente interativo — não há subcomandos. O assistente guia você na escolha do modo, configuração dos usuários permitidos, instalação das dependências da ponte e leitura do código QR. Após o pareamento, você pode conversar com o Hermes pelo WhatsApp como com qualquer outro contato.

hermes whatsapp

Requer um TTY: o assistente solicita entradas de forma interativa.

O que o assistente faz

1. Escolher um modo — um número de bot separado (recomendado) ou seu número pessoal (self-chat).
2. Definir usuários permitidos — os números de telefone autorizados a enviar mensagens ao agente (separados por vírgula, ou * para qualquer um).
3. Instalar dependências da ponte — executa npm install no diretório da ponte na primeira vez (pode levar alguns minutos).
4. Verificar sessão existente — se creds.json já existir, mantenha o pareamento atual ou refaça-o.
5. Parear via código QR — abra o WhatsApp (ou WhatsApp Business) no telefone com o número do bot, vá em Aparelhos conectados e leia o código QR exibido no terminal.
6. Iniciar o gateway — após o pareamento, execute hermes gateway para receber mensagens.

Exemplos

hermes whatsapp
# 1. Escolha o modo: 1) número de bot separado (recomendado)  2) número pessoal (self-chat)
# 2. Informe os números permitidos (separados por vírgula, ou * para qualquer um)
# 3. As dependências da ponte são instaladas automaticamente
# 4. Leia o QR com o WhatsApp → Aparelhos conectados → Conectar um aparelho
# 5. Inicie o gateway: hermes gateway

# Reexecutando o assistente com uma sessão existente
hermes whatsapp
# ✓ Sessão existente do WhatsApp encontrada — Reparear? [y/N]
# Responda 'n' para manter o pareamento atual, 'y' para limpá-lo e ler um novo QR

Dicas

• O WhatsApp só é habilitado após um pareamento bem-sucedido. Se você abortar o assistente antes do fim, a ponte permanece desativada e o gateway não tentará iniciá-la.
• A sessão (creds.json) fica em ~/.hermes/whatsapp/session/ — faça backup para evitar reparear.
• Para um bot de produção na API oficial da Meta, use hermes whatsapp-cloud — os dois adaptadores são complementares, não alternativos.