---
sourceDocument: Zurich Conversational Interfaces
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/conversational-interfaces

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Integrate your self-configured bot with single Microsoft Teams tenant

# Integrate your self-configured bot with single Microsoft Teams tenant {#ariaid-title1}

* Release version: Zurich
* 
* Updated August 15, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Integrate multiple ServiceNow instances with a single Microsoft Teams tenant by creating multiple bots on the Microsoft Teams tenant. Use your ServiceNow
Virtual Agent application, which supports multiple bots on a single Microsoft Teams tenant, to install Conversational Integration with Microsoft Teams application.

## Before you begin

Role required: virtual_agent_admin or admin and Microsoft Teams Tenant
admin  
This installation requires a ServiceNow instance other than the one integrated with the production bot to integrate with one bot (of the multiple bots) on a single Microsoft Teams tenant.  
Note:  
The ServiceNow instance that you will use to integrate with a single Microsoft Teams tenant must not be an instance that you have used for installing Conversational Integration with Microsoft Teams in the primary method where you can integrate only one ServiceNow instance with one tenant.

Ensure that you created a bot on the Microsoft Teams tenant for each
ServiceNow instance to be integrated. For more
information, see [Create a bot in Microsoft Teams](https://www.servicenow.com/docs/MkBghQ0Z8mf~wkfCDgKbeA "You must create a bot in Microsoft Teams to be able to integrate with the Virtual Agent.").

## Procedure

1. Fetch the Tenant ID, Client ID (App ID), Client Secret, and Bot Name details for your bot created in Microsoft Teams.  
   For more information, see [Retrieve bot details](https://www.servicenow.com/docs/MkBghQ0Z8mf~wkfCDgKbeA#create-bot-msteams__bot-details).  
   Note:  
   Use this information when setting up the bot in your ServiceNow instance.
2. As a ServiceNow admin, set up the bot on the ServiceNow instance in the global scope.  
   Note:  
   The virtual_agent_admin can install bots with multiple instances or bots apart from production in the ServiceNow instance and avail all the features of Virtual Agent and the flexibility to integrate one of the multiple ServiceNow instances with a bot on a single Microsoft Teams tenant.
   1. Log in to your ServiceNow instance (secondary instance for integrating with a bot on single Microsoft Teams tenant) and navigate to AllConversational InterfacesChannels and Integrations.
   2. In General Settings under Channels and integrations, select View All.  
      The Channels and integrations page opens.
   3. Under the Available Channels section in the Microsoft Teams tile, select Add Integrations.  
      Note:  
      The Add Integrations drop-down is available only after installing the Conversational Integration with Microsoft Teams plugin (sn_va_teams) on your ServiceNow instance.
   4. From the Add Integrations drop-down, select Integrate with Self-configured bot.
   5. In the Integrate Microsoft Teams with self-configured bot page, enter the Name of the bot, Tenant ID, Client ID (App ID), and Client Secret from creating the Microsoft Teams bot, and select the Single tenant bot check box before selecting Submit.  
      Figure 1. Integrate Microsoft Teams with self-configured bot  
      Note:  
      For each additional bot to be integrated, repeat steps 1 and 2. If you created your bot before October 2025, you don't need to select the Single tenant box check box.

      If you would like to
      integrate your ServiceNow instance with another Microsoft Teams bot, select the Add integration for Self-configured bot icon against the Self-configured bot or select the Add integration drop-down on the Manage Microsoft
      Teams channel page and select Integrate with Self-configured bot.  
      User receives a message that the installation is successful.
   {#teams-install-custom-app__substeps_mx3_vfk_qrb}
{#teams-install-custom-app__steps_qss_wr4_btb}

## What to do next

* [Auto-generate the manifest file for uploading on Microsoft Teams](https://www.servicenow.com/docs/c9yl6DpUlWlu96oIpwEXjQ "Auto-generate the manifest file and customize the branding of your Microsoft Teams app so that you can make Virtual Agent available in your organization.").
* [Upload the manifest package file to publish your bot](https://www.servicenow.com/docs/J3GxlZB7ndKqA~Xouhr73A "Upload the manifest file that you generated to the Microsoft Teams and test your app experience to make it be available in the Microsoft global app store.")
{#teams-install-custom-app__ul_z4k_znt_y5b}

*[\>]: and then