TCPA compliance (Blacklist Alliance)

VICIfast scrubs every outbound dial against Blacklist Alliance before VICIdial places the call. You bring the BLA API key; the audit trail and the billing live in your BLA account.

Setting it up

1. Get an API key from blacklistalliance.com.

2. Dashboard → your server → TCPA Compliance (BLA).

3. Paste the key, pick a default failure mode (Allow or Block).

4. The default applies to every trunk in Inherit mode.

Per-trunk overrides

Different clients can have different compliance contracts. Override per trunk: set the trunk's TCPA mode to Custom with its own key + failure mode, or to Disabled entirely (the trunk skips the check).

Performance

BLA lookups are cached in Redis for 6 hours per (server, number) tuple. Repeat dials of the same number return in <5ms. The cache key includes a hash of your sealed API key, so rotating the key automatically invalidates the cache.

Audit log

Every BLA check writes to AuditLog with the dialed number, the trunk, the result (allow / block / cached / failed), and the timestamp. Export from /admin/audit-log.