Follow these steps for integrating slack.
Login to your Floatbot account and go to your bot dashboard. On your bot dashboard click on configure. You will see a text bar called Slack setting. Click on Slack setting.
When you open slack setting you will see the following screen.
Let us step by step look at each one of them.
To get started, you will need to head to Slack API and create a Slack app.
Fill in the basic information and when you’re done click on create App.
Now we will start filling in other details.
1st element is Slack App Redirect URL
Copy the URL from bot dashboard and go to Slack.
Click on OAuth & Permissions on the left-hand side column, which is under the feature section. In the redirect URLs box paste the URL and click on Save URLs.
Here you need to add few details. Scroll down to Scopes add few details. For example, we have added these. After adding click on save changes.
2nd element is SLACK APP INTERACTIVE MESSAGES ACTION URL
Copy the link again from Floatbot’s bot dashboard and head to Slack.
Click on Interactive Components on the left menu. Enable the property, paste the URL and click on enable interactive components.
3rd element is EVENT SUBSCRIPTIONS URL/COMMANDS REQUEST URL
This URL has to be pasted into 2 sections in Slack. Let us see where
Section number 1- Copy the URL from bot dashboard and go to Event subscriptions on the left-hand side column in Slack.
Enable the event and paste the URL copied from Floatbot’s dashboard.
Section number 2 is Slash commands.
Under the feature section only go Slash commands and create a new command.
As soon as you create a new command, you will see this screen
Set your command name as /start (Note: / is important) And in the request URL paste your copied URL.
Now from Slack, you’ll have to copy two important elements that will help you complete the integration SLACK APP CLIENT ID AND SLACK APP CLIENT SECRET.
Head to Basic information on Slack. You’ll see a box called App credentials.
Copy the client ID and Client secret. Go to Floatbot and paste it in the respective tabs
Now that's done, click on update and your bot is configured!
Here are few details that you will need to fill in Slack:
- In the Basic information tab, you will need to fill in details like display information: your App name, short description and colour.
- Add details to the Bot user under the Feature tab. Add a display name and a default username.
- In the event subscription tab scroll down to Subscribe to workspace events and add few events.
Add message.im and message.channels events, they both are compulsory to add. To add event click on Add workspace event.
Some other important terms that you need to know about Slack are:
Inviting to Channels
The slack bot needs to be invited to channels. You can invite by using a command like /invite@username (you can replace the username with your bot name)
Distributing Your Bot
Use the slack button to let people install and use your bot. Slack has a code generator on their site to get the code you have to display the Slack button.
Select the app that you created from the list and tick only the bot option. Copy the code and paste it where you want your button to be seen.
Publishing to the Slack App Directory
When your bot starts working perfectly, you can apply to list your bot in Slack App Directory.
© Copyright 2018, Floatbot.ai.