Slack¶
Last update · 3 min read
Post RU4M updates to your Slack channels. When one of your events or companies changes, RU4M writes a short message to the channel you connected.
Before you start¶
You need approved integration access. Read Requesting integration access if you do not have it yet. Only a company's Owner or Admin can open these pages.
You also need permission to add an app to your Slack workspace. To use a private Slack channel, you must already be a member of it.
Slack channels and webhooks share one limit of 10. The form shows how many are in use, for example 2 of 10 webhooks in use.
If RU4M has suspended your access, Connect channel is disabled and RU4M posts nothing. Read Overview, deliveries and audit.
Where to find it¶
- Select Integrations in the bar on the left.
- Select Slack in the Integrations panel.
You can also open Slack directly. The Overview page has a Slack card with a link to the same page.
The table lists each channel with its Channel, Events, Status and Last delivery. A channel that has received nothing yet shows Never.
Getting the Webhook URL from Slack¶
A Webhook URL is the address RU4M uses to post to one Slack channel. Each channel needs its own URL. Slack setup guide on the RU4M page opens Slack's own instructions.
- Create an app in your Slack workspace, or open one you already have.
- Select Incoming Webhooks in the app's settings.
- Turn on Activate Incoming Webhooks.
- Select Add New Webhook to Workspace.
- Choose the channel.
- Select Authorize.
- Copy the new address under Webhook URLs for Your Workspace.
Treat the Webhook URL like a password. Anyone who has it can post to your channel.
Connecting a channel¶
- Find the Connect Slack channel card on the Slack page.
- Paste the address into Slack webhook URL. It must start with
https://hooks.slack.com/services/. - Optionally, type the channel's name into Channel, for example
#events. - Under Events, select at least one event.
- Keep the switch on Active to start right away. Switch it to Paused to start later.
- Select Connect channel.
The app confirms Slack channel connected. The channel appears in the table. A Slack channel has no signing secret, so RU4M shows you no secret to save.
What RU4M posts¶
Each message names what happened and which event or company changed. An event message also shows its start, place and organizer when they are known. An Open in RU4M Backoffice button opens the event or company, unless it was deleted.
Slack messages are always in English, whatever language you use in RU4M.
Pausing and turning on a channel¶
Use the switch in the Status column.
- Switch it off to pause the channel. The app confirms Slack channel paused. RU4M posts nothing while it is paused.
- Switch it on to start again. The app confirms Slack channel turned on.
Managing a channel¶
Open the actions menu at the end of the channel's row.
Editing a channel¶
- Select Edit.
- Change the address, the channel name, the events or the status.
- Select Save changes.
The app confirms Changes saved.
Sending a test message¶
- Select Send test message.
- Select Send test message in the Send a test message? dialog.
RU4M posts RU4M is connected to the channel. The app confirms Test message sent.
Disconnecting a channel¶
- Select Delete.
- Select Disconnect in the Disconnect this Slack channel? dialog.
RU4M stops posting to that channel immediately. The app confirms Slack channel disconnected. You can connect the channel again at any time.
You can also disconnect a channel on the edit page, in the Disconnect channel card.
Troubleshooting¶
The channel receives nothing. Check that the channel is Active and that you selected the right events. Then open the Deliveries page. Slack deliveries carry a Slack badge.
The app does not accept the address. Use the Webhook URL from Slack. It must start with https://hooks.slack.com/services/.
Connect channel is disabled. You already have 10 Slack channels and webhooks together, or RU4M has suspended your access. Disconnect a channel or delete a webhook you no longer use.
Someone else has the Webhook URL. Remove the webhook in your Slack app and create a new one. Then paste the new address on the channel's edit page.
Related tasks¶
- Overview, deliveries and audit — check every delivery and send a failed one again.
- Webhooks — notify your own system instead of a Slack channel.
- Requesting integration access — get access before you connect a channel.