Here are the step-by-step instructions to integrate your bot with Slack

  1. Log in to Dashboard -> navigate to the overview page of the bot that you want to change.

  2. On the overview page, you will see several tabs. Look for the one labelled "Launch" and click on it.

  1. Select the "Slack" tab. Click on the "Enable" switch to enable the integration.

Important Note: Please note that you must sign-in to your slack workspace where you wish to integrate your OrimonAI chat-bot, before proceeding further. A link for doing the same is provided on the Integration page as well as here. You need to create a Slack workspace, here in-case you don't have one.

  1. Now scroll down to see 2 dialog boxes as shown below.

Bot Name: Here you can set the name you want for you bot in Slack, according to your preference.

Event Name: This is the event in Slack that your bot will respond to, which can be one of 2 configurations.

  • App Mention: Configuring your bot to this event type, ensures that your chat-bot in Slack is only invoked/triggered, if it is directly mentioned by typing its command (@<bot-name>).

  • Message: Configuring your bot to this event type, ensures that your chat-bot responds and reads to every message in your channel/workspace, without the need to directly mention it.

  1. Once, you configure your Bot Name & Event Name, click on "Get Started". Then you will see a page as shown below.

Now click on, "Add To Slack" to begin the integration process, after which you will be redirected to Slack's Official Website, and a dialog box will open up as shown below.

  1. Select the workspace where you want to integrate your bot and click on "Next". After this Slack will ask you to authorize the App.

  1. Click on "Create", after which you will be redirected to the App's page & prompted to add this App to your Workspace by clicking "Add To Workspace".

  2. After this, you'll see a screen as shown below, click on "Allow".

  1. Now, on the left panel go to "Event Subscriptions" where you will see a configuration as shown below.

Here in the Request URL you will be a button "Retry", click on this button and then click on "Save Changes".

  1. After this navigate back to the Slack Integration page on your OrimonAI dashboard, where you will see a configuration as shown below. Click on "Verify Event URL"

  1. As soon as your, Event URL is verified a new dialog box will show up as follows.

  1. To proceed further, go back to the Slack API page of your App, navigate to Oauth & Permissions under the section OAuth Tokens for Your Workspace, copy the token provided, as shown below and paste it on the Bot Token dialog box on your dashboard, then click on "Connect To Slack".

  2. If the installation process of your bot has been followed correctly, you will see a configuration screen on your dashboard as shown below.

That's all for Integrating your chat-bot with Slack!

Last updated