What problem does it solve?
Webhook subscriptions eliminate the manual effort of monitoring external systems and manually starting agent runs by letting event payloads directly trigger automation.
Core Features & Use Cases
- Dynamic webhook routes: Create subscriptions that map incoming events to a configured prompt template and delivery target.
- Event-driven agent execution: Use event filters and payload field placeholders (dot-notation) to tailor the run to each request.
- Secure delivery and reliability: Use HMAC-SHA256 signatures, support idempotent behavior via routing/state persistence, and include operational testing and troubleshooting steps.
- Practical integrations: Trigger from GitHub/GitLab CI events, Stripe payment status changes, monitoring/alert systems, IoT sensors, and other HTTP event sources.
Quick Start
Use webhook-subscriptions to create a Telegram-triggered automation by running the command: gengar webhook subscribe alerts --events "alert" --prompt "Alert: {alert.name}\nSeverity: {alert.severity}\nMessage: {alert.message}\n\nPlease investigate and suggest remediation." --deliver telegram --deliver-chat-id "123456789".