Slack
1. Making a Slack App
Follow this link to make an App on Slack first: https://api.slack.com/apps and press a green button on the top "Create New App"
When you click "Create New App" button, a pop-up window will come up as on the screenshot below. Please chose the first option "From scratch"
Once you click the "From scratch" option, another pop-up should come up, just like on the screenshot below. You have to chose a name to your app in the first field "App Name" (in our example on the screenshot below it's IngestAI but you're free to chose any other convinient for you name).
And in the second drop-down field you have to select a workspace where you want to add your IngestAI bot. Chose one and click the green button beow of the pop-up window "Create App" as on the screenshot below.
2. Adding Incoming Webhooks
Next step is setting up Incoming Webhooks. Once you clicked "Create App" button, you should see Basic Information (just like on the screenshot).
Please click on "Incoming Webhooks" in the section of "Add features and functionality", just like on the the screenshot.
3. Activate Incoming Webhooks
You now should see "Incoming Webhooks" window as on the screenshot. Please turn on (activate) incoming webhooks clicking on the switch button just like it's indicated on the screenshot.
4. Add New Webhook to Workspace
Once you activate your Incoming Webhooks, you should see the screen as on the screenshot. Please scroll down to the section "Webhook URL" and click the button "Add New Webhook to Workspace" on the bottom.
5. Channel Permissions
You should now be redirected to a new window where you have to choose your channel. Chose the channel where you would like to add your bot.
And then push the green button "Allow".
After that you will be redirected to the "Incoming Webhooks" window like on the screenshot below.
Please scroll down to the section "Webhook URL" and copy the Webhook URL link by clicking the "Copy" button.
6. Add your Slack bot to IngestAI
Go to the web-site of IngestAI to the section of "Slack Bots" clicking this link: https://app.ingestai.io/main/slackbots and click the green button "+ Add Slack Bot" as on the screenshot below.
7. Add your Webhook URL
Choose a name to your bot, paste your Webhook URL that you copied in the end of the step 4, choose the Default Library for your bot, and click "Save" button below the Slack Bot Name.
If everything was correct, you should see a message on the green font saying "Bot was successfully saved!" and a red URL web link should appear just above the "Save button" just like on the screenshot. This red link is your Commands Webhook URL – please copy this link.
8. Create new command
Now please go back to your Slack window and find the "Slash Commands" on the sidebar in the "Features" section just like you can see on the screenshot. Click on "Slash Commands" and click on the "Create New Command" button. You need to add at least one Slash command. Adding more than one slash command you will be able to use it for addressing to different knowledge bases and context.
9. Create /help command
Make command with Name /help and past your Commands Webhook URL (that you copied in the IngestAI site – in the end of the step #6) to the Request URL field, set Short Description for your Command, and click the green button "Save" in the right corner below.
10. Save your bot
You should now be redirected to another screen with a yellow caution message asking you to reinstall your app - please make reinstalment clicking on "reinstall your app".
11. Choose a channel for your bot (again)
Sometimes after reinstalment you have to choose again a workspace for your bot. Please choose a workspace and click "Allow".
12. Check your command in Slack
Now the command should appears in your Slack Bot:
13. Make a test request to your command
Press this command and ask any questions to make sure your Slack bot is communicating correctly with your knowledge base:
And make sure you receive an answer from your Slack bot:
That's all \uD83C\uDF89 ! You’re amazing \uD83E\uDD29 ! Have fun!