Bot Setup

This page contains information on how to create Microsoft teams, bot on Microsoft developer panel.

Required information for Creating MS Teams Chatbot

To do MS Teams integration, you will need the following details on your end.

• Bot ID

• Bot Password

• Update the Webhook endpoint in the Bot Details

• Create and Publish an app for your organization

Steps to complete integration

Step 1: Setup MS Teams Bot

1. Login to the MS Teams using the following URL https://teams.microsoft.com/v2/. If you do not have the MS Teams documentation, Create the one before proceeding.

2. Once logged in, Navigate to the developer portal of MS Teams.

   

   MS Teams Developer Portal
3. Choose the "Tools" tab and click on "Bot Management Option"

   

   Bot Management on MS Teams
4. On this Page, Locate the "New Bot" option and add the bot by giving it a name.

5. Once the bot is created, Enter the following Webhook endpoint address and click "save" to proceed. https://api.v7.botpenguin.com/ms-teams/webhook

   

   Configure Webhook Endpoint
6. Navigate to "Client Secrets" and add new and Copy the Provide secret key. Keep this secret key safe. This will be used while creating the configuration on BotPenguin.

   

   Bot Password

7. Return to the bot listing page and copy the "Bot ID". Keep this key safe. This will be used while creating the configuration on BotPenguin.

   

   Copy Bot ID

Step 2: Create the MS Teams App

1. Navigate back to the "Apps" tab and click on "New App".

2. Create the new app by providing the name. (e.g BotPenguin)

3. Fill in the basic information of the App. An example of the same is as follows

   1. Short Name - BotPenguin

   2. Full name - BotPenguin - The chatbot builder platform

   3. Short description- BotPenguin is an omnichannel platform to automate your communications.

   4. Long description - BotPenguin is an advanced chatbot platform designed to streamline and enhance conversational experiences for businesses across various industries. With a focus on user-friendly interactions, BotPenguin leverages artificial intelligence and natural language processing to create intelligent chatbots that can efficiently handle customer queries, provide information, and engage in meaningful conversations.

   5. Version - 1.0.0

   6. Developer or company name - BotPenguin

   7. Website (must be a valid HTTPS URL) - https://botpenguin.com/

   8. Privacy policy- https://botpenguin.com/privacy-policy

   9. Terms of use - https://botpenguin.com/terms-and-conditions

   10. App ID: Same as Bot ID

   

   Manage Basic Information
4. You can give your own branding to your app or leave as it is.

   

   Manage Branding
5. Navigate to the "App Features" tab and add the "Bot". Once the next page opens, choose the relevant bot and assign the following scopes

   1. Personal

   2. Teams

   3. Group Chat

   Also, Check the following options under what your bot can do.

   1. Upload and Download files

      

      Configure Bot

6. Now, Move to the "Publish to Org" tab, and Submit your app for your organization.

   

   Publish your app

Step 3: Approve your app as Admin

1. Open the Teams admin portal using the following link https://admin.teams.microsoft.com/

2. Locate the "Manage Apps" options under the "Team Apps" Section. Search for your app and click on the same.

   

   Approve App

3. Click on the App and Click "Publish"

4. Once you have approved the apps, It takes some time to get listed for your users.

Step 4: Save the configuration on BotPenguin

1. Navigate to the BotPenguin Dashboard.

2. Click on "Create new bot" on the top left.

3. Choose MS Teams as the channel.

4. Name your bot and Fill in the Bot ID and Bot Secret (Bot Password) which you copied in 1st step.

Once you have updated the same. Your bot will be created.

Please reach out to us at [email protected] for further assistance.