Connecting to Slack

Slack is a cloud-based messaging platform that enables real-time communication and collaboration across teams. It supports public and private channels, direct messaging, file sharing, and integration with a wide range of tools and services. Integrating Slack with IBM watsonx Orchestrate allows you to automate notifications, streamline workflows, and enhance team productivity by connecting your business processes directly to your communication channels.

To enable this integration, you must establish a secure connection that enables both platforms to communicate. See Managing connectionsfor more details.

Important: By default, Single sign-on (SSO) is disabled for your app. To enable it, refer to Configuring single sign-on for applications.

Connecting to Slack using OAuth2

To connect watsonx Orchestrate to Slack using OAuth2:

  1. From the main menu, select Manage > Connections.

  2. Search for Slack.

  3. Locate the connection ID with the following format: slack_oauth2_auth_code_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection is used:

    • Draft: for development or testing
    • Live: for production use

  6. Select Oauth2 Authorization Code as the authentication type.

  7. Provide the following values:

    Key Description
    Server URL Base URL of the Slack server
    Token URL Endpoint to exchange the authorization code for an access token
    Scope Defines what access is being requested
    Authorization URL URL where users are redirected to log in and authorize access
    Client ID Unique ID for your application
    Client Secret A secret key used to authenticate your app with Slack

    To get these values, see the Slack API documentation..

  8. Choose the appropriate credential type.

  9. Click Save to complete the setup.

Connecting to Slack using Bearer Token

  1. From the main menu, select Manage > Connections.
  2. Search for Slack.
  3. Locate the connection ID with the following format: slack_bearer_ibm_184bdbd3
  4. Click edit next to the matched connection ID.
  5. Choose the environment where the connection will be used:
    • Draft: for development or testing
    • Live: for production use
  6. Select Bearer Token as the authentication type.
  7. Choose the appropriate credential type.
  8. Click Save to complete the setup.

Connecting to Slack using Key Value Pair

  1. From the main menu, select Manage > Connections.

  2. Search for Slack.

  3. Locate the connection ID with the following format: slack_key_value_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection will be used:

    • Draft: for development or testing
    • Live: for production use

  6. Select Key Value Pair as the authentication type.

  7. Provide the following Keys, click Add new field to add additional key-value pairs:

    • base_url: The base URL for Slack API (for example, https://slack.com/api)

    To get these values, see the Slack API documentation.

  8. Choose the appropriate credential type.

    Note: Only the team credentials are supported when an app is connected using the Key Value Pair authentication type.

  9. Click Save to complete the setup.

Note: The icon A Supports appears indicates that the connection was successfully established.