Slack

Slack is a messaging application designed for businesses that enables individuals to access the information they require. By uniting people to function as a cohesive team, Slack revolutionizes the way organizations communicate.

Setting up a new Slack connection

  1. Head to this link and click on Create New App > From scratch

  2. Enter your app name and select your slack workspace.

  3. Then click on Create App

  4. Go to OAuth & Permissions page.

  5. Copy OAuth Redirect URL from Plumber and add it in Redirect URL. Click on Save URLs.

  6. Go to Bot Token Scopes and add chat:write.customize along with chat:write scope to enable the bot functionality.

  7. Go back to Basic Information on the left sidebar.

  8. Scroll down to App Credentials.

    • Copy Client ID into the API Key field in Plumber

    • Copy Client Secret into the API Secret field in Plumber

  9. Click on Connect.

  10. A new window with the Slack consent screen will pop up.

If a new window does not appear, it could because your Slack organisation does not allowing adding this new Slack app. Ask your Slack admin to approve this.

  1. Click on Allow.

  2. Your Slack integration is now ready!

Send a message to a channel

Field
Description
Required

Channel

Select the channel you want to send the message to.

If you do not find your channel in the dropdown list, ensure that the channel is Public or the user that your API token is created under has access to the channel. If you want to send to a private channel, see here.

✔️

Message

Message body of the message.

This supports whatever markdown syntax that Slack supports. See how to format your message. To mention users, use the following format: <@USER_ID>. e.g.:

Copy

Hey <@U024BE7LH>, thanks for submitting your report.

To get the user's ID, click on the overflow button in their Slack profile, and choosing the Copy member ID option.

To mention user groups, use the following format: <!subteam^ID>, e.g.:

Copy

Hey <!subteam^SAZ94GDB8>, there's a new task in your queue.

✔️

Send as a bot?

If false, the message will be sent as yourself.

The first message is sent with Send as a bot? set to false. The next is set to true.

Defaults to No

Bot name

Only works if Yes is selected for Send as a bot?

Sender name of the bot.

Bot icon

Only works if Yes is selected for Send as a bot?

Display image of the bot. This can be:

  • an emoji that your Slack org supports such as :robot: 🤖

  • a URL pointing to the image

Find a message

This action looks for a message in your Slack org.

Field
Description
Required

Search Query

Search query to use for finding matching messages.

Examples: hello world -> search term

in:#plumber hello world -> search for the term in #plumber channel in:#plumber-dev from:@ian hello world -> search for the term in #plumber channel and sent by ian

See the Slack Search Documentation for more information on constructing a query.

✔️

Sort by

Options: - Match strength: relevance to search query - Message date time: date and time the message was sent

Defaults to Match strength

Sort direction

Options: - Descending: newest or best match - Ascending: oldest or worst match

Defaults to Descending

FAQ

How to send a message to a private channel?

To send to private channels, you would need the Slack ID of the private channel (it will not appear in the dropdown). To retrieve this:

  1. start by typing /display ids into any conversation on Slack.

  2. Select the built-in shortcut Display IDs

  3. Select the private channel in the dropdown as shown in the screenshot below.

  4. Copy and paste the selected conversation/channel ID into Plumber and click Use: <CHANNEL_ID>

You can also manually retrieve a specific user group's ID by clicking Copy group ID in the overflow menu.

Last updated

Was this helpful?