AMDelete documentation
Everything you need to run AMDelete on VICIdial: install, configure campaigns, read results and operate safely.
Install on VICIdial
Requirements, the one-line installer, self-tests and turning campaigns on.
How decisions are made
Routes, the listening window and what reaches your agents.
Security & data
What leaves your dialer, what we store and how keys work.
Outcomes and VICIdial statuses
| Status | Meaning | Goes to agent |
|---|---|---|
ADMAC | Machine (generic) | No |
ADVM | Voicemail greeting | No |
ADBP | Voicemail beep | No |
ADFX | Fax or modem tone | No |
ADRG | Ringing after answer | No |
ADSI | Silence or dead air | Yes |
ADTO | Timeout (listening window ended) | Yes |
ADER | Service error | Yes |
ADUN | Unresolved | Yes |
Fallback reasons
When the adapter hands a call to your dialer's locally configured fallback route it records why. If you have not defined an override, that route defaults to VICIdial AMD. You will see the reason in your console's analytics and in /var/log/asterisk/amdelete-decisions.jsonl on the dialer.
| Reason | What to do |
|---|---|
credits_exhausted | Add credits. Calls resume on AMDelete within a minute. |
account_suspended | Your account is paused. Check your email or contact support. |
authentication_refused | The installation's key was revoked or expired. Re-enroll the dialer from the console. |
service_unavailable | The service didn't answer in time. Check the dialer's network path to api.amdelete.com. |
model_policy_unserved | The dialer is pinned to a model we no longer serve. Run amdelete-ctl update. |
rate_limited | More new calls per minute than your account allows. Contact support to raise it. |
Command reference
| Command | Does |
|---|---|
amdelete-ctl preflight | Read-only system check |
amdelete-ctl status | Installed files, routes, AstDB switches, service reachability |
amdelete-ctl selftest | Synthetic call through the real dialplan (unbilled) |
amdelete-ctl check-campaign ID | Shows what a campaign needs to use AMDelete |
amdelete-ctl configure-vicidial --campaign ID | Adds AMDelete statuses and the status map for a campaign |
amdelete-ctl kill / resume | All calls to the dialer's local fallback now / undo |
amdelete-ctl update | Install the latest signed release |
amdelete-ctl rollback / uninstall | Restore the files AMDelete replaced / remove it |