Quick Reference
timezone_filtering
What Timezone Filtering Does
Enables automatic filtering of leads based on local time zone to ensure calls only reach contacts during allowed calling hours (typically 8am-9pm local time per TCPA). Options include state-based, area-code-based, and lead-field-based timezone detection.
Recommended Configuration
| Center Size | Recommended Value | Notes |
| --- | --- | --- |
| 10–25 Agents | Y with AREACODE for TCPA compliance | Start conservative, monitor for 48 hours before adjusting |
| 25–100 Agents | Y with AREACODE for TCPA compliance | Scale gradually — larger operations amplify effects of misconfiguration |
| 100–500 Agents | Y with AREACODE for TCPA compliance | Consult ViciStack optimization team for enterprise-scale tuning |
How to Change This Setting
-
Navigate to Admin > Campaigns
-
Select campaign
-
Enable Timezone Filtering option
-
Select detection method: AREACODE (recommended), STATE, or CUSTOM
-
Set allowed calling hours start and end times
-
Configure timezone handling for leads with no detectable zone
-
Submit
Common Problems
Disabled timezone filtering causes TCPA violations from early morning or late night calls
AREACODE detection fails on VoIP numbers with non-local area codes
Leads with international numbers may get wrong timezone assignment
ViciStack Module
ViciStack’s List Management & Optimization module automatically monitors and optimizes timezone_filtering based on real-time performance data from your operation. Instead of manual tuning, ViciStack continuously analyzes call outcomes, agent performance, and contact rates to recommend and implement optimal values — often catching configuration drift before it affects your numbers.
Frequently Asked Questions
What does timezone_filtering do in VICIdial? +
Enables automatic filtering of leads based on local time zone to ensure calls only reach contacts during allowed calling hours (typically 8am-9pm local time per TCPA). Options include state-based, area-code-based, and lead-field-based timezone detection.
What is the recommended value for timezone_filtering? +
The recommended range for timezone_filtering is Y with AREACODE for TCPA compliance. The out-of-box default is N. Note that optimal values vary by operation size, campaign type, and carrier — use ViciStack's automated tuning to find your exact optimal configuration.
Can ViciStack automatically optimize timezone_filtering for me? +
Yes. ViciStack's List Management & Optimization module monitors timezone_filtering continuously and alerts you when the value drifts outside optimal range. On qualifying plans, ViciStack can automatically adjust this setting based on real-time performance data — no manual intervention required.
Need Help Optimizing Your VICIdial?
Get a free performance audit from our team of VICIdial experts. We'll identify quick wins and long-term improvements.
Get Your Free Audit →