How It Works
- Enable a connector in Dashboard → Connectors
- Copy your webhook URL
- Paste it into the external system’s webhook settings
- Events flow in automatically — agents see them via
search()andbriefing()
Available Connectors
PagerDuty
Ingests incident lifecycle events: triggered, acknowledged, resolved. What it captures:- Incident title, severity, and status
- Assigned responders
- Service and escalation policy
- Resolution notes
incidents/pagerduty/{service_name}
Setup:
- In AMFS Dashboard → Connectors, enable PagerDuty
- Copy the webhook URL
- In PagerDuty → Integrations → Generic Webhooks (v3), add the URL
GitHub
Ingests pull request events, deployment statuses, and issue updates. What it captures:- PR opened/merged/closed events with diff stats
- Deployment success/failure with environment info
- Issue state changes and label updates
repos/{owner}/{repo}
Setup:
- In AMFS Dashboard → Connectors, enable GitHub
- Copy the webhook URL and signing secret
- In your GitHub repo → Settings → Webhooks, add the URL with the secret
Slack
Ingests channel messages and thread context relevant to incidents or decisions. What it captures:- Messages from monitored channels
- Thread context around incident discussions
- Bot interaction logs
comms/slack/{channel}
Setup:
- In AMFS Dashboard → Connectors, enable Slack
- Copy the webhook URL
- In your Slack app → Event Subscriptions, add the URL
Jira
Ingests issue transitions, sprint events, and release notes. What it captures:- Issue status transitions (e.g., In Progress → Done)
- Sprint start/complete events
- Release creation and deployment tracking
projects/jira/{project_key}
Setup:
- In AMFS Dashboard → Connectors, enable Jira
- Copy the webhook URL
- In Jira → System → Webhooks, add the URL
Direct Event Ingestion
For any system that doesn’t have a built-in connector, push events directly via the REST API:agent_id="external/{source}", visible to all agents and automatically included in Cortex digest compilation.
Use this for:
- Monitoring alerts (Datadog, Grafana, custom)
- CI/CD pipelines reporting deployment status
- Cron jobs pushing periodic metrics
- Any system with an outgoing webhook
Webhook Authentication
All webhook endpoints require your API key. Include it as a header when configuring webhooks in external systems:X-PagerDuty-Signature, GitHub’s X-Hub-Signature-256) using the signing secret configured in Dashboard → Connectors.
