How to use Reminder Agent

Updated by Jake Gipson

Reminder Agent: How It Works

What is the Reminder Agent?

The Reminder Agent is an automated feature that helps you follow up with customers who haven't responded to support tickets. Instead of manually tracking and sending follow-up messages, the Reminder Agent does this for you automatically.

How Does It Get Activated?

The Reminder Agent wakes up and starts working whenever aΒ ticket's status changes. Here's the step-by-step process:

1. Status Change Triggers the Check

When you (or anyone on your team) changes a ticket's status, the system asks:Β "Should the Reminder Agent handle this ticket?"

2. Eligibility Check

The system checks if the ticket meets ALL of these conditions:

Condition

What It Means

Feature Enabled

Your company has the Reminder Agent feature turned on

Ticket Not Closed

The ticket must still be open/active

Customer Activated

The customer's company is on your "reminder list" (or you've set it to "all customers")

Board Activated

The ticket is on a service board where reminders are enabled

Source Activated

The ticket came from a channel (email, chat, etc.) where reminders are allowed

Status Matches

The ticket's current status is one you've designated as a "reminder status"

If any of these checks fail, the Reminder Agent stays quiet and does nothing.

3. Scheduling the Reminder

If the ticket passes all checks, the Reminder Agent calculatesΒ whenΒ to send the first reminder message.

⏰ Two Ways to Schedule Reminders

You can choose one of two scheduling methods. Each method handlesΒ timezonesΒ andΒ messenger working hoursΒ differently.

πŸ“… Option A: Daily Reminders

Send reminders at theΒ same time every dayΒ β€” perfect for consistent, predictable follow-ups.

Setting

Description

Reminder Time

The exact time to send reminders (e.g., 9:00 AM)

Day Type

Choose betweenΒ Weekdays onlyΒ (Mon-Fri) orΒ Every dayΒ (7 days)

Timezone

Uses yourΒ company's timezoneΒ from settings

How Daily Scheduling Works

  1. When a ticket becomes eligible, the system looks for theΒ next occurrenceΒ of your reminder time
  2. If that time has already passed today, it schedules for tomorrow
  3. If "Weekdays only" is selected, weekends are automatically skipped

🌍 Timezone Behavior

Daily reminders use yourΒ company's configured timezone:

  • If your company is set to "America/New_York" and you set reminders for 9:00 AM
  • The reminder fires at 9:00 AM Eastern Time, regardless of where the customer is located

πŸ“˜ Example Scenarios: Daily Reminders

Scenario 1: Simple Next-Day Reminder

  • Settings: 9:00 AM, Weekdays only, Company timezone: America/New_York
  • Ticket becomes eligible: Wednesday at 10:00 AM EST
  • Reminder scheduled for:Β Thursday at 9:00 AM EST

Scenario 2: Weekend Skip

  • Settings: 9:00 AM, Weekdays only, Company timezone: America/Chicago
  • Ticket becomes eligible: Friday at 11:00 AM CST
  • Saturday and Sunday are skipped
  • Reminder scheduled for:Β Monday at 9:00 AM CST

