Time Groups.md - edlentz/Nimbus GitHub Wiki

In Nimbus Voice (FreePBX-based), Time Groups are the building blocks for Time Conditions. They define specific time ranges β€” such as business hours, lunch breaks, weekends, or holidays β€” that can then be referenced in Time Conditions to route calls accordingly.

Think of a Time Group as a schedule that tells the system when something should happen.


🧱 What Is a Time Group?

A Time Group is a reusable set of time rules that can be applied in:

  • Time Conditions

  • Call Flow Controls

  • Inbound Routing

A Time Condition uses a Time Group to determine whether to route a call to Destination A (if the time matches) or Destination B (if it doesn’t).


πŸ› οΈ How to Create a Time Group in Nimbus Voice

  1. Go to Applications β†’ Time Groups

  2. Click β€œAdd Time Group”


πŸ“‹ Time Group Configuration Fields

Field | Description -- | -- Description | A name for the time group (e.g., Business Hours, Holiday Schedule). Time Ranges | Define one or more conditions based on: β†’ Time Range | Start and end times (e.g., 09:00 - 17:00) β†’ Days of the Week | Select specific days (e.g., Monday to Friday) β†’ Days of the Month | Optional (e.g., 25 for Christmas) β†’ Months | Optional (e.g., December only) β†’ Years | Optional (rarely used unless planning far ahead)

This makes it easy to reuse a "Holiday" group in multiple Time Conditions across your system.


πŸ”„ Time Group Matching Logic

  • If any one of the conditions in a Time Group matches the current time, the Time Condition is considered matched.

  • If none match, it defaults to the no-match destination in the Time Condition.


πŸ” Tips and Best Practices

  • Use clear, descriptive names: Support Hours, Lunch Break, Holidays.

  • Group multiple dates (e.g., holidays) in one Time Group for simpler management.

  • Use Time Conditions to act on the logic β€” Time Groups only define the time ranges.

  • Combine Time Groups + Overrides (Feature Codes) for manual holiday or emergency control.


🧭 Use Time Groups In:

  • Time Conditions (main use case)

  • Call Flow Control

  • Inbound Route scheduling

  • IVR redirection based on schedule

image

⚠️ **GitHub.com Fallback** ⚠️