What problem does it solve?
This Skill allows you to create dynamic webhook subscriptions, enabling external services to trigger Hermes agent runs by posting events to a URL, thus automating event-driven workflows.
Core Features & Use Cases
- Event-Driven Automation: Trigger Hermes agent runs based on external events from services like GitHub, GitLab, Stripe, CI/CD, IoT sensors, and monitoring tools.
- Flexible Setup: Configure webhooks through a setup wizard, manual config, or environment variables.
- Management Commands: Use the
hermes webhook CLI to create, list, remove, and test webhook subscriptions.
- Prompt Templates: Support for prompt templates with access to nested payload fields for personalized responses.
- Direct Delivery: Option to deliver notifications directly to users' chat without LLM cost.
- Security: HMAC-SHA256 secret for each subscription, webhook adapter validates signatures, and subscriptions persist to a secure location.
Quick Start
Set up a webhook subscription for GitHub issues by running the command:
hermes webhook subscribe github-issues \
--events "issues" \
--prompt "New GitHub issue #{issue.number}: {issue.title}\n\nAction: {action}\nAuthor: {issue.user.login}\nBody:\n{issue.body}\n\nPlease triage this issue." \
--deliver telegram \
--deliver-chat-id "-100123456789"