Skip to main content

Slack webhook

You can send the alerts from an alert policy to a Slack channel. To do this, create an incoming webhook in Slack, then paste its URL into the policy.

Before you start​

  • You need permission in your Slack workspace to add an incoming webhook to a channel. If you don't have it, ask your Slack administrator.
  • You need access to ManageIT → Manage Alert Policies.

Create the webhook in Slack​

  1. In Slack, create the channel that should receive alerts, or choose an existing one.
  2. Add an incoming webhook for that channel. Slack's own help explains how to do this for your workspace.
  3. Copy the webhook URL that Slack gives you. It starts with https://.

Keep the webhook URL private. Anyone who has it can post to your channel.

Add the webhook to an alert policy​

  1. Open ManageIT → Manage Alert Policies.
  2. Select the policy name to edit it, or select Create Alert Policy.
  3. Under Communication, paste the URL into Slack Webhook.
  4. Select Send Test next to the field.
  5. Check the message under the field and in your Slack channel.
  6. Select Save Changes, or Create Policy for a new policy.

What happens next​

When the test works, you see Slack webhook accepted the test message. and the channel receives the message Your webhook is verified. After you save, the policy's alerts are posted to that channel. Slack appears in the policy's Channels.

Troubleshooting​

MessageFix
Enter a webhook URL first.Paste the URL into Slack Webhook before selecting Send Test.
Webhook URL must be a valid https:// address.Paste the full URL, starting with https://.
Could not reach the webhook endpoint.Check the URL is complete and try again.
Webhook returned followed by an error codeSlack refused the message. Check the webhook still exists in Slack, or create a new one.