What the NVA_recording AGI does for non-screen agents

The NVA_recording AGI (Asterisk Gateway Interface) script gives Call recording and call-logging to agents who never touch the VICIdial agent browser screen. If someone on your team dials from a desk phone, a third-party softphone, or any non-VICIdial interface, this script is what captures the call and optionally logs it to the database.

Where it fits in the dialplan

You wire agi-NVA_recording.agi into your Dialplan as the first step in a custom extension or a Call Menu. The AGI runs before the call is passed along to its destination. A minimal example that records audio and logs to user_call_log:

exten => _X.,1,AGI(agi-NVA_recording.agi,BOTH------Y---N---Y---N)

Parameters are separated by three dashes. The first value sets logging output to BOTH (log file and STDERR), position 3 enables user_call_log, position 5 enables audio recording. Position 4 enables call_log logging — the comment in the AGI is clear: only enable this for inbound and intersystem calls.

The 16 parameters

1. Logging output: NONE, STDERR, FILE, or BOTH
2. VICIdial user ID — if empty, defaults to the accountcode or the vicidial_live_agents user who launched the call
3. Log in user_call_log (Y/N)
4. Log in call_log (Y/N) — inbound and intersystem calls only
5. Audio record this call (Y/N)
6. Double-log in call_log (Y/N) — inbound Call Menu forwarded calls only
7. Play the recording ID before recording starts (Y/N)
8. Include the recording ID in the filename (Y/N)
9. Search vicidial_list for the phone number dialed (Y/N)
10. If 9 is Y: search method — ALLLISTS or PHONE
11. Error out and end call if phone number not found (Y/N)
12. Run the phone entry's NVA Call URL (Y/N)
13. If number not found, insert lead into the phone's NVA List ID (Y/N)
14. Override the NVA List ID with a specific list ID
15. Override the phone's NVA Phone Code
16. Override the phone's NVA Status when the lead is inserted

Common configurations

flowchart LR
  A[Non-screen agent dials] --> B[NVA_recording AGI runs]
  B --> C{Audio record enabled?}
  C -->|Y| D[MixMonitor starts recording]
  C -->|N| E[Log only no audio]
  B --> F{Search vicidial_list?}
  F -->|Y found| G[Run NVA Call URL]
  F -->|Y not found| H[Insert lead into NVA list]
  F -->|N| I[Skip lookup]

For a Call Menu prompt that records and announces the recording ID: agi-NVA_recording.agi,BOTH------Y---N---Y---N---Y---Y. For a custom dialplan entry that also searches for the phone number, runs the NVA Call URL, and errors if not found: add Y---ALLLISTS---Y---Y at the end.

**Heads up:** Parameter 4 (call_log) and parameter 6 (double-log call_log) carry explicit warnings in the AGI source. Enable them only for the exact call types noted — enabling them on standard outbound calls creates duplicate log rows.

For the broader recording picture, start with VICIdial call recording explained. To see all three recording AGIs side by side, check the recording AGIs overview.

VICIfast handles dialplan configuration as part of setup. See VICIfast pricing and let us take care of the wiring.