Send instant messages from ALM

This task describes how to send Microsoft Teams messages to users associated with a specific ALM entity. For example, users working on the same defect, test, or a requirement.


Before sending Teams chat, complete the following configuration tasks.

In Microsoft Azure App Service

Complete the following tasks in Microsoft Azure App Service:

  1. Create your application in Microsoft Azure App Service.

  2. Open the application. In the Authentication tab, Mobile and desktop applications section, add the following redirect URI:

  3. In the API permissions tab, add the following permissions of the Microsoft Graph API:

    • Channel.ReadBasic.All

    • ChannelMessage.Send

    • ChatMessage.Send

    • offline_access

    • Presence.Read

    • Presence.Read.All

    • Team.ReadBasic.All

    • User.Read

    • User.ReadBasic.All

  4. Click the Grant admin consent for <your tenant name> button.

For details about creating and configuring applications, refer to the Microsoft Azure App Service documentation.

In ALM Site Administration

Complete the following tasks in ALM Site Administration:

  • Set the following site parameters:


    • Set TEAMS_APP_CLIENT_ID to the Application (client) ID of your application.

    • Set TEAMS_APP_TENANT_ID to the Directory (tenant) ID of your application.

    For information about your application's client ID and tenant ID, go to the Overview tab of your application in Microsoft Azure App Service.

    For details on setting site parameters, see Set configuration parameters.

  • The users must have their email addresses defined in ALM. For details on setting up users, see Manage users in a project.
Add URLs in your firewall

If your organization is secured with a firewall or proxy server, add the following URLs to the allow list to ensure that the ALM client can access the Microsoft Teams resources:




Back to top

Start Teams chat from an entity form

To start a Microsoft Teams chat from an entity form:

  1. Open the entity form.

  2. Locate the user field where the user you want to chat with is defined.

  3. Click the Microsoft Teams presence indicator on the left side of the user's name.

    The indicator is gray and does not reflect the user's real-time Teams status until you sign in to Microsoft Teams with your ALM account's email address. The Teams status is synchronized every 10 seconds.

    If this is the first time you are clicking the indicator in the current ALM session, the Microsoft login window opens and prompts you to log in to Microsoft.

  4. The Teams chat window with the user opens, with an automatic message waiting to be sent.

    The message includes the entity's link and general information, such as name, ID, and summary.

    Known issue: Due to the API changes in Microsoft Teams, the entity's link is displayed in plain text. To open the entity in ALM, do either of the following:

    • Copy the entity address (enclosed in the parentheses) and paste it into your browser.

    • Delete the closing parenthesis ")" at the end of the message and manually add a closing parenthesis. The plain text becomes a clickable link.

    If you start the Teams chat when creating a new entity, the automatic message is not displayed.

  5. Click the Send button. The message becomes a link that enables the chat participants to open the entity in ALM.

  6. Send other messages to the user.

Back to top

See also: