Don’t use Slack Incoming WebHooks; App Creation is Dead Simple!

At Wehkamp we ❤️ Slack! Seriously, in order to improve our efficiency, we've connected many of our applications, alerts and dashboards to Slack channels. But, as with all things, there is a right way and a wrong way of integrating a webhook at enterprise level.

As a Slack admin I see the old integration being requested every now and then, so let's see how easy it is to move away from Slack Incoming WebHooks. This guide was created with the help of Harry Kroes, one of our cloud engineers, as we needed to create a webhook to connect alerts from Nifi to Slack.

Why is it a problem?

Let me be clear: the Slack Incoming WebHooks integration will work, but is legacy and you should migrate as soon as possible.

Please note, this is a legacy custom integration - an outdated way for teams to integrate with Slack. These integrations lack newer features and they will be deprecated and possibly removed in the future. We do not recommend their use.

Slack Incoming WebHooks

At Wehkamp, that's not even the main problem! Whenever the creator of a legacy webhook leaves the organization, the webhook is disabled. The code of the reactivated webhook changes; so vital integrations break.

Warning message: Some configurations of Incoming WebHooks have been deactivated. This is because the team members who set up those configurations are no longer regular members of this workspace.
Nooooo: some configurations of Incoming WebHooks have been deactivated.

Fast Guide To Create An App

It is super simple to create an application, especially now that we have Slack App Manifests. Follow this wizard and you'll have an app in 2 minutes:

  1. Goto api.slack.com/apps?new_app=1
  2. Choose From An App Manifest:
Slack wizard for app creation.
Slack wizard for app creation.
  1. Select your workspace and click Next
Step 1 of 3: select a workspace for your app.
Select workspace.
  1. Add this manifest, change the contents to your liking and click the Next button.
display_information:
  name: My Alert
  description: Alerts from the My Monitoring System. Used for My App monitoring.
  background_color: "#8B0000"
features:
  bot_user:
    display_name: My Alert
    always_online: true
oauth_config:
  scopes:
    bot:
      - incoming-webhook
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
  1. Review your app and hit the Create button. 🎉 Congratz, your app is now created 🎉
  2. Next, we need to install the app. Navigate to Settings > Basic Information and click the Install your app section and hit the Install to Workspace button:
Building Apps for Slack settings screen.
Install the app.
  1. Select a default channel and hit the Allow button:
Slack screen: choose a default channel for your app postings.
Select a default Slack channel.
  1. 🥳 Your app is now installed and you can copy the webhook! 🥳 Navigate to Features > Incoming Webhooks > Webhook URLs for Your Workspace and do your thing!
Slack screen for managing your webhooks.
Configure one or more webhooks.

Add collaborators

It is super easy to add a new application. Now you can add collaborators to your app, so when you leave the organization, the application is still managed by your peers. Navigate to Settings > Collaborators to add more members.

Enjoy!

expand_less