*Version: 1.0| Last Updated: 14/10/2024* ## Overview - **Integration Name:** Slack - **Purpose:** Fetch events from Slack, Post messages via webhook - **Audience:** Support team, TAM - **Prerequisites:** Administrator role in MoovingON AI --- ## Table of Contents - [[#Setup Instructions]] - [[#Configuration]] - [[#Related Links]] --- ## Setup Instructions **From the left-hand side of the UI, click on settings > integration** **** **Click on Add Slack** **** **Add a name for the integration, and keep the default settings** **** **Will popup a new URL page asking: MoovingON AI is requesting permission to access the "Customer Name" Slack workspace. After filling in the relevant information, click Allow** --- ## Configuration 1. **Create a Slack app (if you don’t have one already):** Pick a name, choose a workspace to associate your app with (bearing in mind that you’ll probably be posting lots of text messages, so you might want to create a channel for sandbox use), and then click Create App. If you’ve already created one, you can use it too. 2. **Enable Incoming Webhooks** After creating, you’ll be redirected to the settings page for your new app (if you are using an existing app, just load its settings via your app’s management dashboard). From here, select the Incoming Webhooks feature, and click the Activate Incoming Webhooks toggle to switch it on 3. **Create an Incoming Webhook** Now that Incoming Webhooks are enabled, the settings page should refresh and some extra options will appear. One of those options will be a really helpful button marked Add New Webhook to Workspace, and you should click it. What this button does is trigger a shortcut version of the installation flow for Slack apps, one that is completely self-contained so that you don’t have to actually build any code to generate an Incoming Webhook URL. We’ll show how you can generate webhooks programmatically later, but for now, you’ll see something like this. [https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX](https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX) **Following screen:** **** **Go ahead and pick a channel that the app will post to, and then click to authorize your app. You’ll be sent back to your app settings, and you should now see a new entry under the Webhook URLs for Your Workspace section, with a Webhook URL that look something like this: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXThat URL is your shiny new Incoming Webhook, one that’s specific to a single user, and a single channel. Let’s see how you can use that webhook to post a message.** 4. **Webhook URL to post a message via MoovingON AI Webhook Feature** - **Go To Webhook Management** - **Click On The “+” Button** **** - **Fill in the required fields and save** **** --- ## Related Links - **External Resources:** [Slack Documentation](https://slack.com/help/categories/200111606-Using-Slack)