How to purge old scheduled callbacks

Over months of dialing, scheduled callbacks accumulate. Some were called and never closed out, some were set for dates that came and went, and some belong to agents who are long gone. A pile of dead callbacks clutters the listings and makes it harder to see the ones that still matter. VICIdial gives administrators a way to purge old Scheduled callback records so the callback area stays useful.

The purge links in admin

The simplest path is built into the admin screens. At the bottom of the callback screens you will find purge links that administrators can use to remove old callbacks directly. There are also callback management utilities available to level 9 managers inside the Admin Utilities section, which give more control than the inline links.

flowchart TD
  A[Old callbacks pile up] --> B{How to clear?}
  B -->|Quick| C[Use admin purge links]
  B -->|More control| D[Admin Utilities level 9]
  B -->|Automatic| E[AST_DB_dead_cb_purge script]
  C --> F[Old records removed]
  D --> F
  E --> G[Optional: drop duplicates per lead]
  G --> F

The dead-callback purge script

VICIdial also ships a maintenance script, AST_DB_dead_cb_purge.pl, that handles dead callbacks. An option can be added to it to remove duplicate callback entries for a single Lead, keeping only the newest one. That is handy when an agent set several callbacks on the same lead and you only care about the latest. Turning that option on is an administrator change, so if you want it you will need someone with shell access to the box to set it up rather than doing it from the admin interface.

Purge with care

Before you purge, remember that a callback points at a real Lead with a history. Purging the callback clears the reminder, not the lead, but you do not want to wipe callbacks an Agent is still actively working. A good habit is to view the listing first, by user or campaign, and confirm what is actually stale before removing anything. If you are not sure how to read the listing, dispositioning a call as CALLBK explains how callbacks get created in the first place, and the scheduled callbacks overview covers their full life cycle.

Purging is not reversible from the admin, so when in doubt, narrow your scope: clear one departed agent's callbacks or one retired list rather than sweeping everything at once.

How often should you do this? There is no single right answer, but a monthly or quarterly pass works for most teams. Tie it to your list lifecycle: when you retire a batch of leads, purge the callbacks that came from it in the same sitting. The same goes for off-boarding — when an agent leaves, deal with their callbacks then rather than letting them accumulate as dead weight. A small, regular cleanup is far less risky than one giant purge a year later, when you can no longer remember which callbacks were real.

Maintenance without the babysitting

Keeping callbacks tidy is part of running a healthy dialer, and the tools to do it are standard VICIdial. On a managed box the admin and scripts are already in place, provisioned in under 40 seconds, so you can focus on cleanup rather than setup. See VICIfast pricing to get started.