Skip to content

Rotation mentions

Works on the Free plan. Options marked Pro below need a Pro plan.

Mentions let anyone in your Slack workspace reach the people on duty for a rotation without knowing who they are. Somebody mentions the bot with a rotation code in a channel, and Round Robin notifies the people on duty, tracks whether one of them acknowledges, and reports back to the requester.

Use mentions where Round Robin cannot keep an on-duty user group for you, for example because your workspace 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, click Settings, and stay on Rotation details.
  2. On the Details tab, fill in the Code field. Keep it short. Letters, numbers and hyphens are allowed, spaces are not. It is stored uppercase, and matching is case-insensitive.
  3. Save the rotation.

Mention behavior is configured per rotation, under Settings → Alerts & mentions in the dashboard. The basic flow (mention, notify, acknowledge) works on every plan; the options below tune it.

The Mention settings section of a rotation’s Alerts & mentions settings, showing expiration time, Require acknowledgment, Apply round-robin logic to mentions, and Rotate after acknowledgment

Option Plan What it does
Mention expiration time Pro to change it (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 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 the person on duty acknowledges a mention, the duty passes to the next person. See Rotate after acknowledgment on a rotation with a schedule.

Rotate after acknowledgment on a rotation with a schedule

Section titled “Rotate after acknowledgment on a rotation with a schedule”

Rotate after acknowledgment works on every rotation. On a rotation with at least one window on a schedule, each acknowledgment moves the turn order on by one person. Every later turn then goes to somebody other than the person planned, and covers and swaps already agreed can land on other people.

With the switch on, a panel under it says so:

This rotation follows a schedule. Each acknowledgment hands the duty to the next person, so planned swaps and covers can land on other people.

Rotations that hand over on every acknowledgment work best with the Manual schedule.

Switch schedule to Manual opens the window’s page when one window is on a schedule, and the Coverage tab when several are. Set each window’s schedule type to Manual there and save. The button shows only to people who can edit the rotation’s coverage.

To keep the schedule and the planned turns, switch Rotate after acknowledgment off.

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.

Who gets each mention message, and whether it lands in the thread, a direct message or a reply only the requester sees: see Mentions.

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.