VICIdial Timezone Filtering: Complete Optimization Guide

Quick Reference

Setting Name

timezone_filtering

Default Value

N

Recommended

Y with AREACODE for TCPA compliance

Impact Level

High

Location in VICIdial

Admin > Campaigns > [Campaign] > Timezone Settings

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.

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

  1. 1 Navigate to Admin > Campaigns
  2. 2 Select campaign
  3. 3 Enable Timezone Filtering option
  4. 4 Select detection method: AREACODE (recommended), STATE, or CUSTOM
  5. 5 Set allowed calling hours start and end times
  6. 6 Configure timezone handling for leads with no detectable zone
  7. 7 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

daily_call_limit Daily Call Limit Campaign dial_status_filter Dial Status Filter Campaign lead_filter Lead Filter Campaign

ViciStack Module

How ViciStack Optimizes Timezone Filtering

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.

Learn About List Management & Optimization →

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.

Not sure if your VICIdial settings are optimized? Get a free 247-point audit.

Get Your Free VICIdial Audit →