Slack Notifier - Setup

Need some help? Contact us:

So if you want to Speed up your processes with good Slack Notifications, follow along below for how you can go about doing it.

You need to have a slack account and IguanaX installed. If you don't expand this point to find out how.

You will need a Slack account that you control - if you don’t already have one then Get a free Slack Account

You will also need to have IguanaX installed - see Installation.

Import the Slack Notifier Component

Import the Slack Notifier component - see Create a Componentif you need a reminder on how to do this from the dashboard.

Click Edit > Make a Copy and Edit, to open the translator - it's not working yet because we don't have an API key.

Okay so our first problem is to get a valid Key

We need to go through’s Slack’s process to create a Private app. Effectively we need to set up a password that Iguana can use to talk to Slack.

Start by going to https://api.slack.com/ - make sure you are signed in and then click on Create App

Go to https://api.slack.com/

You need to be logged in and have the right permissions. Slack’s user interface can be a pain in the butt here since if you’re not logged in, it will take you to the application rather than staying on the API page. If that happens, you will need to go back to https://api.slack.com/. Make sure you select your workspace.

This is one way to find it, from the home page

Then:

In the Create an app dialog - select From scratch

Then fill in the name of your app - IguanaX and select your workspace

Name it anything you like. “Brad” ?

The screen snap below shows what is involved - you will need to have a good sense of imagination and remember it is your workspace and not iNTERFACEWARE (that’s my workspace )

Now we need to select the permissions the 'app' gets

Scroll down to 'Scopes' and click on Add an OAuth Scope

Getting tired yet lol! I know it’s a big GUI to wade through:

Now add the chat:write.public and users:read.email scopes

This is common concept when setting up a Private app. We have to tell Slack what the app is allowed to access.

The trick here is to enter the scopes you are searching for like for chat:write.public we have:

Some actions (scopes) require other permissions to work, so Slack will prompt you about getting those permissions as well.

Repeat rinse with users:read.email

After this you should see:

Install to the workspace to get the API Key which

You will scroll to the top of the screen for this:

then you will see something like:

and then you get the gold - the Api Key which Slack calls a Bot User OAuth Token (ugh I hate jargon).

Paste the API key into the Slack Notifier card view

Copy paste it into the Key (see Custom Fields ) for the Slack Notifier component:

Then get a Channel ID from a Slack channel you want to write to and set the ID in the ChannelID field in the card

Create a new Slack Channel to receive notifications. This channel must be public.

Each Channel in Slack has a unique ID. To find it, in the regular Slack application, right click on a channel you want to write to the app and select the View channel details

You will see something like this:

Copy the Channel ID into the ChannelID Custom Fields of the notifier component:

Change the email address to some one who you know is in your Slack Workspace

The email will be used to tag a user in your Slack notification.

Click edit script to open the translator and see it in action!

This little video shows the whole thing in action:

action.mp4

Can you start to see how easy it will be to Speed up your processes with good Slack Notifications and eliminate communication bottlenecks in your processes.

Now life gets interesting when you think about how to apply this.

Take a look at How the Slack Notifier works for more information on the concepts used in building and adapting this component.