Create an Azure Bot in the Azure Portal

In this tutorial, you will create a resource group and configure a new Azure bot in the Azure Portal.

Create a Resource Group

If you already have a resource group, you can skip this section.

To create access to a resource group, follow these steps:

1. Click the Create a resource card.
2. In the Marketplace search, enter resource group.
3. In the search results, find the Resource group card. At the bottom of this card, click Create > Resource group.
4. On the Create a Resource group page, select your subscription from the list. A trial or usage-based one will work.
5. Add a unique name for the group.
6. Select a region where all resources will be stored.
7. Save changes by clicking Review + create > Create.

Your resource group will be created. You can check it by clicking the bell icon > Go to resource group.

Create an Azure Bot

To create a bot, follow these steps:

1. Click the Create a resource card.
2. In the Marketplace search, enter Azure Bot or azure bot.
3. In the search results, find the Azure bot card. At the bottom of this card, click Create > Azure bot.
4. On the Create an Azure bot page, fill in the following fields:
   • Bot handle - enter a display name of the Azure bot that you are creating.
   • 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.
5. In the Microsoft App ID section, select Single Tenant or Multi Tenant type of App.
6. In the Creation type list, select Use an existing app registration.
7. In the App ID field, Enter the Client ID you previously copied and saved.
8. In the App tenant ID field, enter the Client Secret you previously copied and saved.
   This field is required only for the Single Tenant option.
9. Save changes by clicking Review + create > Create.
   

Wait for the deployment, which might take 1-2 minutes, then go to the resource.

Configure the Azure Bot

Go to the Azure Bot that you have just created:

1. In the Settings section, select Configuration.
2. In the Messaging endpoint field must be the previously copied Endpoint URL from the Cognigy.AI Azure Bot Services Endpoint
3. Activate the Enable Streaming Endpoint checkbox.
4. Click Add OAuth Connection Settings.
5. On the New Connection Setting window, fill in the following fields:
   • Name — add a unique name. Copy and save this name for later usage in Cognigy.AI.
   • Service provider — select Azure Active Directory v2.
   • Client ID — enter the previously copied and saved Client ID.
   • Client Secret — enter the previously copied and saved Client Secret.
   • Token Exchange URL — enter the Cognigy AI Endpoint URL.
   • Tenant ID — enter the “common” word for a Multi-tenant or the tenant ID for a Single tenant.
   • Scopes — add permissions your bot should have. Must be in a space-delimited list, for example, email offline_access openid profile User.Read.
6. Click Save.
7. At the bottom of the Configuration page, click Apply.

Note: If you reopen the connection, you can use the Test Connection button to test the connection. However, be aware that if you use Single Tenant, this test will not succeed. This is not a cause for concern, as everything still functions correctly. The test is not designed to work with Single Tenant.

Channels Section

Add the Teams channel to your channel list. 

1. Go to the Azure Bot that you have just configured.
2. In the Settings section, select Channels.
3. In the Available channels section, select Microsoft Teams.
4. Accept Terms of Service by clicking Agree.
5. Click Save.

The Teams channel appears in your channel list.

Note: The Teams channel might display some errors. These errors can be ignored, as each message is properly delivered to Cognigy.AI and processed.

Update the Cognigy Azure Bot Services Endpoint

To update the Cognigy Azure Bot Endpoint:

1. Go to the Cognigy.AI interface, then Deploy > Endpoints. Select your previously created Azure Bot Services Endpoint.
2. In the Bot Framework Settings section:
   • Add the Client ID to the Microsoft App ID.
   • Add the Client Secret to the Microsoft App Password.
   • Add the Connection Name to the SSO Connection Name.
3. Save changes.
   

Once the Azure Bot has been configured, you can create an App for Teams.