Set Up Webhook Notifications

Step-by-Step

1. Create Webhook Endpoint

Your server needs a POST endpoint:

@app.route('/webhooks/agentstatus', methods=['POST'])
def agentstatus_webhook():
    data = request.json
    print(f"Agent {data['agent_name']} is now {data['new_status']}")
    return {'received': True}, 200

2. Configure in Agent Status

Settings → Webhook URL → Enter endpoint → Save.

Webhook Payload

{
  "event_type": "status_change",
  "agent_id": "abc123",
  "agent_name": "Production ChatBot",
  "previous_status": "UP",
  "new_status": "DOWN",
  "changed_at": "2026-02-25T10:30:00Z",
  "details": {
    "verdict": "DOWN",
    "uptime": 15.5,
    "regions_affected": ["us", "eu", "ap"]
  },
  "dashboard_url": "https://platform.agentstatus.dev/agents/abc123"
}

Integrations

Slack

Use Slack incoming webhooks or a middleman to format messages with color-coded attachments.

PagerDuty

Map DOWN→critical, DEGRADED→warning, UP→resolve using Events API v2.

Discord

Similar to Slack — use Discord webhook URL.

Behavior

• Timeout: 10 seconds (process async if slow)
• Retries: 3 with exponential backoff (30s, 2min, 10min)
• Triggers: Status changes only (no repeated alerts)

Troubleshooting

• Not firing? Check URL, endpoint returns 2xx, status actually changed
• Duplicates? Use agent_id + changed_at as dedup key
• Timeout? Return 202 quickly, process asynchronously