How to publish your bot to Microsoft Teams

Prerequisites: Have a Microsoft Teams account. Access the official website to use the online version, or download the Microsoft Teams application for Windows, Linux or Mac.

Setting up smart contact in Microsoft Teams

1. In the applications tab, search for and install the App Studio application.

2. After installation, App Studio will be available for creating new custom applications. Click the App Studio icon.

3. Click on the Manifest editor tab and then select the option + Create a new app to create your application.

4. In App details, fill in all required fields and optional fields as desired. At this time the data does not need to be related to Take Blip, so feel free to fill in as you prefer.

5. On the left side menu, select the Bots option and click Set up.

6. In the window that opened, enter the name of your smart contact (it is not necessary to be the same as the one in Take Blip), and check the following options:

• Messaging Bot

• My bot supports uploading and downloading files

• *Scope

• Personal
• Team
• Group Chat

If an error occurs when creating the bot, try using a shorter name.

7. When the initial configuration is complete, copy the bot ID (displayed below its name) and save it in a temporary location. It will be needed in the next steps.

8. Click on the “Generate new password” button, copy the generated value and save it in a temporary location. It will be needed in the next steps. Attention: This value will only be displayed once.

9. The Bot endpoint address field is the Take Blip endpoint URL. This is the setting that defines which URL should be used by Microsoft Teams to send messages sent by users of your application. Therefore, you must configure the Take Blip URL, as shown below (use the bot ID copied in step 7):

https://abs.gw.msging.net/{{id-do-bot}}

If your smart contact is associated with a Take Blip contract, use the URL below:

https: // {{contract-id}} .abs.gw.msging.net / {{bot-id}}

Setting up smart contact on Take Blip

After filling in all Microsoft Teams information, you need to set up your smart contact on Take Blip.

10. Access your smart contact on Take Blip, and go to the advanced settings screen.

11. Always using the postmaster@abs.gw.msging.net domain, add the Microsoft Teams configuration keys by replacing the values ​​with your data, as shown in the table below.

• ApplicationId - Bot ID copied in step 7.
• ApplicationPassword - Password copied in step 8.
• AccountExternalId - Bot ID copied in step 7.

12. In order to have an even better integration of Take Blip with Teams, other variables are necessary for labeling the type of content trafficked, they are: AudioSentence, DocumentSentence, GifSentence, VideoSentence, WeblinkSentence, TextButton. When one of these types of content is sent, the displayed label adapts to the value filled in the advanced settings. Feel free to fill in the values in the way that best suits you.

Testing your smart contact in Teams

13. On the left side menu, select the option Test and distribute and click Download, as shown in the image below. A file with an "application package" will be downloaded.

14. Go back to the applications tab, click on the option Load a custom application and choose the file downloaded in step 13.

If the Upload a custom application option is not available, this means that your email is corporate and your company does not have a contract with Microsoft for privileged access to Microsoft Teams resources. So, hire the service or integrate using a non-corporate email.

If an error occurs when selecting the file, check that all information filled in during the smart contact settings in Microsoft Teams is correct. Repeat steps 13 and 14 if any adjustments were necessary.

15. Your application will now be available in the Created by your organization section. Click the application and then click Add.

16. Everything’s ready. Your smart contact is now available for testing at Microsoft Teams!