Snoozing conversations and scheduling messages

Two tools keep follow-ups from falling through the cracks: snooze and scheduled messages.

Snoozing

Use organize_conversation with action snooze and a future snooze_until datetime (ISO 8601, e.g. '2026-08-01T09:00:00Z'). The conversation leaves your active inbox and resurfaces exactly when the time hits. Add an optional note like 'Follow up on proposal', it is never sent to the other person, it's just for you. If the person replies before the snooze fires, it auto-cancels so you see their reply immediately.

Scheduling messages

Use schedule_message with a chat_id, message_text (up to 8,000 characters), and a future send_at datetime. The message sends itself at that moment. The best part: if the contact replies before the scheduled time, the send auto-cancels, so you never talk over them or send a 'just checking in' after they already answered.

Managing what's queued

• list_reminders shows all pending snoozes and scheduled messages sorted by fire time. Filter by status: pending (default), fired, sent, cancelled, failed, or all.
• cancel_reminder cancels either kind by its reminder_id. Cancelling a snooze also brings the conversation back to your active inbox immediately.

A simple rhythm:

1. End every conversation with either a reply, a snooze, or a scheduled follow-up.
2. Review list_reminders weekly so nothing queued has gone stale.

Common mistake: scheduling in the wrong timezone. send_at is an absolute ISO timestamp, so convert from the recipient's local time deliberately.

Pro tip: schedule follow-ups into the recipient's working hours, mid-morning their time. A message that lands at 3am local sits at the bottom of a pile by the time they wake up.