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.

Antes de Iniciar

Role required: external_app_install_admin

Por Que e Quando Desempenhar Esta Tarefa

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.

Nota:

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.

Procedimento

1. Navigate to All > ServiceNow for Microsoft 365 > Application Manifest > ServiceNow for Teams.
2. Select New.
   The Generic Info section opens.
3. On the Generic Info section, fill in the fields.

   Tabela 1. Generic Info Form

   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. Nota: 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.

4. Select Submit.
5. Select Next.
   
   The Configure Virtual Agent section opens
6. 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.
   
   
   
7. Configure the Virtual Agent in your instance.
   For more information, see Conversational Integration with Microsoft Teams.
8. In the Configure Tab section, fill in the fields.

   Tabela 2. Configure Tab form

   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.

   
   
   
9. Select Next.
   The Ready section opens.
10. In the Ready section, select the Enable Activity Feed option to receive notifications for campaigns.
11. 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.

    Nota:

    If none of the configured fields match the User Claim value, you can create a custom field and enter the required value.
12. Verify the details provided and select Download Manifest.
    
    
    
    The manifest file is downloaded in the zip format.

O que Fazer Depois

You must upload the manifest file in Microsoft Teams. For more information, see Upload manifest file in Microsoft Teams.