How to modify a VICIdial phone

Once a phone entry exists, you change it from the LIST ALL PHONES screen. That list shows every phone on the system, and each row has a MODIFY link. Click it and you land on the full edit screen for that one device, where the complete set of options is finally available.

This matters because the add form is deliberately short. When you first create a phone you only see the first 17 fields. The rest, including the webphone behavior options and several smaller settings, do not appear until the record is saved and reopened through MODIFY. So if you went looking for a setting during creation and could not find it, this is where it lives.

Getting to the modify screen

Go to ADMIN, then PHONES, then LIST ALL PHONES. Find the device you want, click MODIFY on its row, and the edit screen opens with every field populated from the current record. From here you can change anything: the passwords, the server, the caller ID, the status, the webphone toggles, and the rest.

flowchart TD
  A[ADMIN then PHONES] --> B[LIST ALL PHONES]
  B --> C[Find the device row]
  C --> D[Click MODIFY]
  D --> E[Full field set opens]
  E --> F[Edit any field]
  F --> G[Save changes]
  G --> H{Changed SIP or IAX secret?}
  H -->|Yes| I[Re-register the device]
  H -->|No| J[Done]

The diagram ends on the one gotcha worth remembering: if you change the registration secret on a SIP (Session Initiation Protocol) device, the device has to register again with the new value or it drops offline.

The two passwords you will edit most

Two fields look similar and behave nothing alike. The Login Password is only for logging into the web agent interface. The Registration Password is the secret the device uses for Phone registration in the auto-generated config. Changing one does nothing to the other. If an agent can log in to the web screen but the handset shows offline, you changed the wrong password.

The Registration Password accepts up to 20 characters of letters, numbers, dashes, and underscores, and its default is the word test. A strong value is at least eight characters with upper and lower case and at least one number, so change it off the default before any device goes live.

Other fields worth knowing on the modify screen

• Outbound CallerID: the number shown on outbound calls, though a campaign Call ID overrides it once the agent logs into a campaign.
• Server IP: move the phone to a different server if needed.
• Status: ACTIVE and ADMIN allow the GUI client to work; ADMIN also grants access to the admin web site. Other statuses block GUI and admin access.
• Set As Webphone and the webphone toggles: turn the browser phone on and tune its dialpad, mute, and volume controls.

If you run a Webphone, the modify screen is the only place to flip its options, since none of them show up during the initial add. And whenever you edit the outbound CID (caller ID), remember the campaign Call ID will win once an agent is dialing under a campaign.

Where to go next

For the full picture of how phones, agents, and servers connect, see the VICIdial phones guide. Because the two passwords cause so much confusion, it is worth reading login vs registration password before you touch either field.

Tired of editing config screens by hand? VICIfast gives you a hardened VICIdial server with sensible defaults in under 40 seconds. See our pricing for what each plan includes.