Pular para o conteúdo principal

O que funciona

O Hermes fica ouvindo seu WhatsApp por um pequeno plugin do zapbip. Você escreve primeiro ou responde uma pergunta depois, e a mensagem chega na sessão do Hermes.

Mensagens encaminhadas

Uma mensagem que você encaminhou de outra pessoa chega ao Hermes com um aviso de que não foi você quem escreveu, então ele não a trata como uma instrução sua.

Como ela escuta

Tipo: Local. Enquanto uma pergunta está aberta, o Hermes espera até 50 segundos por vez. Se você não respondeu, a espera termina como pendente e o Hermes chama de novo, quantas vezes for preciso, sem limite de tempo. O plugin mantém uma conexão aberta com o zapbip, sem limite de tempo. Se a rede cair, ele reconecta sozinho, esperando um pouco mais a cada tentativa que falha (1 segundo no começo, 30 segundos no máximo). As mensagens que você enviar nesse meio tempo esperam na sua caixa de entrada do zapbip, e o plugin pega todas as que ficaram sem resposta assim que volta.

Se o plugin não puder ser instalado

O Hermes pode consultar a caixa de entrada. Adicione o servidor MCP da configuração e crie uma tarefa a cada 1 minuto que chama check_inbox. Suas mensagens esperam até um minuto, e a resposta volta do mesmo jeito.

Configure do zero

O que você precisa

  • O Hermes com o gateway rodando.
  • Seu link de conexão, o mesmo link https://.../c/<secret>/mcp que sua IA usa para falar com o zapbip. Trate-o como uma senha.

Instale o plugin

Instale o pacote no ambiente Python em que o Hermes roda:
Depois ative-o em ~/.hermes/config.yaml:
Defina o link e quem pode falar com o Hermes no ambiente em que o gateway roda, nunca em um arquivo que você compartilha:
O arquivo que guarda seu link de conexão funciona como uma senha. Dê a ele a permissão 600, para que só o seu usuário consiga ler, e nunca o compartilhe nem o envie para o Git:
Reinicie o gateway. Rode apenas um listener por agente: o plugin ou npx zapbip@0.1.0 listen, nunca os dois. Um segundo listener substitui o primeiro.

Como o Hermes responde

O Hermes envia as respostas às suas mensagens pelo próprio plugin, sem configuração extra. Adicione o zapbip como servidor MCP para o Hermes também puxar conversa com você, fazer uma pergunta com botões e esperar a resposta, e usar a consulta periódica abaixo:
Depois peça ao Hermes no WhatsApp para enviar ✅ instalado. Se essa mensagem chegar, está funcionando.

Confira se funciona