Share this page

# 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.

In this topic:

## Pre-requisites

Before sending Teams chat, complete the following configuration tasks.

In Microsoft Azure App Service | Complete the following tasks in Microsoft Azure App Service: Create your application in Microsoft Azure App Service. Open the application. In the Authentication tab, Mobile and desktop applications section, add the following redirect URI: https://login.microsoftonline.com/common/oauth2/nativeclient 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 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 ENABLE_TEAMS_INTEGRATION to Y. 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: https://aadcdn.msftauth.net https://login.microsoftonline.com/ https://graph.microsoft.com/

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:

- ALM integrations overview

https://admhelp.microfocus.com ALM 8942
Tips to improve your search results... ALM Help Center ALM Help Center ALM Help 16.00-16.0.1 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: