Send Microsoft Teams messages from ALM

This task describes how to send Microsoft Teams messages to users working on ALM entities.


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 Setting ALM Configuration Parameters.

  • The users must have their email addresses defined in ALM. For details on setting up users, see Managing Users in a Project.

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.

    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