Skip to content
Integrate VA with MS Teams for GCC-H › Specialized VA integrations for Teams › Integrate VA with Teams › Conversational Integration with Microsoft Teams › Integrate VA with messaging apps › Integrate VA with other channels › Virtual Agent › Conversational Interfaces
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Integrate your self-configured bot with Microsoft Teams for GCC-H or DoD

Link your registered Microsoft Teams bot with your ServiceNow instance to integrate it with the Virtual Agent. Use your ServiceNow Virtual Agent application to install and configure Conversational Integration with Microsoft Teams.

Before you begin

Role required: virtual_agent_admin or admin and Microsoft Azure admin.

Procedure

  1. Fetch the Tenant ID, Client ID (Application ID), Client Secret, and Bot Name details for your bot created in Microsoft Teams.

    For more information, see Retrieve bot details.

    Note: Use this information when setting up the self-configured bot in your ServiceNow instance.

  2. As a ServiceNow admin, set up the self-configured bot on the ServiceNow instance in the global scope.

    1. Log in to your ServiceNow instance and navigate to All > Conversational Interfaces > Settings.

    2. In General Settings under Channels, 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.

Image omitted: add-msteams-self-integ.png
Microsoft Teams Add Integrations options. The Integrate with Self-configured bot option is selected.
4.  From the **Add Integrations** drop-down, select **Integrate with your self-configured bot**.

5.  In the Integrate Microsoft Teams with self-configured bot page, provide the **Name of the bot**, **Tenant ID**, **Client ID \(App ID\)**, and **Client Secret** that you made a note while creating the Microsoft Teams bot and select **Submit**.
Image omitted: msteams-multi-integ.png
Integrate Microsoft Teams with self-configured bot window in Conversational integrations Channels and integrations settings.
    **Note:** If you own multiple ServiceNow instances and would like to integrate additional bots for additional instances, repeat the preceding steps to add and integrate with bots.

    If you would like to integrate your ServiceNow instance with another Microsoft Teams bot, select the Plus icon against the Self-configured bot or select the **Add integration** drop-down on the Manage Microsoft Teams channel page and select **Integrate with your self-configured bot**.
Image omitted: add-self-config-integ-2.png
Manage Microsoft Teams channel in Conversational Interfaces general settings. The Add integration button and Self-configured bot option under Add integration are highlighted.
    For more information, see [Manage the ServiceNow Virtual Agent integration with Microsoft Teams](configure-va-teams.md).

    User receives a message that the installation is successful.

  1. In your ServiceNow instance, navigate to System OAuth > Application Registry and open the record that contains the sample-msteams-oauth-consumer.

  2. Right-select on the grey bar header titled OAuth OIDC Entity on the top of the page to select Configure > Form Layout.

Image omitted: gcc-h-form-layout.png
OAuth OIDC Entity record page with Form Layout selected from Configure option.

  1. Search for Token URL from the Available field, add it to the Selected field, and move it under Redirect URL.

  2. Select Save to save the layout.

Image omitted: save-form-layout-gcc-h.png
OAuth OIDC Entity form configuration page, with Token URL option selected
You’re redirected to the OAuth OIDC Entity record.

  1. On the OAuth OIDC Entity form, select the lock icon to unlock the Token URL field, and then update the default value:

    • For multi-tenant application: https://login.microsoftonline.us/MicrosoftServices.onmicrosoft.us/oauth2/v2.0/token
    • For Single-tenant application: https://login.microsoftonline.us/<Tenant-ID>/oauth2/v2.0/token
    • Scroll down the OAuth OIDC Entity form, select the OAuth Entity Scopes tab, and update the OAuth scope's default value to https://api.botframework.us/.default.

  2. On the OAuth OIDC Entity form, select the information icon next to the OAuth OIDC Provider Configuration field and select Open Record.

  3. On the OIDC Provider Configuration form, update the OIDC Metadata URL to https://login.botframework.azure.us/v1/.well-known/openidconfiguration and select Update.

Parent Topic:Integrating Virtual Agent with Microsoft Teams for GCC-H or DoD