Configure Slack for external content indexing

Create a Slack API application to allow the Slack external content connector to crawl public channels in your Slack source system.

Before you begin

You need permission to create Slack API applications in your organization's Slack workspace.

Role required: none

About this task

The Slack external content connector retrieves content from public channels in your Slack source system using a Slack API application. You need to create this application and configure its OAuth settings to allow the external content connector access to your Slack workspace.

Your connector administrator needs the Slack API application's client ID and secret to configure the Slack external content connector for proper connection to your Slack source system.

Procedure

1. Navigate to the Slack API: Applications page at https://api.slack.com/apps.

2. If prompted, sign in to your Slack account and select the workspace that you want the external content connector to crawl.

3. Select Create an App.

If you already have existing applications on this page, select **Create New App** instead.

1. In the Create an app dialog box, select From scratch.

1. In the Name app & choose workspace dialog box, specify a name and workspace for your application.

   1. In the App Name field, enter a name for your application.

   2. In the Pick a workspace to develop your app in field, select the workspace that you want the external content connector to crawl.

   3. Select Create App.

The application's Settings page appears, open to the Basic Information page.

1. In the App Credentials section, select Show to display the Client Secret field value, then record the application's Client ID and Client Secret values in a secure location.

**Important:** Your connector administrator needs these values to configure the Slack external content connector.

1. Navigate to Features > OAuth & Permissions.

2. On the OAuth & Permissions page, configure a redirect URL for the application.

   1. In the Redirect URLs section, select Add New Redirect URL.

2.  Enter the URL for your ServiceNow AI Platform® instance, `https://<instance-name>.service-now.com`, replacing `<instance-name>` with the name of your instance.

3.  Select **Add**.

4.  Select **Save URLs**.

1. On the OAuth & Permissions page, in the Scopes section's Bot Token Scopes subsection, configure each of these bot token scopes for the application.

   • channels:history
   • channels:join
   • channels:read
   • files:read
   • remote_files:read
   • team:read
   • users:read
   • Select Add an OAuth Scope.

2.  Enter the OAuth scope's name to filter the list of scopes, then select the scope's entry.

    The selected scope appears in the list of Bot Token Scopes for your application.

1. On the OAuth & Permissions page, install the application into your Slack workspace.

   1. In the OAuth Tokens section, select the link to install the application to your Slack workspace.

      The installation link's text will include the name of your Slack workspace.

2.  On the confirmation page, select **Allow**.

1. On the OAuth & Permissions page, opt into token rotation for the application.

   1. In the Advanced token security via token rotation section, select Opt In.

2.  On the confirmation page, select **Opt in**.

What to do next

Provide the following items to your connector administrator:

• The Slack API application client ID and client secret that you recorded in step 6.
• The URL where your Slack workspace is accessible. This is usually https://slack.com.

Your connector administrator needs these items to configure a Slack external content connector to retrieve attachments from your Slack instance.

For details on creating and configuring a Slack external content connector, see Create a Slack external content connector.

Parent Topic:Slack external content connector