Creating a Slack Bot
Follow these steps to create a bot for Slack:
- In Flow XO, click Bots in the top menu bar, then choose + New.
- Now choose Slack as the messaging platform.
- Type in a Name for the bot.
- If you like, you can fill out the Welcome Text box. This is optional.
- Select whether to Show the welcome text even if a catch-all trigger is found if required
- Select the Language as required
- Now we'll head over to Slack at https://api.slack.com/apps/new.
- Give your new app a name and select Development Slack Workspace. Click Create App
- Fill in any other Basic Information for the app, including features and functionality, setting an icon, name, description, etc.. When you're done, click Save Changes.
- Click on OAuth & Permissions on the left menu. In the Redirect URLs section click Add New Redirect URL. Copy the Slack App Redirect URI from Flow XO into the redirect URL, click Add and then click Save URLs.
- Still in Oauth and Permissions, scroll down to the Scopes section and under Bot Token Scopes, click Add an OAuth Scope. Add the following Bot Token Scopes:
- In the User Token Scopes, add:
Your scopes section should look like this:
- Click on Interactive Components on the left menu in Slack and enable Interactivity. Enable interactivity and copy the Slack App Interactive Messages Action URL from Flow XO into the Request URL field and then click Save Changes.
- Now click on Basic Information on the left, and you'll see your App Credentials. You'll then need to copy the Client ID and Client Secret into Flow XO.
- You can optionally fill in a Success URL. If you leave this blank, the user will be redirected to their Slack team after installing your bot. This is usually a good thing to do, but if you prefer, type a different URL to send the user to here.
- Now that's done, click Next to save those details and your bot is configured!
- The final step invites you to install your bot into your own team. Follow the steps on screen. You'll also see the information you need to tell other people how to install your bot.
Inviting to Channels
Slack bots have to be invited to channels that they can then participate in. Once you or any of your users have installed your bot, they'll need to use the command "/invite @username" (replace @username with your bot's username) to invite into channels.
Distributing Your Bot
You should use the Slack Button to allow people to install and use your bot with just a few steps.
Slack has a simple code generator on their site to get the code you need to display the button. Choose the app you just created from the list and tick only the Bot option. Then copy the code and paste wherever you want the button to be shown.
Publishing to the Slack App Directory
When you're happy that your bot is working as you expect, you can apply to have the bot listed in the Slack App Directory. Slack has details on their site about how to add an app.
Let us know how we can improve Flow XO on our feedback site.