Set up Slack integration

DevOps admin permissions are required.

Integrating with Slack enables all stakeholders of a backlog item to collaborate and communicate.

When you set up integration with Slack, you add your ALM Octane workspace to a Slack team. Then, users can click Chat w/ Slack in a backlog item to open a Slack channel with this item's author and owner.

If you configure the integration to expose ALM Octane data on Slack channels, information from the backlog item is sent to the channel.

Note: You can add your ALM Octane workspace to only one Slack team.

We recommend using different Slack teams for different ALM Octane workspaces.

To set up integration with Slack:

  1. In ALM Octane, in Settings , click Workspaces and select your workspace.

  2. Click the DevOps tab. On the left side of the pane, select Collaboration Tools.

  3. Click + to add Slack as a collaboration tool. The Add Collaboration Tool dialog box opens.

  4. In Slack, make sure you have a team to use for all communication related to this workspace. Add all of your ALM Octane workspace members to the team.

    If you do not have such a team, click the link in the Add Collaboration Tool dialog box to open Slack and create a team.


    • When creating a new team, make sure to use an email address that you can access. Slack sends a confirmation code to this address as part of the process.

      You can use the same email address to create different teams.

    • You can add members to the Slack team at any time.

    When you finish creating the team, go back to the ALM Octane browser tab.

  5. Consider carefully whether to allow exposing internal ALM Octane information on the Slack channel.

    If you select the checkbox for this option in the Add Collaboration Tool dialog box, ALM Octane sends information about the relevant backlog items to the Slack channels it opens.

    Note: You can modify this setting at any time in the collaboration tool grid.

  6. Click to add your workspace to the Slack team.

    The ALM Octane chat application, octanechatsapp, requests access to your Slack team.

  7. Optionally, select a different team and select whether to expose more or less information about your Slack team to ALM Octane.

  8. Click Authorize.

The integration with Slack is complete. In backlog items, the Chat w/ Slack button is now enabled.

Troubleshooting: If the integration setup fails due to a communication failure, reporting an inaccessible redirect_url, contact your site administrator to make sure that the site parameter SERVER_BASE_URL is defined correctly.

For details, see the ALM Octane Installation and Administration Guide.