Skip to content

Rotation mentions

Mentions let anyone in your Slack workspace ask the on-duty users of a rotation for help, without knowing who is on duty. A user mentions the bot with a rotation code in a channel, and Round Robin notifies the people currently on duty, tracks whether someone acknowledges, and reports back to the requester.

Mentions are especially useful when Round Robin cannot manage a Slack user group for you (see the on-duty user group feature) — for example, when workspace policy restricts user-group changes.

A mention conversation in a Slack channel

A mention targets a rotation by its code, so the rotation needs one first. In the dashboard at app.roundrobinbot.eu:

  1. Open the rotation and choose Configure → Edit.
  2. On the Details tab, fill in the Code field. Keep it short and memorable; letters, numbers, dashes, and underscores are allowed — no spaces.
  3. Save the rotation.

Mention behavior is configured per rotation, under Configure → Options in the dashboard. Everything beyond the basic flow requires a Pro plan.

The Mention Settings section of the rotation Options page, showing expiration time, Require Acknowledgment, Apply Round-Robin Logic, and Rotate After Acknowledgment

Option Plan What it does
Mention expiration time Pro to change (default 60 minutes) Maximum time a mention stays open. If nobody acknowledges before it elapses, the mention expires and closes automatically.
Require acknowledgment Pro By default a mention is one-shot: on-duty users are notified once, and the mention simply waits until expiration. With this option on, Round Robin notifies again after the number of minutes you set (Notify again after, default 10) if nobody has acknowledged.
Apply round-robin logic to mentions Pro Instead of notifying every on-duty user at once, notify one at a time, rotating who goes first across mentions.
Rotate after acknowledgment Pro When an on-duty user acknowledges a mention, rotate them out of duty.

Mentions themselves happen in Slack, where the conversation is:

  1. Go to a channel where the Round Robin bot is a member.
  2. Type @Round Robin <code>, for example @Round Robin multi. You can add a free-text message after the code; it is forwarded to the on-duty users.
  3. Round Robin confirms your request with a message visible only to you, including how long the mention stays open.

Mentioning Round Robin with a rotation code in a channel

If the code does not match any rotation, Round Robin tells you so. Each person can have only one open mention per rotation at a time; if you mention the same rotation again while yours is still open, Round Robin reminds you the request is already pending.

Each notified on-duty user receives a direct message with Ack and Pass buttons.

The direct message an on-duty user receives, with Ack and Pass buttons

  • Ack — the requester is told who acknowledged, and contact is established. The mention closes.
  • Pass — the user declines. If other on-duty users were also notified, the mention stays open for them; if nobody notified is left, Round Robin either notifies again (depending on the rotation’s mention options) or closes the mention and informs the requester that nobody could answer.

The confirmation the requester sees after an acknowledgment

If nobody is on duty when the mention is created, the requester is informed immediately and the mention closes.

The response when nobody is on duty

With Require acknowledgment on, on-duty users who have not responded are reminded after the configured minutes.

The notify-again reminder an on-duty user receives

The dashboard’s Mentions page lists all mentions and their status (open, acknowledged, ignored, expired), so you can review activity across your rotations.

The Mentions page in the dashboard, listing mention activity and status

Suppose a rotation has three users on duty: Robert, John, and Jack.

  • A mention is created and only Robert is notified.
  • When the next mention is created, John is notified first, then Jack on the one after, and so on.

On its own, this option only changes who gets notified: if the notified user passes, the mention closes and the requester is told nobody could answer. Combine it with Require acknowledgment to walk through the on-duty users within a single mention: if Robert passes, or neither acknowledges nor passes within the configured minutes, John is notified next instead of Robert being reminded.

You can also set the rotation code without leaving Slack: open the rotation for editing and fill in the Code field in the edit modal, then save.

The Code field in the rotation edit modal in Slack