Hermes Agent: Mensagens Multi-Plataforma

Última atualização: 2026-08-31

Multi-plataforma é a capacidade de comunicação do Hermes — um Agent servindo simultaneamente no Telegram, Discord e Slack, como se você tivesse múltiplos clones.

💡 Dica: A integração de plataformas do Hermes não é simples encaminhamento de mensagens — cada plataforma mantém memória e habilidades completas, com formato de mensagem adaptado automaticamente.

📋 Pré-requisitos: Lição 3 — Arquivos de Configuração

1. O Que Você Vai Aprender

# Conteúdo
Lista de plataformas suportadas
Configuração de cada plataforma
Fluxo de processamento de mensagens
Adaptação de características por plataforma
Roteamento de mensagens multi-plataforma

2. História

(1) Problema: Plataformas Diferentes, Bots Diferentes

Bob usa Telegram para conversar com colegas, Slack para trabalho, Discord para comunidades. Cada plataforma tem seu próprio Bot, memória não compartilhada, habilidades não sincronizadas.

(2) Solução: Um Agent, Cobertura Total

O Hermes da Alice se conecta a todas as plataformas simultaneamente:

BASH
# Um Hermes, três entradas
Telegram: @AliceHermesBot
Slack:    Hermes App
Discord:  Hermes#1234

# Memória e habilidades totalmente compartilhadas
No Slack: "Ajude-me a revisar código"
→ No Telegram: "Continue aquela revisão"
→ O Agent sabe que é a mesma conversa

3. Plataformas Suportadas

Plataforma Tipo Formato Arquivos Grupos
Telegram Bot Markdown ✅ Imagens/Arquivos
Discord Bot Markdown ✅ Imagens/Anexos
Slack App mrkdwn ✅ Arquivos ✅ Canais
WhatsApp Business Texto puro ✅ Imagens/Docs
Signal Bot Texto puro ✅ Imagens
Twitter/X Bot Texto puro ✅ Imagens
Email IMAP/SMTP HTML/Texto ✅ Anexos
Web Chat Personalizado Markdown ✅ Upload drag&drop
CLI Terminal ANSI
VS Code Extensão Markdown ✅ Workspace
REST API HTTP JSON ✅ Base64
n8n Workflow JSON
Home Assistant Casa Inteligente Texto puro
Custom Personalizado Configurável Configurável Configurável

4. Configuração de Plataformas

(1) Telegram

YAML
platforms:
  telegram:
    enabled: true
    token: "${TELEGRAM_BOT_TOKEN}"
    parse_mode: "MarkdownV2"
    max_message_length: 4096
    allowed_users:
      - 123456789
    allowed_chats:
      - -1001234567890
    features:
      voice_messages: true
      photos: true
      files: true
      inline_queries: true
BASH
hermes config set platforms.telegram.token "your-token"
hermes platform start telegram

(2) Discord

YAML
platforms:
  discord:
    enabled: true
    token: "${DISCORD_BOT_TOKEN}"
    guilds:
      - id: "123456789"
        channels: ["general", "dev", "ai-help"]
    allowed_roles:
      - "Developer"
      - "Admin"
    features:
      slash_commands: true
      thread_support: true
      reactions: true
      embeds: true

(3) Slack

YAML
platforms:
  slack:
    enabled: true
    bot_token: "${SLACK_BOT_TOKEN}"
    app_token: "${SLACK_APP_TOKEN}"
    workspace: "my-team"
    channels:
      - "general"
      - "dev-help"
      - "ai-assistant"
    features:
      app_mentions: true
      direct_messages: true
      thread_replies: true
      file_sharing: true

(4) WhatsApp

YAML
platforms:
  whatsapp:
    enabled: true
    phone_number_id: "${WHATSAPP_PHONE_ID}"
    access_token: "${WHATSAPP_TOKEN}"
    verify_token: "${WHATSAPP_VERIFY_TOKEN}"
    webhook_url: "https://your-domain.com/webhook/whatsapp"

5. Fluxo de Processamento de Mensagens

(1) Pipeline Unificado de Mensagens

100%
graph LR
    A[Telegram] --> M[Pipeline de Mensagens]
    B[Discord] --> M
    C[Slack] --> M
    D[WhatsApp] --> M
    M --> P[Análise de Mensagem]
    P --> Q[Verificação de Permissão]
    Q --> R[Recuperação de Memória]
    R --> S[Correspondência de Habilidades]
    S --> T[Raciocínio LLM]
    T --> U[Chamada de Ferramenta]
    U --> V[Geração de Resposta]
    V --> W[Adaptação de Formato]
    W --> A2[Telegram]
    W --> B2[Discord]
    W --> C2[Slack]
    W --> D2[WhatsApp]

(2) Adaptação de Formato de Mensagem

Plataforma Blocos de Código Imagens Mensagens Longas
Telegram ```markdown Envio separado Dividir em múltiplos segmentos
Discord ```markdown Embed Dividir + continuar
Slack ```mrkdwn Block Dividir em thread
WhatsApp Sem formatação Envio separado Dividir em múltiplos segmentos
Email HTML Inline/Anexo Email único

6. Adaptação de Características por Plataforma

(1) Processamento de Mensagens de Voz

BASH
# Telegram: usuário envia voz → STT → Agent processa → TTS → responde com voz
# Workflow automático:
Usuário: [Mensagem de voz 0:15]
Agent: [voice_stt] → "Como está o clima em São Paulo hoje"
       [web_search] → Encontrou o clima
       [voice_tts] → [Mensagem de voz 0:08] "São Paulo hoje, ensolarado, 26 graus"

(2) Conversas em Grupo

YAML
platforms:
  discord:
    group_behavior:
      trigger: "mention"
      listen: false
      prefix: "!"
      respond_to_replies: true

7. Roteamento de Mensagens Multi-Plataforma

(1) Memória Cross-Platform

BASH
# Começa conversa no Slack
Slack: me: Ajude-me a revisar auth.py
       Agent: Encontrados 3 problemas de segurança...

# Continua no Telegram
Telegram: me: Sobre aquele resultado da revisão, me dê mais detalhes
          Agent: [Recuperação cross-platform]
                 Sobre a revisão de auth.py, os 3 problemas são...

(2) Regras de Roteamento

YAML
routing:
  platform_rules:
    telegram:
      model: "gpt-4o-mini"
      personality: "friendly"
    slack:
      model: "gpt-4o"
      personality: "professional"
    discord:
      model: "gpt-4o"
      personality: "creative"

❓ Perguntas Frequentes

P: Quantas plataformas podem ser conectadas simultaneamente? R: Sem limite. Todas as 15+ plataformas rodando simultaneamente sem problemas, cada uma em thread independente.

P: A latência cross-platform é alta? R: Recuperação de memória <100ms, não afeta a experiência. Tempo de resposta depende da inferência do modelo.

P: Cada plataforma pode ter personalidade diferente? R: Sim. Via regras de roteamento, defina tom, modelo e habilidades diferentes por plataforma.

P: Como evitar responder a todos no grupo? R: Configure gatilho: @menção ou prefixo específico (ex: !hermes). Padrão: responde apenas mensagens diretamente direcionadas.

P: Quais limitações do WhatsApp? R: WhatsApp Business API tem limite de frequência (máx. 1000 mensagens em 24h), requer verificação Meta Business.

P: Como monitorar status de cada plataforma? R: hermes platform status mostra conexão e estatísticas de todas as plataformas.


📖 Resumo


📝 Exercícios

  1. Básico (⭐): Conecte Telegram ou Discord, complete uma conversa, verifique envio/recebimento normal.
  2. Intermediário (⭐⭐): Conecte duas plataformas simultaneamente, comece em uma e continue na outra, verifique memória cross-platform.
  3. Avançado (⭐⭐⭐): Configure regras de roteamento multi-plataforma: Slack em modo profissional, Discord em modo criativo.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%