How to Publish Your Bot on Teams

How to Publish Your Bot on Teams

Prerequisites:

1- Make sure to be the Global admin in the Microsoft Azure portal. Other roles are not able to create a bot.

2- Before publishing Mindbehind bot, make sure to have a healthy bot in Microsoft Azure.

3- After having a healthy Teams bot on Azure, make sure to have MICROSOFT APP ID and MICROSOFT APP PASSWORD.

Registering the Microsoft Teams Bot in Azure:

Make sure to follow all these steps:

https://kb.verba.com/display/docs/Registering+the+Microsoft+Teams+Bot+in+Azure

Creating a bot channel registration

Step 1 - Log in to the Azure portal.

Step 2 - Search for Azure Bot in the search box on the top, then click on the link under the Marketplace section.



Step 3 - In the left panel, provide a unique name at the Bot handle, then select the Subscription, the Resource group, and the Location of the bot channel registration. The Location should be the same region where the Verba Bot virtual machine resides in Azure.


Step 4 - Click on the Review + Create button and if the configuration is correct, click on the Create button again. Creating the Azure Bot may take some seconds. Azure will actually create an App Registration and a Bot Service assigned to it.

Adding a Teams Channel to the Bot Service

Step 5 - Once the Bot Channels Registration is completed, search for Bot Services in the search box on the top, then click on the Bot Services link under the Services section.

(Alternatively, the Bot Services can be also found by opening the hamburger menu in the upper right corner, then selecting All services, then the AI + machine learning category.)


Step 6 - Select the Bot Service from the list that was created previously using the name provided at Step 3 (Bot handle).

Step 7 - In the second left panel, under the Bot management section, click on the Channels menu.


Step 8 - Under the Add featured channel section, select the Teams icon (Configure Microsoft Teams channel).

Step 9 - Select the Calling tab, then tick the Enable calling checkbox.

Step 10 - (IGNORE THIS STEP. WE DO NOT NEED TO ADD WEBHOOK CALL FOR OUR TEAMS CHANNEL).

At the Webhook (for calling) setting, provide the following URL: https://verba_bot_vm.domain.com:9440/api/calling

Replace the verba_bot_vm part with the hostname of the Azure virtual machine which will host the Verba Bot service. At the domain part, use the domain of the Teams tenant (also specified in the SSL certificate).


Step 11 - Click on the Save button. Agree with the terms of service.

Configuring authentication for the bot

Step 12 - Search for App registrations in the search box on the top, then click on the App registrations link under the Services section.

(Alternatively, the App registrations can be also found by opening the hamburger menu in the upper right corner, then selecting the Azure Active Directory, then selecting App registrations in the left panel.)


Step 13 - Select the App Registration from the list that was created previously using the name provided at Step 3 (Bot handle).

Step 14 - Take a note of the Application (client) ID and the Directory (tenant) ID. They will be needed later.

Application (client) ID is MICROSOFT-APP-ID that you will you use when you add Teams Channel in your Mindbehind Account Channel.



Step 15 - Select the Certificates & secrets menu in the left panel.



Step 16 - Under the Client secrets section, click on the New Client Secret button.

Step 17 - Provide a Description, set when the secret Expires, then click on the Add button.



Step 18 - Take a note of the new Client secret. It will be needed later.

Client Secret is MICROSOFT-APP-PASSWORD that you will you use when you add Teams Channel in your Mindbehind Account Channel.

Step 19 - In the left panel, under the Manage section, click on the Authentication menu.




Step 20 - Under the Platform configuration sections, click on the Add a platform button.

Step 21 - In the right panel, select Web.

Step 22 - Provide a Redirect URI. It can be any website. Take a note of the URI provided, it will be needed later.

Step 23 - Click on the Configure button in the bottom.


Configuring permissions to the bot

Step 24 - In the left panel, under the Manage section, click on the API permissions menu.



Step 25 - Click on the Add a permission button.

Step 26 - Select Microsoft Graph, then select Application permissions.

Step 27 - Select the following permissions:

  • Calendars.ReadCalls.AccessMedia.AllCalls.Initiate.AllCalls.InitiateGroupCall.AllCalls.JoinGroupCall.AllCalls.JoinGroupCallAsGuest.AllOnlineMeetings.Read.AllUser.Read.All

Using the same App Registration for Chat Recording also

