All Collections
Authentication guides
Custom Slack App Authentication Guide
Custom Slack App Authentication Guide

How to build a custom app in Slack and authenticate it for use with Tines

Stephen O'Brien avatar
Written by Stephen O'Brien
Updated over a week ago

Slack is an instant messaging program developed for professional and organizational communications. Users can communicate with voice calls, video calls, text messaging, media, and files in private chats or as part of communities called workspaces. Here is our guide for authenticating Slack for use with Tines via a custom-built application.

First, create a chatbot in Slack

  1. Navigate to https://api.slack.com/apps, select Create New App, select 'From scratch' or 'From an app manifest' based on your preferences, and choose a name. When you create your Slack App, you have to choose your workspace. If this is your first time setting up an application, testing it in a demo or development workspace may make sense.

  2. On the next page, you’ll be presented with several options on what features and functionality you’d like for your application:

    Configure your bot to your desired specifications. Some commonly used features and functionality include:

    • Permissions: enable various user and/or bot scopes for your app. Follow this link view a full list of actions you can do with your bot. Click into the details for your desired actions to understand what permission scopes are needed. Additionally, all Tines Slack templates list the required scopes for each action in the description of the action template as further guidance.

    • Interactive Components: send messages with embedded interactivity to users. For example, send users messages with interactive buttons that can be used to stop and start your automation stories in Tines, upon user input.

    • Slash Commands: allow a user to interact with Tines through specific, user-defined commands e.g.

      • /searchdomain – search for traffic to a domain in logs

      • /lookupuser – find user profile information in active directory

      • /quarantinedevice – quarantine a device proactively

  3. Once you have configured your app to your custom specifications, navigate to the OAuth & Permissions feature tab on the left and locate the section 'OAuth Tokens for Your Workspace.' Depending on the permissions scopes you enabled, you may have a User OAuth token or a Bot User OAuth token. Copy the relevant token to use in the next step.

Create a Slack credential in Tines

Slack connect flow (recommended):

  1. Login to your Tines tenant

  2. Navigate to the team that will be using the API and click "Credential"

  3. Click "+ New Credential" and select "Slack"

  4. Select "Use my own Slack app" and follow the prompts to connect.

Read about our connect flows here.

For more complex capabilities for your chatbot, check out this blog

For more on creating credentials in Tines, click here.

You can find a selection of Slack stories in the Tines story library.

Did this answer your question?