Create a bot in Microsoft Teams
You must create a bot in Microsoft Teams to be able to integrate with the Virtual Agent.
Before you begin
Role required: Microsoft Teams admin, Global Administrator, or roles containing Application Administrator.
Procedure
Login into Microsoft Teams and navigate to Developer Portal.
On the Developer Portal page, navigate to the Tools > Bot Management.
Select Create a New bot and provide a bot name of your choice and select Add.
Open the bot that you created and select the Configure tab.
Under Endpoint address, specify the following URL:
For example:
https://<instancename>.service-now.com/api/now/v1/cs/adapter/msft/eventsNote: Replace the <instancename> with the name of your ServiceNow instance where you are integrating with Microsoft Teams. In case of multi-instance single tenant integration, use the secondary ServiceNow instance for integrating with a bot on Microsoft Teams tenant.
Select Save.
Navigate to Client secrets and select Add a client secret for your bot.
Copy the value of the client secret from the New client secret generated pop-up for later use as it is displayed only during this step and select OK.
Navigate to Developer Portal > Tools > Bot management and copy the Bot ID of the bot you created.
Retrieve the following details of your bot in Microsoft Teams to integrate with Virtual Agent.
- Tenant ID: Follow the instructions on Microsoft Teams documentation, to fetch the Tenant ID.
- Client ID (App ID): Client ID is the Bot Id that you have copied as mentioned in Step 8.
- Client Secret: It is the secret that you have copied as mentioned in Step 7.
- Bot Name: The name of the bot that you entered in Step 3.
Select the Single tenant check box.
Note: If you created your bot before October 2025, you don't need to select the Single tenant check box.
Press Enter to save.
What to do next
Integrate your self-configured bot with single Microsoft Teams tenant.
Parent Topic:Integrating multiple ServiceNow instances with a single Microsoft Teams tenant