State Business Hours (Call Times)

What State Business Hours Are

A state business hours entry defines per-day time
windows during which outbound calls to leads in
specified states are permitted. Calls outside these
windows are blocked. Each entry covers all seven days
of the week with individual open/close times per day.

Key Fields

• states: a PostgreSQL text array of state codes using the us-XX format (e.g., us-ca, us-ny).
• Per-day columns: for each day of the week, three columns exist:
  • {day}_closed (boolean): when true, no calls are permitted on that day.
  • {day}_open_at (integer): the earliest permitted call time in HHMM format (e.g., 800 = 8:00 AM, 1330 = 1:30 PM).
  • {day}_close_at (integer): the latest permitted call time in HHMM format (e.g., 2059 = 8:59 PM).
• Day names: monday, tuesday, wednesday, thursday, friday, saturday, sunday. Each gets three columns (21 total).
• company_id: the owning company.

Default Values

New records default to all days open from 800 (8:00 AM) to
2059 (8:59 PM), no days closed.

Time Zone Handling

Hours are evaluated in the call's local time zone (from the
lead's geographic data), with a fallback to the application
default time zone. The system converts the current time to
HHMM format (hour * 100 + minutes) and compares against
the day's open_at and close_at values.

Always Closed

If all seven days have their closed flag set to true, the
record is considered "always closed" and next_action_at is
set to 1 week from now when blocking.