Once you have created your first Flow in Globant Enterprise AI, following the steps in How to create a Flow, you may be interested in exposing it in various communication and management platforms. Here is a step-by-step guide on how to expose a Flow through Teams.
Go to Teams developer portal.
There, click on Tools, select the Create your first bot button and fill in the bot name.
Once you have created the bot, go back to the main Tools screen and select the newly created bot; in this case, Documentation Assistant.
When you click on it, a window will open with a menu on the left side containing the following options:
Configure, Channels, Meeting event subscriptions and Client secrets.
In the Configure option, fill in the Endpoint address field with the following URL: https://botbuilder.fluentlab.ai/fluentlab/api/v1/webhook/teams/<bot-id>. In this URL, the <bot-id> segment must be replaced with the ID of your Flow.
To get the <bot-id>, go to the environment where you are building the flow. In the Side Navigation Menu, click on the Overview option within the Overview section. There, you will see a summary of the Flow containing the <bot-id> along with other details, such as the Flow's name and purpose.
The <bot-id> is the alphanumeric identifier that appears below the name of your Flow.
Next, click on Client secrets and select Add a client secret for your bot.
This will open a pop-up dialog showing the message New client secret generated. Make sure to save the New client secret generated, as you will only be able to view it once. This client secret will be used later in the Flow configuration.
Go to the Apps section of the menu and click on Create your first app. Next, enter the name of your app.
Once you have created your app, a window will automatically open for you to configure the basic app information. You will need to complete the following fields:
App names:
- Short name: Short name of the app.
- Full name: Full name of the app.
Descriptions:
- Short description: Short description of the app.
- Long description: Detailed description of the app.
Developer information:
- Developer or company name: Developer or company name.
- URL: Website of the developer or company.
App URLs:
- Privacy policy: URL of the privacy policy.
- Terms of use: URL of the terms of use.
Application (client) ID:
- Bot ID: It is automatically generated when the bot is created. To view the ID, go to Tools > Bot Management.
Go to Configure > App features in the left menu and select Bot.
In the window that opens, select the bot you created in "Step 1: Create a Teams bot" from the drop-down menu titled Select an existing bot. Next, choose "Upload and download files" below What can your bot do?
Then choose "Personal" below Select the scopes where people can use your bot and click on the "Save" button.
Navigate to the following URL: https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/~/Authentication/appId/<bot-id>/isMSAApp/, replacing <bot-id> with the bot ID.
Click on "Supported account types" and on the next screen select "Multi-tenant". Finally, click on "Save".
Go to the Flow you want to expose. Next, go to the Side Navigation Menu > Configuration > Integrations and click on the Add Integration button.
Select "Teams" from the drop-down menu and fill in the required data:
- Client Id: this is the ID of the bot created in Teams.
- Client secret: is the secret of the client generated in "Step 3: Configure secret".
To test your application in Teams, first go to the Teams developer portal and then to the Apps section. Select your app and click on the Publish button in the upper right corner.
You will have several options available; in this case, select "Download the app package" to download your application package.
Next, open the Microsoft Teams application, go to "Apps" and select "Manage your apps". Here, proceed to "Upload an app" and upload the package you downloaded.
Distribute your Microsoft Teams app