ChatOps integrations

This section provides instructions for integrating a ChatOps application, such as Slack or Microsoft Teams with ValueEdge. The integration enables all stakeholders to collaborate and communicate.

Set up a Slack integration

To set up integration with Slack, you add your ValueEdge workspace to a Slack workspace. This enables users to open Slack channels for discussions from within ValueEdge items, allowing stakeholders of backlog items or pipeline run failures to communicate. For details, see Collaborate.

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

Note: You can add your ValueEdge workspace to only one Slack workspace.

We recommend using different Slack workspaces for different ValueEdge workspaces.

To enable your ValueEdge workspace users to collaborate in Slack, define Slack as a collaboration tool in ValueEdge, and add your ValueEdge workspace to your Slack workspace:

  1. In ValueEdge's Settings > Spaces, 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 workspace to use for all communication related to this ValueEdge workspace. Add all of your ValueEdge workspace members to the Slack workspace.

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

    • When creating a new Slack workspace, 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 Slack workspaces.

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

    When you finish creating the Slack workspace, go back to the ValueEdge browser tab.

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

    If you select the checkbox for this option in the Add Collaboration Tool dialog box, ValueEdge 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 Add to Slack to add your ValueEdge workspace to the Slack workspace.

    The ValueEdge chat application registered on Slack requests access to your Slack workspace.

    For SaaS ValueEdge, the name of the application is octanechatsapp. For on-premises ValueEdge, the application is set up by your site admin.

  7. Optionally, select a different Slack workspace and select whether to expose more or less information about your Slack workspace to ValueEdge.

  8. Click Authorize.

The integration with Slack is complete. The Chat w/ Slack button is now enabled in backlog items and in a pipeline run's Tests tab.

Troubleshooting: If the integration setup fails due to a communication failure, reporting an inaccessible redirect_url, contact your site admin to make sure that the configuration parameter SERVER_BASE_URL is defined correctly. For details, see Configuration parameters.

Back to top

Prepare for a Microsoft Teams integration

To prepare your system to integrate with Microsoft Teams, you need to register the Teams app in Azure, and perform steps in ValueEdge. Registering Teams in Azure establishes a trust relationship between your application and the identity provider, the Microsoft identity platform. For more details, refer to the Azure documentation.

The integration with Microsoft Teams lets you send comments to a specific Teams channel.

To register Teams in Azure:

  1. Open the Azure portal via the organization's account: https://portal.azure.com/.

  2. Log in as a tenant admin. This will allow you to grant consent for the permissions that will be required later.

  3. Open the Active Directory service.

  4. In the navigation side pane, click App registrations, and click New application registration.
  5. In the App > Authentication section, create a redirect URI to: https://<server_base_url>/api/msteams-integration/auth-code .

  6. In the App > API permissions section, grant the following Microsoft Graph API delegated permissions: Group.Read.All User.ReadBasic.All Team.ReadBasic.All ChannelMessage.Send offline_access.

    Note: If you skip this step, you can provide consent to these permissions upon your login.

  7. Create a client secret for your app in the App > Certificates & Secrets section.
  8. Save the client secret. You will need it to enable the integration.

Back to top

Configure ValueEdge for Microsoft Teams integration

To enable your ValueEdge workspace users to collaborate in Microsoft Teams, you need to define it in the Collaboration Tools section.

To add Microsoft Teams as a collaboration tool:

  1. Click the DevOps tab. In the left pane, select Collaboration Tools.

  2. In the tool dropdown, select Microsoft Teams if it is not already selected. Click + Microsoft Teams. ValueEdge prompts you to set up the integration.
  3. Enter the required credentials: Application (client) ID, Directory (tenant) ID, and client secret. Click Configure. The credentials can be found in the Azure portal.
  4. Exit the admin settings section, and make sure you are logged in to ValueEdge as an admin.
  5. Go to any work item entity and click the Discuss on Teams button . ValueEdge prompts you to provide consent for the requested permissions.
  6. Select the Consent on behalf of your organization checkbox and click Login. ValueEdge will authenticate on behalf of your Microsoft users through the application that you created.

Non-admin users can collaborate in Microsoft Teams from within ValueEdge. For details, see Discuss on Microsoft Teams.

Back to top