Blekk
07/24/2026, 1:44 AMAI Evy
07/24/2026, 1:44 AMAI Evy
07/24/2026, 1:44 AMAI Evy
07/24/2026, 1:44 AMAI Evy
07/24/2026, 1:44 AMBlekk
07/24/2026, 10:57 AMAI Evy
07/24/2026, 10:57 AMAI Evy
07/24/2026, 10:57 AMjson
{
"type": "book_appointment_cal",
"name": "book_appointment",
"description": "Book an annual check up.",
"cal_api_key": "cal_live_xxxxxxxxxxxx",
"event_type_id": 60444,
"timezone": "America/Los_Angeles"
}
For dynamic timezone handling, you can:
1. Pass timezone as a dynamic variable when creating the call, then reference it in your agent's logic [(1) ]() [(2) ]()
2. Use system default dynamic variables like {{current_time_[timezone]}} to get the current time in any timezone (e.g., {{current_time_Australia/Sydney}} or {{current_time_America/New_York}}) [(3) ]()
3. Include timezone information in your prompt using dynamic variables to ensure the agent books appointments in the correct timezone [(4) ]()
The key is injecting timezone data into the call context at call creation using the variables field, ensuring the agent has the correct timezone information before attempting to book.
**AI Evy
07/24/2026, 10:57 AMAI Evy
07/24/2026, 10:57 AMBlekk
07/24/2026, 12:14 PMAI Evy
07/24/2026, 12:14 PMAI Evy
07/24/2026, 12:14 PMjson
{
"type": "book_appointment_cal",
"name": "book_appointment",
"description": "Book an annual check up.",
"cal_api_key": "cal_live_xxxxxxxxxxxx",
"event_type_id": 60444,
"timezone": "Pacific/Auckland"
}AI Evy
07/24/2026, 12:14 PMAI Evy
07/24/2026, 12:14 PMAI Evy
07/24/2026, 12:14 PMBlekk
07/24/2026, 12:17 PMAI Evy
07/24/2026, 12:17 PMAI Evy
07/24/2026, 12:18 PMPacific/Auckland) . To handle bookings in the caller's timezone, you can use dynamic variables and prompt instructions. [(1) ]() [(2) ]() [(3) ]()
Here's the approach:
1. Configure your Book Appointment Cal tool with your Cal.com timezone: [(2) ]() [(3) ]()
json
{
"type": "book_appointment_cal",
"name": "book_appointment",
"description": "Book an annual check up.",
"cal_api_key": "cal_live_xxxxxxxxxxxx",
"event_type_id": 60444,
"timezone": "Pacific/Auckland"
}
[(2) ]() , [(3) ]()
2. Use dynamic variables to capture and convert the user's timezone: [(1) ]()
You can pass the user's timezone as a dynamic variable when creating the call using `retell_llm_dynamic_variables`:
json
{
"user_timezone": "Australia/Perth"
}AI Evy
07/24/2026, 12:18 PMgeneral_prompt or `state_prompt`: [(2) ]() [(3) ]()
- Ask the user what state or city they're calling from [(1) ]()
- Use that information to determine their timezone
- When they request a time (like "5am my time") , convert it to Pacific/Auckland time before booking
- You can reference {{user_timezone}} in your prompt if you pass it as a dynamic variable
The agent will handle the timezone math in conversation, ensuring that when someone in Perth says "5am," it books the correct equivalent time in your NZST Cal.com calendar. [(1) ]() [(2) ]() [(3) ]()AI Evy
07/24/2026, 12:18 PMAI Evy
07/24/2026, 12:18 PMBlekk
07/24/2026, 12:20 PMAI Evy
07/24/2026, 12:20 PMAI Evy
07/24/2026, 12:21 PMtimezone parameter in the Book Appointment Cal tool is set to "Pacific/Auckland" to match my Cal.com calendar
- Confirm the configuration looks like this:
json
{
"type": "book_appointment_cal",
"name": "book_appointment",
"description": "Book an annual check up.",
"cal_api_key": "cal_live_xxxxxxxxxxxx",
"event_type_id": 60444,
"timezone": "Pacific/Auckland"
}AI Evy
07/24/2026, 12:21 PMgeneral_prompt or state_prompt) that tell the agent to: [(1) ]()
- Ask the user what state/city they're calling from
- Identify their timezone based on their location
- Convert their requested time to Pacific/Auckland (NZST) before booking
- Handle the timezone conversion accurately (e.g., Perth 5am = Auckland 9am)
3. Dynamic Variable Support (if applicable) : [(2) ]()
- If you've set up dynamic variables for timezone handling, confirm that {{user_timezone}} or similar variables are properly referenced in the prompt
Please review these changes and let me know if everything is configured correctly. I want to ensure that when someone in Perth says '5am my time,' it books the correct equivalent time in my NZST Cal.com calendar."
---
This message asks Conductor AI to verify the specific technical requirements for proper timezone handling in Retell AI. [(1) ]() [(2) ]()AI Evy
07/24/2026, 12:21 PMAI Evy
07/24/2026, 12:21 PM