Azure Bot Services: Deploy an Endpoint

501691c-AzureBotServices.png 

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:

Inject a Message to a Flow
and
Notify a Contact

Description

This tutorial covers the necessary steps for creating and connecting a 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:

  • login.botframework.com/v1/.well-known/openidconfiguration
  • login.microsoftonline.com/botframework.com/oauth2/v2.0/token
  • *.botframework.com matching to the corresponding channel (e.g. msteams.botframework.com)

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 a 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.

71157ce-azureSettings.PNGCreating 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.

605de86-Screenshot_from_2019-09-03_10-14-19.png

A Created Bot Framework Endpoint

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:

  • The app ID of your bot in Azure Bot Service
  • A secret of your bot in Azure Bot Service

The next chapter will describe where you can find this setting in Azure Bot Services.

2. Creating a bot in Azure Bot Service

Location: 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 Service". Create a new bot and choose "Bot Channel Registration"

41839dc-Screenshot_from_2019-07-15_15-28-58.png

Creating a Bot Channel Registration

Fill out the information on the next page depending on your preferred region, and put in the Endpoint URL you got in the last step as the Messaging endpoint

6bccac7-Screenshot_from_2019-07-15_15-30-49.png

Adding the Endpoint URL to the bot

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

Cognigy.AI

Requirements
✔ Endpoint URL
✔ Bot in Azure Bot Service

To connect your Endpoint in Cognigy.AI to the Azure Bot Service, we need the App ID and the App Password of the bot from Azure Bot Service. To get these, go to the Settings page of your bot in the Azure Bot Service Dashboard and find the Microsoft App ID of the bot. Copy the value and save it e.g. in a text editor. Afterwards, click on the link just above which says "Manage". This takes to you the App Registrations page for your bot where you can create a Client Secret. Create a secret and save it temporary e.g. in a text editor.

6bccac7-Screenshot_from_2019-07-15_15-30-49.png

Client Secret for Bot

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.

e6974dc-Screenshot_from_2019-07-15_16-03-22.png

Configuring the Endpoint with the app credentials

You are now finished with connecting your Endpoint with Azure Bot Service! Link a channel to your bot in Azure Bot Service and talk to your Conversation AI in Cognigy.AI


Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.