Once you have created your Flow in The Lab following the steps in How to create a Flow, you may want to expose it through Slack. To do so, follow the steps below.
Go to Create a workspace. Enter your email address and, if required, check your email for a verification code. Finally, click on the Create a Workspace button.
Next, follow the steps by entering the required information: your company or team name, your name, and the project your team is currently working on. In addition, select a plan. Once you have completed these steps, you will see a tab similar to the one below.
Click on the down arrow icon next to the name of your workspace (in the top left corner of the screen, next to the name Globant). Next, select Tools & settings and within that menu, click on Manage apps.
Clicking on Manage apps opens a new window. In the upper right corner, click on Build (next to Manage).
In the next window that opens, click on the Create New App button. This will initiate the process that enables you to proceed with exposing the Flow through Slack.
In the window that appears, select From scratch to configure the app manually and define its main settings.
Enter the app name in the App Name field, choose the workspace under Pick a workspace to develop your app in, and then click on Create App.
Next, the Basic Information section will open. From the menu on the left, select OAuth & Permissions and go to the Scopes section.
Below Bot Token Scopes, click on Add an OAuth Scope.
Add these OAuth Scopes:
- app_mentions: read
- chat: write
- im: history
- files: read
- users: read
- users.profile: read
In the menu on the left, click on App Home.
In the Show Tabs section, below Messages Tab, select the check box next to Allow users to send Slash commands and messages from the messages tab.
This option allows users to send Slash commands (/) and messages directly from the app's messages tab, facilitating interaction with the bot or integration without the need to switch windows or sections.
Return to OAuth & Permissions and click on the OAuth Tokens section. Next, select the button labeled Install to (followed by the workspace name). In the screen that opens, click on Allow.
After completing this step, return to OAuth & Permissions, where you will see the Bot User OAuth Token. Just below it, a long alphanumeric key will appear next to a Copy button. Make sure to copy this key.
In the menu on the left, click on Basic Information. In the App Credentials section, look for Signing Secret, click on Show to reveal the key, and copy it.
Go to the Flow you want to expose. Next, open the Side Navigation Menu, and go to Configuration > Integrations > Slack Client.
Fill in the required data:
- Bot User OAuth Token.
- Slack signing secret.
Then click on the Confirm button.
Return to the Slack page and, in the left menu, click on Event Subscriptions. In the Features section, enable the events by toggling the switch below Enable Events. Then, in the Request URL field, paste the URL of the FluentLab bot: https://botbuilder.fluentlab.ai/fluentlab/slack/<BOT_ID>
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 in the OVERVIEW section. There, you will see a summary of the Flow, including the Bot id, along with other details such as the Flow's name and purpose.
The <BOT_ID> is the alphanumeric identifier displayed below the name of your Flow.
If everything is set up correctly, you should see a Verified status next to Request URL. Then go to the Subscribe to bot events section, click on the Add Bot User Event button, and select message.im.
After making these changes, click on the Save Changes button at the bottom to save your settings.
In the left menu, click on Interactivity & Shortcuts. Enable Interactivity by toggling the corresponding switch. Next, in the Request URL field, paste the URL of the FluentLab bot: https://botbuilder.fluentlab.ai/fluentlab/slack/<BOT_ID>
Once you have made these changes, click on the Save Changes button at the bottom.
In the left menu, click on Install App, and then click on the Reinstall button (followed by the workspace name, which in this case is Globant).
In the screen that opens, click on Allow.
Go to your Slack workspace and interact with the bot:
