Once you have created your Flow in Globant Enterprise AI 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 necessary, check your email to get a code. Finally, click on the Create a workspace button.
Next, follow the steps by entering the requested 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 the Tools & settings option and within that menu, click on Manage apps.
Clicking on Manage apps will open a new window of the slack app directory, where you will have to locate the tab called Build (next to Manage) in the upper right corner. Finally, in the next window that opens, click on the Create an App button.
In the window that appears, select From scratch. Enter the name of the app in App Name, choose the workspace in 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 and add the permissions:
- Messaging: Allows to communicate with the Flow using text messages.
- app_mentions: read
- chat: write
- im: history
- File Support: Allows the user to send files to the Flow.
- User Data: Allows to get user information like name, email and location.
- 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 to the left of 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 messages tab of the app, facilitating interaction with the bot or integration without the need to switch windows or sections.
Go back 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, go back 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 wish to expose. Next, access Side Navigation Menu > Configuration > Integrations > Slack Client and fill in the required data:
- Bot User OAuth Token.
- Slack signing secret.
Then click on the Confirm button.
Go back to the Slack page and, in the left menu, click on Event Subscriptions. In the Features section, enable the events by selecting 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 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.
If everything is set up correctly, you should see the 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.
Once you have made these changes, click on the button at the bottom called Save Changes to save the settings.
In the menu on the left, click on Interactivity & Shortcuts. Enable Interactivity by selecting 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 button at the bottom labeled Save Changes.
In the menu on the left, click on Install App and then 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:
