Create and download the manifest file for self-configured apps
Create and download the ServiceNow for Microsoft Teams manifest file from your instance to enable Microsoft Teams to use the ServiceNow for Teams app.
Before you begin
Role required: external_app_install_admin
About this task
You can connect multiple ServiceNow instances to one Microsoft Teams tenant. For more information, see Integrating multiple ServiceNow instances with a single Microsoft Teams tenant.
Multiple self-configured app environments can be connected to the Microsoft Teams tenant as you can create separate Azure apps for each self-configured app environment.
This process is for configuring a Microsoft Teams manifest file, which dictates how an application would behave in Microsoft Teams. For information about the manifest generation provided by ITSM/HR, see Auto-generate the manifest file for uploading on Microsoft Teams, which includes more available configurations.
Note: You can only connect one pre-published app setup to the Microsoft Teams tenant. For information about creating a manifest file for pre-published apps, see Create and download the manifest file for pre-published apps.
Procedure
Navigate to All > ServiceNow for Microsoft 365 > Application Manifest > ServiceNow for Teams.
Select New.
The Generic Info section opens.
In the Generic Info section, fill in the fields.
| Field | Description |
|---|---|
| Short name | Short name for the manifest file. |
| Full name | Complete name for the manifest file. |
| Version | Version of the manifest file. For example, `1.0.0`. |
| Unfurl Links | Option to unfurl the links in Microsoft Teams.Link unfurling generates a content-rich preview\(adaptive card\) when a supported link is shared in a conversation with a user in Microsoft Teams. For more details about link unfurling, refer Unfurl the web links in Microsoft Teams chat. |
| Short description | Short description about the manifest file. |
| Description | Detailed description about the manifest file. |
| Accent Color | Custom color for the conversations in Microsoft Teams according to the company branding. The accent color must be in the HTML color code format. |
| Use default images | Option to use the default images for branding.Note: If you want to customize the company branding, clear the Use default images option and then upload the icons. For more information on the size of icons, see App icons and manifest schema icons. |
Select Submit.
Select Next.
Next option in Generic Info tab
The **Configure Virtual Agent** section opens
In the Configure Virtual Agent section, select either of the following options.
- Select Connect a single ServiceNow instance to your Microsoft Teams Tenant to connect one ServiceNow instance to a Microsoft Teams tenant. The Virtual Agent Bot ID is auto-populated when you select this option. This is applicable for pre-published apps. For more information, see Create and download the manifest file for pre-published apps.
- Select Connect multiple ServiceNow instances to your Microsoft Teams tenant to connect multiple ServiceNow instances to one Microsoft Teams tenant.
Configure Virtual Agent tab
To configure the Virtual Agent in your instance, select **Configure Virtual Agent**. For more information, see [Conversational Integration with Microsoft Teams](../../conversational-interfaces/virtual-agent/teams-conv-integration.md).
To integrate Virtual Agent with Microsoft Teams by configuring your own bots, see [Integrating Virtual Agent with Microsoft Teams using the self-configured bot](../../conversational-interfaces/virtual-agent/va-integ-teams-self-configured-bot.md).
In the Configure Tab section, fill in the fields.
Field Description Enable tabs Option to add tabs in the Microsoft Teams application. This option is selected by default. Tab name Name of the service portal tab that appears in the Microsoft Teams application. Enable Activity Feed Option to enable the activity feed to receive campaign notifications in Microsoft Teams. This option is selected by default. Application (client) ID The client ID of the Azure app. Directory (tenant) ID The tenant ID of the Azure app. For a self-configured app, you must provide the Application (client) ID and Directory (tenant) ID in the Configure Tab section. The Tenant ID and Client ID (App ID) can be fetched from the Azure portal.
self-configured app options
Select Next.
The Ready section opens.
In the Ready section, select the Enable Activity Feed option to receive notifications for campaigns.
Navigate to the Application registry record and view the OIDC Provider Configuration record.
- Select the link in the information message at the top of the page.
- Navigate to System OAuth > Application Registry and select Azure AD - <Tenant-ID>. The User Claim is part of the id_token that is fetched from Microsoft Entra ID (Entra ID). The User Field must be configured so that the value fetched from the User [sys_user] table matches the User Claim value.
Note: If none of the configured fields match the User Claim value, you can create a custom field and enter the required value.
Verify the details provided and select Download Manifest.
Manifest file
The manifest file is downloaded in the zip format and an application registry is created.
What to do next
You must upload the manifest file in Microsoft Teams. For more information, refer Upload manifest file in Microsoft Teams.
Parent Topic:Setup for integrating self-configured apps with Microsoft Teams for Employee Experience