Skip to main content

Change the business timezone

Updated today

Change the business timezone

This guide explains how to set the project_business_time_zone attribute and what can go wrong if the incorrect timezone is selected.

🚨 WARNING

An incorrect timezone affects appointment scheduling, working hours detection, call routing, and reporting. Always verify this attribute is correct after creating an AI Employee.

What the timezone controls

The Business Time Zone attribute (project_business_time_zone) defines the timezone the AI Employee uses for all time-based operations. Nearly every time-sensitive feature in the system depends on this setting:

  • Working hours status: The agent compares the current time in the business timezone against the working hours schedule to determine if the business is open or closed.

  • Schedule phrases: The agent generates messages like "We are currently open and will remain open until 9 PM Pacific Time."

  • Appointment and booking times: The timezone is sent to booking systems (Google Maps, OpenTable, etc.) to ensure appointments are scheduled correctly.

  • Calendar generation: The system generates a 45-day calendar with dates in the business timezone, helping the agent understand references like "tomorrow" or "next Friday."

  • Call transfer routing: Determines whether to use the working hours or non-working hours escalation phone number.

  • Report timestamps: All conversation logs and email reports use the business timezone.

Set the timezone

  1. Open the Builder.

  2. Navigate to Attributes > Business.

  3. Locate the Business Time Zone attribute (project_business_time_zone).

  4. Select the correct IANA timezone for the business location from the dropdown. Common values include:

  5. America/New_York (Eastern Time)

  6. America/Chicago (Central Time)

  7. America/Denver (Mountain Time)

  8. America/Los_Angeles (Pacific Time)

  9. Europe/London (GMT/BST)

  10. Asia/Tokyo (Japan Standard Time)

  11. Click Save.

πŸ—’οΈ NOTE

If the business is a call center and serves multiple time zones, use the time zone of the main office.

Did this answer your question?