Webhooks

Webhooks let you send alert notifications to any HTTP endpoint. YipYap also auto-detects webhook URLs from popular platforms and formats the payload accordingly.

Generic Webhook

To configure a generic webhook:

Go to Settings > Notifications > Add Channel > Webhook.
Enter the destination URL.
Optionally configure a secret for HMAC signature verification.

Payload Format

YipYap sends a POST request with a JSON body:

{
  "event": "alert.firing",
  "monitor": {
    "id": "mon_abc123",
    "name": "API Health",
    "url": "https://api.example.com/health"
  },
  "alert": {
    "id": "alt_xyz789",
    "status": "firing",
    "fired_at": "2025-01-15T10:30:00Z"
  },
  "dashboard_url": "https://console.yipyap.run/alerts/alt_xyz789"
}

HMAC Signature

If you configure a webhook secret, YipYap includes an X-YipYap-Signature header containing an HMAC-SHA256 signature of the request body. Verify this signature on your end to confirm the request originated from YipYap.

Auto-Detected Platforms

When you paste a webhook URL from one of these platforms, YipYap automatically formats the payload to match the platform’s expected format:

Platform	URL Pattern
Slack	`hooks.slack.com/services/...`
Discord	`discord.com/api/webhooks/...`
Microsoft Teams	`*.webhook.office.com/...`
Google Chat	`chat.googleapis.com/...`
Lark	`open.larksuite.com/open-apis/bot/...`
DingTalk	`oapi.dingtalk.com/robot/send?...`
Synology Chat	`chat.synology.com/...`

No additional configuration is needed for auto-detected platforms. YipYap handles the formatting.

Retry Policy

If the webhook endpoint returns a non-2xx status code or times out (30 second limit), YipYap retries up to 3 times with exponential backoff.