Engati - User Guide
Deploying the bot
Microsoft Teams
14 min
microsoft teams is a popular platform for workplace communication and collaboration deploying your engati bot on teams allows your coworkers to access it directly within your organization's teams accounts for assistance key benefits of deploying on teams include enabling employees to get quick answers, integrating bot features into collaborative workflows, and providing a unified experience within teams users can interact with your bot in teams channels, chats, and meetings to get questions resolved, automate processes, and more to deploy on teams, you need an organizational outlook account and access to microsoft portals the setup involves linking your account, registering an app, and configuring bot permissions in azure certain engati features like identity, webviews, file upload, and carousels are not supported within teams currently due to platform limitations setting up setting up step 1 navigate to configure > deployment > microsoft teams step 2 navigate to the url https //dev botframework com/bots/new and sign in to the microsoft account step 3 fill in the details for bot profile for your convenience, we have provided descriptions for each field, indicating the values to enter in each display name enter the name you want give to your bot bot handle here, you'll need to input the key identifier of the bot to find the key identifier, switch to the engati portal and go to configure > bot details > key identifier note ensure that different key identifiers are used to create different apps in microsoft teams long description give the description about your bot step 4 enter the messaging endpoint, which is the endpoint url located on the engati portal under configure > deployment > microsoft teams also check the box to "enable streaming endpoint" once entered, click on "create microsoft app id and password" step 5 you will be redirected to microsoft azure portal, click on ‘new registration’ at the top left corner of the page step 6 enter the name of the application, select "accounts in any organizational directory and personal microsoft accounts" and then click on "register", to complete the registration step 7 go to ‘certificates & secrets’ from the front left navigation bar and click on "+new client secret" select the expiry date as 24 months and click add step 8 copy the generated password from ‘value’ and paste it into the ‘ app secret’ field on the engati bot platform step 9 navigate to the overview tab in the top left corner, copy the application (client) id and paste it into the app id field on the engati portal step 10 once you have entered app id and app secret, save the changes in the engati portal step 11 switch back to bot framework portal and enter the application id in app id under configuration from microsoft azure portal > overview > application id step 12 check the "i agree that " button and click on "register" step 13 click on "configure microsoft teams channel" step 14 select "microsoft teams commercial (most common)" and click on "save" step 15 navigate to the developer portal https //dev teams microsoft com/apps click on ‘+new app’ and assign a name to your app step 16 copy the application (client) id from the microsoft azure portal https //portal azure com/#view/microsoft aad registeredapps/applicationslistblade and paste it into the application (client) id field on the developer portal https //dev teams microsoft com/apps step 17 on the developer portal ( https //dev teams microsoft com/apps ) fill in the basic information such as description fields, developer information, and app urls for your convenience, we have provided values to enter in each field for developer information developer or companies name engati website url https //www engati com/ for app urls privacy policy https //www engati com/privacypolicy terms of use https //www engati com/termsofuse once you are done filling in the required fields, click on "save" step 18 navigate to permissions and enable the permisions mentioned below and click on "save" note not more then 16 permissions should be enabled step 19 navigate to app feature and enable bot, message extension and personal app for enabling bot as app feature , select the bot created bot from the dropdown menu enable the following options and then click on "save" for enabling message extension, select the bot created bot from the dropdown menu then click on "save" for enabling personal app, click on the three dots besides chat and select "move down" then click on "save" step 20 navigate to publish to org and click on "publish your app" once the created app on microsoft teams is approved from the the admin portal of that organization our engati portal is deployed on your micrsoft team successfully! ms teams capture email and other details ms teams capture email and other details you can now capture email ids and other details from ms teams by deploying our engati bot to deploy the bot on ms teams you can follow the steps given in our https //help engati com/microsoft teams steps to check the captured email ids and other details are as follows after deploying the bot on ms team, log in to our engati app porta select the bot that has been deployed on the ms teams 3\ in the left navigation bar, go to users > user list 4\ select the user whose details you want to view 5\ in the custom attributes section, you will find all the captured details about the user note for the app to show up in the microsoft teams apps section, it may some time this time can vary from a few hours up to a day for further help on the app showing up, you can also reach out to the microsoft support team via your microsoft admin portal https //admin teams microsoft com/ app not showing up in apps section troubleshooting steps app not showing up in apps section troubleshooting steps if you have created an app but it does not appear in the apps section of microsoft teams even after a few hours in such cases, you need to grant the necessary permissions to the app from the microsoft admin portal step 1 access your microsoft admin portal (i e https //admin teams microsoft com/ ) and navigate to the teams app section here, select the "manage app" option step 2 locate the app you have created from the list of apps step 3 once you have found your app, click on it and navigate to the "permissions" tab step 4 in the permissions tab, you will find a button labeled "grant admin consent " click on this button to authorize the required permissions for your app step 5 after clicking the "grant admin consent" button, a pop up window will appear click on "accept" in this window to confirm the permissions note for the app to show up in the microsoft teams apps section, it may some time this time can vary from a few hours up to a day for further help on the app showing up, you can also reach out to the microsoft support team via your microsoft admin portal https //admin teams microsoft com/ if you face any issues or queries please reach out to us at mailto\ support\@engati com

