diff --git a/notifications.adoc b/notifications.adoc index 2459095..cf2511f 100644 --- a/notifications.adoc +++ b/notifications.adoc @@ -178,6 +178,99 @@ gotify: example token somesecrettoken ---- +[[notification_targets_webhook]] +Webhook +~~~~~~~ + +Webhook notification targets perform HTTP requests to a configurable URL. + +The following configuration options are available: + +* `url`: The URL to which to perform the HTTP requests. + Supports templating to inject message contents, metadata and secrets. +* `method`: HTTP Method to use (POST/PUT/GET) +* `header`: Array of HTTP headers that should be set for the request. + Supports templating to inject message contents, metadata and secrets. +* `body`: HTTP body that should be sent. + Supports templating to inject message contents, metadata and secrets. +* `secret`: Array of secret key-value pairs. These will be stored in + a protected configuration file only readable by root. Secrets can be accessed + in body/header/URL templates via the `secrets` namespace. +* `comment`: Comment for this target. + +For configuration options that support templating, the +https://handlebarsjs.com/[Handlebars] syntax can be used to +access the following properties: + +* `{{ title }}`: The rendered notification title +* `{{ message }}`: The rendered notification body +* `{{ severity }}`: The severity of the notification (`info`, `notice`, + `warning`, `error`, `unknown`) +* `{{ timestamp }}`: The notification's timestamp as a UNIX epoch (in seconds). +* `{{ fields. }}`: Sub-namespace for any metadata fields of the + notification. For instance, `fields.type` contains the notification type - + for all available fields refer to xref:notification_events[Notification Events]. +* `{{ secrets. }}`: Sub-namespace for secrets. For instance, a secret + named `token` is accessible via `secrets.token`. + +For convenience, the following helpers are available: + +* `{{ url-encode }}`: URL-encode a property/literal. +* `{{ escape }}`: Escape any control characters that cannot be + safely represented as a JSON string. +* `{{ json }}`: Render a value as JSON. This can be useful to + pass a whole sub-namespace (e.g. `fields`) as a part of a JSON payload (e.g. + `{{ json fields }}`). + +==== Examples + +===== `ntfy.sh` + +* Method: `POST` +* URL: `https://ntfy.sh/{{ secrets.channel }}` +* Headers: +** `Markdown`: `Yes` +* Body: +---- +``` +{{ message }} +``` +---- +* Secrets: +** `channel`: `` + +===== Discord + +* Method: `POST` +* URL: `https://discord.com/api/webhooks/{{ secrets.token }}` +* Headers: +** `Content-Type`: `application/json` +* Body: +---- +{ + "content": "``` {{ escape message }}```" +} +---- +* Secrets: +** `token`: `` + +===== Slack + +* Method: `POST` +* URL: `https://hooks.slack.com/services/{{ secrets.token }}` +* Headers: +** `Content-Type`: `application/json` +* Body: +---- +{ + "text": "``` {{escape message}}```", + "type": "mrkdwn" +} +---- +* Secrets: +** `token`: `` + + [[notification_matchers]] Notification Matchers ---------------------