Adding a Slack destination

There are two ways to configure Slack destinations:

• Slack API
• Slack Webhook

The email destination type lets one or more email addresses.

The API approach is more complex to configure, but more flexible. In particular, it allows you to send notifications or schedule sharing to multiple Slack channels, whereas a Slack webhook is tied to a specific Slack channel.

If you are likely to configure multiple SquaredUp destinations to target different Slack channels, the API approach may be preferable. If you are only targeting a single Slack channel, the webhook approach should suffice.

Slack API

Generate an API Token

1. You will need to create a Slack app. Go to https://api.slack.com/apps and click on Create an App.

2. Select From scratch, specify a name for the app and the Slack workspace that hosts the Slack channels you want to send to.

3. Configure the app icon and description. You can use whatever name, description and icon you would like, but it makes sense for them to refer to SquaredUp so that users can clearly see where the messages are originating from.

4. Navigate to Features > OAuth & Permissions from the left-hand pane.
5. Configure the chat:write permission to Send messages as @squaredup_alerts.
6. Configure the chat:write.public permission to Send messages to channels.
7. Click Install to Workspace.
8. You should now be given a token.

Adding a destination in SquaredUp

1. Add a new notification destination by doing one of the following:

   • Navigate to Monitors and click Add notification rule.
   • Navigate to Settings > Notifications and click Add destination.

2. Destination Name:
   Enter a name for your destination. This helps you to identify this destination in the list of your destinations.

3. Token:
   Paste the API token in here. Token reuse
4. Slack channel:
   Enter the destination Slack channel for messages to be delivered to.
   Note

   You can specify public or private Slack channels, but for private channels the Slack app you created must be added to the Slack channel (type /invite in the Slack channel).

5. Test:
   Click to send a test message and check that it is working as expected.

   Note

   In Slack, when you click the View button in the notification you may get a warning triangle beside it. To fix this, add https://api.squaredup.com/api/slack_interaction as the Interaction URL.

6. In SquaredUp Add a notification rule to configure when a notification should be sent, and select this destination. For Scheduled sharing select this destination on the Destination tab.

Slack Webhook

Generate a webhook URL

1. You will need to create a Slack app. Go to https://api.slack.com/apps and click on Create an App.

2. Select From scratch, specify a name for the app and the Slack workspace that hosts the Slack channels you want to send to.

3. Configure the app icon and description. You can use whatever name, description and icon you would like, but it makes sense for them to refer to SquaredUp so that users can clearly see where the messages are originating from.

4. Go to Incoming Webhooks and enable the Activate Incoming Webhooks option.
5. Click Add new Webhook to Workspace and choose the Slack channel you want to target.
6. Select the Channel for webhook.
7. Click Install {webhookName}.
8. Copy the Webhook URL.

Adding a destination in SquaredUp

1. Add a new notification destination by doing one of the following:

   • Navigate to Monitors and click Add notification rule.
   • Navigate to Settings > Notifications and click Add destination.

2. Destination Name:
   Enter a name for your destination. This helps you to identify this destination in the list of your destinations.

3. URL:
   Paste the webhook URL to configure the destination in SquaredUp.

4. Query parameters:
   Click Add query parameter

   to include additional key:value pairs in your request URL. Each parameter is appended to the query string when the request is sent.

   Toggle encryption for a parameter value using the encrypt icons

   /
   next to it.

5. Test:
   Click to send a test message and check that it is working as expected.

   Note

   In Slack, when you click the View button in the notification you may get a warning triangle beside it. To fix this, add https://api.squaredup.com/api/slack_interaction as the Interaction URL.

6. In SquaredUp Add a notification rule to configure when a notification should be sent, and select this destination. For Scheduled sharing select this destination on the Destination tab.

Was this article helpful?