Microsoft Teams - Azure Bot Framework
To use the Agentic platform directly in Microsoft Teams, you will need to create Microsoft Teams - Azure Bot Framework credentials. This page will describe the procedure for this functionality to work, including setting up a Bot Framework in Azure, creating the credentials, and deploying the Microsoft Teams application.
Prerequisites
Before creating the credentials, you must ensure you have set up a Bot Framework in Microsoft Azure.
Setting up Azure Bot Framework
This setup can only be done by an Azure Admin.
Open the Microsoft Azure Admin Portal.
Find and open Bot Services.
In the upper left of the window, click Create to open the list of services.
Select Azure Bot. Note that it might be at the end of the list, so you should click Load more to view the complete list.
In Azure Bot, click Create.
Specify the bot’s details.
In Project details:
Specify the Bot handle (internal name).
Select the subscription and resource group.
In Microsoft App ID:
Select Create new Microsoft App ID.
Select the type of app:
If you plan to only use the bot for your organization's members, select Single Tenant.
If you plan to share the bot with external members, select Multi-Tenant.
Click Review + create.
When the validation is passed, the bot’s details are displayed. Click Create to continue.
After the bot is created, the overview is displayed. Click Go to resource.
10. In the Bot profile menu, enter its name and click Apply. The icon and description are optional.
The provided icon must be a full square icon in PNG format with 192x192 px dimensions. If the icon contains a logo, this logo must fit within 120x120 px in the center (safe area).
11. In the Configuration menu, set the messaging endpoint as https://agentic.konverso.ai/integ/botframework/message/ and click Apply.
12. In the Microsoft App ID area, click Manage to open the Certificates & secrets view.
13. By default, there is already one client secret created. However, it is impossible to copy its value, so it is required to create a new client secret.
14. Click New client secret, enter a description, specify the expiry date, and click Add.
15. After the client secret is created, copy and save its value. It is important to do it right away because the value will be hidden later.
16. Go to Overview and copy the Application (client) ID and Directory (tenant) ID.
17. Now go back to the bot menu (to do so, click its name in the breadcrumbs), go to Channels, select Microsoft Teams, and click Save.
Do not forget to copy the Application (client) ID, Directory (tenant) ID, and Client Secret, as these credentials will be used to create the Microsoft Teams - Azure Bot Framework credentials.
Adding Microsoft Teams - Azure Bot Framework credentials
Below are the steps to create new Microsoft Teams - Azure Bot Framework credentials:
Go to Administration > Credentials & models.
Click Add credentials to create new credentials;
Select the Microsoft Teams - Azure Bot Framework card;
Name your credentials, e.g., MSTeams Bot Framework;
Select who to share the credentials with. This will determine who can modify the credentials. If you want to keep these credentials private, select Only me. If you want to share them with other builders, select Builders.
Provide the Directory (tenant) ID of your Azure tenant.
Provide the Application (client) ID of the Azure Bot.
Provide the Client secret associated with the given Application (client) ID.
If your Azure Bot has been configured to be multi-tenant (meaning that it can be used by multiple tenants), select the Multi-tenant checkbox. If you configured your Azure Bot to be Single tenant, then leave this box unchecked. Please refer to step 6.b. in the Setting up Azure Bot Framework section above.
Click Create.
Read the Setting up Azure Bot Framework above to learn how to get the Directory (tenant) ID, the Application (client) ID, and the Client secret.
The new credentials are now available in the Credentials list.
Video tutorial: How to add Microsoft Teams - Azure Bot Framework credentials
Creating the Microsoft Teams application
Now that you have created your Microsoft Teams - Azure Bot Framework credentials, you will need to contact a Konverso consultant to proceed with the next steps, including the creation of the Microsoft Teams application.
This step is mandatory. Please make sure you contact Konverso to finish the setup and get your Microsoft Teams application ZIP file.
Deploying the Microsoft Teams Application
Once the Konverso consultant gets back to you and provides you with the ZIP file containing the Microsoft Teams application, you will need to register this application inside the Microsoft Teams Application Portal.
Note that this task can only be done by an O365 Admin.
Go to Teams apps > Manage apps.
Click Actions in the top right of the page.
Click Upload new app.
Upload the ZIP file and configure the application according to your requirements.
Please note that you will need to wait between 5 minutes and 48 hours for the application to be available.
What’s next?
Once the application is configured and deployed in Microsoft Teams, users can start chatting with agents by accessing the application.
Users initiating a conversation for the first time will be prompted to authenticate with their Microsoft Teams account via the provided link.
