Skip to content

Webhook Channel Plugin

The Webhook channel plugin is an alert_deliver plugin that sends Core-rendered alert payloads over HTTP webhooks. It supports multiple template profiles, from generic JSON to Slack, Mattermost, PagerDuty, Teams, Discord, Opsgenie, Grafana OnCall, Google Chat, and CloudEvents.

Highlights

  • Treats HTTP method, headers, auth, timeout, retry, and idempotency key as transport settings.
  • Supports Slack blocks/attachments/text, Mattermost, PagerDuty Events v2, Teams MessageCard, Discord embed, Opsgenie alert, Google Chat card/text, and CloudEvents v1 profiles.
  • Blocks private or internal network targets by default unless explicitly allowed for trusted deployments.
  • Separates config validation from optional test delivery in health checks.

Before Registration

  • Prepare webhook URL, authentication mode, template type, timeout, and retry policy.
  • Review required fields and rate limits for each downstream webhook provider.
  • Explicitly review network policy before enabling internal webhook targets.

Operations Tips

  • Custom headers cannot override Core-managed headers such as Authorization, Content-Type, User-Agent, or Idempotency-Key.
  • The generic profile preserves the original message_json, which is useful for downstream automation.
  • Human-readable chat profiles use notification_language and Core-rendered messages for display text.