Integrations
Inbound channelsHermes Agent runs on Slack/Telegram/Email — Hermes Loop has the first webhook hop.
What this is
Hermes Agent's selling point is that it lives across Telegram / Discord / Slack / WhatsApp / Signal / Email / CLI. Hermes Loop's first hop is a generic signed webhook that drops anything into the inbox.
What to do
Set INTEGRATIONS_WEBHOOK_SECRET to require signed webhooks. Without it, the endpoint is open — fine for local dev, NOT fine for production.
What happens next
The created InboxItem is queued for triage; the Triage Agent proposes a crew + objective; you approve and convert it into a real mission.
Generic webhook
POST /api/integrations/webhook
Body shape: { channel, sender, text, metadata? }. Header (when signed): X-Foundry-Signature: sha256=<hex>.
curl -X POST https://hermes-agent.vercel.app/api/integrations/webhook \
-H "Content-Type: application/json" \
# (no signature header — INTEGRATIONS_WEBHOOK_SECRET is not set, so signing is skipped) \
-d '{"channel":"slack","sender":"@vlk","text":"audit https://example.com","metadata":{"channel_id":"C123"}}'Recent inbound (last 5)
- [mobile] Set up a weekly Monday QA audit for my landing page.4h ago
- [mobile] Audit https://demo.acme-saas.test for conversion + a11y issues.4h ago
- [demo] Audit https://demo.acme-saas.test for conversion + accessibility issues.4h ago
- [demo] Watch the AI semis space (NVDA, AVGO, AMD) and brief me every weekday morning before the open4h ago
Channels
All inbound surfaces
Generic webhook
LivePOST { channel, sender, text, metadata? } to /api/integrations/webhook. Optional HMAC signing.
Discord
LiveInbound: signed JSON webhook → InboxItem. Outbound: approval embeds via webhook URL or bot token.
Open Discord setup →
Slack
LiveInbound: /foundry slash command with X-Slack-Signature verification → InboxItem.
Open Slack setup →
Email
LiveInbound: SendGrid / Mailgun / Postmark forwarder webhook → InboxItem.
Open Email setup →
CLI
LiveOperator CLI: foundry health · jobs · receipts · mission create · evals.
Open CLI setup →
Telegram
RoadmapNative bot integration is roadmap. Route Telegram messages via the generic webhook in the meantime.


