Azure Bot ServicesΒΆ

Deprecation: Handover Providers in Endpoint Settings
The Handover Providers section in the Endpoint settings has been deprecated in 4.97. The removal date is September 2025. We encourage you to try our new Handover Providers interface, which offers greater flexibility for managing your integration with contact centers. For a smooth migration, refer to the migration guide.
The Azure Bot Services Endpoint enables you to connect your AI Agent to the Azure Bot Services platform. This integration allows you to deploy your AI Agent to Microsoft Teams and other channels supported by Azure Bot Services.
PrerequisitesΒΆ
- Access to the Azure Bot Services platform.
- An account on the Microsoft Entra Admin Center.
- An account on the Microsoft Teams Developer Portal.
RestrictionsΒΆ
- In Microsoft Teams, postback buttons in quick reply, gallery, list, or button configurations will always display the button title in the user's chat when clicked. This behavior can't be disabled but doesn't affect other channels supported by the Azure Bot Services Endpoint.
Generic Endpoint SettingsΒΆ
Learn about the generic Endpoint settings available on the following pages:
- Endpoints Overview
- NLU Connectors
- Data Protection & Analytics
- Transformer Functions
- NLU Connectors
- Session Management
- Real-Time Translation Settings
- Transformer Functions
- Handover Settings
- Inject and Notify
Specific Endpoint SettingsΒΆ
Azure Bot Services Settings
Setting | Description |
---|---|
Access Scope | Defines who can access this app: - Multi Tenant β allows users from any Azure Active Directory (AAD) tenant to access the app, for example, users from different organizations. - Single Tenant β restricts access to one specific AAD tenant. Only accounts within your organizationβs directory can log in. |
Restrict to Azure AD Accounts | When Multi Tenant is selected, this toggle restricts access to Azure AD accounts only. It prevents public access and allows access only for accounts managed in your organization's Azure Active Directory. |
Microsoft App ID | The app ID for your bot. You can find it on the Settings page of your bot in the Azure Bot Services Dashboard. |
Microsoft App Password | The Client Secret for your bot. You can find it on the App Registrations page in the Azure Bot Services Dashboard. |
SSO Connection Name | The name of the connection you create in Azure Bot Services when setting up a Bot. This name is used when connecting the Endpoint with an SSO integration. |
How to Set UpΒΆ
Setup on the Cognigy.AI SideΒΆ
1. Create an Azure Bot Services Endpoint
- In the left-side menu of your Project, click Deploy > Endpoints.
- On the Endpoints page, click + New Endpoint.
- In the New Endpoint section, do the following:
- Select the Azure Bot Services Endpoint type.
- Specify a unique name.
- Select a Flow from the list. Save changes.
- In the Configuration Information section, copy the Endpoint URL and save it for later use in Azure Bot Services.
Setup on the Azure Bot Services SideΒΆ
1. Create an App in Azure AD B2C
- Go to the Microsoft Entra Admin Center and select Azure AD B2C.
- In the Manage section, select App registrations, then click New registration.
-
In the Supported account types section, select one of the following options:
- Under Redirect URI, pick Single-page application (SPA) and enter the URL
https://login.microsoftonline.com/<tenantID>/oauth2/v2.0/token
. - Click Register, then copy Tenant ID.
- Go to Entra ID > App registrations, find your application that you created. Then copy and save the Application (client) ID.
- Open the app by clicking on its name. Go to Manage > Authentication. Enter the Cognigy.AI Endpoint URL in the Front-channel logout URL field. In the Supported account types section, ensure that Accounts in this organizational directory only for a single tenant is enabled.
1. Under **Redirect URI**, select **Single-page application (SPA)** and enter the URL `https://token.botframework.com/.auth/web/redirect`. 2. Go to **Entra ID > App registrations**, find the app that you created. Then copy and save the **Application (client) ID**. 3. Open the app by clicking its name. Go to **Manage > Authentication**. Enter the Cognigy.AI Endpoint URL in the **Front-channel logout URL** field. In the **Supported account types** section, ensure that **Accounts in any organizational directory** for a multitenant is enabled.
- Under Redirect URI, pick Single-page application (SPA) and enter the URL
-
Go to Manage > Certificates & secrets. Click + New client secret. Name your secret, set expiry, click Save. Copy the value and save it for later use.
- Go to Manage > API permissions, click + Add a permission, then Microsoft Graph > Delegated permissions. Select
openid
, which is required for SSO. Select other permissions likeemail
if needed. - Click Add permissions. Click Grant admin consent if required β permissions get a green check.
- Go to Manage > Expose an API. In the Application ID URI field, enter
api://botid-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
. Replacex
with your saved Client ID. Save changes. - Click + Add a scope. Name the scope. Allow both admins and users to consent. Fill in other required fields. Save changes.
- Click + Add a client application and add:
5e3ce6c0-2b1f-4285-8d4b-75ee78787346
(MS Teams Web)1fec8e78-bce4-4aaf-ab1b-5451cc387264
(MS Teams Mobile & Desktop)
- Go to Manage > Manifest, update the following parameters to the values:
AccessTokenAcceptedVersion
to2
.Oauth2RequirePostResponse
totrue
(use only for Single Tenant).SignInUrl
β enter your Cognigy.AI Endpoint URL. Save changes.
2. Create a Resource Group in Azure Bot Services
If you already have a resource group, you can skip this section.
- Click the Create a resource card. In the Marketplace search, enter resource group.
- In the search results, find the Resource group card. At the bottom of this card, click Create > Resource group.
- On the Create a Resource group page, select your subscription from the list. A trial or usage-based one will work.
- Specify a unique name for the group.
- Select a region to store the resources.
- Save changes by clicking Review + create, then Create.
Your resource group will be created. You can check it by clicking the bell icon, then Go to resource group.
3. Create a Bot in Azure Bot Services
- Click the Create a resource card.
- In the Marketplace search, enter azure bot. In the search results, find the Azure bot card. At the bottom of this card, click Create > Azure bot.
- On the Create an Azure bot page, fill in the following fields:
- Bot handle - enter a display name for the Azure bot.
- Subscription and Resource group - select the same values that you previously configured in the Resource group section.
- Data residency β select Global.
- Pricing tier β select Free plan by clicking Change plan.
-
In the Microsoft App ID section, fill in the following fields according to the scope of your app:
- Select Single Tenant.
- In the Creation type list, select Use an existing app registration.
- In the App ID field, enter the Client ID you previously copied and saved.
- In the App tenant ID field, enter the Client Secret you previously copied and saved.
- Select Multi Tenant.
- In the Creation type list, select Use an existing app registration.
- In the App ID field, enter the Client ID you previously copied and saved.
-
Save changes by clicking Review + create, then Create. Wait for the deployment, which might take 1-2 minutes, then go to the resource.
- In the Settings section, select Configuration.
- The Messaging endpoint field must contain the previously copied Endpoint URL from the Azure Bot Services Endpoint. Activate Enable Streaming Endpoint. Click Add OAuth Connection Settings.
- On the New Connection Setting window, fill in the following fields:
- Name β add a unique name. Copy and save this name for later use in Cognigy.AI.
- Service provider β select Azure Active Directory v2.
- Client ID β enter the Client ID you previously copied and saved.
- Client Secret β enter the Client Secret you previously copied and saved.
- Token Exchange URL β enter the Cognigy.AI Endpoint URL.
- Tenant ID β enter the word
common
for a multitenant or the tenant ID for a single tenant. - Scopes β add the permissions your bot should have. Must be in a space-delimited list. For example,
email offline_access openid profile User.Read
.
- Save changes. At the bottom of the Configuration page, click Apply.
4. Add the Teams Channel to your Azure Bot
- Add the Teams channel to your channel list.
- Go to the Azure Bot that you have just configured.
- In the Settings section, select Channels.
- In the Available channels section, select Microsoft Teams.
- Accept Terms of Service by clicking Agree. Click Save. The Teams channel appears in your channel list.
Note
The Teams channel might display errors. You can ignore these errors because each message is properly delivered to and processed by Cognigy.AI.
5. Update the Azure Bot Services Endpoint
To update the Azure Bot Services Endpoint:
- In the Cognigy.AI interface, go to Deploy > Endpoints. Select the Azure Bot Services Endpoint you previously created.
- In the Bot Framework Settings section, fill in the fields as follows:
- Microsoft App ID β enter the Client ID.
- Microsoft App Password β enter the Client Secret.
- SSO Connection Name β enter the Connection Name.
6. Create a Microsoft Teams App
- Go to the Microsoft Teams Developer Portal and select Apps from the left pane.
- Select + New app, enter your app name and click Add. Go to Configure > Basic Information.
- Fill in the following fields:
- Short description β a brief summary about your app.
- Long description β more details about your app, such as its functions or restrictions.
- Developer or Company name β for example,
Cognigy
. - Website β for example, https://www.cognigy.com/.
- Privacy policy β for example, https://www.cognigy.com/privacy-policy.
- Terms of use β for example, https://www.cognigy.com/legal-notice.
- Application (client) ID β the Client ID you saved earlier.
- (Optional) Microsoft Partner Network ID β only if you have admin consent permissions.
- Save changes and specify which features your bot will use:
- Go to Configure > App features.
- Select the Bot card.
- On the Bot page, configure the following settings: 3.1 Select Enter a bot ID and enter your saved Client ID. 3.2 Enable Upload and download files β required to prevent a bug that blocks attachments. 3.3 Select Personal scope.
- Save changes.
(Optional) 6.1 Configure Single Sign-On
If you want to use Single Sign-On (SSO) with your bot, follow these steps:
- Go to Configure > Single sign-on.
- In the Application ID URI field, enter
api://botid-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
. Replacex
with your saved Client ID. Save changes. - Still under Single sign-on, add these domains:
token.botframework.com
β for token authentication.mydomain.com
β your Endpoint's hosting domain.- To complete the SSO configuration, go to the Cognigy Help Center: SSO and Graph API Nodes guide.
7. Configure the App Package
- Go to Configure > App package.
- At the top, click Download App package.
- Unzip the downloaded package, you'll get two images and a
manifest.json
file. Open themanifest.json
in a code editor. Make these adjustments:- Around line 6, replace
packageName
with your unique package name β do not usecom.package.name
. Otherwise, SSO won't work. - Add this key at the top level:
"permissions": ["identity", "messageTeamMembers"]
- Around line 6, replace
- Save the changes and zip the modified
manifest.json
file and the two images. The new zip file must contain only these files. - Open your Teams client or go to https://teams.microsoft.com.
- In the bottom-left corner, click Apps.
- Click Upload a custom app and select your new
.zip
package. Click Add β the bot should now appear as a contact you can chat with.