Working hours: when the agent is allowed to reach out

Working hours define when the agent is allowed to send proactive
messages. Inbound replies always send — if a contact messages you at 3am,
the agent replies at 3am.

What working hours control

• Triggers — respect the window. A trigger that fires outside hours is
• Follow-ups — respect the window. Step scheduled for 3am → pushed to
• Agent-initiated follow-ups (schedule_followup) — respect the window.

What they don't control

• Inbound replies. If a contact messages, the agent replies. Full stop.
• Manual sends from the Inbox. You clicking send is your decision.
• Handover notifications. Notifications to you are always real-time.

Fields

• Enabled — turn the whole thing on/off
• Start hour / End hour — 0–24, in the agent's configured timezone
• Working days — tick the days the agent is active
• Timezone — IANA timezone string (e.g. America/New_York). All

Example configurations

B2B agent, US East Coast business hours:
- Start 9, End 18, Mon–Fri, America/New_York

Global consumer agent, near-24/7 but quiet overnight:
- Start 7, End 22, Mon–Sun, contact's local timezone (coming soon)

Aggressive sales agent, always on:
- Disabled entirely — treat every minute as fair game

Design principle

Respect the ask. If someone opts into being contacted, they're still
asleep at 3am. The agent's window shouldn't be your window — it should be
the contact's window. Default to restraint; you can always loosen later.