Webhooks
Receive events from external services (GitHub, GitLab, JIRA, Stripe, etc.) and trigger Hermes agent runs automatically. The webhook adapter runs an HTTP server
Receive events from external services (GitHub, GitLab, JIRA, Stripe, etc.) and trigger Hermes agent runs automatically. The webhook adapter runs an HTTP server that accepts POST requests, validates HMAC signatures, transforms payloads into agent prompts, and routes responses back to the source or to another configured platform. …
What this page covers
- Video Tutorial
- Quick Start
- Setup
- Via setup wizard
- Via environment variables
- Verify the server
- Configuring Routes {#configuring-routes}
- Route properties
- Full example
- Prompt Templates
- Forum Topic Delivery
- GitHub PR Review (Step by Step) {#github-pr-review}
- 1. Create the webhook in GitHub
- 2. Add the route config
- 3. Ensure gh CLI is authenticated
- 4. Test it
- GitLab Webhook Setup {#gitlab-webhook-setup}
- 1. Create the webhook in GitLab
- 2. Add the route config
- Delivery Options {#delivery-options}
- Direct Delivery Mode {#direct-delivery-mode}
- When to use direct delivery
- Example: Telegram push from Supabase
- Example: Dynamic subscription via CLI
- Response codes
- Configuration gotchas
- Dynamic Subscriptions (CLI) {#dynamic-subscriptions}
- Create a subscription
- List subscriptions
- Remove a subscription
- Test a subscription
- How dynamic subscriptions work
- Agent-driven subscriptions
- Security {#security}
- HMAC signature validation
- Secret is required
- Rate limiting
- Idempotency
- Body size limits
- Prompt injection risk
- Troubleshooting {#troubleshooting}
- Webhook not arriving
- Signature validation failing
- Event being ignored
- Agent not responding
- Duplicate responses
- gh CLI errors (GitHub comment delivery)
- Environment Variables {#environment-variables}
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Messaging Platforms
Messaging Gateway
Chat with Hermes from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin, BlueBubb
Telegram
Telegram Setup Hermes Agent integrates with Telegram as a full featured conversational bot. Once connected, you can chat with your agent from any device, send v
Discord
Discord Setup Hermes Agent integrates with Discord as a bot, letting you chat with your AI assistant through direct messages or server channels. The bot receive
Slack
Slack Setup Connect Hermes Agent to Slack as a bot using Socket Mode. Socket Mode uses WebSockets instead of public HTTP endpoints, so your Hermes instance does
WhatsApp Setup Hermes connects to WhatsApp through a built in bridge based on Baileys . This works by emulating a WhatsApp Web session — not through the officia
Signal
Signal Setup Hermes connects to Signal through the signal cli daemon running in HTTP mode. The adapter streams messages in real time via SSE (Server Sent Events