Scenario 3: Same Day (if time hasn't passed)

  • Settings: 3:00 PM, Every day, Company timezone: Europe/London
  • Ticket becomes eligible: Tuesday at 10:00 AM GMT
  • Feature flag "Allow Same Day Reminders" is enabled
  • Reminder scheduled for:Β Tuesday at 3:00 PM GMTΒ (same day!)

Scenario 4: Same Day Time Passed

  • Settings: 9:00 AM, Every day, Company timezone: America/Los_Angeles
  • Ticket becomes eligible: Monday at 2:00 PM PST
  • 9:00 AM has already passed
  • Reminder scheduled for:Β Tuesday at 9:00 AM PST

⏱️ Option B: Custom Delay

Send reminders after aΒ specific number of hoursΒ β€” perfect for urgent follow-ups or SLA-based timing.

Setting

Description

Delay Hours

Number of hours to wait (1-100 hours)

Timezone

Not timezone-dependent β€” simply adds hours from current time

How Custom Delay Works

  1. When a ticket becomes eligible, the system takes theΒ current time
  2. Adds your configured number of hours
  3. That's when the reminder fires

🌍 Timezone Behavior

Custom delay is timezone-agnostic β€” it simply adds hours to the current moment:

  • If it's 2:00 PM anywhere and you have a 4-hour delay
  • The reminder fires at 6:00 PM (in UTC internally, displayed in local time)

πŸ“˜ Example Scenarios: Custom Delay

Scenario 1: Simple 24-Hour Delay

  • Settings: 24-hour delay
  • Ticket becomes eligible: Monday at 2:30 PM
  • Reminder scheduled for:Β Tuesday at 2:30 PM

Scenario 2: Short Urgent Delay

  • Settings: 4-hour delay
  • Ticket becomes eligible: Wednesday at 9:00 AM
  • Reminder scheduled for:Β Wednesday at 1:00 PM

Scenario 3: Weekend Crossing

  • Settings: 48-hour delay
  • Ticket becomes eligible: Friday at 3:00 PM
  • Reminder scheduled for:Β Sunday at 3:00 PM
  • ⚠️ Note: Without working hours enabled, this WILL fire on Sunday

🏒 Integration with Messenger Working Hours

When theΒ Working Hours featureΒ is enabled, the Reminder Agent respects your business schedule. This prevents reminders from being sent when your team isn't available.

How Working Hours Are Determined

Priority

Source

Timezone Used

1st

Company's own Messenger Hours settings

Messenger Hours timezone

2nd

Parent company's Messenger Hours (fallback)

Parent's Messenger Hours timezone

Important:Β Working hours use theΒ Messenger Hours timezone, which may be different from your company timezone!

Working Hours + Daily Reminders

The systemΒ validatesΒ that your reminder time falls within working hours:

βœ… Valid Configuration

  • Working Hours: 8:00 AM - 6:00 PM
  • Reminder Time: 9:00 AM
  • βœ“ 9:00 AM is within working hours β€” reminder will fire

❌ Invalid Configuration

  • Working Hours: 9:00 AM - 5:00 PM
  • Reminder Time: 8:00 AM
  • βœ— 8:00 AM is BEFORE working hours start
  • Result:Β Error message, reminder skipped

πŸ“˜ Example: Daily + Working Hours

Scenario: Closed Day Skip

  • Settings: 10:00 AM daily, Weekdays only
  • Working Hours: Mon-Thu 9 AM - 5 PM (Friday is OFF)
  • Ticket becomes eligible: Thursday at 11:00 AM
  • Friday is a weekday but working hours are OFF for Friday
  • System finds next available working day
  • Reminder scheduled for:Β Monday at 10:00 AM

Scenario: Finding Next Available Day

  • Settings: 9:00 AM daily, Every day
  • Working Hours: Mon-Fri 9 AM - 5 PM (weekends OFF)
  • Ticket becomes eligible: Friday at 10:00 AM
  • Saturday and Sunday have no working hours
  • Reminder scheduled for:Β Monday at 9:00 AM

Working Hours + Custom Delay

The systemΒ adjustsΒ the calculated time to fit within working hours:

Calculated Time Falls...

What Happens

Within working hours

Reminder fires at calculated time

Before working hours start

Moves to start of working hours that day

After working hours end

Moves to start of next working day

On a non-working day

Moves to start of next working day

πŸ“˜ Example: Custom Delay + Working Hours

Scenario 1: Lands Within Hours

  • Settings: 4-hour delay
  • Working Hours: 9:00 AM - 5:00 PM
  • Ticket becomes eligible: Tuesday at 10:00 AM
  • Calculated time: Tuesday at 2:00 PM βœ“ (within 9-5)
  • Reminder scheduled for:Β Tuesday at 2:00 PM

Scenario 2: Lands After Hours

  • Settings: 6-hour delay
  • Working Hours: 9:00 AM - 5:00 PM
  • Ticket becomes eligible: Monday at 2:00 PM
  • Calculated time: Monday at 8:00 PM βœ— (after 5 PM)
  • Adjusted to next working day start
  • Reminder scheduled for:Β Tuesday at 9:00 AM

Scenario 3: Lands Before Hours

  • Settings: 8-hour delay
  • Working Hours: 10:00 AM - 6:00 PM
  • Ticket becomes eligible: Monday at 11:00 PM
  • Calculated time: Tuesday at 7:00 AM βœ— (before 10 AM)
  • Adjusted to working hours start
  • Reminder scheduled for:Β Tuesday at 10:00 AM

Scenario 4: Weekend + Working Hours

  • Settings: 24-hour delay
  • Working Hours: Mon-Fri 9:00 AM - 5:00 PM
  • Ticket becomes eligible: Friday at 3:00 PM
  • Calculated time: Saturday at 3:00 PM βœ— (no working hours on Saturday)
  • System searches for next working day
  • Reminder scheduled for:Β Monday at 9:00 AM

Scenario 5: Multiple Days Off

  • Settings: 4-hour delay
  • Working Hours: Only Tuesday and Thursday, 10:00 AM - 4:00 PM
  • Ticket becomes eligible: Tuesday at 5:00 PM (after hours)
  • Wednesday has no working hours
  • Reminder scheduled for:Β Thursday at 10:00 AM

⚠️ Edge Cases & Limits

Situation

Behavior

No working hours configured

Error: "Messenger hours not configured" β€” reminder skipped

Messenger Hours set to "Always Available"

Working hours check bypassed β€” reminder fires at calculated time

No working hours found in 8 days

Error: "No available working hours" β€” reminder skipped

Reminder time outside all working hours

Error with details β€” reminder skipped

πŸ”„ Quick Comparison

Aspect

Daily Reminder

Custom Delay

When it fires

Same time every day

X hours from now

Timezone used

Company timezone

None (UTC internally)

Working hours timezone

Messenger Hours timezone

Messenger Hours timezone

Weekend handling

Optional skip (Weekdays setting)

Only with Working Hours enabled

Best for

Consistent daily follow-ups

Urgent or SLA-based timing

What Happens When a Reminder Fires?

When the scheduled time arrives:

  1. Final eligibility checkΒ - The system confirms the ticket is still eligible (customer hasn't replied, status hasn't changed, etc.)
  2. Message sentΒ - An AI-generated follow-up message is sent to the customer based on the instructions you've configured
  3. Next reminder scheduledΒ - If you have multiple reminders configured (up to 5), the next one gets scheduled
  4. Activity loggedΒ - An internal note is added to the ticket showing "Reminder Agent sent Reminder 1" (or 2, 3, etc.)

Multiple Reminders in Sequence

You can set up toΒ 5 reminder messages, each with its own custom instructions. They fire one after another:

Reminder 1  β†’  (wait)  β†’  Reminder 2  β†’  (wait)  β†’  Reminder 3  β†’  ...  β†’  Final Action

Each reminder only fires if the customer still hasn't responded since the last one.

What Happens After the Last Reminder?

After all your configured reminders have been sent (and the customer still hasn't replied), the Reminder Agent can automatically:

  • Change the ticket statusΒ to a status you've designated (e.g., "Waiting for Response")
  • Close the ticketΒ if you've set the final status to a "closed" status

This is configured in yourΒ Status MappingΒ settings.

When Does the Reminder Agent Cancel?

The Reminder Agent stops and cancels any scheduled reminders when:

  • βœ“ The customer replies to the ticket
  • βœ“ The ticket status changes to something not on the "reminder list"
  • βœ“ The ticket is closed
  • βœ“ A team member manually changes or closes the ticket
  • βœ“ A new reminder is scheduled (replaces the old one)

Summary Flow

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ TICKET STATUS CHANGES β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Is ticket eligible? (feature on, right board, status, etc.) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ β”‚
YES NO
β”‚ β”‚
β–Ό β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Calculate when to send β”‚ β”‚ Do nothing / Cancel existing β”‚
β”‚ (daily time OR custom delay)β”‚ β”‚ reminders if any β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Adjust for working hours β”‚
β”‚ (if feature enabled) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Schedule reminder job β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β–Ό
(Time passes...)
β”‚
β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Re-check eligibility β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”
β”‚ β”‚
YES NO
β”‚ β”‚
β–Ό β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Send reminder β”‚ β”‚ Cancel reminder β”‚
β”‚ to customer β”‚ β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ More reminders? YES β†’ Schedule next NO β†’ Apply final status β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Configuration Checklist

To use the Reminder Agent, make sure you have configured:

  1. ☐ Enabled the Reminder Agent for your company
  2. ☐ Selected customers (all or specific ones)
  3. ☐ Selected boards where reminders should apply
  4. ☐ Selected sources (email, chat, etc.)
  5. ☐ Mapped statuses - which statuses trigger reminders and what status to apply at the end
  6. ☐ Set timing - daily time OR custom delay hours
  7. ☐ Written reminder instructions - what the AI should say in each reminder message (up to 5)
  8. ☐ (Under feature flag) Configured working hours if you want time-aware scheduling

FAQ

Q: What if a customer replies after the first reminder?

A: The next reminder is automatically cancelled. The ticket returns to normal handling.

Q: Can I see which tickets have active reminders?

A: Yes, the system logs "Reminder Agent is activated" as an internal note when reminders are scheduled.

Q: What timezone does the Reminder Agent use?

A: It uses your company's configured timezone for daily reminders, and your messenger's working hours timezone for working-hours adjustments.

Q: What if no working hours are configured?

A: If working hours feature is enabled but no hours are set up, you'll receive an error message and the reminder will be skipped.


How did we do?