How to register Zoiper to a VICIdial phone

Zoiper is a popular Softphone, a phone that runs as an app on a computer or mobile device instead of a desk handset. To make it ring through VICIdial, you create a phone entry on the VICIdial side first, then feed three of its values into Zoiper. Get those three right and registration is almost automatic.

Create the phone entry first

Before opening Zoiper, add a phone in the admin pages with a protocol of SIP. A SIP (Session Initiation Protocol) phone has its Asterisk account created for it within about a minute of saving the form, so the account Zoiper is reaching for will exist by the time you switch apps.

The three values Zoiper needs

Zoiper asks for a host, a username, and a password. Map them to VICIdial like this:

• Host / Domain — the Server IP of the server the phone is active on.
• Username / Account — the phone Extension, which is the device name without the protocol prefix. For SIP/test101 you enter test101.
• Password — the Registration Password from the phone record. This is the device secret, not the Login Password. Its default is the word test, so change it to something at least eight characters with mixed case and a number.

Mixing up the two passwords is the single most common reason Zoiper refuses to register. The Login Password logs a user into the web agent screen and never reaches the device. The Registration Password is what the device itself authenticates with, and it lives in the auto-generated config the system writes for the phone. Zoiper wants the second one. If you only remember one rule from here, make it that one: the app authenticates with the Registration Password.

It also helps to know that the extension you type is the device name as the server already knows it, with no slash and no protocol in front. The form on the VICIdial side keeps these clean for SIP entries, which is why the username you give Zoiper is something short like test101 rather than the full SIP/test101 string.

Add the account in Zoiper

1. Open Zoiper and choose to add a new SIP account.
2. Enter the username, password, and host using the three values above.
3. Let Zoiper auto-detect transport, then save and let it register.

Exact menu wording shifts between Zoiper versions, so follow the on-screen labels rather than a fixed path. Some builds offer a single combined field for the SIP domain and outbound proxy, while others split them. When in doubt, put the Server IP in the host or domain field and leave the proxy blank. When the account turns green, the device has registered and the phone is ready in the active list, which means an agent can now use it on a campaign.

sequenceDiagram
  participant Z as Zoiper
  participant V as VICIdial Server
  Z->>V: REGISTER extension and Registration Password
  V->>V: Match SIP account in config
  V-->>Z: 200 OK registered
  Z->>V: Ready for inbound and outbound calls

If it will not register

Recheck the password field, confirm the Server IP is the active server, and make sure the phone record actually saved with a SIP protocol. The VICIdial phones pillar guide has the full field map, and the add-a-new-phone walkthrough covers the VICIdial side that Zoiper is reaching for.

Prefer a server that is already tuned for VICIdial out of the box? See VICIfast plans and skip the setup entirely.