The same App Registration can be used for the chat recording. In that case, add the following permissions also:

  • Calls.AccessMedia.All
  • Calendars.Read
  • Calls.Initiate.All
  • Calls.InitiateGroupCall.All
  • Calls.JoinGroupCall.All
  • Calls.JoinGroupCallAsGuest.All
  • OnlineMeetings.Read.All
  • User.Read.All
  • Group.Read.All
  • Chat.Read.All
  • ChannelMessage.Read.All
  • ChannelMember.Read.All
  • Directory.Read.All
  • Files.Read.All
  • Sites.Read.All

If the Chat recording will be used, the protected API access has to be requested. See Protected API Access for Chat Recording section at the bottom.

Step 28 - Click on the Add permissions button.

Separate Azure tenants for the recording provider (bot) and for the Teams environment to record

In the case when the recorded Teams environment and the recording bot are in separate Azure tenants, the following steps have to be done using the Tenant ID of the Azure tenant where the Teams environment to record resides, and also using a user that has the Teams Service Admin or Global Admin role in that tenant. In order to gather the Tenant ID for Step 29, you have to log in to the Azure portal of that tenant, then go to the Azure Active Directory.



Multi-Tenant configuration:

If the same bot is being used in multiple tenants, then the following steps have to be done for each tenants using the guidelines above.

Step 29 - Build the consent URL. The format is the following:

Replace the {tenant_id} part with the Directory (tenant) ID and ****the {microsoft_app_id} part with the Application (client) ID from Step 14. Replace {redirect_uri} part with the URI from Step 22.

Step 30 - Copy the previously created consent URL into the browser, then hit enter. Log in with a Teams Service Admin or Global Admin user of the Azure tenant where the Teams environment to record resides. Click on the Accept button. The page will redirect to the webpage provided in the Redirect URI setting.


After successfully publishing bot,

Step 31 - Please visit Configuration page on left menu, add messaging endpoint such as: **https://app.mindbehind.com/external/v1/incoming/teams/{microsoftAppID}**  Provide Microsoft App ID that you received on Step 14. You can also see your Microsoft App ID below.

As Mindbehind, we have an endpoint for you to receive your messages through the bot. We just need you to provide messaging endpoint with your app ID.

Important: Please select the Bot Type as “MultiTenant” below.


You can see your bot URL that you can send through teams from Channels tab. You will see your Microsoft Teams Healthy channel and Open in Teams button which redirect you to Teams App:






Setting up the Mindbehind bot for your Teams Business account:

  1. Go to MindBehind platform.
  2. Choose the company that your assistant belongs to.

  1. Click on Channels.
  2. Select ADD TEAMS


  1. Add your credentials that you have in Microsoft Azure Bot, such as your APP ID and password.



  1. Go to your assistant.
  2. Right on the top click ‘Publish’.
  3. In section ‘Channels’ you can see the pages that you added.



  1. For the last step, please click the ‘Deployments’ section and press add deployment.
  1. Select your channel.
  2. Select the assistant version and press “Publish”.

Congratulations! Your bot is running on your Teams bot as well.


    • Related Articles

    • How to Publish your bot on Telegram

      Prerequisites: 1- Create a bot using @botfather on Telegram 2- After creating the bot via botfather, take note of the bot username, bot name, and bot token. Creating a bot using botfather Step 1 – Search for the handle @botfather on telegram. Step 2 ...

    • How to Publish your Bot to Instagram

      Prerequisites: Before publishing your bot on your Instagram Business account please follow the following steps: First of all, connect your Instagram Business account to a Facebook account.   Select Settings from your Instagram account. At the bottom ...

    • Which Message and Card Types Are Supported on Teams?

      You can find limitations & details of message types for Teams assistants below. 1- Message Action 1. Send Image Images must be at most 1024×1024 and in PNG or JPEG. 2- Selection Action We can use 2 types of selection action formats for Teams. (Send ...

    • How to publish your chatbot on Freshchat

      You can easily publish your chatbot on Freshchat but before we start, please keep in mind that the following message types are supported by Freshchat: single card with/without image including link buttons, single/multiple quickreply without link, ...

    • How to Publish Web Messenger by Using Google Tag Manager

      About Google Tag Manager (GTM) Google Tag Manager is a free tool that allows you manage and deploy marketing tags  on your website or mobile app without having to modify the code. For more information you can visit their website.   If you do not have ...