What the Bulk Phone Insert Page Does in VICIdial

Adding phones one at a time is fine for a handful of seats. For a real call center it is hours of clicking, and one mistyped value repeated across fifty entries. The Bulk Phone Insert page creates phone entries in bulk across one or more servers, optionally wiring up aliases at the same time. It is powerful and unforgiving: there is no undo button, so understanding each field before you submit really matters.

The fields, one by one

• Servers - the IP addresses of existing, active servers you want the phones created on. They must be valid, live IPs, one per line.
• Phones - the Extension list. Letters and numbers only, no special characters, one per line.
• Registration Password - the SIP or IAX2 secret each phone registers with. Use a complex value for security.
• Login Password - the agent-screen login password, separate from the registration secret above.
• Create Alias Entries - set YES to tie same-numbered extensions across servers together for phone-login load balancing.
• Alias Suffix - the suffix appended to an extension to form its alias id, so cc100 with suffix x becomes cc100x.
• Client Protocol - SIP, PJSIP, or IAX2. These are VOIP protocols that write conf file entries so the phones can register.
• Local GMT, Phone Context, Template ID, and the webphone options round out the per-phone defaults applied to the whole batch.

Two passwords, two jobs

The two password fields trip people up more than anything else on this page. The Registration Password is the SIP (Session Initiation Protocol) or IAX2 secret a phone uses to register with Asterisk; the Login Password is what the Agent types on the agent screen. They are independent - one secures the device on the network, the other secures the session in the application. Mixing them up means either the phone will not register or the agent cannot log in.

What a single insert creates

flowchart TD
  A[Servers list] --> D[Bulk Phone Insert]
  B[Extensions list] --> D
  C[Passwords + protocol] --> D
  D --> E[Phone rows per server]
  E --> F{Create Alias Entries?}
  F -->|YES| G[Alias rows with suffix]
  F -->|NO| H[No aliases]
  E --> I[Conf entries pending rebuild]

There is no undo - so test first

This is the one rule to remember: the page has no undo. Run it with two or three records first, confirm the rows look right and register, then run the real batch. Cleaning up a wrong batch of hundreds of phone rows by hand is exactly the chore this tool was meant to spare you, so the small test run is cheap insurance. Note too that submitting the form does not rebuild your Asterisk conf files automatically - you trigger that manually from System Settings or the Modify Server page once the inserts are done, or the new phones simply will not come up.

If you are populating phones across more than one box, read how to bulk-insert phone extensions across multiple servers next. This page sits among the others in our VICIdial admin bulk tools guide.

Used carefully, this page is the difference between an afternoon of manual entry and a thirty-second job that produces identical phones across your whole estate. Get the two passwords straight, pick the right protocol and context, test small, and rebuild the conf files, and the rest is just typing two lists. A managed VICIdial server gives you this page on a clean, single-tenant box from minute one, with sensible protocol and context defaults already in place. See VICIfast pricing to get started.