How to connect a Grandstream phone to VICIdial

Grandstream makes both desk handsets and ATA boxes that speak SIP (Session Initiation Protocol), the protocol VICIdial phones use to register and place calls. Whether you have a Grandstream Hardphone (deskphone) or an adapter, the path is the same: create the phone entry in VICIdial, then enter three values on the device.

Create the phone entry

Add a new phone in the admin pages with a protocol of SIP or PJSIP. SIP phones have their Asterisk settings generated automatically within about a minute of saving the form, so you never edit a config file by hand. Write down the Server IP, the phone Extension, and the Registration Password, because those are the three the Grandstream needs.

Configure the Grandstream account

Grandstream devices are set up through their web interface. Browse to the phone's IP address, log into the admin page, and open one of the account or SIP account tabs. The fields you care about are:

• SIP Server — the Server IP of the VICIdial server the phone is active on.
• SIP User ID and Authenticate ID — the phone extension, for example test101, with no protocol prefix.
• Authenticate Password — the Registration Password from the phone record. This is the device secret, distinct from the Login Password used for the web agent screen.

The Registration Password defaults to the word test on a fresh phone entry. Set it to a stronger value, at least eight characters with mixed case and a number, before the device handles real calls. Confusing it with the Login Password is the classic reason a Grandstream sits unregistered. The two passwords sit side by side on the same record, so it is an easy slip, but the device only ever cares about the Registration one.

Grandstream firmware often separates a SIP User ID from an Authenticate ID. On a standard VICIdial phone both take the same value, the plain extension with no protocol prefix. Filling them in consistently avoids a mismatch where the phone tries to register as one name but authenticates as another, which the server will simply reject.

Save and confirm registration

Apply and reboot if the device asks, then check the account status. A registered Grandstream marks the account as registered in its status view or lights the line key for that extension. Menu wording differs across Grandstream models and firmware, so go by the labels you actually see rather than a screenshot from another model. A successful registration means the phone now shows up in the active list on the VICIdial side, ready for an agent to use.

flowchart LR
  A[Add SIP phone in VICIdial] --> B[Account auto-built in Asterisk]
  B --> C[Open Grandstream web admin]
  C --> D[Set SIP Server to Server IP]
  D --> E[Set User ID to extension]
  E --> F[Set Authenticate Password to Registration Password]
  F --> G[Apply and reboot]
  G --> H[Account shows registered]

Common snags

If it will not register, confirm the Authenticate Password matches the Registration Password exactly, that the Server IP is the active server, and that the phone saved as a SIP protocol. The VICIdial phones pillar guide maps every field, and the login vs registration password explainer untangles the two passwords for good.

Looking for a managed VICIdial box that just works with your Grandstream phones? See VICIfast pricing and get a dialer running in under 40 seconds.