This page outlines the steps required to setup Microsoft (MS) Teams as a chat channel for Luma. Please reach out to the Serviceaide support team and raise a support ticket asking them to create the Luma channel connector for MS Teams and provide a package; include your Luma tenant ID in the ticket information. Please also specify name for your bot in MS Teams. This is how users will identify the contact in MS Teams once all the configuration steps are completed. After raising the support ticket, Administrators can complete the setup by following the steps mentioned in this article. Once the setup is complete, users will be able to send and receive messages from Luma using Microsoft Teams.
| Table of Contents |
|---|
| Info | ||
|---|---|---|
| ||
To configure MS Teams, you must have an account in Microsoft Office 365 portal and Microsoft Teams portal. |
...
Configuration Changes on Azure Portal
- Login to Azure portal with admin credentials and navigate to Azure Active Directory.
...
- Click on 'New Registration' to register a new application.
- On 'Register an application' screen, add display name for your application. On Support account types, select 'Accounts in any organizational directory (Any Azure AD Directory - Multitenant)' and click 'Register'.
...
- A new Application will now be available. System will auto generate Client/Application ID, Directory/Tenant ID and Object ID for the application.
- Next step is to create a new Client Secret Key. Click on 'Certificates & secret'. On 'Certificate & secret' screen, click on 'New Client secret' to generate a new secret key. Add a name to the secret key to identify the key and select Expires ‘Never’. Click 'Add'.
- A new secret key will be auto generated. This secret key will be used in Luma to enable auto authentication. The key would be encrypted later, Copy the key and save it for later use. This ID will be used in Channel configuration setting in Luma.
...
- Now, navigate to API permissions and click on Add a permission button to request permissions for your application to communicate with Luma.
8.
- On Request API permission screen, Click on Microsoft Graph.
9.
- Click Application permissions,select the below permissions:
a) User.Read
b) Under AccessReview, select AccessReview:Read.All
c) Under Directory, select Directory.Read.All
Click on Add Permissions to update permissions for your app. 10. Requested
- Requested permissions will now appear in the API Permission list. Click 'Grant admin consent ' button.
11.
- System now prompts a message to grant consent for requested permissions. Click Yes to update.
12.
- Once the permissions are added, Success message "Successfully granted admin consent for the requested permissions." will appears.
13.
- Copy the Application Id from Application screen and save it for later use. This ID will be used in Channel configuration setting in Luma.
Configuration Changes in Luma
- Login to Luma with admin credentials and navigate to Tenant Settings.
- On Settings screen→ Manage Channel ID section, select 'MS_Teams' Channel for configuration. Set User attributes to 'channelSourceData'. Add User App id and Secret key copied from Azure portal (in previous steps) and click on Save.
Users will now be auto authenticated using channel specific source data.