Generate a webhook in Slack

1. Create a Slack app (if you don’t have one already)

Create your Slack app

Pick a name, choose a workspace to associate your app with (bearing in mind that you’ll probably be posting lots of test messages, so you might want to create a channel for sandbox use), and then click Create App. If you’ve already created an app, you can use that one instead.

2. Enable Incoming Webhooks for your Slack app

After creating your Slack app, 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 to your Slack workspace

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 built any code to generate an Incoming Webhook URL. You’ll see something like the following screen:

Permissions screen with incoming webhooks channel selector

Go ahead and pick a channel that the app will post to, and then click the Authorize button. If you need to add the Incoming Webhook to a private channel, you must first be in that channel.

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’ll look something like this:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

That URL is your shiny new Incoming Webhook, one that’s specific to a single user, and a single channel.

Add your Slack webhook URL into the Commentful plugin

To set up the Commentful Slack notifications, you can create a Slack Webhook URL by following the steps above, and then in Commentful under the Settings icon button (in the top right of the plugin window), then click Enable Slack notifications for review links, then copy/paste in your Slack Webhook URL:

eg. https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX)

You can make sure the Slack integration is working by clicking the Send Test Message to Slack button, which will send a test notification from Commentful to your Slack channel.