Azure Bot Services: Deploy an Endpoint (Microsoft Teams) – Cognigy.AI Help Center

Azure Bot Services: Deploy an Endpoint (Microsoft Teams)

Cognigy Support
February 24, 2023

Within our Cognigy.AI platform you're able to connect your Cognigy resources to Azure Bot Services (formerly known as Microsoft Bot Framework) by using our Endpoint integration.

Inject & Notify

You can use the Inject and Notify functionality with this type of Endpoint. For further details see the Inject & Notify Documentation page.

Microsoft Teams Deployment Options

When used for MS Teams, this Endpoint is used to deploy a virtual agent as a direct messaging bot that users can directly chat with in a private chat session. For deploying a virtual agent that answers when it is mentioned by a user in a team channel post, please use the Microsoft Teams Endpoint.

Description

This tutorial covers the necessary steps for creating and connecting an Azure Bot Services Endpoint to Azure Bot Service (Microsoft Bot Framework). If you want more information about assigning a Flow to the Endpoint and setting up the Data Management see Endpoints.

Whitelisting of URLs

The Azure Bot Services Endpoint needs to make requests to the following domains. You can whitelist these in your proxy if necessary:

Setup Process

  1. Create an Azure Bot Services Endpoint in Cognigy.AI
  2. Integrate Azure Bot Services with your Bot Framework team
  3. Send messages to your Bot

1. Create a Azure Bot Services Endpoint

Location: Cognigy.AI

The first thing you need to do is to create an Azure Bot Services Endpoint in Cognigy.AI. In order to do this, navigate to your Project, click on the button in the lower left corner and create an Endpoint.

Creating an Azure Bot Services Endpoint

After creating your Endpoint, you should be navigated to the Endpoint configuration of your Azure Bot Services Endpoint. Here you need to set the Flow that the Endpoint should point to, and you can change the NLU Connector of the Endpoint.

The Azure Bot Services Endpoint settings

Now that you have created the Azure Bot Services Endpoint, all that is left to do is to connect it to the Azure Bot Services. The Azure Bot Services Endpoint contains Azure Bot Services Settings which are two settings we need in order to connect to the Endpoint of the Azure Bot Service. We will need:

2. Creating a bot in Azure Bot Service

Requirements

✔ Endpoint URL

In order to create a bot in Azure Bot Service, log into the Azure portal and search for "Bot Services". Create a new bot and choose "Azure Bot".

Select "Create" which will take you to the "create an azure bot" menu.

Creating the Azure Bot

Complete the information on the next page and finish the creation of the bot.

Once the bot appears on your list of Bot Services, select the bot and navigate to the "Configuration" tab. Add the Cognigy Endpoint URL you as the Messaging endpoint

Adding the Endpoint URL to the bot

You will also find the Microsoft App ID on the configuration page, which will be required in step 3.

### 3. Connecting your Azure Bot Services Endpoint to Azure Bot Service

**Requirements**

✔ Endpoint URL  
✔ Bot in Azure Bot Service

To connect your Endpoint in Cognigy.AI to the Azure Bot Service, do the following steps:

1. Get the bot's **App ID** and **App Password**from Azure Bot Service. In the Azure Bot Service Dashboard, go to the Configuration page of your bot.
2. Find the **Microsoft App ID** field. Copy the value and save it temporarily, for example, in a text editor.
3. Open the [Azure Active Directory admin center](https://aad.portal.azure.com/) and click **Azure Active Directory > App registrations**.
4. Select created bot from the application list.
5. In the **Manage** menu, click **Certificates & secrets**.
6. Create a client secret. Copy the value and save it temporarily, for example, in a text editor.

**Additional Security settings for Secure Azure Tenants**

Some Azure tenants will require a manual adjustment of the signInAudience parameter in the App's manifest. This will be evident if messages are not received when first testing the bot. To change this value, from the Azure portal homepage, navigate to _App Registrations_ > _{Your Bot Registration}_ > _Manifest_ and change the **_signInAudience_** parameter to **_AzureADMultipleOrgs_**.

Now you have the App Id and the App Password (Client Secret) so you can open the Azure Bot Services Endpoint in Cognigy.AI and put in the values in the corresponding fields in the `Bot Framework Settings` Form.

_Configuring the Endpoint with the app credentials_

You are now finished with connecting your Endpoint with Azure Bot Service! [Link a channel](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0) to your bot in Azure Bot Service and talk to your Conversation AI in Cognigy.AI.

There are many channels that you are able to connect to via Azure Bot Services, one such example is a direct messaging bot in Microsoft Teams as shown below:

_Example of the direct messaging MS teams chatbot_

### Endpoints & Channels  
- [Azure Bot Services: Advanced Deployment with SSO (Microsoft Teams): SSO and Graph API Nodes](https://support.cognigy.com/hc/en-us/articles/6422300559388-Azure-Bot-Services-Advanced-Deployment-with-SSO-Microsoft-Teams-SSO-and-Graph-API-Nodes)  
- [Azure Bot Services: Advanced Deployment with SSO (Microsoft Teams): Apps Developer Portal](https://support.cognigy.com/hc/en-us/articles/6422298661404-Azure-Bot-Services-Advanced-Deployment-with-SSO-Microsoft-Teams-Apps-Developer-Portal)  
- [Azure Bot Services: Advanced Deployment with SSO (Microsoft Teams): Azure Portal](https://support.cognigy.com/hc/en-us/articles/6422296629404-Azure-Bot-Services-Advanced-Deployment-with-SSO-Microsoft-Teams-Azure-Portal)  
- [Azure Bot Services: Advanced Deployment with SSO (Microsoft Teams): Azure Active Directory Portal](https://support.cognigy.com/hc/en-us/articles/6422293904540-Azure-Bot-Services-Advanced-Deployment-with-SSO-Microsoft-Teams-Azure-Active-Directory-Portal)  
- [Azure Bot Services: Advanced Deployment with SSO (Microsoft Teams): Intro](https://support.cognigy.com/hc/en-us/articles/6417377133596-Azure-Bot-Services-Advanced-Deployment-with-SSO-Microsoft-Teams-Intro)  
- [Amazon Connect: Intro](https://support.cognigy.com/hc/en-us/articles/6229662732444-Amazon-Connect-Intro)  
- [Amazon Connect: Setup Amazon Connect](https://support.cognigy.com/hc/en-us/articles/6229664156060-Amazon-Connect-Setup-Amazon-Connect)  
- [Amazon Connect: Control Amazon Connect from Cognigy.AI](https://support.cognigy.com/hc/en-us/articles/6229683335196-Amazon-Connect-Control-Amazon-Connect-from-Cognigy-AI)  
- [Amazon Connect: Enable SSML replies from Cognigy.AI](https://support.cognigy.com/hc/en-us/articles/6229684421916-Amazon-Connect-Enable-SSML-replies-from-Cognigy-AI)  
- [Amazon Lex: Setup AWS Lambda (Amazon Lex NLU)](https://support.cognigy.com/hc/en-us/articles/6229644597020-Amazon-Lex-Setup-AWS-Lambda-Amazon-Lex-NLU)