Slack

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

Create a Slack App

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

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
  }
}

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.

Access Recipes

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

Add Slack Resource

Add or select a Slack resource in your recipe.

Link Credentials

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

Select Authentication Method

Select “API Token.”

Name Credentials

Enter a credential name for identification.

Enter API Token

Input your Slack OAuth or Bot token.

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

Get Started

App Directory

Authentication

API Token

Resources

Channel

Get Started

App Directory

​Authentication

​API Token

​Resources

​Channel

Authentication

API Token

Resources

Channel