Configure Application Registry on the ServiceNow instance

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment.

You can register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment using one of the following methods.

• Edit existing Microsoft Teams Chat self-configured app application registry (Recommended)
• Create an application registry for Microsoft Teams chat self-configured app

Edit existing Microsoft Teams Chat self-configured app application registry

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment by editing existing Microsoft Teams Chat self-configured app application registry.

Before you begin

Role required: oauth_admin

Procedure

1. Navigate to All > System OAuth > Application Registry.
2. Search and select Microsoft Teams Chat Single Tenant application registry.
3. Fill in the details Client ID and Client Secret on the form.
4. Select Save.
5. All > ServiceNow for Microsoft 365  > Properties
6. Enable the option Set this property to true to use integration hub action for Start Chat / Import chat flows on the ServiceNow for Microsoft Teams properties form
   The OAuth profile property Sys ID of OAuth profile for single tenant setup is set to default (OOB) when shipped with application registry.
7. Select Save.

Create an application registry for Microsoft Teams chat self-configured app

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment by creating a Microsoft Teams Chat self-configured app application registry.

Before you begin

Note:

Use this procedure only if it is absolutely required.

Role required: admin

Procedure

1. Navigate to All > System OAuth > Application Registry.
2. Select New.
3. Select  Connect to a third party OAuth Provider.
4. On the form, fill in the fields.

   Table 1. Application Registries - Microsoft Teams Chat for Single Tenant

   Field	Description
   Name	Name to uniquely identify the record. For example, enter: Microsoft Teams chat self-configured app
   Client ID	Client ID created in Azure portal. Provide the value of the Azure application ID in this field.
   Client Secret	The password you generated when creating the app in Microsoft Teams. For more information, see Register and configure the Request-based chat application on the Microsoft Azure portal.
   Authorization URL	Authorization URL that includes the tenant ID of your app with the format https://login.microsoftonline.com/{tenantid}/oauth2/v2.0/authorize where is the tenant ID created during the app creation in Microsoft Teams.
   Token URL	Token URL that includes the tenant ID of your app with the format https://login.microsoftonline.com/{tenantid}/oauth2/v2.0/token where is the tenant ID created during the app creation in Microsoft Teams.
   Redirect URL	Redirect URL that includes the instance URL with the format https://<instanceURL>/oauth_redirect.do Update the <instanceURL> value with your instance URL.

   
5. Select OAuth Entity Scopes related list.
6. Add the following scopes.
   • Enter Default in Name and enter .default in OAuthscope.
   • Enter Offline Access in Name and enter offline_access in OAuthscope.
7. Select Save.
   System generates an OAuth Entity profile.
8. See OAuth Entity Profile details in the related list OAuth Entity Profiles.
9. Open the OAuth Entity Profile record and copy the Sys ID.
10. Navigate to All > ServiceNow for Microsoft 365 > Properties.
11. Enable the option Set this property to true to use integration hub action for Start Chat / Import chat flows on the ServiceNow for Microsoft Teams properties form.
12. Enter the copied OAuth Entity Profile value in the field Sys ID of OAuth profile for single tenant setup. This needs to be setup if you are setting "sn_tcm_collab_hook.teams_use_ih_actions_for_single_tenant" to true.
13. Select Save.