Skip to content

Use the Bulk Handler

Bulk Handler imports/exports CSV for Extensions, Voicemail, DIDs (inbound routes), Outbound Routes, and User Management — saves hours when adding many at once.

Before You Start

  • A backup. Bulk imports can wreck a system if the CSV is malformed.
  • A small test CSV (1-2 rows) ready to validate before bulk-loading the real one.

Workflow: Export → Edit → Import

The safest approach is always:

  1. Export current data — gives you a perfectly formatted CSV with all column headers.
  2. Edit in Excel/Google Sheets.
  3. Import.

Don't try to build a CSV from scratch — column requirements vary by version.

Steps

Export

  1. Go to System Admin → Bulk Handler.
  2. Pick the tab matching what you're bulk-editing: Extensions, DIDs, Outbound Routes, Voicemail, Users.
  3. Click Export. Download the CSV.

Edit

  1. Open in a spreadsheet.
  2. Add/modify rows. Don't add/rename columns.
  3. Save as CSV (UTF-8, no BOM if the import is picky).

Import

  1. Same tab as export.
  2. Click Import → choose the file.
  3. Replace existing data? — No for additive (most common). Yes wipes the section before importing — DANGEROUS.
  4. Click Import.
  5. Watch for the success/failure summary.
  6. Click Apply Config.

Common Tasks

Add 50 extensions

Export, copy the row template, paste 50 rows below. Update extension number, name, secret, email per row. Import additive.

Bulk-update voicemail emails

Export Voicemail tab. Update the email column. Import additive (will update matching mailboxes).

Bulk-import DIDs

See Bulk-Add DIDs.

Bulk-create User Management entries

Export Users tab. Add rows. Import. Then manually link extensions if not in the CSV.

Verify

After import, spot-check a few rows in the actual modules — Extensions, DIDs, etc. Confirm display name, voicemail, etc. is right.

Common Issues

  • CSV import errors out at row N. Open the CSV, look at row N+1 (CSV is 0-indexed often). A column has invalid data — extension already exists, missing required field, malformed value.
  • Import succeeds but data missing. Required columns blank or in wrong format. Re-check the export template carefully.
  • Special characters mangled. Excel encoding. Save as CSV UTF-8 (Mac/Excel may default to Mac Roman).
  • All extensions get the same secret. Bulk Handler doesn't auto-generate secrets — you provided the same value (or blank). Generate strong random secrets in the spreadsheet before importing.