When you export or bulk-import extensions, Cloud Voice stores each extension as one row in a CSV (comma-separated values) file. This page describes every column in that file: what it holds, whether it is required, the values it accepts, and the value applied when you leave it blank on import.
User’s first name; up to 63 characters. At least one of First Name or Last Name must be supplied. If both are blank, First Name is set to the Extension Number.
Extension Number
Last Name
One name required
User’s last name; up to 63 characters. At least one of First Name or Last Name must be supplied.
None
Email Address
Optional
User’s email address; up to 255 characters and unique across all extensions. Use only letters, numbers, and the characters @_-.'; it must start with a letter, number, or _ and follow the form XXX@XXX.XX.
None
Mobile Number
Optional
User’s mobile number; up to 31 characters. Letters, numbers, and the characters ().-+*# are allowed.
Password for signing in to the Cloud Voice App and the management portal. Must combine uppercase letters, lowercase letters, and numbers. Cannot contain four consecutive digits, four identical digits, the extension number, the first name, or the last name.
Auto-generated
User Role
Required
Management role granted to the user. Enter 0 for no role, or the name of a role defined in the system.
0 (None)
Organization
Optional
Organization the user belongs to. Enter the full path from the root organization, joined with /; separate multiple organizations with &. See the examples below.
Root organization (your Company Name)
System Prompt Language
Optional
Language of the system prompts the user hears during calls. Enter follow_system or the name of a prompt language installed on the system (for example, German). If the language you enter is not installed, follow_system is used.
follow_system
Email Language
Optional
Language of the email notifications sent to the user. Enter follow_system or the name of an installed email language (for example, German). If the language is not installed, follow_system is used.
Write the value as the full path from the root organization down, separating each level with a forward slash (/). To place the user in more than one organization, list each full path and join them with an ampersand (&).
Suppose your root organization is named Acme:
To place the user in the root organization, enter Acme.
To place them in a first-level organization named “Marketing Center”, enter Acme/Marketing Center.
To place them in a second-level organization named “Support Team” beneath Marketing Center, enter Acme/Marketing Center/Support Team.
To place them in two organizations at once, enter Acme/Marketing Center&Acme/Product Management Center.
The extension’s number. Digits only, up to 11 characters, and unique across the system.
None
Caller ID
Required
Caller ID shown on the called party’s device. Letters, numbers, and the characters ().-+*# are allowed, up to 31 characters. If blank, the Extension Number is used.
Extension Number
Emergency Outbound Caller ID
Optional
Caller ID presented when the extension places an emergency call. Same character rules as Caller ID, up to 31 characters.
None
Registration Name
Required
Name used to authenticate SIP (Session Initiation Protocol, the signaling that registers and connects phones) registration; up to 63 characters.
Auto-generated
Registration Password
Required
Password used to register the SIP extension. Must combine uppercase, lowercase, and numbers, and cannot contain four consecutive digits, four identical digits, the extension number, the first name, or the last name.
Auto-generated
IP Phone Concurrent Registrations
Required
Number of SIP phones that may register to the extension at the same time. Enter 1, 2, 3, 4, or 5.
1
Cloud Voice App (Web) Concurrent Registrations
Required
Number of web sessions of the Cloud Voice App that may be signed in at once. Enter 1, 2, or 3.
Require a PIN to open the mailbox. 0 = off, 1 = on.
1
Voicemail Access PIN
Required when Enable Voicemail = 1 and Voicemail PIN Authentication = 1
PIN for opening the mailbox. Digits only, 3 to 15 characters.
Auto-generated
Voicemail Language
Optional
Language of the prompts a caller hears when leaving a voicemail. Enter follow_system or an installed prompt language (for example, German); if it is not installed, follow_system is used.
follow_system
New Voicemail Notification
Required when Enable Voicemail = 1
How the user is emailed about new voicemail. no = no email; with_attach = email with the recording attached; without_attach = email without the recording. If this column or Email Address is blank, no is used.
no
Send to
Required when Enable Voicemail = 1 and New Voicemail Notification = with_attach or without_attach
Where notification emails are sent. user Email = the user’s own email address; custom Email = the address in Voicemail Email Address.
user Email
Voicemail Email Address
Required when Enable Voicemail = 1, New Voicemail Notification = with_attach or without_attach, and Send to = custom Email
Custom address for voicemail notifications. Up to 255 characters, using letters, numbers, and the characters @_-.; must start with a letter, number, or _ and follow the form XXX@XXX.XX.
None
After Notification
Required when Enable Voicemail = 1 and New Voicemail Notification = with_attach or without_attach
What to do with the mailbox copy once the notification is sent. no = leave it; mark_read = mark it read; delete = delete it. delete is available only when New Voicemail Notification = with_attach.
no
Play Date and Time
Required when Enable Voicemail = 1
Announce when the message was left before playing it. 0 = off, 1 = on.
0
Time Display Format
Required when Play Date and Time = 1
Clock format for the announced time. Follow System, 12-hour format, or 24-hour format.
Follow System
Play Caller ID
Required when Enable Voicemail = 1
Announce the caller’s ID before playing the message. 0 = off, 1 = on.
0
Play Message Duration
Required when Enable Voicemail = 1
Announce the message length in minutes before playing it. 0 = off, 1 = on.
How DTMF (dual-tone multi-frequency, the tones a phone sends when its keypad keys are pressed) tones are sent. rfc4733, info, inband, or auto.
rfc4733
Transport
Required
Transport protocol(s) for the extension. One or more of udp, tcp, tls.
udp
Qualify
Required
Periodically send a SIP OPTIONS packet to check that the device is reachable. 0 = off, 1 = on.
1
T.38 Support
Required
Support T.38 fax on this extension. 0 = off, 1 = on.
0
SRTP
Required
Encrypt the call’s media (audio and video) stream. SRTP stands for Secure RTP (Real-time Transport Protocol), the protocol that carries the media. 0 = off, 1 = on.
Block the user from placing outbound calls. 0 = off, 1 = on.
0
Disable Outbound Calls outside Business Hours
Required
Block outbound calls outside business hours. 0 = off, 1 = on.
0
Disallow International Calls
Required
Block international calls. 0 = off, 1 = on.
1
Outbound Route Permission
Optional
Outbound routes this extension may use. Enter existing outbound route names, separated by & (for example, {name1}&{name2}). Names that do not exist are skipped.
None
Max Outbound Call Duration (s)
Required
Longest outbound call, in seconds. Digits only, up to 7 characters. -1 follows the system setting; 0 means unlimited.
-1
Outbound Call Frequency Restriction
Optional
Frequency-limit rule(s) applied to the extension’s outbound calls. Enter existing rule names, separated by &. Names that do not exist are skipped.
Each setting below exists three times in the CSV, once for mobile, once for desktop, and once for web. The platform appears in the column name, for example Call Waiting (Mobile), Call Waiting (Desktop), and Call Waiting (Web). The requirement, accepted values, and defaults are the same on every platform.
Setting
Required
Format and rules
Default
Call Waiting
Optional
Allow a second call while the user is already on a call. 0 = off, 1 = on.
