- Approval reminders nudge approvers who have not yet responded to a pending approval round.
- Assignment reminders nudge the current assignee of a ticket that has been sitting in an open state.
list_reminder_policies and configure_reminder_policy tools.
Approval reminders
Nudge approvers who have not yet responded to a pending approval round.
Assignment reminders
Nudge the current assignee of a ticket that has been sitting in an open state.
Shared behavior
Approval and assignment reminders work the same way under the hood:- Each is a workspace-level policy with an Enable toggle, a reminder interval (seconds, minutes, hours, days, or weeks, default
24 hours), a maximum reminders count (1,2,3,5,10, or Unlimited, default3), an optional business schedule, and optional conditions that scope which tickets the policy applies to. - Each reminder is delivered privately to its recipient (pending approvers for approval reminders, the current assignee for assignment reminders). Ravenna sends the reminder through three independent channels: an in-app notification in the notification center, a Slack DM, and an email. No public ticket message is posted, and other people with access to the ticket are not notified.
- Delivery is gated per channel by the recipient’s notification preferences. Approval reminders follow the Approvals group; assignment reminders follow the Assignments group. If a recipient has Slack disabled for that group, the DM is skipped; the same rule applies to email.
- Reminders are only delivered on published tickets. Draft or unpublished tickets do not receive reminder deliveries even if a reminder fires. Each fire is logged on the ticket timeline as a Reminder sent (
REMINDER_SENT) event regardless of whether delivery succeeded on any channel. - The interval clock restarts after every reminder. It is measured from when the work started (or from the last reminder), not from ticket creation.
- When the maximum is reached, the work itself is unaffected. Ravenna fires a Reminder Expired workflow trigger so you can escalate, reassign, or close the ticket in a workflow.
Conditions
You can scope a policy to a subset of tickets by adding conditions. Each policy can have one or more condition groups built from the same ticket fields you use elsewhere in Ravenna (queue, priority, form, requester attributes, and so on).- Leave conditions empty to remind on every ticket the policy type applies to. This is the default.
- Add one or more conditions and the policy only sends reminders for tickets that match. Within a group, all conditions must match (AND). Across groups, any group matching is enough (OR).
- Conditions are re-evaluated every time a reminder is about to fire, not just when the work starts. A ticket that no longer matches is skipped for that cycle, but the schedule keeps running. If the ticket changes back into scope (for example, priority is raised back to
High), reminders resume on the next interval. - Skipped fires do not count toward the Maximum reminders cap. Only delivered reminders count.
- To prevent a never-matching ticket from rescheduling forever, a reminder chain is capped at 30 days from when it first scheduled. After that, the chain stops on its own without firing a Reminder Expired event.
Business hours and weekends
Reminders respect the business schedule you select on the policy. If a reminder would fire outside the schedule’s working windows, Ravenna defers it to the next working window so people are not pinged overnight or on weekends.- If the policy has no schedule selected, reminders fire on a straight wall-clock interval, including nights and weekends.
- The interval is measured in real time, not business time. A 24-hour interval still resumes 24 hours after the work started; the deferral only shifts the delivery moment forward to the next working window.
- Only schedules that belong to the same workspace can be selected.
- On assignment reminders, select Assignee Hours. Ravenna defers each reminder to the assignee’s Working Hours preference. If the assignee has not picked a schedule, Assignee Hours falls back to the plain wall-clock interval for that reminder.
- On approval reminders, select Approver Hours. Ravenna runs one independent reminder chain per pending approver, deferred to that approver’s own Working Hours. Approvers without a schedule receive reminders on the plain interval. See Approver Hours for the per-approver behavior.
- Assignee Hours and Approver Hours are mutually exclusive with picking a workspace schedule on the same policy. Policies set to No schedule or to a specific workspace schedule are unaffected.
Automation settings are admin-only. Each workspace has its own policies. There is no per-channel, per-form, or per-ticket override. Disable a workspace’s policy to stop those reminders everywhere in that workspace.
Approval reminders
When a round becomes active, Ravenna schedules the first reminder using your workspace’s interval setting. Each time the reminder fires:- Ravenna looks up the round’s pending approvers (anyone who has not yet approved or declined).
- If there are no pending approvers, nothing is sent and no further reminders are scheduled. The round has either completed or been reset.
- Otherwise, Ravenna delivers a private reminder to each pending approver through three independent channels, each gated by that approver’s Approvals notification preferences:
- An in-app notification in the notification center.
- A Slack DM in the approver’s existing ticket DM thread with the message ”⏰ Reminder: your approval is still pending on this ticket.”
- An email with the subject line for the ticket, containing “Your approval is still pending on this ticket.”
- If the round still has pending approvers and the cap has not been reached, Ravenna schedules the next reminder one interval out from the reminder it just delivered.
- When the cap is reached, Ravenna fires a Reminder Expired workflow trigger of type
Approval.
Approvers who are added to a round mid-flight (for example, when an admin edits the round) are picked up automatically on the next reminder. They do not need to wait for a new cycle to start.
Configure approval reminders
1
Open Automation settings
Go to Settings → Workspace → Automation. The page is admin-only.
2
Enable approval reminders
Find the Approval Reminders card and toggle Enable approval reminders on.
3
Set the reminder interval
Set how long Ravenna waits after a round opens (or after the last reminder) before sending the next nudge. Enter a whole number and select seconds, minutes, hours, days, or weeks. The default is
24 hours.4
Set the maximum reminders
Set how many nudges Ravenna sends per round before giving up. Select from
1, 2, 3, 5, 10, or Unlimited. The default is 3. Under Approver Hours, this cap is per approver rather than per round.5
Select a business schedule (optional)
Under Business hours, pick one of the following:
- A specific business schedule from the current workspace to defer reminders to its working windows.
- Approver Hours to defer each reminder to the pending approver’s own Working Hours preference. Ravenna runs a separate reminder chain per approver, see Approver Hours.
- No schedule to send on a wall-clock interval, including nights and weekends.
6
Add conditions (optional)
Under Conditions, select Add condition set to limit reminders to tickets matching specific filters (for example, only
Priority is High or Urgent). Leave empty to remind on every pending approval round.Approver Hours (per-approver chains)
When the approval policy’s business hours setting is Approver Hours, Ravenna does not run a single round-wide reminder chain. Instead:- Each pending approver gets their own reminder chain, keyed by
(ticket, round, approver). Every reminder is delivered only to that approver. - Each chain’s fire time is deferred to that approver’s Working Hours preference. Approvers without one receive reminders on the plain interval.
- If a new approver is added to the round mid-flight, they get a fresh chain that starts from when they joined, not from when the round opened.
- Maximum reminders is enforced per approver. Two approvers with a cap of
3can receive up to3reminders each, for6events total on the round. - The ticket timeline records one Reminder sent event per approver, per fire, so audit history reflects each individual chain.
- The Reminder Expired workflow trigger fires once, when the last remaining chain on the round hits its cap. Chains that end because their approver responded do not fire the trigger.
- Approve, decline, reset, or complete the round and every chain on it is cancelled together.
When approval reminders stop
A reminder cycle ends as soon as any of the following happens:- All approvers on the round have responded (the round is approved, declined, or reset).
- The round has no pending approvers when a reminder is about to fire.
- The configured Maximum reminders count has been sent.
- An admin disables the Enable approval reminders toggle.
- The reminder chain has been running for 30 days without delivering, because the ticket never matched the policy’s conditions.
Assignment reminders
When a ticket is assigned, Ravenna schedules the first reminder using your workspace’s interval setting. Each time the reminder fires:- Ravenna checks the ticket. If the ticket is unassigned, was reassigned to someone else, archived, or has moved to a terminal status (
DoneorClosed), the reminder is cancelled. - Otherwise, Ravenna delivers a private reminder to the current assignee through three independent channels, each gated by their Assignments notification preferences:
- An in-app notification in the notification center.
- A Slack DM in the assignee’s existing ticket DM thread with the message ”⏰ Reminder: this ticket is still assigned to you.”
- An email with the subject line for the ticket, containing “This ticket is still assigned to you.”
- If the cap has not been reached, Ravenna schedules the next reminder one interval out from the reminder it just delivered.
- When the cap is reached, Ravenna fires a Reminder Expired workflow trigger of type
Assignment.
Only one assignment reminder runs at a time per ticket. The schedule is keyed by ticket, not by assignee, so a new assignment supersedes the previous reminder.
Configure assignment reminders
1
Open Automation settings
Go to Settings → Workspace → Automation. The page is admin-only.
2
Enable assignment reminders
Find the Assignment Reminders card and toggle Enable assignment reminders on.
3
Set the reminder interval
Set how long Ravenna waits after a ticket is assigned (or after the last reminder) before sending the next nudge. Enter a whole number and select seconds, minutes, hours, days, or weeks. The default is
24 hours.4
Set the maximum reminders
Set how many nudges Ravenna sends per assigned ticket before giving up. Select from
1, 2, 3, 5, 10, or Unlimited. The default is 3.5
Select a business schedule (optional)
Under Business hours, pick one of the following:
- A specific business schedule from the current workspace to defer reminders to its working windows.
- Assignee Hours to defer each reminder to the current assignee’s own Working Hours preference. Assignees without one receive reminders on the plain interval.
- No schedule to send on a wall-clock interval, including nights and weekends.
6
Add conditions (optional)
Under Conditions, select Add condition set to limit reminders to tickets matching specific filters (for example, only tickets in a particular queue, or only
Priority is High or Urgent). Leave empty to remind on every assigned ticket.When assignment reminders stop
A reminder cycle ends as soon as any of the following happens:- The ticket is unassigned or reassigned to a different user. A new cycle begins for the new assignee.
- The ticket is archived.
- The ticket moves to a terminal status (any status in the
DoneorClosedsystem group). - The configured Maximum reminders count has been sent.
- An admin disables the Enable assignment reminders toggle.
- The reminder chain has been running for 30 days without delivering, because the ticket never matched the policy’s conditions.
Escalate stale work with workflows
Pair reminders with the Reminder Expired workflow trigger to escalate work that exhausts its reminder budget without progress. Filter the trigger’s Reminder Type toApproval or Assignment so the workflow only fires for the reminder type you intend.Common patterns:- Notify a backup approver or the assignee’s manager. Add a manager or fallback group when the cap is hit so the request keeps moving.
- Reassign to a fallback group. Move the ticket to a backup channel or assign it to a different team so it does not stall.
- Post an escalation note. Add a private note summarizing who is still pending and ping a lead for triage.
- Auto-close stalled requests. If a request has been ignored for too long, change the ticket status or decline the round in a workflow.
Learn more about the Reminder Expired trigger and building escalation workflows.
Tips
- Start conservative. A 24-hour interval with a 3-reminder cap is the default for a reason. Tighter cadences create noise without changing outcomes.
- Select a business schedule. Without one, reminders fire 24/7 and people get pinged in the middle of the night.
- Use conditions to focus the policy. If only high-priority or channel-specific work warrants nudging, add conditions so routine tickets are not pinged. Conditions are re-checked on every fire, so a ticket can drop out and back into scope without losing its place.
- Use Waiting statuses to pause assignment reminders. Assignment reminders only stop when a ticket reaches a terminal status group (
DoneorClosed). Use statuses and SLA pauses deliberately so reminders fire only when the assignee actually owns the next step. - Always design the expiry path. Reminders only nudge, they do not move the ticket. Build a Reminder Expired workflow so stalled work gets reassigned or escalated automatically.
- Combine approval reminders with Wait for Approval timeouts. Reminders push approvers to act. A Wait for Approval timeout matches neither of the step’s branches, so the Reminder Expired workflow is what handles the case where they never do.