Teams Direct Message Notifications Setup Process

Prerequisites

• Access to an Azure account with permissions to manage Azure Active Directory (Azure AD) applications. Typically, the following Azure AD roles include the required permissions:

  • Application Administrator

  • Application Developer

  • Cloud Application Administrator

• Microsoft's setup of a tenant is complete.

• The Microsoft Teams application is included in the Office365 suite.

Registering the ALICE Application With Azure Active Directory

Creating the ALICE Application in Azure

1. Sign in to the Azure Portal and choose the Azure AD tenant in which the application will be created.
   1. If your account is logged in to more than one Azure AD tenant, switch the directory to the desired Azure AD tenant using the profile menu at the top right corner of the page.
2. Navigate to App Registrations, then select New Registration.
3. Enter the following application registration information.
   1. In the "Name" section, insert the application name that will be displayed to the app users. For example, "ALICE Teams Connector."
   2. Under "Supported account types," select Accounts in this organizational directory only.
   3. In the "Redirect URI" section, select Web from the drop-down window and enter the following redirect URI: 
      1. https://avm-restapi-prod.alicereceptionist.com/
   4. Select Register to create the application.
      
      
4. On the app's registration screen, note the "Application (client) ID" value, as it will need to be used later in the ALICE Portal.
   
   
5. Under the "Manage" section, select Authentication. 
6. Enter the following information:
   1. If a platform has not already been added, select Add a platform and select the Web option. In the "Redirect URLs" section, enter the following URL:
      1. https://avm-restapi-prod.alicereceptionist.com

   2. In the "Front-channel logout URL" section, insert https://avm-restapi-prod.alicereceptionist.com.

7. Click Save.
   
   
   
8. Select API permissions under the "Manage" section on the left side of the screen.
9. Select the Add a permission button.
   
   
10. In the new pop-up window, ensure that the "Microsoft APIs" tab is selected and select Microsoft Graph.
    
    
11. Select Delegated permissions, then add the following items using the search field.
    

    1. Chat.Create

    2. Chat.Read

    3. Chat.ReadBasic

    4. Cheat.ReadWrite

    5. ChatMember.Read

    6. ChatMember.ReadWrite

    7. ChatMessage.Read

    8. ChatMessage.Send

    9. User.Read

12. Select the Add a permission button at the bottom of the page.

13. Once all listed permissions are added, click the Grant admin consent for... button.
    
    

14. On the Authentication screen, set the "Supported account types" to "Accounts in this organizational directory only."
    
    
15. Under the advanced settings section, turn on the switch for “Enable the following mobile and desktop flows.”
16. Click Save.
    
    

Creating the ALICE Team User

In Microsoft Teams, add a Teams User for the ALICE Application. In the below example, the new user is named “AliceGuest Check-In.”

Configure ALICE Receptionist to Use the ALICE Azure App

1. Log into the ALICE Portal as an ALICE Administrator. Under Account Management, select Global Settings.
2. Select the Sync Integrations tab and then the Microsoft Teams tab.
   

   1. Note: If you want to restrict this integration to only one ALICE Directory, configure these settings under Visitor Management by selecting Check-in Settings. Use the Integration tab to find the directory-specific Teams fields.

3. Populate the following fields:

   1. ALICE Teams User Name – The email associated with the ALICE Teams user.

   2. ALICE Teams User Password – The password associated with the ALICE Teams User. It is recommended that this password does not expire.

   3. Azure (Teams) Tenant ID – Enter the ID from the Azure Active Directory Properties page in the Azure Portal.

   4. ALICE Application (Client) ID – The ID found on the app's registration screen in the Azure Portal.

4. Once all four fields have been filled, click Save.