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.
📋 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:
# 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 |
| Business | Texto puro | ✅ Imagens/Docs | ❌ | |
| Signal | Bot | Texto puro | ✅ Imagens | ✅ |
| Twitter/X | Bot | Texto puro | ✅ Imagens | ❌ |
| 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
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
hermes config set platforms.telegram.token "your-token"
hermes platform start telegram
(2) Discord
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
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
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
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 |
| Sem formatação | Envio separado | Dividir em múltiplos segmentos | |
| HTML | Inline/Anexo | Email único |
6. Adaptação de Características por Plataforma
(1) Processamento de Mensagens de Voz
# 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
platforms:
discord:
group_behavior:
trigger: "mention"
listen: false
prefix: "!"
respond_to_replies: true
7. Roteamento de Mensagens Multi-Plataforma
(1) Memória Cross-Platform
# 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
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 statusmostra conexão e estatísticas de todas as plataformas.
📖 Resumo
- 15+ plataformas integradas: Telegram, Discord, Slack, WhatsApp, Signal etc.
- Pipeline unificado: receber → analisar → permissão → memória → habilidade → resposta → adaptar
- Memória cross-platform: qualquer conversa em qualquer plataforma vive no mesmo espaço de memória
- Adaptação por plataforma: voz, grupos, mensagens longas, conversão de formato
- Regras de roteamento: diferentes plataformas podem usar modelos e personalidades diferentes
📝 Exercícios
- Básico (⭐): Conecte Telegram ou Discord, complete uma conversa, verifique envio/recebimento normal.
- Intermediário (⭐⭐): Conecte duas plataformas simultaneamente, comece em uma e continue na outra, verifique memória cross-platform.
- Avançado (⭐⭐⭐): Configure regras de roteamento multi-plataforma: Slack em modo profissional, Discord em modo criativo.