Create and download the manifest file for pre-published 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.
Only one pre-published app setup can be connected to the Microsoft Teams tenant.
Note: You can connect multiple self-configured app environments to the Microsoft Teams tenant as you can create separate Azure apps for each self-configured app environment. For information about creating a manifest file for self-configured apps, see Create and download the manifest file for self-configured apps.
Procedure
Navigate to All > ServiceNow for Microsoft 365 > Application Manifest > ServiceNow for Teams.
Select New.
The Generic Info section opens.
On 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.
- Select Connect multiple ServiceNow instances to your Microsoft Teams tenant to connect multiple ServiceNow instances to one Microsoft Teams tenant. This is applicable for self-configured apps. For more information, see Create and download the manifest file for self-configured apps.
Configure Virtual Agent tab
Configure the Virtual Agent in your instance.
For more information, see Conversational Integration with Microsoft Teams.
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. For a self-configured app, you must provide the Application (client) ID and Directory (tenant) ID in the Configure Tab section.
pre-published app configure tab
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 - sso - <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.
What to do next
You must upload the manifest file in Microsoft Teams. For more information, see Upload manifest file in Microsoft Teams.
Parent Topic:Setup for integrating pre-published apps with Microsoft Teams for Employee Experience