Time-Based Routing

Route incoming calls differently depending on the time of day, day of week, and holidays.

Requirements

• Defined business hours
• Separate contexts for open/closed/holiday handling

Dialplan

[incoming]
exten => s,1,Answer()
 same => n,GotoIfTime(*,*,25,dec?holiday,s,1)
 same => n,GotoIfTime(*,*,1,jan?holiday,s,1)
 same => n,GotoIfTime(09:00-17:00,mon-fri,*,*?open,s,1)
 same => n,Goto(closed,s,1)

[open]
exten => s,1,NoOp(Business hours -- route to queue)
 same => n,Goto(main-queue,s,1)

[closed]
exten => s,1,NoOp(After hours)
 same => n,Playback(custom/after-hours)
 same => n,Goto(voicemail-main,s,1)

[holiday]
exten => s,1,NoOp(Holiday greeting)
 same => n,Playback(custom/holiday-greeting)
 same => n,Goto(voicemail-main,s,1)

How it works

1. GotoIfTime(time,dow,dom,month?context,ext,pri): Evaluates the current time against the given pattern. If it matches, execution jumps to the specified destination.
2. Pattern fields: The four fields are: time range, day-of-week, day-of-month, and month. Use * as a wildcard for any field.
3. Evaluation order matters: Asterisk evaluates GotoIfTime top to bottom. Place more specific rules (holidays) before general ones so they are evaluated first.
4. Fallthrough: If no GotoIfTime matches, execution continues to the next priority, which is the Goto(closed,...) fallback.

Tips

• For dynamic holidays, store dates in AstDB and check with GotoIf($[${DB_EXISTS(holidays/${date})}]?holiday,s,1).
• Use IFTIME in IF() expressions for more complex conditional logic.
• Set the system timezone in /etc/asterisk/asterisk.conf under [options] with defaultlanguage and ensure your OS timezone is correct.