Skip to main content

Business Hours

Business hours routing lets you define when your team is available and automatically handle calls differently based on the time of day, day of the week, and holidays. Calls during business hours are routed to live agents, while after-hours calls can go to voicemail, a recorded message, or an alternate team.

How Business Hours Routing Works​

Caller dials ExoPhone
|
v
Exotel checks current time against business hours schedule
|
├── Within business hours → Route to live agents (primary flow)
|
└── Outside business hours → Route to after-hours handling
(voicemail, greeting, alternate team)

Setting Up Business Hours​

Step 1: Define Your Schedule​

  1. Log in to the Exotel Dashboard.
  2. Navigate to Settings > Business Hours (or configure within your call flow).
  3. Set your weekly operating schedule:
DayStart TimeEnd TimeStatus
Monday9:00 AM6:00 PMOpen
Tuesday9:00 AM6:00 PMOpen
Wednesday9:00 AM6:00 PMOpen
Thursday9:00 AM6:00 PMOpen
Friday9:00 AM6:00 PMOpen
Saturday10:00 AM2:00 PMOpen
Sunday----Closed
  1. Select your time zone (e.g., IST, SGT).

Step 2: Create Business Hours and After-Hours Flows​

Create two separate call flows:

Business Hours Flow:

Greeting ("Welcome to Acme Corp")
→ IVR Menu ("Press 1 for Sales, 2 for Support")
→ Connect (Agent group)
→ No Answer → Call Queue → Voicemail

After-Hours Flow:

Greeting ("Thank you for calling. Our office hours are Monday to Friday, 9 AM to 6 PM.")
→ Greeting ("Please leave a message after the beep.")
→ Voicemail
→ Email notification to team

Step 3: Configure Time-Based Routing​

There are multiple ways to route based on business hours:

Option A: ExoPhone-Level Configuration​

  1. Go to ExoPhones in the dashboard.
  2. Select your ExoPhone.
  3. Under Business Hours Flow, select your business hours call flow.
  4. Under After-Hours Flow, select your after-hours call flow.
  5. Under Schedule, select the business hours schedule you defined.
  6. Save.

Option B: Using the Passthru Applet​

For custom time-based logic:

  1. Add a Passthru applet as the first step in your flow.
  2. Configure it to call your server with the current call details.
  3. Your server checks the time and returns routing instructions.
# Your server receives:
POST https://your-app.com/check-hours
CallSid=<call_sid>&From=<caller_number>

# Your server responds:
# If within business hours:
{"action": "continue"} # Flow proceeds to next applet (Connect)

# If outside business hours:
{"action": "redirect", "flow_id": "<after_hours_flow_id>"}

Holiday Calendar​

Configure holidays so calls are routed to the after-hours flow even on regular business days.

Adding Holidays​

  1. Go to Settings > Business Hours > Holidays.
  2. Click Add Holiday.
  3. Enter the holiday details:
FieldDescriptionExample
NameHoliday nameRepublic Day
DateThe holiday dateJanuary 26
RecurringRepeats every yearYes
FlowWhich flow to use on this dayAfter-Hours Flow
  1. Save.

Example Holiday Calendar​

HolidayDateRecurringFlow
Republic DayJanuary 26YesAfter-Hours
HoliMarch 14, 2025No (date varies)After-Hours
Independence DayAugust 15YesAfter-Hours
DiwaliNovember 1, 2025No (date varies)After-Hours
ChristmasDecember 25YesAfter-Hours
Company Annual DayJune 15YesReduced Hours Flow
tip

For holidays with variable dates (e.g., Eid, Diwali), update your holiday calendar at the beginning of each year. Alternatively, use the Passthru applet to check against a holiday API on your server.

Time-Zone Support​

If your business serves customers across multiple time zones:

Single-Team, Multiple Regions​

If your team operates in one time zone (e.g., IST) but serves customers across India:

  • Set business hours based on your team's local time zone.
  • All routing decisions use the configured time zone.

Distributed Teams Across Time Zones​

If you have teams in different time zones:

  1. Create separate ExoPhones for each region.
  2. Set different business hours for each ExoPhone based on the local team's schedule.
  3. Use IVR or smart routing to direct callers to the appropriate regional team.
Caller dials main ExoPhone
→ IVR: "Press 1 for India support, Press 2 for SE Asia support"
→ 1: Check India business hours → Route to India team or after-hours
→ 2: Check SE Asia business hours → Route to SE Asia team or after-hours

Follow-the-Sun Routing​

Route calls to whichever team is currently within business hours:

Passthru (check which team is active)
|
IST 9 AM - 6 PM → Connect (India team)
SGT 9 AM - 6 PM → Connect (Singapore team)
No team active → Voicemail

Implement this using the Passthru applet with server-side time-zone logic.

Multiple Schedules​

You may need different schedules for different departments:

DepartmentHoursSaturday
Sales9 AM - 8 PM10 AM - 4 PM
Support8 AM - 10 PM9 AM - 6 PM
Billing10 AM - 5 PMClosed

Create a separate business hours schedule for each department and assign the appropriate schedule to each department's call flow.

After-Hours Handling Options​

OptionDescriptionBest For
VoicemailCaller leaves a messageStandard after-hours
Recorded messagePlay a message with hours and alternate contact infoInformation only
SMS responseSend SMS with business hours or self-service linkMobile callers
Callback registrationCapture number for next-day callbackLead capture
Alternate teamRoute to an outsourced or night-shift team24/7 coverage
Emergency routingRoute critical calls to an on-call personHealthcare, IT support
warning

If you provide essential services (healthcare, emergency support), ensure your after-hours flow includes an option to reach an on-call agent for urgent matters. Do not rely solely on voicemail for time-sensitive scenarios.

Best Practices​

  • Inform callers of your hours -- Play a greeting that states your business hours so callers know when to call back.
  • Offer alternatives after hours -- Provide a website URL, email address, or FAQ in your after-hours message.
  • Update holiday calendar proactively -- Add holidays for the entire year at the start of the year.
  • Test time-based routing -- Temporarily set your business hours to a narrow window and test that the after-hours flow works correctly.
  • Use voicemail with email notifications -- Ensure after-hours voicemails are emailed to your team so they are addressed first thing in the morning.
  • Monitor after-hours call volume -- If you receive a significant volume of after-hours calls, consider extending your business hours or adding a night-shift team.

Troubleshooting​

IssueCauseSolution
After-hours flow not triggeringBusiness hours not configuredSet up business hours schedule
Wrong flow at the right timeTime zone incorrectVerify time zone in settings
Holiday not recognizedHoliday not added to calendarAdd the date to the holiday list
Calls go to after-hours during business hoursSchedule start/end times wrongCheck AM/PM and 24-hour format
Weekend calls go to agentsSaturday/Sunday marked as OpenUpdate schedule for weekends