Trigger Registry — Reactive Event Triggers

Create and manage triggers that execute skills or routines in response to external events (webhooks, integrations).

When to Use

• User wants to create a webhook endpoint: "cria um webhook para quando tiver push no GitHub"
• User wants to react to events: "quando alguem abrir issue no Linear, notifica no Discord"
• User wants to list/manage triggers: "lista os triggers", "desativa o trigger de deploy"
• User wants to test a trigger: "testa o trigger #3"

API Reference

The dashboard backend exposes these endpoints:

Trigger Types

Sources & Event Examples

Action Types

Agents

Workflow

Creating a Trigger

1. Understand the request — extract what event, what action, which agent:

   • Event source: GitHub, Stripe, Linear, Telegram, Discord, custom
   • Event filter: which specific events to match (e.g., push to main, charge.succeeded)
   • Action: what to do when triggered (skill, prompt, or script)
   • Agent: which agent should handle the action

2. Confirm with user — show summary:

   Copy

   Criar trigger:
   - Nome: Deploy Notification
   - Tipo: webhook
   - Source: github
   - Filtro: event=push, branch=main, repo=EvolutionAPI/evolution-api
   - Action: skill discord-send-message Deploy detectado na main
   - Agent: @pulse
   - Enabled: true
   
   Confirma?
   

3. Create via API:

   bashCopy

   curl -s -X POST http://localhost:8080/api/triggers \
     -H "Content-Type: application/json" \
     -b "session=..." \
     -d '{
       "name": "Deploy Notification",
       "type": "webhook",
       "source": "github",
       "event_filter": {"event": "push", "branch": "main", "repo": "EvolutionAPI/evolution-api"},
       "action_type": "skill",
       "action_payload": "discord-send-message Deploy detectado na main",
       "agent": "pulse-community",
       "enabled": true
     }'
   

4. Show result — display webhook URL and secret for configuration:

   Copy

   Trigger criado!
   - ID: 1
   - Webhook URL: http://localhost:8080/api/triggers/webhook/1
   - Secret: abc123... (configure no GitHub webhook settings)
   

Listing Triggers

curl -s http://localhost:8080/api/triggers -b "session=..." | python3 -m json.tool

Format as table: ID | Name | Type | Source | Status | Runs

Testing a Trigger

curl -s -X POST http://localhost:8080/api/triggers/1/test -b "session=..."

Common Templates

When user selects a source, suggest pre-built event filters:

GitHub:

• Push to main: {"event": "push", "branch": "main"}
• New PR: {"event": "pull_request", "action": "opened"}
• Issue opened: {"event": "issues", "action": "opened"}
• Release published: {"event": "release", "action": "published"}

Stripe:

• Payment succeeded: {"event_type": "charge.succeeded"}
• New subscription: {"event_type": "customer.subscription.created"}
• Invoice paid: {"event_type": "invoice.paid"}

Linear:

• Issue created: {"event_type": "Issue", "action": "create"}
• Issue updated: {"event_type": "Issue", "action": "update"}