Dokkit Claim a name soon

DokkitAlertsWebhook

Webhook

A JSON request to an https address of yours when an issue opens, and another when it closes. Use it to reach anything Dokkit does not speak to directly.

Set it up

On Dokkit's Alerts page, in Settings. Only the owner can change it.

Webhook addressOn Dokkit's Alerts page, under Webhook, an address that starts with https://.
Who is toldTick Webhook for the states it should hear about, alone or beside another channel.

What it sends

The request it sends:

{
  "event": "opened",
  "issue": {
    "id": "DOK-12",
    "title": "nightly-purge did not run",
    "note": "It was due at 01:00 and no start was reported.",
    "machine": "db-01",
    "state": "down",
    "url": "https://dokkit.example.com"
  }
}

When the issue closes, the same request comes again with "event": "closed".

Try it

Under Webhook, press Send a test. It says at once whether it went, or why not.

  • A Slack or Discord webhook address gets a message in their own format instead.
  • Addresses on your private network are allowed. Addresses that point at the server itself, or link-local ones, are refused unless the server runs with DOKKIT_ALLOW_LOCAL_ALERTS=1.

Next:

Every channelHow Dokkit decides who is toldHome AssistantThrough the webhook, into an automationBack to the startWhat Dokkit is, and the working sample