You must create a bot in Microsoft Teams to be able to integrate with the Virtual Agent.

Before you begin

Role required: none

Procedure

  1. Login into Microsoft Teams and navigate to Developer Portal.
  2. On the Developer Portal page, navigate to the Tools > Bot Management.
  3. Click Create a New bot and provide a bot name of your choice and click Add.
  4. Open the bot that you created and click the Configure tab.
  5. Under Endpoint address, provide the instance URL in the Bot endpoint address field click Save.
    For example: https://<instancename>.service-now.com/api/now/v1/cs/adapter/msft/events.
    Note: 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.
  6. Navigate to Client secrets and click Add a client secret for your bot.
  7. 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 click OK.
  8. Navigate to Developer Portal > Tools > Bot management and copy the Bot ID of the bot you created.
  9. 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.
  10. Press Enter to save.

What to do next

Integrate your Self-configured bot with single Microsoft Teams tenant.