Slack

Learn about Tempest’s Slack integration capabilities and supported resources.

Slack is a messaging platform for team collaboration that brings together people, data, and tools. The Slack App in Tempest enables integration with Slack workspaces to create channels on-demand and import them into your service catalog.

For detailed information about each resource, see the Resources section below.

Authentication

These are the supported authentication methods for Slack in Tempest:

API Token

Ensure your Slack API token has appropriate permissions for all features you plan to use through Tempest.

Tempest uses Slack API Token authentication to interact with Slack workspaces. This requires:

• Slack API Token (Bot token)

How to get a Slack API Token

1. Create a Slack App

   Create a Slack App in your workspace through the Slack API website. Select “From manifest” and then select your workspace.

2. Add Manifest

   Paste in the JSON app manifest found below:

   manifest.json

   {
     "display_information": {
       "name": "Tempest",
       "description": "Tempest Slack App",
       "background_color": "#000000"
     },
     "features": {
       "app_home": {
           "home_tab_enabled": false,
           "messages_tab_enabled": true,
           "messages_tab_read_only_enabled": true
       },
       "bot_user": {
           "display_name": "Tempest",
           "always_online": true
       }
     },
     "oauth_config": {
       "scopes": {
           "bot": [
               "app_mentions:read",
               "channels:history",
               "channels:join",
               "channels:manage",
               "channels:read",
               "chat:write.customize",
               "chat:write.public",
               "chat:write",
               "groups:history",
               "groups:read",
               "groups:write",
               "im:history",
               "im:read",
               "im:write",
               "mpim:history",
               "mpim:read",
               "mpim:write",
               "team:read",
               "usergroups:read",
               "usergroups:write",
               "users:read",
               "users.profile:read"
           ]
       }
     },
     "settings": {
       "event_subscriptions": {
           "bot_events": [
               "app_mention"
           ]
       },
       "interactivity": {
           "is_enabled": true
       },
       "org_deploy_enabled": false,
       "socket_mode_enabled": true,
       "token_rotation_enabled": false
     }
   }
   

3. Install the App

   In the sidebar, click “Install App” and install it in your workspace. Save the Bot User OAuth Token which is shown after the app is installed—it should start with xoxb.

4. Access Recipes

   Navigate to Recipes in Tempest and create or select a recipe.

5. Add Slack Resource

   Add or select a Slack resource in your recipe.

6. Link Credentials

   Click “Add credentials” then “+Link credentials.”

7. Select Authentication Method

   Select “API Token.”

8. Name Credentials

   Enter a credential name for identification.

9. Enter API Token

   Input your Slack OAuth or Bot token.

10. Complete Connection

    Click “Connect.”

Resources

Channel

Create, manage, and import Slack channels within your workspace.

Configuration options:

• Channel name (required): The name of the channel, in alphanumeric with hyphens and underscores only
• Channel topic: The topic of the Slack channel

Properties:

• ID: The Slack channel identifier
• Name: The name of the channel
• Topic: The channel topic
• Is Private: Whether the channel is private
• Created: Date when the channel was created
• Creator: The ID of the user who created the channel
• Number of Members: The count of members in the channel