How to Connect Slack with SpinOne

Before you start, create a webhook URL for your Slack channel using Slack’s Incoming WebHooks app.

1. In SpinOne, go to Settings > Integrations and select the External Integrations tab.
2. On the Slack tile, click View connections.

3. Click Add connection at the top right.

4. Enter a Title for the integration.
5. Paste your webhook URL into the Slack URLs field.
6. Click Create.

Your new connection now shows in the Connections list and can be selected as a notification recipient in your Security Policies.

End-user notifications use a Slack app that sends direct messages on SpinOne’s behalf. Setup includes three steps:

1. Create the Slack app
2. Approve it for your organization
3. Add its token to SpinOne

These direct messages are sent to the user when any of the following cases occur: application is blocked, approval request is approved, approval request is declined, and approval request is updated.

Step 1: Create the Slack App

1. Go to https://api.slack.com/apps and click Create New App.

2. Select From a manifest and click Continue.

3. Select the JSON tab and paste the manifest below.

{
  "display_information": {
    "name": "SpinOne DM notifications",
    "description": "SpinOne notifications"
  },
  "features": {
    "bot_user": {
      "display_name": "SpinOne DM notifications",
      "always_online": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": ["chat:write", "im:write", "users:read", "users:read.email"]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}

4. Select your Workspace and click Next.

5. Review the app and click Create.

6. In the left sidebar, click Install App, then click Install to [your workspace].

7. Click Allow.

8. Copy the Bot User OAuth Token. You’ll need it in Step 3.

Step 2: Approve the App for Your Organization

This step applies if your Slack uses an Enterprise Grid organization.

1. In the Slack app, click your organization name in the top left.
2. Go to Tools & settings > Manage apps. This opens your Slack admin page in the browser.

3. Go to Integrations > Installed apps.
4. Find SpinOne DM notifications, click the ⋯ menu, and select Approve for organisation.

Step 3: Add the Token to SpinOne

1. In SpinOne, go to Settings > Integrations > External Integrations.
2. On the Slack tile, click View connections.
3. Click Edit on the Approval_Process_Channel connection.
4. Paste the token into the Slack Token field and click Save.

End users will now receive SpinOne notifications as Slack direct messages. To customize the message text, go to Approval Process > Settings > Notification Templates > Slack > User Notifications.