Cloudpbx Admin Guide en PDF
Cloudpbx Admin Guide en PDF
Cloudpbx Admin Guide en PDF
Admin Guide
Yeastar Cloud PBX
Version: 81.13.0.15
Date: 2020-03-10
Contents
Admin Guide........................................................................................................................ 5
Extensions........................................................................................................................5
Extension Overview..................................................................................................5
Extension Basic Setup............................................................................................. 6
Extension Groups................................................................................................... 15
Presence.................................................................................................................17
Voicemail.................................................................................................................20
Call Monitoring........................................................................................................29
Call Permission.......................................................................................................31
Extension Settings..................................................................................................32
Contacts......................................................................................................................... 39
Contacts Overview................................................................................................. 39
Manage Company Contacts...................................................................................41
Manage Personal Contacts....................................................................................43
Configure Company Contacts Permissions for Users............................................46
Identify Callers from Contacts................................................................................47
Contacts FAQ......................................................................................................... 48
Trunks............................................................................................................................ 50
Trunk Overview...................................................................................................... 50
VoIP Trunks............................................................................................................ 50
WebRTC Trunks..................................................................................................... 64
Call Control.................................................................................................................... 69
Emergency Numbers..............................................................................................69
Time Conditions......................................................................................................70
Inbound Routes...................................................................................................... 81
Outbound Routes................................................................................................... 99
Outbound Restriction............................................................................................106
Contents | iii
AutoCLIP Routes..................................................................................................108
SLA Stations.........................................................................................................111
Call Features............................................................................................................... 117
IVR........................................................................................................................ 118
Ring Group........................................................................................................... 122
Queue................................................................................................................... 122
Conference........................................................................................................... 128
Call Pickup............................................................................................................130
Call Transfer......................................................................................................... 134
Callback................................................................................................................ 135
Speed Dial............................................................................................................ 136
DISA......................................................................................................................137
Intercom/Paging....................................................................................................138
Call Parking.......................................................................................................... 143
Fax........................................................................................................................ 146
PIN List................................................................................................................. 151
Blacklist/Whitelist.................................................................................................. 153
Call Recording............................................................................................................. 157
Call Recording Overview......................................................................................157
One Touch Record............................................................................................... 157
Auto Recording.....................................................................................................158
Voice Prompts..............................................................................................................166
System Prompt..................................................................................................... 166
Music on Hold (MoH)........................................................................................... 169
Custom Prompt.....................................................................................................171
Set Prompts for Failed Calls................................................................................ 176
System Management...................................................................................................177
System General Settings..................................................................................... 177
Security................................................................................................................. 184
User Permission................................................................................................... 185
Date and Time......................................................................................................186
Email..................................................................................................................... 187
Contents | iv
Auto Cleanup........................................................................................................188
Event Center.........................................................................................................189
Remote Management........................................................................................... 191
API........................................................................................................................ 192
Maintenance.................................................................................................................192
Upgrade Firmware................................................................................................192
Backup and Restore.............................................................................................194
Reboot the PBX................................................................................................... 196
Reset the PBX......................................................................................................197
System Log...........................................................................................................197
Operation Log.......................................................................................................198
Troubleshooting.................................................................................................... 199
PBX Monitor.................................................................................................................203
Resource Monitor........................................................................................................ 204
CDR and Recordings.................................................................................................. 205
Search CDR and Recordings...............................................................................206
Fuzzy Search CDR and Recordings....................................................................207
Download CDR and Recordings.......................................................................... 207
Admin Guide
Admin Guide for Yeastar Cloud PBX.
Audience
This guide is for administrators who need to prepare for, configure and operate Yeastar
Cloud PBX.
Extensions
Extension Overview
An extension is a short internal number. Extensions allow users to make and receive calls.
You can assign extensions to every employee in your organization.
Extension types
SIP Extension
To use a SIP extension, you need to enter the extension credentials on an IP phone or a
softphone. After the extension is registered on a phone, you can make and receive calls.
Extension format
Yeastar Cloud PBX supports 1-digit to 7-digit extension format. The default extension format
is 4-digit number.
Before you create extensions, you can go to Settings > PBX > General > Preferences >
Extension Preferences > User Extension to change the extension format and range.
Admin Guide | 1 - Admin Guide | 6
SIP Forking
Yeastar Cloud PBX supports SIP forking, which enables an extension number to be
registered by multiple SIP phones. When a call reaches the extension, all registered phones
will ring simultaneously, and you can take the call from any device easily.
You can configure SIP Forking on the extension configuration page. The value of
Concurrent Registrations limits how many SIP phones the extension can be registered
on.
Note:
Create an Extension
Before registering a SIP account on phones, you need to create a SIP account.
2. On the Basic page, go to General section, and set the general settings of the
extension.
Admin Guide | 1 - Admin Guide | 7
3. On the Basic page, go to User Information section, and set the user information.
• Email: Extension user can reset his/her login password, receive voice mails, faxes,
or PBX notifications via this email address.
• User Password: The password is used to log in the PBX or log in Linkus mobile
client. The password is generated randomly by default.
• Prompt Language: The default prompt language is the same as the system
language. If the extension user speaks foreign language, you can set a specific
system prompt.
Note: Before selecting other system prompts, go to Settings > PBX > Voice
Prompts > System Prompt to download online prompts.
• Mobile Number: Extension user can receive the PBX notifications or forwarded
calls on this mobile number.
2. On the Basic page, go to General section, and configure the following settings:
Note:
• Start Extension: Enter the first extension number. The system will create
extensions in bulk starting with the extension number.
• Create Number: Enter the number of extensions that will be created.
• Concurrent Registrations: Yeastar Cloud PBX supports to register one extension
number on multiple phones. When a call reaches the extension number, all phones
will ring.
• Prompt Language: The language of voice prompts. The default prompt language
is the same as the system language. If the extension user speaks foreign
language, you can set a specific system prompt.
Note: Before selecting other system prompts, go to Settings > PBX > Voice
Prompts > System Prompt to download online prompts.
Related tasks
Bulk Edit Extension Names and Emails
Related information
Register a SIP Extension
Admin Guide | 1 - Admin Guide | 9
Register Extensions
For most SIP phones, the following items are needed for the SIP phone to register with
Yeastar Cloud PBX.
◦ Extension Number
◦ Registration Name
◦ Registration Password
◦ Caller ID Name
◦ Transport
Log in the phone web interface, fill in and save the required items to register the SIP
extension.
• On the phone web interface, check if the status indicates that the extension is
registered.
• Log in PBX web interface, go to PBX Monitor > Extensions to check if the status
shows .
Related tasks
Register Yealink Phone with Yeastar Cloud PBX
Register Htek Phone with Yeastar Cloud PBX
Register Cisco Phone with Yeastar Cloud PBX
Register Fanvil Phone with Yeastar Cloud PBX
Register Snom Phone with Yeastar Cloud PBX
Admin Guide | 1 - Admin Guide | 10
Manage Extensions
1. Log in PBX web interface, go to Settings > PBX > General > Preferences >
Extension Preferences.
2. Change the range of User Extensions.
3. Click Save and Apply.
Edit Extensions
After creating extensions, you may need to change extension settings. You can edit an
extension, or edit extensions in bulk.
Edit an Extension
1. Log in PBX web interface, go to Settings > PBX > Extensions, click Export to export
all the extensions.
2. Edit the CSV file, enter the users' names and email addresses, then save the file.
Admin Guide | 1 - Admin Guide | 11
• fullname: Enter the user's name. The fullname stands for the Caller ID Name.
• email: Enter the user's email address.
c. Click Import.
Note: You may get an error prompt like the following figure.
Note: Ignore the error if the Error Cause displays "username[1000]: The
imported record is existing, the record has been overwritten".
Delete Extensions
When an employee leaves or an extension is no longer needed, you can delete the
extension from the Yeastar Cloud PBX.
Delete an Extension
Import/Export Extensions
The extensions configured on Yeastar Cloud PBX can be exported and saved as a
template. You can fill in desired extension information and import the CSV file to PBX again.
Admin Guide | 1 - Admin Guide | 13
Export Extensions
Import Extensions
Tip: You can export extensions first, and use the CSV file as a template.
1. Log in PBX web interface, go to Settings > PBX > Extensions, click Welcome Email.
2. Select the extensions that you want to send Welcome Email to.
• To send emails to all extensions, select All Extensions.
• To send emails to specific extensions, follow the instruction.
3. Click Send.
Related tasks
Edit 'Welcome Email' Template
Admin Guide | 1 - Admin Guide | 14
1. Log in PBX web interface, go to Settings > PBX > Extensions, click Welcome Email.
Extension Groups
Create an Extension Group
You can assign and categorize extensions in different groups. Extension groups simplify the
configuration process.
1. Go to Settings > PBX > Extensions > Extension Group, click Add.
1. Go to Settings > PBX > Extensions, search and find the desired extension group,
click .
2. Edit the group as you need.
3. Click Save and Apply.
1. Go to Settings > PBX > Extensions > Extension Group, search and find the desired
extension group, click .
2. Click Yes to confirm the deletion.
For example, you need to set an outbound route and only allow the Support group members
to make outbound calls through this route. You can simply assign the Support extension
group instead of assigning an extension member one by one. It simplifies the configuration
process.
Admin Guide | 1 - Admin Guide | 17
Presence
Extension Presence Overview
This topic introduces what is presence and how the presence status can benefit the user's
work.
What is Presence
Extension Presence indicates the availability status of an extension. Presence settings are
linked to the Call Forwarding rules and Linkus ring strategy. Different call forwarding rules
and ring strategy can be set for each presence status.
Change Presence status to quickly route incoming calls. For example, if the user is at
a meeting and do not want to miss calls, set the status to Away and forward the call to
voicemail. Once the user is ready to receive calls again, switch back to Available.
• On the Linkus client, extension users can change their own presence status.
• On the Extension Web Portal, Linkus users can change their own presence status.
• On the PBX Web Portal, you can change all extensions presence.
1. Go to Settings > PBX > Extensions, search and find the desired extension, click .
2. Click the Presence tab.
3. In the Presence drop-down list, select a status to configure.
4. In the Presence Information field, enter the a custom status message to display on
Linkus.
The Linkus users can see whether you are available to communicate.
5. Set call forwarding rules for the Presence status.
a. Select the Call Forwarding conditions:
• Always: All the incoming calls will be forward to the destination.
• No Answer: Only the unanswered calls will be forwarded to the destination.
• When Busy: Only the calls that come in while you are talking on the phone
will be forwarded.
b. Beside the selected forwarding condition, select the forwarding destination.
6. Set the ring strategy for the Presence status.
• Ring First: When a call reaches the extension, which terminal will ring first.
• Ring Secondly: If the incoming call is not answered on the terminals that are
selected as Ring First, the terminals that are selected as Ring Secondly will ring.
7. Click Save and Apply.
3. In the Music on Hold for Call Forwarding drop-down list, select Ringing Tone.
Admin Guide | 1 - Admin Guide | 19
Below are the default call forwarding feature codes and the description of how to use the
feature codes.
Voicemail
Voicemail Overview
Yeastar Cloud PBX integrates a free voicemail system. Voicemail is a modern kind of
answering machine that allows the callers to leave audio messages in case of unavailability.
1. Go to Settings > PBX > Extensions, search and find the desired extension, click .
Note: To receive voicemail via email successfully, make sure the system email is
working.
1. Go to Settings > PBX > Extensions, select the desired extension, click .
2. Click the Features tab.
3. In the Send Voicemail to Email drop-down list, select an email type.
• Send to user's email: Send voicemail to the extension user's email address.
• Send to custom email: Send voicemail to a custom email address.
4. Click Save and Apply.
1. Go to Settings > System > Email > Email Templates, click beside Voicemail to
Email.
A user can dial *02 on other user's phone to enter the voicemail main menu, then enter
his/her extension number and voicemail PIN to check voicemail.
Tip: If the users are using Linkus, they can dial *2 directly to check their voicemails.
When an extension is busy on a phone, the voicemail greeting consists of 3 audio clips:
Busy Prompt + Voicemail Prompt + "Di"
• Default Voicemail Prompt: Please leave your message after the tone, when done hang
up or press the pound key (#)."
• Busy Prompt: Select the prompt that will be played when the extension is busy.
• Unavailable Prompt: Select the prompt that will be played when the extension is
unavailable.
• Voicemail Prompt: Select the prompt that will be played after Busy or Unavailable
prompt.
Note: The greeting prompt file format should be ".wav", ".WAV" or ".gsm" file.
Supported Format: PCM: 8K, 16bit, 128kbps; A-law(g.711): 8k, 8bit, 64kbps; u-law (g.711):
8k, 8bit, 64kbps; gsm: 6.10, 8k, 13kbps.
1. Go to Settings > PBX > Extensions, search and find the desired extension, click .
2. Click the Features tab.
3. Click Browse to upload a prompt file.
Admin Guide | 1 - Admin Guide | 25
a. Log in the PBX web interface, go to Settings > PBX > Extensions, edit the
extension 4000.
b. On the extension Features page, enable Share Voicemail Status.
c. Click Confirm.
Result:
• Green BLF LED: The extension 4000 has NO unread voicemail messages.
• Red BLF LED: The extension 4000 has unread voicemail messages.
For example, to receive multiple extensions' voicemail messages from the mailbox
voicemial@yeastar.com. Set Send Voicemail to Email to the same custom email address
voicemial@yeastar.com for these extensions.
Admin Guide | 1 - Admin Guide | 27
Message Options
Max Messages per Folder Each extension user has a Read voicemail folder and an Unread folder.
You can set the maximum number of messages per folder.
Delete Voicemail This function will work if you enable Send Voicemail to Email. If the
voicemail is forwarded to the user's email, PBX will delete voicemails from
the user's voicemail folder.
Ask Caller to Dial 5 By default, when the caller accesses a user's voicemail, PBX starts to
record message automatically. If you want to prompt the caller first, you
can enable this option. The caller needs to dial 5 first, then starts to record
message.
Admin Guide | 1 - Admin Guide | 28
Setting Description
Operator Breakout from If enabled, the users can dial 0 to exit the voicemail destination of an IVR.
Voicemail
Greeting Options
Busy Prompt Select the greeting that will be played when the extension is busy.
Note: To use a custom prompt, you need to upload your audio file to
the Custom Prompt page first.
Unavailable Prompt Select the greeting that will be played when the extension is unavailable.
Note: To use a custom prompt, you need to upload your audio file to
the Custom Prompt page first.
Voicemail Prompt Select the greeting that will be played before the caller leave a message.
Note: To use a custom prompt, you need to upload your audio file to
the Custom Prompt page first.
Playback Options
Announce Message Caller ID If enabled, the PBX will announce who left the message.
Announce Message Duration If enabled, the PBX will announce the message duration.
Announce Message Arrival If enabled, the PBX will announce when the message was received.
Time
Allow Users to Review If enabled, the users can review their recorded message, and then send
Messages the messages.
Voicemail Menu
You can dial *2 on your phone to access the voicemail menu. Below is the detailed
voicemail menu.
Admin Guide | 1 - Admin Guide | 29
Call Monitoring
Call Monitoring Overview
Call Monitoring allows authorized users to monitor another extension user's call in real time.
The supervisor can dial "feature code" + "extension number" to monitor the extension user's
call.
In the Call Monitor section, you can enable or disable monitor modes, and modify
corresponding feature codes.
The supervisor can not talk with the monitored extension users.
• Whisper (Default code: *91)
Admin Guide | 1 - Admin Guide | 30
Whisper mode allows supervisor to listen to a call in real time, and talk with the
monitored extension user privately.
Barge-in mode allows the supervisor to listen to a call in real time and talk with both
parties.
a. Go to Settings > PBX > Extensions, click beside the desired extension.
c. In the Monitor Settings section, select a Monitor Mode for the supervisor.
a. Go to Settings > PBX > Extensions, click beside the desired extension.
c. On the Monitor Settings section, select the checkbox of Allow Being Monitored.
Call Permission
Set Call Permission of an Extension
On the Extension configuration page, you can set the outbound call permissions for the
extension user.
1. Go to Settings > PBX > Extensions, click beside the desired extension.
2. On the Extension configuration page, click Call Permission tab.
3. Select outbound routes for the extension from Available box to Selected box.
Outbound Restriction
Select the Outbound Restriction option to prohibit this extension from making
outbound calls.
On the Extensions page, the extension will be locked and the extension status will
show .
Note: If the extension user makes outbound calls over the limit of Outbound
Restriction rule, the extension will also be locked.
Double click the icon or unselect the checkbox of Outbound Restriction to allow
this extension to make outbound calls.
Extension Settings
SIP Extension Settings
This reference describes all settings on a SIP extension.
Basic Settings
Navigation path: Settings > PBX > Extensions, edit a SIP extension on the Basic tab.
General Settings
Settings Descriptions
Caller ID If you set the caller ID number, the called party will
see this caller ID number when the extension user
makes an outgoing call.
Settings Descriptions
Caller ID name If you set the caller ID name, the called party will
see this caller ID name when the extension user
makes an outgoing call.
Settings Descriptions
Presence Settings
Extension Presence indicates the availability status of a SIP extension. Presence settings
are linked to the Call Forwarding rules and Linkus ring strategy. You can set different call
forwarding rules and ring strategy for each presence status.
Navigation path: Settings > PBX > Extensions, edit a SIP extension under the Presence
tab.
Presence Settings
Admin Guide | 1 - Admin Guide | 34
Settings Description
You can forward calls to a specific destination or a specific extension user to avoid missing
calls. Depending on the presence status and your preferences, you can set the PBX to
forward calls to voicemail, extension, mobile number, queue, etc.
Settings Description
When Busy Only forward the calls that come in while you are
talking on the phone.
You can set ring strategy for the following terminals that the SIP extension registered to.
• Extension
• Linkus Mobile Client
• Linkus Desktop Client
Settings Description
Features Settings
You can configure voicemail, mobility extension, call monitoring, and other settings under
the Features tab.
Admin Guide | 1 - Admin Guide | 35
Navigation path: Settings > PBX > Extensions, edit a SIP extension under the Features
tab.
Voicemail Settings
Settings Description
Share Voicemail Status Enable this option to share voicemail status of this
extension with other extensions.
Busy Prompt Set the prompt that will be played when the
extension user is busy in a call.
Unavailable Prompt Set the prompt that will be played when the
extension user is unavailable.
Mobility Extension
Yeastar Mobility Extension allows you to stay in contact with colleagues and clients using
either office phone or mobile phone with the same extension number.
Settings Description
Enable Mobility Extension Enable this option to allow your mobile number
have the same permission as the office phone when
you use associated mobile number to call in the
PBX.
Mobility Extension
• Set Mobile Number: Set the associated mobile
number.
• Prefix: Set the prefix of the mobile number
according to the outbound route.
Admin Guide | 1 - Admin Guide | 36
Monitor Settings
Call Monitoring allows authorized users to monitor another extension user's call in real time.
Settings Description
Allow Being Monitored Enable this option to allow anyone to monitor the
extension user's ongoing call.
• Disabled
• Extensive
Other Settings
Settings Description
Ring Timeout (s) Set the timeout in seconds. Phone will stop ringing
after timeout.
Admin Guide | 1 - Admin Guide | 37
Settings Description
Max Call Duration (s) Set the maximum call duration in seconds for every
call of this extension.
Note:
Send email notification when extension user Enable this option to send email notification when
password is changed extension user password is changed.
Advanced Settings
The advanced settings of SIP extension require professional knowledge of SIP protocol.
Incorrect configurations may cause calling issues. It is wise to retain the default settings
provided on the SIP extension page. However, for a few fields, you need to change them to
suit your situation.
Navigation path: Settings > PBX > Extensions, edit an extension under the Advanced
tab.
VoIP Settings
Settings Description
Settings Description
DTMF Mode Set the default mode for sending DTMF tones.
• UDP
• TCP
• TLS
Settings Description
Enable User Agent Registration Authorization Whether to restrict user agents from registering to
the extension.
IP Restriction
Settings Description
Enable IP Restriction This option is used for IP access control. Only the
IP address or IP section that matches the settings
can register the extension number.
Admin Guide | 1 - Admin Guide | 39
Settings Description
• 192.168.5.100/255.255.255.255
Navigation path: Settings > PBX > Extensions, edit a SIP extension under the Call
Permission tab.
Settings Description
Contacts
Contacts Overview
Yeastar Contacts feature allows you to add external contacts to Company Contacts and
share the Company Contacts with your organization. Each extension user has a Personal
Contacts to create and manage their personal contacts.
Contacts types
Company Contacts
Company Contacts is a phone book that allows you to store a list of external
contacts, such as the company's customers, resellers and partners.
Admin Guide | 1 - Admin Guide | 40
Note: By default, only the PBX administrator can view and manage
Company Contacts. To share Company Contacts with extension users, refer to
Configure Company Contacts Permissions for Users.
Personal Contacts
Personal Contacts is a phone book for each extension user. Users can store a
list of external contacts exclusive to themselves, such as direct customers.
Key features
Sync contacts between Linkus clients and PBX
Users can manage contacts both on Linkus and PBX web page.
For more information, see Manage Company Contacts and Manage Personal
Contacts.
Identify incoming calls
The contact's name is displayed for incoming calls to your Linkus, desk phone,
or other softphones if the contact's information is saved in Company Contacts
or Personal Contacts. By knowing who’s calling, the users can handle the calls
efficiently.
Contacts limits
The following table shows the maximum number of contacts supported on the PBX.
Requirements
Only the PBX administrator and the authorized users can manage Company Contacts.
For more information of Company Contacts permissions, see Configure Company Contacts
Permissions for Users.
For more information of Contacts on Linkus, see Linkus Mobile Help (Me > Settings > Help
& Feedback).
Add √ √
Edit √ √
Delete √ √
Export √ ×
Import √ ×
Note: The First Name, Last Name are required fields, and at least one number is
required.
4. Click Save.
Use the CSV file as a template, save your data in the same format. For the data
requirements in the CSV file, see Import Parameters - Contacts.
If the contact data is imported successfully, the web page will display the following
confirmation.
If you get an error prompt like the following figure, click Yes to check the log and
update your data in the CSV file.
For more information of Contacts on Linkus, see Linkus Mobile Help (Me > Settings > Help
& Feedback).
Add √ √
Edit √ √
Delete √ √
Export √ ×
Import √ ×
Note: The First Name, Last Name are required fields, and at least one number is
required.
4. Click Save.
4. Click Save.
Use the CSV file as a template, save your data in the same format. For the data
requirements in the CSV file, see Import Parameters - Contacts.
If the contact data is imported successfully, the web page will display the following
confirmation.
If you get an error prompt like the following figure, click Yes to check the log and
update your data in the CSV file.
Admin Guide | 1 - Admin Guide | 46
Permissions
The PBX provides two permission levels: View and Manage.
Note: Assign the Manage permission carefully to appropriate users. If a user delete
contacts accidentally, the contacts would be lost.
4. Click Save.
Requirements
Identifying Caller ID is supported on all endpoints, including Linkus, desktop phone, and
other softphones.
• Exact Match: Only when the incoming Caller ID matches exactly your existing
contact number will the contact name be displayed.
• Fuzzy matching: When the last few digits of the incoming Caller ID matches that
of your existing contact number, the contact name will be displayed. The default
value is 7.
4. In the Name Display Format field, select the contact display order.
• First Name Last Name
• Last Name First Name
5. Click Save and Apply.
Example
◦ If the incoming caller ID is 12345678, the contact name "Dora" will be displayed.
◦ If the incoming caller ID is +012345678, the contact name will not be displayed.
• Fuzzy matching last 8 digits is configured:
◦ If the incoming caller ID is +012345678, the contact name "Dora" will be displayed.
◦ If the incoming caller ID is 62345678, the contact name "Dora" will not be
displayed.
Contacts FAQ
• Cannot import my contacts
• Can I set a Contacts sub-administrator?
Admin Guide | 1 - Admin Guide | 49
The PBX administrator can go to Settings > Permission to grant Contacts permission for
the desired user.
If the Contacts permission is assigned to an user, the user can do the following operations:
After you create the personal contacts, the contacts is stored in PBX.
You can not retrieve and view Contacts information on IP phones at present. But Contacts
feature will be supported on IP phones soon, and information can be synchronized among
the PBX server, Linkus Clients, and IP phones at that time.
Contacts information is stored on PBX, so it will be automatically saved when you back up
the PBX.
Company Contacts is stored on PBX system disk, so you can not expand the capacity by
adding extra storage device.
Trunks
Trunk Overview
Making and receiving calls between internal extensions is one thing, but if you want to
receive and make calls to the outside world, you need at least a trunk to the outside world.
VoIP Trunks
VoIP Trunks Introduction
VoIP Trunks are phone lines that transmits calls over the Internet. A VoIP provider can
assign a local number to one or more cities or countries and route it to the PBX phone
system. Usually VoIP trunks are cheaper than traditional PSTN trunks.
• VoIP Register Trunk: Registration based VoIP trunk. VoIP Register Trunk uses the
username and password for registration with SIP providers.
• VoIP Peer Trunk: Uses the IP address & port or domain of PBX for authentication or
connect PBX directly to VoIP provider's dedicated network. Your VoIP provider route
incoming and outgoing calls based on the DID number, PBX port or PBX domain, or
route calls by a private network.
Account Trunk is designed for connection between Yeastar Cloud PBX and other
devices. Yeastar Cloud PBX will act as a VoIP account provider, the other device
should register this account to connect to Yeastar Cloud PBX.
• WebRTC Trunk
Procedure
When users call the DID number, the DNIS name will be displayed on ringing
phone.
iv. Click and repeat steps i-ii to add another DID numbers.
When users call the DID number, the DNIS name will be displayed on ringing
phone.
6. If your trunk is a Peer Trunk, complete the following configurations:
You can check the trunk status in PBX Monitor. If the trunk status shows , the trunk
is ready for use.
Assume that you bought a SIP trunk from the VoIP provider, and the trunk information is
displayed as below. We will introduce how to set up a Register Trunk according to the trunk
information.
Protocol SIP
Transport UDP
Username 254258255
Password 05JsOmsIS54SYh
• Password: Enter the password that is associated with the username (e.g.,
05JsOmsIS54SYh).
• Authenticate: Enter the authentication name to register to the VoIP provider (e.g.,
254258255).
• From User: Enter the same name as User Name (e.g., 254258255).
6. Set DID numbers for the trunk#
a. Select Add Single DID.
b. Enter the DID Numbers which is provided by the VoIP provider.
c. Select the checkbox of DNIS Name, enter a DNIS name for the DID number.
When users call the DID number, the DNIS name will be displayed on ringing
phone.
You can check the trunk status in PBX Monitor. If the trunk status shows , the trunk
is ready for use.
Admin Guide | 1 - Admin Guide | 55
Related tasks
Add an Outbound Route
Add an Inbound Route
Set up DOD Numbers for VoIP Trunk
Note: If you don't know which type to select, contact Yeastar support.
DID-based If the VoIP provider routes incoming calls and outgoing calls based on the DID
number, select DID-based VoIP trunk.
Port-based If the VoIP provider routes incoming calls and outgoing calls based on the SIP
registration port, select Port-based VoIP trunk.
Domain-based If the VoIP provider routes incoming calls and outgoing calls based on the PBX
domain name, select Domain-based VoIP trunk.
Private Network If the PBX and the VoIP provider are in the same private network, select
Private-Network based VoIP trunk.
5. Enter the trunk information that is provided by the VoIP provider.
You can check the trunk status in PBX Monitor. If the trunk status shows , the trunk
is ready for use.
Admin Guide | 1 - Admin Guide | 56
Related tasks
Add an Outbound Route
Add an Inbound Route
Set up DOD Numbers for VoIP Trunk
Note: The other device should use the provided trunk information to connect to the
Yeastar Cloud PBX.
After the Account Trunk is registered on the other device, you can check the trunk
status in PBX Monitor. If the trunk status shows , the trunk is ready for use.
Related tasks
Add an Outbound Route
Add an Inbound Route
Admin Guide | 1 - Admin Guide | 57
Basic Settings
Navigation path: Settings > PBX > Trunks, edit a trunk on the Basic tab.
Settings Description
Select Country Select the country that the VoIP provider operates in.
Settings Description
Authentication Name Enter the authentication name to register to the VoIP provider.
From User
Enter a name. All the outgoing calls from this trunk will use this name in From
header of the SIP invite package.
DID Number Direct Inward Dialing number, can be used to distinguish incoming calls.
DNIS Name Dialed Number Identification Service is a telephony service used to identify
which number was dialed.
Bind a DNIS name for a DID number, when users call the DID number, the
DNIS name will be displayed on ringing phone.
Caller ID Number
If you set the caller ID number, when users make outbound calls through this
trunk, the called party will see this caller ID number instead of the calling party's
number.
This feature requires support from the VoIP provider.
Caller ID Name If you set the caller ID name, when users make outbound calls through this
trunk, the called party will see this caller ID name instead of the calling party's
name.
Enable Outbound Proxy Set the outbound proxy if the VoIP provider needs.
Enable SLA After enabling SLA, users can share this trunk to make outbound calls and
receive inbound calls by BLF keys on their phones. In this way, Inbound Route
settings and Outbound Route settings for the trunk is invalid.
Advanced Settings
The advanced settings of VoIP trunk requires professional knowledge of SIP protocol.
Incorrect configurations may cause calling issues. It is wise to leave the default settings
provided on the VoIP trunk page. However, for a few fields, you need to change them to suit
your situation.
Navigation path: Settings > PBX > Trunks, edit a trunk on the Advanced tab.
VoIP Settings
Admin Guide | 1 - Admin Guide | 59
Settings Description
Qualify Enable this option to send SIP OPTION packet to SIP device to
check if the device is up.
DTMF Mode Set the default mode for sending DTMF tones.
Enable SRTP Enable or disable SRTP (encrypted RTP) for the trunk.
T.38 Support Enable or disable T.38 fax for this trunk. Enabling T.38 will add the
performance cost.
User Phone Whether to add the parameter user=phone in the SIP INVITE packet.
Inbound Parameters
Settings Description
Get DID From Decide from which header field will the trunk retrieve DID header.
• [Follow System]
The trunk will follow the global Get DID From setting.
• TO
• INVITE
• Remote-Party-ID
• P Asserted Identify
• Diversion
• P-Called-Party-ID
• P-Preferred-Identity
Admin Guide | 1 - Admin Guide | 60
Settings Description
Get Caller ID Decide from which header field will the trunk retrieve Caller ID header.
From
• [Follow System]
The trunk will follow the global Get Caller ID From setting.
• From
• Contact
• Remote-Party-ID
• P Asserted Identify
Outbound Parameters
Settings Description
Remote Party ID Select which Remote Party ID value should be contained in the SIP
INVITE headers when making an outbound call.
P Asserted Identify Select which P Asserted Identify value should be contained in the
SIP INVITE headers when making an outbound call.
Transfer Parameters
• The Originator Caller ID: The Caller ID Number of the first caller in cases
that the call is transferred.
• From User: The From User value that you configured for the trunk.
• None: Do not send Remote Party ID with the SIP INVITE packet.
Settings Description
Other Settings
Settings Description
Realm
SIP Realms, also known as domains within SIP networks.
Inband Progress This Inband Progress setting applies to the extensions which make
calls through this trunk.
• Check this option: PBX will send a 183 Session Progress to the
extension when told to indicate ringing and will immediately start
sending ringing as audio.
• Uncheck this option: PBX will send a 180 Ringing to the extension
when told to indicate ringing and will NOT send it as audio.
Admin Guide | 1 - Admin Guide | 62
Codec Settings
Each new created VoIP trunk has a default preferred codec list. However, the default codec
list may not match the codecs supported by your VoIP provider. In order to maximize the
quality of calls and the amount of bandwidth used for calls, you’ll want to choose and
configure your preferred codec list to match the settings that your VoIP provider supports.
Navigation path: Settings > PBX > Trunks, edit a trunk on the Codec tab.
Select Codec
In the Available box, double click a codec, the selected codec will appear in
the Selected box.
In the Selected box, click a codec, and click to change the priority.
Admin Guide | 1 - Admin Guide | 63
Adapt Caller ID
The incoming caller ID that matches the adaptation pattern will be adapted, so that you can
press the call record directly on your phone call back a number.
Navigation path: Settings > PBX > Trunks, edit a trunk on the Adapt Caller ID tab.
Settings Description
• [12345-9] matches the numbers in the bracket (in this example, 1, 2, 3, 4,5, 6, 7, 8,
9);
• Wildcard matches one or more numbers. E.g. "9011." matches anything starting
with 9011 (excluding 9011 itself);
• Wildcard "!" matches none or more than one numbers. E.g. "9011T matches
anything starting with 9011 (including 9011 itself);
Strip Strip allows you to specify the number of digits that will be stripped from the front of
the Caller ID before the call is displayed. For example, if the incoming Caller ID is
05929999999, but you need to dial number 5929999999 to call back, one digit should
be stripped.
Admin Guide | 1 - Admin Guide | 64
Settings Description
Prepend These digits will be prepended to the Caller ID before the call is displayed. For example,
if the incoming caller ID is 5929999999, but you need to dial digit 0 before the number
to call back, 0 should be prepended.
WebRTC Trunks
WebRTC Click-to-Call
WebRTC (Web Real-Time Communication) is a collection of communications protocols and
application programming interfaces that enable real-time communication over peer-to-peer
connections. Yeastar Cloud PBX supports WebRTC Click-to-Call that allows the website
visitors calling to a pre-configured destination by clicking a link/button the web page.
Note: The failed test is caused by WebRTC not being supported by the web browsers.
Browser Conditions/Limitations
Mac Desktop: √
Android Phone: √
iOS Phone: ×
Mac Desktop: √
Android Phone: ×
iOS Phone: ×
Go to Settings > PBX > General > WebRTC, check the option Enable, click Save.
When a WebRTC call is made through this trunk, the trunk number will be displayed on
the ringing endpoint.
7. Click Save.
A link for the WebRTC trunk is generated in WebRTC Inbound Call Link. You can
place the link on your web page. When your website visitors click the link, they will be
connected to the destination of this WebRTC trunk.
Admin Guide | 1 - Admin Guide | 66
1. Go to Settings > PBX > Call Control > Inbound Routes, click Add.
2. Set WebRTC call destination.
• Name: Enter a route name.
• Member Trunks: Select the WebRTC trunk to the Selected box.
• Enable Time Condition: Select the checkbox of Enable Time Condition, and
configure time conditions to route the incoming calls based on the time conditions.
• Destination: Select the inbound route destination.
Note: To test the WebRTC Click-to-Call, you can paste the WebRTC link in the web
browser directly.
Admin Guide | 1 - Admin Guide | 67
1. On the WebRTC turnk configuration page, click to copy the WebRTC link.
A dialpad will be displayed on the web page and the call will be connected to your pre-
configured destination.
Basic Settings
Navigation path: Settings > PBX > Trunks, edit WebRTC trunk on the Basic tab.
Settings Description
WebRTC Inbound Call Link Place the link on your web page. When your website visitors click the link,
they will be connected to the destination of this WebRTC trunk.
Codec Settings
Yeastar Cloud PBX supports a-law and u-law codecs.
Navigation path: Settings > PBX > Trunks, edit WebRTC trunk on the Codec tab.
Select Codec
In the Available box, double click a codec, the selected codec will appear in
the Selected box.
Set the Codec Priority
In the Selected box, click a codec, and click to change the priority.
Maximum Channels: Defines the maximum number of concurrent calls allowed in this
trunk.
Admin Guide | 1 - Admin Guide | 69
Call Control
Emergency Numbers
Add an Emergency Number
To ensure that the extension users can make emergency calls at any time, you need to
add emergency numbers on Yeastar Cloud PBX. You can also set an alert to notify the
emergency contacts that an emergency call has been dialed.
Note: Emergency calls have the highest priority. If the trunk used to make emergency
calls is busy, the PBX will terminate the ongoing call, and place the emergency call.
b. Optional: If the selected trunk needs a prepended number before the emergency
number, enter a prepended number in the Prepend field.
For example, if your trunk needs a prepended number 0 before the emergency
number 911, users should dial 0911 to make the emergency call. To comply with
the user's dialing habit, you can set the Prepend as 0. In this way, users can dial
911 as they usually do.
Note: If the first trunk cannot work properly, the PBX will use the second trunk
to make calls.
If someone makes emergency calls through the PBX, the contacts will receive
notification calls on their extensions.
a. In the drop-down list, select a contact.
b. Optional: Click to add another contact.
1. Go to Settings > PBX > Emergency Number, click beside the emergency number
that you want to edit.
2. Edit information of emergency number.
3. Click Save and Apply.
1. Go to Settings > PBX > Emergency Number, click beside the emergency number
that you want to delete.
2. In the pop-up window, click Yes to delete the selected emergency number.
3. Click Apply.
Time Conditions
Time Conditions Overview
A Time Condition is a time group, which can be applied to outbound routes and inbound
routes. You can use Time Condition to control calls based on date and time.
Time Condition is typically used to control the destination of an inbound call based on
the date and time.
You can select a Time Condition and set a corresponding destination for an inbound
route. When a call reaches the PBX, PBX will route the call to the destination when the
current system time matches the time defined in the Time Condition.
Admin Guide | 1 - Admin Guide | 71
You can also apply Time Condition to an outbound route to limit when the users can
use the outbound route.
1. Go to Settings > PBX > Call Control > Time Conditions > Time Conditions, click
Add.
2. In the Name field, enter a name to help you identify it.
3. In the Time field, set the time according to your office time.
4. Click to add another time period.
5. In the Days of Week field, select your office days.
6. If you want to apply the time period(s) to specific dates, select the checkbox of
Advanced Options, and set the month and the days of month.
Note: Advanced Options is disabled by default, which means that the time
period(s) will be applied throughout the year.
However, you may need to add another Time Condition to route incoming calls to other
destinations due to company's schedule. For example, you want all incoming calls during
lunch break to be routed to the receptionist. In this way, employees can enjoy nap time
without missing any important calls.
In this case, you can add another Time Condition for non-office hours.
1. Go to Settings > PBX > Call Control > Time Conditions > Time Conditions, click
Add.
2. In the Name field, enter a name to help you identify it.
3. In the Time field, set the time according to your non-office time.
4. Click to add another time period.
5. In the Days of Week field, select your office days.
6. If you want to apply the time period(s) to specific dates, select the checkbox of
Advanced Options, and set the month and the days of month.
Note: Advanced Options is disabled by default, which means that the time
period(s) will be applied throughout the year.
Set holidays
You can add a group of holidays and set a Time Condition destination like an IVR for the
holidays on your inbound route. When a customer calls to your company during holidays,
the PBX will route the call to the IVR and inform your customers that you are on vacation.
Admin Guide | 1 - Admin Guide | 73
1. Go to Settings > PBX > Call Control > Time Conditions > Holiday, click Add.
2. In the Name field, enter a name to help you identify it.
3. In the Type field, select a type.
• By Date: If the holiday such as Chinese Spring Festival varies every year, select
this type.
• By Month: If the holiday such Chinese National Day always falls on the same
calendar date, select this type.
• By Week: If the holiday such as Thanksgiving Day always falls on the same week,
select this type.
4. In the Start Date field, select the start date of the holiday.
5. In the End Date field, select the end date of the holiday.
6. Click Save and Apply.
1. Go to Settings > PBX > Call Control > Inbound Routes, click beside the inbound
route that you want to edit.
2. On the Inbound Route page, select the checkbox of Enable Time Condition.
3. Click , and select a Time Condition from the drop-down list.
4. Select destination from the drop-down list.
Inbound calls will be routed to the pre-configured destination if the date and time of the
calls match the time condition.
Admin Guide | 1 - Admin Guide | 74
1. Go to Settings > PBX > Call Control > Outbound Routes, click beside the
outbound route that you want to edit.
2. On the Outbound Routes page, select the Time Condition which will be applied to the
outbound route.
Only in this time period can extension users make outbound calls via this outbound
route.
3. Click Save and Apply.
1. Go to Settings > PBX > Call Control > Time Conditions, click beside the Time
Condition that you want to edit.
2. Change Time Condition settings according to your needs.
3. Click Save and Apply.
1. Go to Settings > PBX > Call Control > Time Conditions, click beside the Time
Condition that you want to delete.
2. On the pop-up window, click Yes and Apply.
According to your office hours, you can set two Time Conditions as follows..
Admin Guide | 1 - Admin Guide | 75
• Office hours
• Lunch break
Holiday examples
Yeastar Cloud PBX supports 3 types of holidays.
If date of a holiday varies every year, you can set a holiday by date.
For example, Chinese Spring Festival falls on February 15th-21st. You can set the
holiday as follows.
Admin Guide | 1 - Admin Guide | 76
If a holiday always falls on the same date, you can set a holiday by month.
For example, Christmas falls on December 25th every year. You can set the holiday as
follows.
If a holiday always falls on the same week, you can set a holiday by week.
For example, Thanksgiving Day falls on the 4th week of November. You can set the
holiday as follows.
On Inbound Route page, enable Enable Time Condition, click to add Time Conditions,
and set corresponding destinations.
For example, the following table is a schedule of Time Conditions for a company.
Admin Guide | 1 - Admin Guide | 77
Note: All holidays will be integrated into one Holiday, you don't have to select holidays
one by one from Time Condition on inbound routes.
Scenarios
Company A sets day time condition and night time condition in an inbound route with
different destinations.
The staffs occasionally leave early or someone needs to enable the night time condition
manually. In this scenario, the staffs can dial override feature code to override the time
condition.
You can go to Settings > PBX > General > Feature Code > Time Condition to change the
feature code prefix.
Admin Guide | 1 - Admin Guide | 79
1. Go to Settings > PBX > General > Feature Code > Time Condition, click Set
Extension Permission.
We take Yealink T53W v95.0.0.0.0.0.1 as an example to explain how to set BLF keys to
monitor Time Condition state.
1. Set Time Condition Override permission for the extension that is registered on the IP
phone.
a. Log in PBX interface, go to Settings > PBX > General > Feature Code > Time
Condition, click Set Extension Permission.
Admin Guide | 1 - Admin Guide | 80
a. Log in the phone web interface, go to DSS Key > Memory Key.
f. Click Confirm.
• Red: The PBX is using this Time Condition; inbound calls go to the destination of
the Time Condition.
• Green: This Time Condition is not in use.
3. Press a BLF key to override Time Condition, the BLF LED turns to red.
You can also log in the PBX web interface, and check the Time Condition state on
configuration page of Inbound Routes. If the state shows , it indicates that the PBX
is using the Time Condition, and route all incoming calls to destination of the Time
Condition.
Admin Guide | 1 - Admin Guide | 81
Inbound Routes
Inbound Route Overview
An inbound route is used to tell the PBX where to route inbound calls based on the caller's
phone number or the DID number. Inbound routes are often used in conjunction with time
conditions and an IVR.
If you don't specify DID numbers and Caller ID numbers on the inbound route, the inbound
route will match and route all inbound calls to a pre-configured internal destination on the
PBX.
• Hang up
• Extension
• Extension Range
• Voicemail
• IVR
• Ring Group
• Queue
• Conference
• DISA
• Callback
• Outbound Route
• Fax to Email
Admin Guide | 1 - Admin Guide | 82
The PBX has a default inbound route. When users call to the selected trunk, the PBX will
route the call to an IVR. You can delete the default inbound route, then add a new one to
configure settings according to your needs.
1. Go to Settings > PBX > Call Control > Inbound Routes, click Add.
3. Optional: In the DID Pattern field, enter a DID number or a DID pattern if you want to
route inbound calls based on DID numbers.
The PBX will route the call only when the caller dials the matched numbers.
Note: Leave this blank to match calls with any or no DID info.
4. Optional: In the Caller ID Pattern field, enter a Caller ID or a Caller ID pattern if you
want to route inbound calls based on Caller IDs.
The PBX will route the call only when the caller ID number matches the Caller ID
Pattern.
Note: Leave this blank to match calls with any or no caller ID info.
5. In the Member Trunks field, select the desired trunk from Available box to the
Selected box.
The PBX will route the inbound call when the caller calls the number of the selected
trunk.
Admin Guide | 1 - Admin Guide | 83
6. If you allow the inbound calls to be routed to a desired destination without time limit,
configure the following settings:
7. If you allow the inbound calls to be routed to different destinations based on time
condition, configure the following settings:
If an inbound call reaches the PBX during the time period, PBX will route the call to
the selected destination.
If an inbound call reaches the PBX beyond the time periods that are defined in the
above Time Conditions, PBX will route the call to the selected destination.
8. Optional: In the Distinctive Ringtone field, enter the ringtone name. Distinctive
Ringtone helps users recognize where the call is from.
For example, the IP phone has a ringtone called "Family". You can enter "Family" in
the Distinctive Ringtone field. When a call reaches the IP phone through this inbound
route, the IP phone plays the "Family" ringtone.
Admin Guide | 1 - Admin Guide | 84
9. Optional: Select the checkbox of Enable Fax Detection. PBX will send the fax to Fax
Destination if a fax tone is detected.
• Extension: PBX will send the fax to Fax Destination if a fax tone is detected.
• Fax to Email: PBX will send the fax as an attachment to the specified email
address. An email address can be associated with extensions or be customized
address.
Note: If you want to send fax to email, make sure system email is configured
correctly.
1. Go to Settings > PBX > Call Control > Inbound Routes, click Import.
2. Click Download the Template, add the inbound routes information in the template file.
Note:
• The imported file should be a UTF-8 .csv file.
• For requirements of the import parameters, refer to Import Parameters - Inbound
Routes.
Adapt Caller ID feature is supported on each trunk. Go to Settings > PBX > Trunks, click
Adapt Caller ID tab on the trunk edit page to configure the settings.
Example 1
Company A wants to add a digit 0 to the 11-digit incoming caller ID number that begins with
digit 1 for quick redial purposes.
In this case, you can configure Adapt Caller ID on trunk 1, and set the rules as follows:
• Patterns: 1.
• Strip: Leave it blank.
• Prepend: 0
Example 2
Company B wants all Xiamen numbers to be displayed as local number without Xiamen
area code (0592) that is received through the trunk 2.
Admin Guide | 1 - Admin Guide | 86
In this case, you can configure Adapt Caller ID on trunk 2, and set the rules as follows:
• Patterns: 0592.
• Strip: 4
• Prepend: Leave it blank.
Note: The following examples ignore time condition, you can set time condition
according to your needs.
The following example shows an inbound route based on DID number 5503301.
Admin Guide | 1 - Admin Guide | 87
• Name: Set a name to help you identify it. For DID routes, you can set the name as the
DID number, which helps you identify the route.
• DID Pattern: 5503301
• Member Trunks: Select the trunk that has the DID number.
• Destination: Set the destination.
The following example shows an inbound route based on DID range 5503301-5503305,
which will route calls to extension 1001-1005.
In the following example, the inbound route will route caller ID numbers that start with digit
1 to the destination. For example, number 532352584 that doesn't start with digit 1 can not
call in the system through this inbound route.
• Caller ID Pattern: 1.
In the following example, when users dial 5503301 with phone number starting with digit 1,
the inbound call will be routed to the destination.
• Caller ID Pattern: 1.
• DID Pattern: 5503301
DID numbers
DID (Direct Inward Dialing) is a telephone service that allows outside users to reach a
certain destination instead of going to a receptionist or a queue and needing to dial an
extension number.
The trunk provider usually assigns a range of numbers to the VoIP trunk or the physical
trunk. There is an extra charge for the DID numbers. Contact your trunk provider for more
information about DID numbers.
Example:
You purchased two DID numbers from the SIP trunk provider: 5503301 and 5503302.
Admin Guide | 1 - Admin Guide | 89
To route inbound calls to different destinations based on different DID numbers, you can set
up two inbound routes for the two DID numbers.
Example: You purchased 10 DID numbers from the SIP trunk provider: 8823201-8823210.
Admin Guide | 1 - Admin Guide | 92
To assign the DID numbers one by one to extension 1001-1010 , you can configure the
inbound route as follows.
Admin Guide | 1 - Admin Guide | 93
Note: The number of extensions and DID numbers must be the same.
Caller ID routing
Caller ID (Caller Identification) is a telephone service that displays a caller's phone number
on the called party's phone device before the call is answered.
Caller ID routing allows users to accept or reject calls based on the caller's phone number.
Inbound calls which match the Caller ID pattern on PBX will be routed to the pre-configured
destination. For those unmatched, calls can not be established.
Scenarios
A company is dedicated to offering targeted service for different regions, the company
hopes that the Caller ID of inbound calls can be identified and the calls can be routed to
responsible employees. In this case, you can set Caller ID patterns for inbound routes.
Configuration Example
Company A assigns pre-sales business in France to Rose, and pre-sales business in
America to Mike. Refer to the following table and related configuration figures.
Note: Distinctive Ringtone feature needs support from the IP phones. We take Yealink
phone as an example.
Admin Guide | 1 - Admin Guide | 97
1. Log in the phone web interface, go to Settings > Ring, select a ringtone and set the
name.
2. Log in the PBX web interface, go to Settings > PBX > Call Control > Inbound
Routes, select an inbound route to edit.
a. In the Distinctive Ringtone field, enter the ringtone name that is configured on IP
phone.
b. Click Save and Apply.
When a call comes through the inbound route, the phone will play corresponding ringtone.
1. Go to Settings > PBX > Trunks, click beside the trunk that you want to edit.
2. On the Basic page, enter the trunk DID number, and set the DNIS Name for the DID
number.
Note: For VoIP Peer Trunk, click Advanced tab to find the DID settings.
Admin Guide | 1 - Admin Guide | 98
3. If the trunk has another DID number, click to add a DID number and set a DNIS
name.
For example, a VoIP trunk has 3 DID numbers. 5503301 for Support, 5503302 for
Sales, and 5503303 for Marketing. When external users dial a DID number, extension
users can notice the intention by DNIS name displayed on an IP phone.
Make a call to the trunk of the PBX, the user who receives the call will see the incoming
caller ID and the DNIS name of the trunk.
Admin Guide | 1 - Admin Guide | 99
For example:
Set up two Ring Groups according to your organization, one is named as Sales, the other is
named as Support.
You can set up two inbound routes to route incoming calls to different destinations by
different trunks, and enable Distinctive Caller ID feature.
• When external users call to PBX, and IP phones of Sales members ring, "Sales" will be
displayed on IP phones.
• When external users call to PBX, and IP phones of Support members ring, "Support"
will be displayed on IP phones.
1. Go to PBX > General > Preferences, select the checkbox of Distinctive Caller ID.
Outbound Routes
Outbound Route Overview
An outbound route is used to tell the PBX which extension users are allowed to make
outbound calls and which trunk to use for the outbound calls.
Admin Guide | 1 - Admin Guide | 100
Pattern
A pattern specifies routing rules to route a call based on the digits dialed by a user. The
PBX matches a dial pattern and routes the call out based on the dial pattern.
Pattern Description
[###] Refers to any digit in the brackets, example [123] would match the numbers 1, 2, or
3.
Range of numbers can be specified with a dash, example [136-8] would match the
numbers 1, 3, 6, 7, and 8.
Example 9011. matches any numbers starting with 9011 (excluding 9011 itself).
Example 9011! matches any numbers starting with 9011 (including 9011 itself).
Strip
Strip is an optional setting, it defines how many digits will be stripped from the front of the
dialed number before the call is placed.
Admin Guide | 1 - Admin Guide | 101
Example:
If a user wants to call number 1588902923, he/she should dial 91588902923. The PBX will
strip digit 9 from the dialed number, and call the number 1588902923.
Prepend
Prepend is an optional setting. The prepend will be added to the beginning of a successful
match. If the dialed number matches the Pattern, the prepend will be added to the
beginning of the number before placing the call.
Example:
If a trunk requires 10-digit dialing, but users are more comfortable with 7-digit dialing, you
can prepend a 3-digit area code to all 7-digit phone numbers before the calls are placed.
Related information
Outbound Route Examples
The PBX has a default outbound route with dial pattern X. that allows users to dial any
outgoing numbers. You can delete the default outbound route, then add a new one to
configure settings according to your needs.
1. Go to Settings > PBX > Call Control > Outbound Routes, click Add.
• Member Trunks: Select a trunk to make outbound calls. If the dialed number
matches a dial pattern of the outbound route, PBX will route the call out through
selected trunk.
• Extensions: Select which extensions are allowed to use this outbound route.
• Password: Optional. Set a password for the outbound route. If a password is
set, users are required to enter a password when they try to make outbound calls
through this route.
◦ None: No password is needed.
◦ PIN List: Select a PIN list. Users are required to enter a password in the PIN
list when they try to make outbound calls through this outbound route.
◦ Single Pin: Enter a password. Users are required to enter the password when
they try to make outbound calls through this outbound route.
• Rrmemory Hunt: Optional.
◦ If the feature is enabled, PBX will remember which trunk was used last time,
and then use the next available trunk to call out.
For example, PBX uses the first trunk to call out, then it will use the second
trunk to call out next time.
◦ If the feature is disabled, PBX will use trunks orderly to call out.
• Time Condition: Optional. You can define during which time period can users use
this outbound route. By default, users can call out through the outbound route at
any time.
Note: After you finish the outbound route configurations, you need to check and adjust
the priority of your outbound routes, so that PBX can match and route the call out through
the proper outbound route.
Related concepts
Dial Patterns of Outbound Route
Related information
Outbound Route Examples
For long-distance calls, you need to dial the 4-digit area code and local numbers, such as
0595-5503305. The area code in China is in the format of 0ZXX, the first digit is 0, and the
second digit cannot be 0.
The local number starts with digit 1-9, and users should
dial 9 before the number.
1XXXXXXXXXX Leave it blank. Leave it blank. Users can dial the mobile number as they
usually do.
00. Leave it blank. Leave it blank. Numbers start with digits 00 will go through this
outbound route.
1. Go to Settings > PBX > Call Control > Outbound Routes, click Import.
2. Click Download the Template, add the outbound routes information in the template
file.
Note:
• The imported file should be a UTF-8 .csv file.
• For requirements of the import parameters, refer to Import Parameters - Outbound
Routes.
Note: The route priority is important, especially if there is some overlap. For example,
the number 5503305 matches both a dial pattern of ZXXXXXX and X., the PBX will send the
call through the outbound route with the highest priority.
Example:
When users dial 05503301, both of the two outbound routes match 05503301:
• Outbound Route-Long-distance call: The dial pattern is 0XXXXXXX and uses trunk 1.
• Outbound Route-Local call: The dial pattern is X. and uses trunk 2.
Admin Guide | 1 - Admin Guide | 105
To call 5503301 through trunk 1, you need to prioritize the outbound route of "Long-distance
call"; or PBX will match the outbound route of “Local call" and route the call out using trunk
2.
Note: After you delete the outbound route, extension users can not make outbound
calls through this outbound route.
Admin Guide | 1 - Admin Guide | 106
Outbound Restriction
Outbound Restriction Overview
Outbound Restriction is used to limit how many outbound calls extension users can make
within specified time period.
Scenarios
Avoid toll fraud
Most toll fraud is committed from the outside. Hackers may attack the system by registering
to extensions and making outbound calls frequently.
With the Outbound Restriction rules, if extension users make outbound calls over the limited
frequency, the extensions will be blocked and unable to make outbound calls.
Note: We recommend that you keep the default Outbound Restriction rule.
Double click the icon , the extension will be able to make outbound calls again.
Admin Guide | 1 - Admin Guide | 107
1. Go to Settings > PBX > Call Control > Outbound Restriction, click Add.
AutoCLIP Routes
AutoCLIP Overview
AutoCLIP (Auto Calling Line Identity Presentation) is an intelligent call matching feature.
You can configure AutoCLIP to route inbound calls to original extensions, which will promote
your customer satisfaction and work efficiency.
Scenarios
Assume sales representatives in your company often make outbound calls to customers for
promotion. More or less, some customers may miss the calls. When customers call back,
the calls are routed to the reception or business auto attendant. Neither reception/business
auto attendant nor the customers know who placed the call.
With AutoCLIP feature, the PBX can redirect the calls to the original extension users who
placed the calls when customers call back.
1. When extension users make outbound calls, the PBX automatically stores the records
to AutoCLIP routing table.
2. When customers call in the PBX, PBX will search the phone numbers from the
AutoCLIP routing table.
Admin Guide | 1 - Admin Guide | 109
• If there're matched records in AutoCLIP routing table, the calls will be routed to
corresponding extensions.
• If there're not matched records in AutoCLIP routing table, the calls will be routed to
the destination specified in inbound routes.
Note:
• Enable caller ID feature for the trunk that you want to configure AutoCLIP routes, or the
PBX can not distinguish the caller ID and perform AutoCLIP.
• If many extension users make outbound calls to the same external user, PBX will only
match the last extension user that placed the call when the external user calls back.
2. In the Member Trunks field, select the trunk(s) from Available box to the Selected
box.
Admin Guide | 1 - Admin Guide | 110
• Delete Used Records: Select this option, PBX will perform AutoCLIP as follows:
a. When receiving an external call from customer A, the PBX will search the
record from AutoCLIP list, and redirect the call to the original extension user
that placed the call.
b. PBX will delete the AutoCLIP record.
c. When receiving an external call from customer A again, PBX will always route
the call to the destination specified by the inbound route instead of searching
the record from AutoCLIP list.
d. If extension users of PBX make outbound calls to customer A again, PBX will
generate AutoCLIP record again.
Note: To restrict PBX from routing all inbound calls from a certain
customer to the same extension user, select Delete Used Records.
• Record Keep Time: Set how long records can be kept in AutoCLIP list. If keep
time of a certain record over the value, PBX will automatically delete the record.
• Only Keep Missed Call Records: Select this option. Only unconnected outbound
calls (missed calls on the called party) will be recorded in AutoCLIP list.
• Digit Match: The default value is 7, which means if the digit of caller ID is less
than or equal to 7, the PBX will match the whole phone number with all phone
numbers in AutoCLIP list. If the digit of caller ID over 7, the PBX will match the last
7 digits of phone number with all phone numbers in AutoCLIP list.
Admin Guide | 1 - Admin Guide | 111
Example:
Example:
Extension user (1000) uses trunk1 to call external user (15880273600). PBX will
route the call to extension (1000) only when the external user (15880273600) calls
the phone number of trunk1.
Extension user uses the trunk with AutoCLIP feature to call external users out.
PBX generates an AutoCLIP record when extension user uses the trunk with AutoCLIP
feature to call external users out. On the AutoCLIP Routes page, click View AutoCLIP List
to view AutoCLIP record.
SLA Stations
SLA Overview
SLA (Shared Line Appearance) feature helps users share and monitor SIP trunks. After
enabling SLA feature for a trunk, the trunk works as the exclusive line for SLA station and is
unavailable in both inbound routes and outbound routes.
SLA trunk refers to the trunk with SLA feature enabled. SLA station refers to an extension
which is bound with a SLA trunk.
• When an SLA station makes an outbound call through SLA trunk, other members
sharing the SLA trunk can monitor the trunk state by BLF keys LED on phone devices.
• When receiving an external call from SLA trunk, all extensions sharing the SLA trunk
will ring.
Admin Guide | 1 - Admin Guide | 112
Note: If Allow Barge feature is enabled on an SLA trunk, all members can place
and join multi-party calls.
Assume that the boss’s phone is extension 2000 and the assistant's phone is extension
1000. The shared trunk name is "sipabc" and the trunk number is 5503305.
Note: SLA feature should be used in conjunction with BLF keys on phone devices.
a. Go to Settings > PBX > Trunks, click beside the trunk that you want to enable
SLA.
b. On the Basic page, select Enable SLA and configure the SLA settings.
Admin Guide | 1 - Admin Guide | 113
a. Go to Settings > PBX > Call Control > SLA, click Add.
b. On the SLA Station configuration page, set SLA station for the boss.
Admin Guide | 1 - Admin Guide | 114
3. On the boss's IP phone (extension 2000), configure a BLF key to monitor SLA trunk.
a. Log in the phone web interface, go to DSS key > Line Key to set a BLF key for the
boss.
b. Select a key to configure.
Note:
◦ {ext_num} stands for extension number.
◦ {trunk_name} stands for trunk name.
c. Click Confirm.
4. On the assistant's IP phone (extension 1000), configure a BLF key to monitor SLA
trunk.
a. Log in the phone web interface, go to DSS key > Line Key to set a BLF key for the
assistant.
b. Select a key to configure.
Note:
◦ {ext_num} stands for extension number.
◦ {trunk_name} stands for trunk name.
If the configuration is correct, you can see the BLF key LED is on.
Related concepts
Share Trunks by SLA
Note: For different phone models, there may be some difference in the status of BLF
keys.
• If the BLF key used to monitor SLA trunk turns green, it indicates that the trunk is
available, and the associated SLA station can make outbound calls through this trunk.
To make outbound calls, the SLA station should press BLF key first, and dial the
external number out after hearing a dial tone.
• If the BLF key used to monitor SLA trunk turns red, it indicates that the trunk is in use.
Other SLA stations can not use the trunk to make outbound calls now.
When an SLA station is in a call with other users using this SLA trunk, other SLA stations
can join the active call by pressing the BLF key.
Note: Hold Access of SLA station has a higher priority than the Hold Access of a
trunk.
• If Hold Access is set to Open, other stations that share the trunk can press BLF key to
retrieve the call.
• If Hold Access is set to Private, the call can be retrieved only by the station that
previously put the call on hold.
Related concepts
SLA Sample Configuration
Call Features
Admin Guide | 1 - Admin Guide | 118
IVR
Like most organisations, where possible, we would like to route incoming calls an Auto
Attendant. You can create one or more IVR (Auto Attendant) on the system to achieve it.
When calls are routed to an IVR, the system will play a recording prompting them what
options the callers can enter such as “Welcome to XX, for sales press 1, for Technical
Support press 2”.
Set up an IVR
Set up your own IVR if you need to routing incoming calls via an auto attendant.
1. Go to Settings > PBX > Call Features > IVR, click Add to add an IVR or edit the
default IVR.
• Number: PBX treats IVR as an extension; you can dial this extension number to
reach the IVR from internal extensions.
• Name: Set a name for the IVR.
• Prompt: Use the default IVR prompt or select your custom IVR prompt.
• Prompt Repeat Count: Set how many times the prompt will be played.
• Response Timeout: Set how long the PBX will wait for the caller to operate.
• Digit Timeout: After the user enters a digit, the user needs to enter the next digit
within the timeout.
Admin Guide | 1 - Admin Guide | 119
• Dial Extensions: Whether to allow callers to dial extension numbers via IVR.
• Dial Outbound Routes: Whether to allow callers to dial outbound calls via IVR.
Note: This option is useful if you interconnect two PBXs. The callers can
dial the other PBX's extension number via the IVR. In this solution, you need to
configure the appropriate outbound route and inbound route in both of the two
connected PBXs.
• Dial to Check Voicemail: Whether to allow users to check voicemail via IVR.
Note: This option is for the users who work out of the office. They can call in
the PBX and check their voicemail messages via the IVR.
3. Click Key Press Event tab, set the destination based on callers key presses.
4. On the Key Press Event page, set the Timeout destination and the Invalid
Destination.
• Timeout: If callers do not make an entry within the Prompt Repeat Count, they
will be transferred to the Timeout destination.
• Invalid: If callers enter a digit that is not defined in the IVR, they will be transferred
to the Invalid destination.
1. Upload a custom prompt or record a custom prompt on the PBX web interface.
2. Go to Settings > PBX > Call Features > IVR, edit your IVR.
3. Select the Prompt to your custom prompt.
4. Set the Prompt Repeat Count.
5. Click Save and Apply.
Related tasks
Upload a Custom Prompt
Record a Custom Prompt
Convert Audio Files Online
Convert Audio Files via WavePad
" Thank you for calling Yeastar. We are currently closed in observance of Holiday Name. We
will return on Date. If you got something urgent, please press 1 to contact our support. To
leave a voicemail, please press 2."
The second sentence is what your would change frequently. You can divide the IVR prompt
to 3 clips.
1. Go to Settings > PBX > Voice Prompts > Custom Prompts, click Upload to upload
your IVR prompt clips.
2. Go to Settings > PBX > Call Features > IVR, edit your IVR.
Admin Guide | 1 - Admin Guide | 121
Next time, when you want to change the IVR prompt, you can change the desired prompt
clip instead of changing the whole IVR prompt.
Dial by Name
You can set the IVR Keypress to "Dial by Name", that will allow the callers to find the person
by entering the first 3 letters of extensions' first name.
• Better to instruct the callers to use the feature in the IVR prompt.
1. Go to Settings > PBX > Call Features > IVR, edit your IVR.
2. Click Key Press Event tab, set a key action to Dial by Name.
Admin Guide | 1 - Admin Guide | 122
Ring Group
A ring group helps you to ring a group of extensions in a variety of ring strategies. For
example, you could define all the technical support guys' extensions in a ring group and ring
the support guys one by one.
1. Go to Settings > PBX > Call Features > Ring Group, click Add.
Queue
Queues are designed to receiving calls in a call center.
A queue is like a virtual waiting room, in which callers wait in line to talk with the available
agent. Once the caller called in PBX and reached the queue, he/she will hear hold music
and prompts, while the queue sends out the call to the logged-in and available agents. A
number of configuration options on the queue help you to control how the incoming calls are
routed to the agents and what callers hear and do while waiting in the line.
Admin Guide | 1 - Admin Guide | 123
Queue Agents
Yeastar Cloud PBX supports dynamic agents and static agents.
• Static Agent: A static agent always stays in a queue to receive incoming calls.
• Dynamic Agent: A dynamic agent can log in a queue or log out a queue at any time.
On the Queue configuration page, the unselected agents act as dynamic agents.
Add a Queue
Add a simple call queue.
1. Go to Settings > PBX > Call Features > Queue, click Add.
4. Select Failover Destination, define what should happen if the call does not get
answered by an agent.
• Dynamic agents: A dynamic agent can log in or log out a queue at any time.
• Static agents: A static agents will always stay in the queue.
6. Set the Agent Timeout, define how long the phone should keep ringing before it
considers the call unanswered by that agent.
It is done for a simple call queue, for more information of queue settings, refer to Queue
Settings.
Queue Settings
References of basic queue settings and caller experience settings.
Option Description
Number Use this number to dial into the queue, or transfer callers to this number to
put them into the queue.
Name Give this queue a brief name to help you identify it.
Password You can require agents to enter a password before they can login to this
queue.
Admin Guide | 1 - Admin Guide | 125
Option Description
Ring Strategy
This option sets the Ringing Strategy for this Queue.
• Ringing All: Ring All available Agents simultaneously until one answer.
• Least Recent: Ring the Agent which was least recently called.
• Fewest Calls: Ring the Agent with the fewest completed calls.
• Random: Ring a Random Agent.
• Rememory: Round Robin with Memory,Remembers where it left off in
the last ring pass.
• Linear: Rings interfaces in the order specicied in the configuration file.
Static Agents
Select static agent of the queue. The static agents will always stay in the
queue.
Note:
• The static agent is not allowed to log in and log out the queue.
• The unselected users are dynamic agents.
Agent Timeout The number of seconds an agent's phone can ring before we consider it a
timeout. If you wish to customize, enter the value in the text box directly.
Ring In Use If set to no, unchecked, the queue will avoid sending calls to members whose
device are known to be “in use”.
Agent Announcement Announcement played to the Agent prior to bridging in the caller.
Retry The number of seconds to wait before trying all the phones again. If you wish
to customize, enter the value in the text box directly.
Wrap-up Time How many seconds after the completion of a call an Agent will have before
the Queue can ring them with a new call .If you wish to customize, enter the
value in the text box directly. Input 0 for no delay.
Caller Settings
Music On Hold Select the “Music on Hold” playlist for this Queue.
Caller Max Wait Time Select the maximum number of seconds a caller can wait in a queue before
being pulled out. If you wish to customize, enter the value in the text box
directly. Input 0 for unlimited.
Leave When Empty If enabled, callers already on hold will be forced out of a queue when no
agents available.
Join Empty If enabled, callers can join a queue that has no agents.
Join Announcement Announcement played to callers once prior to joining the queue.
Admin Guide | 1 - Admin Guide | 126
Caller Settings
Agent ID Announcement Announcement played to the callers to prompt the agent ID. The agent is
who will answer the call.
Satisfaction Survey Prompt When the agent hangs up, the system will play the prompt to ask the caller
to rate their satisfaction scale.
Announce Hold Time Enabling this option causes PBX to announce the hold time to the caller
periodically based on the frequency timer. Either yes or no; hold time will be
announced after one minute.
Frequency How often to announce queue position and estimated hold time.
Periodic Announcements
Events
Key Once the events settings are configured, the callers are able to press the
key to enter the destination you set. Usually, a prompt should be set on
Periodic Announcements to guide the callers to press the key.
For example, dynamic agent 1000 dials 6700* to log in the queue 6700.
• To log out a queue, dial [QUEUE_NUM]**.
For example, dynamic agent 1000 dials 6700** to log out the queue 6700.
Admin Guide | 1 - Admin Guide | 127
For example, dynamic agent dials *756700 to log in the queue 6700.
• Dial *75[QUEUE_NUM] again to log out a queue.
For example, dynamic agent dials *756700 again to log out the queue 6700.
For example, on the phone of a dynamic agent, set a BLF key to quickly log in or log out
queue 6700.
1. Log in the phone web interface, go to Function Keys > Line Key.
2. Set a BLF key to log in or log out queue 6700.
Now, the agent can press the BLF key to switch his/her status in the queue.
• When the prompt "agent logged out,goodbye." is played, the agent is logged out of the
queue.
• When the prompt "agent logged in, goodbye." is played, the agent is logged in the
queue.
Note: Monitoring agent status is supported in the firmware version 30.8.0.8 or later.
We will set a BLF key to monitor if the agent 1001 is in the queue 6700 or not.
1. Log in the phone web interface, go to Function Keys > Line Key.
3. Click SaveSet.
Check the BLF LED status:
Conference
Conference calls increase employee efficiency and productivity, and provide a more cost-
effective way to hold meetings.
Conference members can dial * to access to the settings options and the admin can kick the
last user out and lock the conference room.
Add a Conference
To make a conference call, you should add a conference on the PBX first.
1. Go to Settings > PBX > Call Features > Conference, click Add.
• Number: The extension users need to dial this number to join the conference.
• Name: Set a name for the conference.
• Participant Password: Optional. If the password is set, users need to input the
correct PIN to join this conference.
• Wait for Moderator: If this option is checked, the conference participants could not
hear each other until the moderator joins in the conference.
• Sound Prompt: Select the sound prompt used for the login and logout of
conference members.
• Allow Participant to Invite: Whether to allow the participants to invite users to join
the conference.
• Moderator Password: The moderator doesn't need to enter a password to join the
conference. If a user enter this password to join the conference, he/she will act as
the conference moderator.
• Member Moderators: Select the conference moderators.
Join a Conference
Both the PBX extension users and the external users can join the conference.
1. For the PBX extension users, dial the conference number to join the conference room.
2. For the external users, you need to set the inbound route destination to a conference
first, then the external users call to the PBX, their calls will be routed to the conference.
Call Pickup
Call Pickup is a feature that allows a user to answer an incoming call that rings on a
telephone other than the user’s own.
You can change the code on Settings > PBX > General > Feature Code > Extension
Pickup.
Operation
Dial *04[EXT_NUM] to pick up a call.
Admin Guide | 1 - Admin Guide | 131
For example, the ringing extension number is 1000, you should dial *041000 to pick up the
call.
c. Click Confirm.
2. To get notified when the monitored extension has an incoming call, set visual alerts and
audio alerts for the BLF Pickup.
a. On the phone web page, go to Phone > Features > Call Pickup.
Admin Guide | 1 - Admin Guide | 132
A “beep” sound will remind you of an incoming call for the monitored extension.
d. Click Confirm.
When the monitored extension has an incoming call, the followings occur on your phone,
press BLF key to pick up the call.
You can change the code on Settings > PBX > General > Feature Code > Call Pickup.
1. Go to Settings > PBX > Call Features > Pickup Group, click Add.
• Type: BLF
• Value: Enter the feature code of group pickup. The default code is *4.
• Label: Set a label that you want to display on the phone screen.
• Line: Choose the line where your extension is registered on.
3. Click Confirm.
If your configuration is correct, the BLF LED will turn green.
Admin Guide | 1 - Admin Guide | 134
Call Transfer
Yeastar Cloud PBX supports Attended Transfer and Blind Transfer, users can dial the
feature code to transfer a call on their phones.
Attended Transfer
If you want to tell the new person about the caller's issue and give any background
information before transferring the call, you can choose attended transfer.
Scenario: You (B) are talking with A, then transfer the call to C.
Blind Transfer
If you don't need to consult the new person who you want to transfer the call to, you can
perform a blind transfer. Your call will be ended after you transfer the call.
Scenario: You (B) are talking with A, then transfer the call the C.
Callback
Callback feature allows callers to hang up and get called back to the PBX. Callback feature
could reduce the cost for the users who work out of the office using their own mobile
phones.
Set up Callback
Add a Callback rule and set Inbound Route destination to the Callback rule.
Note: Make sure that the Caller ID service is enabled on the callback trunk. If the PBX
cannot recognize the inbound caller ID, callback will fail.
a. Go to Settings > PBX > Call Features > Callback, click Add.
Note: Make sure that you have set up an outbound route for the trunk,
or callback will fail. If the Register-Trunk is used for Callback, make sure the
From User is configured, or callback would fail.
• Delay Before Callback: How long to wait before calling back the caller.
• Strip: Optional. How many digits will be stripped from the call in number
before the callback is placed.
Note: You do not need to configure Strip if the trunk supports calling back
with the Caller ID directly.
Admin Guide | 1 - Admin Guide | 136
For example, user 5503301 calls in the PBX, the caller ID displays 05503301.
To call back to the user, you should set strip 1 digit so that the PBX will call
back to 5503301.
• Prepend: Optional. The digits added before a callback number before the
callback is placed.
Note: You do not need to configure Prepend if the trunk supports calling
back with the Caller ID directly.
For example, user 15880232154 calls in the PBX, the caller ID displays
15880232154. To call back to the long-distance number 15880232154 through
the selected trunk, you should add digit 9 before the number. In this case, set
Prepend to 9.
a. Go to Settings > PBX > Call Control > Inbound Route, edit your inbound route.
3. Test callback.
Make an inbound call to the PBX trunk, after you hear the ring tone, hangup the call,
the PBX will call back to you.
Speed Dial
Sometimes you may just need to call someone quickly without having to look up his/her
phone number. You can by simply define a shortcut number. You can use Speed Dial
feature to place a call by pressing a reduced number of keys.
1. Go to Settings > PBX > Call Features > Speed Dial, click Add.
2. On the configuration page, configure the Speed Dial.
Admin Guide | 1 - Admin Guide | 137
Note: You need to add the outbound dial prefix before the phone number if you
want to call an external number.
Dial *99111 on your phone to call the number 15990234988. *99 is the default feature code
for speed dial.
DISA
DISA (Direct Inward System Access) allows users outside the office to make calls through
the PBX's trunks. For the staffs who are outside the office, they can use DISA feature to
take advantage of lower long-distance rates that are provided by the PBX trunks.
Set up DISA
Add a DISA and set the Inbound Route destination to DISA.
1. Add a DISA.
a. Go to Settings > PBX > Call Features > DISA, click Add.
a. Go to Settings > PBX > Call Control > Inbound Route, edit your inbound route.
3. Test DISA.
a. Make an inbound call to the PBX, you will get a dial tone after inputting a correct
DISA pin code.
b. Dial the external number that you want to call.
Intercom/Paging
The Paging and Intercom features allow you to make an announcement to a group of
extensions. The called parties do not need to pick up the handset as the audio will be
played via the phone speakers.
Admin Guide | 1 - Admin Guide | 139
1. Go to Settings > PBX > Call Features > Paging/Intercom, click Add.
• Number: Use the default or specify an number for the paging group.
• Name: Enter a name for the paging group.
• Type: Choose 1-Way Paging.
• Dial * to Answer: If this option is checked, the paging group members can dial * to
talk to the paging initiator.
Note: When a member dials *, the group announcement will terminate, and
the member who dials * can have a private call with the paging initiator.
When you dial the paging group number, the members in the group will hear the
announcement.
Note: Intercom allows all users in the group to talk and be heard by all.
1. Go to Settings > PBX > Call Features > Paging/Intercom, click Add.
• Number: Use the default or specify an number for the intercom group.
• Name: Enter a name for the intercom group.
• Type: Choose 2-Way Intercom.
• Dial * to Answer: If this option is checked, the intercom group members can dial *
to talk to the intercom initiator.
Note: When a member dials *, the group announcement will terminate, and
the member who dials * can have a private call with the intercom initiator.
When you dial the intercom group number, the members in the group will automatically join
the conference by speakerphone mode.
When you make a Multicast Paging, the PBX sends Real-time Transport Protocol (RTP)
streams to the IP phones without involving SIP signaling. The phones that will receive the
RTP streams don't need to register SIP extensions.
Note:
• The IP phone that will receive 1-way multicast paging should support Multicast Paging
feature.
• The Multicast Paging is one-way audio call.
a. Go to Settings > PBX > Call Features > Paging/Intercom, click Add.
• Number: Use the default or specify an number for the paging group.
• Name: Enter a name for the paging group.
• Type: Choose 1-Way Multicast Paging.
• IP of Multicast Channel: Enter the multicast IP address and port (e.g.
224.255.255.255:1000).
b. In the Multicast Listening section, enter the same multicast IP address and port
of the PBX.
c. Click Confirm.
When you dial the paging group number, the members in the group will automatically
answer the call into speakerphone mode.
Note: In this way, the audio is two way, both the caller and called party can hear each
other.
Call Parking
Call Parking is a feature that allows you to suspend a call for an extended period of time
and then retrieve that call from any extension.
Scenarios
During a call with clients, extension users may need to check information somewhere else.
In such case, extension users can park the call temporarily and retrieve the call by any
extensions when getting things done.
Settings Descriptions
Call Parking The default feature code is *6. During a call, dial *6 on your phone, the
system will automatically assign a parking slot number to the call.
Directed Call Parking The default feature code is *06. During a call, dial "06+parking slot number",
the call will be parked to the designated parking slot number.
Parking Extension Range Specify the range of parking extension where a call will be parked. The
default value is 6900-6999.
Parking Timeout (s) Specify the time that a call can be parked before it is retrieved by other
extensions. The default value is 60s.
Timeout Destination
If a parked call hasn't been retrieved before the parking timeout, PBX will
route the call to the designated destination.
• Original Parker:The call will be routed to the user who parks this call.
• Extension: Te call will be routed to the designated extension number.
• Extension's Voicemail: The call will be routed to the designated
extension's voicemail.
• Custom Number: The call will be routed to the designated number.
Admin Guide | 1 - Admin Guide | 144
Example:
1. During a call, dial *6 on your phone, the system will prompt you that the parking slot
number is 6900.
2. Dial 6900 on another phone to retrieve the call.
Example:
3. Click Confirm.
2. On the IP phone that you will use to retrieve a parked call, configure the Caller ID
Source.
Test call parking. When you retrieve the parked call from the IP phone, the phone screen
will display the parking slot number for 1 or 2 seconds, then display the original caller ID.
The following call flow shows how the IP phone gets caller ID when a user retrieves a
parked call.
1. A user dials parking slot number 6900 on IP phone to retrieve a parked call.
2. PBX sends a Re-INVITE packet that contains Remote-Party-ID.
3. The IP phone gets the caller ID from the Remote-Party-ID header.
Fax
Yeastar Cloud PBX supports Fax over IP. You can send or receive a fax via a physical fax
machine or receive a fax over the network.
Admin Guide | 1 - Admin Guide | 147
PSTN fax terminals traditionally use the T.30 protocol to send analog data. To exchange
analog fax data with a PSTN terminal over the Internet, the T.38 protocol first converts
analog data into digital data. The protocol then converts the data back to analog on the
receiving end if the receiver is a PSTN fax terminal.
If this option is enabled, no T.38 attributes will be added in re-invite SDP packet.
• Error Correction
Admin Guide | 1 - Admin Guide | 148
Fax to Email
Fax to Email feature helps you receive faxes on your smart phone or computer. Yeastar
Cloud PBX will convert the received fax and forward it to an extension user's email.
Make sure the PBX system email works, or the PBX cannot forward the received faxes
to an extension user's email.
2. Check if the extension user's email is configured.
• If you want to receive fax via fax detection, set the Destination to IVR, and set Fax
Destination to Fax to Email.
• If you want to receive fax through a private trunk, set the Destination to Fax to
Email.
Admin Guide | 1 - Admin Guide | 149
1. Go to Settings > PBX > Call Control > Inbound Route, click Add.
2. On the configuration page, select the dedicated trunk to the Selected box.
Note: The selected trunk will be used to receive faxes only, users cannot make
audio calls through the selected trunk.
Users can dial the number of the dedicated trunk, then send fax to the PBX.
Admin Guide | 1 - Admin Guide | 150
1. Go to Settings > PBX > Call Control > Inbound Route, configure your inbound route.
1. Go to Settings > System > Email > Email Template, click beside Fax to Email.
On the Edit Template page, the description of variables and the default email contents
are displayed.
Admin Guide | 1 - Admin Guide | 151
PIN List
PIN List is used to manage lists of PINs (numerical passwords) that can be used to access
restricted features such as outbound route and DISA.
1. Go to Settings > PBX > Call Features, click More to display more call features.
2. Click PIN List.
3. On the Add PIN List page, configure the following settings:
Admin Guide | 1 - Admin Guide | 152
Blacklist/Whitelist
Yeastar Cloud PBX allows you to blacklist and whitelist IP addresses. This article briefly
introduces the definitions and basic settings of blacklist and whitelist, and provides related
configuration examples.
• Blacklist
The blacklist is used to filter phone numbers. If a phone number is added to the
blacklist, the system blocks incoming or outgoing calls for the phone number.
• Whitelist
The whitelist is used to add trusted phone numbers. If a phone number is added to the
whitelist, the system allows incoming or outgoing calls for the phone number.
Blacklist/Whitelist Setting
Yeastar Cloud PBX supports system blacklist/whitelist and personal blacklist/whitelist. You
can set a global system blacklist/whitelist to apply to all extensions. Extension users can
also log in the PBX web interface by their accounts, and set blacklist/whitelist for their own
extensions.
Log in the PBX web interface as an administrator, and go to Settings > PBX > Call
Features > Blacklist/Whitelist to set blacklist and whitelist.
Log in the PBX web interface by extension accounts, the extension users can view the
system blacklist and whitelist that is set by the administrator.
Note: Extension users can add personal blacklist and whitelist for their extensions
according to their needs.
• Blacklist/Whitelist Priority
Priority of blacklist/whitelist: system whitelist > system blacklist> personal whitelist >
personal blacklist.
Blacklist Example
We demonstrate a few examples of blacklist as follows.
Prohibit inbound calls from external numbers
For example, 10086 and 1008611 are not allowed to call in PBX. You can add the two
numbers to blacklist as follows.
For example, 10086 and 1008611 are not allowed to call in PBX, and all extensions on PBX
are not allowed to call out 10086 and 1008611.
Admin Guide | 1 - Admin Guide | 155
Note: You can add an extension group in advance for quick selection.
For example, prohibit extension group (sales) from calling R&D team (all extension
numbers are in the format 5XXX).
Whitelist Example
The whitelist has a higher priority than the blacklist, so you can use whitelist to filter trusted
phone numbers from blacklist, and allow inbound/outbound calls for the phone numbers.
For example, assume you've added 5XXX (extension numbers of R&D team) to blacklist to
prohibit sales from calling R&D teams, but you want to allow sales to call extension 5001. In
this case, you can add 5001 to whitelist as follows.
Admin Guide | 1 - Admin Guide | 157
Call Recording
For more detail of One Touch Recording, refer to One Touch Record.
Auto Recording
Auto Recording is a feature that enables the PBX to automatically record
internal calls, external calls, and conference calls.
You can change the code via Settings > PBX > General > Feature Code > One Touch
Record.
When an extension user dial *1 to record the call, PBX will play the prompt to the other
party.
3. In the One Touch Recording End Prompt field, select a custom prompt.
When an extension user dial *1 to stop recording the call, PBX will play the prompt to
the other party.
4. Click Save and Apply.
Auto Recording
Auto Recording is a feature that enables the PBX to automatically record internal calls,
external calls, and conference calls.
1. Go to Settings > PBX > Recording, check the option Enable Recording of Internal
Calls.
2. Set the recording announcement for internal calls.
Admin Guide | 1 - Admin Guide | 159
a. Upload a custom prompt to the PBX or record a custom prompt on the PBX.
b. Set Internal Call Being Recorded Prompt to your custom prompt.
The PBX will notify the called party that the call is being recorded.
3. In the Record Extensions section, select extensions to the Selected box.
1. Go to Settings > PBX > Recording, set the recording announcement for external calls.
Admin Guide | 1 - Admin Guide | 160
a. Upload a custom prompt to the PBX or record a custom prompt on the PBX.
b. Set custom prompt for outbound calls, inbound calls, and callback calls.
• Outbound Calls Being Recorded Prompt: If the external call (outbound) has
enabled call recording, this prompt will notify the external party that the call is
being recorded.
• Inbound Calls Recorded Prompt: If the external call (inbound) has enabled
call recording, this prompt will notify the external party that the call is being
recorded.
• Callback Calls Being Recorded Prompt: If the external call (callback) has
enabled call recording, this prompt will notify the external party that the call is
being recorded.
2. In the Record Trunks section, select trunks to the Selected box.
Note: If you have selected extensions in the Record Extensions section, the
extensions' calls will be recorded no matter which trunks are used.
Admin Guide | 1 - Admin Guide | 161
When you play the recording files, the paused part will be absent.
The default feature code to pause and resume Auto Recording is *00.
You can change the code in Settings > PBX > General > Feature Code > Auto
Recording Switch.
Admin Guide | 1 - Admin Guide | 162
During an external call, the extension user can dial feature code to pause and resume call
recording.
Related tasks
Monitor Auto Recording Status
3. Click Confirm.
Admin Guide | 1 - Admin Guide | 163
When the monitored extension is being recorded, the BLF LED will turn red.
When the monitored extension is not in a call or the Call Recording is paused, the BLF LED
will turn green.
Related tasks
Pause/Resume Auto Recording
1. Go to Settings > Event Center > Event Settings > System, enable Notification and
Record for Auto Cleanup Reminder.
• Record: The event of Recording Auto Cleanup will be recorded in Event Log.
• Notification: When the recording capacity is about to be reached, the PBX will
send notification email to the Notification Contacts.
2. To modify the email template, click .
2. In the User drop-down list, select a user whom you want to grand permissions to.
4. Click CDR and Recordings tab, and grant Recording Permission to the user.
5. Set which extensions' recording files are allowed to play, download or delete.
Admin Guide | 1 - Admin Guide | 166
• All Extension: The user can manage all the extensions' recording files.
• Selected Extensions: The user can manage only the selected extensions'
recording files.
6. Click Save.
When the user log in the PBX User Portal, he/she will have permission to manage
recording files.
Voice Prompts
System Prompt
The default system prompt language is English. You can change the global system prompt,
and if an extension user works in a foreign language, you can set a different system prompt
for the user.
3. On the Download Online Prompt page, select your desired system prompt, click to
download the file.
After the file is downloaded, you can see the system prompt in Prompt List.
Admin Guide | 1 - Admin Guide | 167
2. In the Upload System Prompts section, click Browse to choose the system prompt
file.
Note: Upload the .tar file that is provided by Yeastar, or the system prompt won't
work.
3. Click Upload.
If the file is uploaded successfully, you can see the prompt file in the Prompt List.
c. On the Download Online Prompt page, select your desired system prompt, click
to download the file.
After the file is downloaded, you can see the system prompt in Prompt List.
2. Go to Settings > PBX > Extensions, select the desire extension, click .
The PBX has a default MoH playlist, you can add MoH playlists and upload music files to
the PBX.
Note: The default MoH files are distributed under the Creative Commons Attribution-
ShareAlike3.0 license through explicit permission from their authors.
1. Go to Settings > PBX > Voice Prompts > Music on Hold, click Create New Playlist.
2. On the configuration page, set the playlist name and the playlist order, click Save.
Admin Guide | 1 - Admin Guide | 170
4. Click Browse to choose an audio file from your local PC, then click Upload.
Note: The uploaded file should meet the audio file requirements.
Related concepts
Requirements of Custom Audio Files
Related tasks
Change the MoH Playlist
Convert Audio Files via WavePad
Convert Audio Files Online
Admin Guide | 1 - Admin Guide | 171
The PBX will play the select MoH playlist when a user is held in a call.
Related tasks
Add a Custom MoH Playlist
Custom Prompt
The default voice prompts and announcements in the system are suitable for almost every
situation.
However, you may want to use your own voice prompt to make it more meaningful and
suitable for your case. In this case, you need to upload a custom prompt to the system or
record a new prompt and apply it to the place you want to change.
Option Requirement
Option Requirement
1. Go to Settings > PBX > Voice Prompts > Custom Prompts, click Upload.
Note: The uploaded file should meet the audio file requirements.
After the file is uploaded, you can see the file on the Custom Prompts page.
1. Go to Settings > PBX > Voice Prompts > Custom Prompts, click Record New.
2. On the configuration page, set the prompt name and select an extension to record the
prompt.
Admin Guide | 1 - Admin Guide | 173
3. Click Save.
The selected extension will ring.
4. Record your prompt on the phone. When done, press the # key or hang up.
5. Refresh the Custom Prompts page, you can see the saved prompt file.
You can click to play the prompt, and decide whether to save it or not. If you are not
satisfied with the prompt, click to record again.
Related tasks
Play a Custom Prompt
Note: We recommend that you play your custom prompts before you apply the custom
prompts to IVR, MoH, or other places.
4. Click Play.
The selected extension will ring.
Related tasks
Upload a Custom Prompt
Record a Custom Prompt
4. For the .wav type, set the encoder options according to the requirements of custom
audio files, click OK.
Admin Guide | 1 - Admin Guide | 175
Related tasks
Convert Audio Files Online
1. Visit g711.org.
• Invalid Phone Number Prompt: The PBX will play the prompt when the dialed
number is invalid.
• Busy Line Prompt: The PBX will play the prompt when the trunk used is busy.
• Dial Failure Prompt: The PBX will play the prompt if no trunk is available to call
out.
Admin Guide | 1 - Admin Guide | 177
System Management
System Preference
Configure the preferences settings that will be applied globally to the system.
Go to Settings > PBX > General > Preferences to configure the system preferences.
General Preference
Table 2. Descriptions of General Preference
Option Description
Note:
Attended Transfer Caller ID The Caller ID that will be displayed on the recipient's phone.
For example, Phone A (transferee) calls Phone B (transfer),
and Phone B transfers the call to Phone C (recipient). If set to
Transfer, the Caller ID displayed will be Phone B's number; if
set to Transferee, Phone A's number will be displayed.
Flash Event Set which event will be triggered by pressing the hook flash:
• 3-way Calling
• Call Transfer
Virtual Ring Back Tone Once enabled, when the caller calls out with cellular trunks,
the caller will hear the virtual ring back tone generated by the
system before the callee answers the call.
Admin Guide | 1 - Admin Guide | 178
Option Description
Distinctive Caller ID When the incoming call is routed from Ring Group, Queue or
IVR, the Caller ID would display where it comes from.
Match Route Permission When Seizing If checked, when users seize a line to place an outbound
a Line call, the call will succeed only when the route permission is
matched.
FXO Mode
Select a mode to set the On Hook Speed, Ringer Impedance,
Ringer Threshold, Current Limiting, TIP/RING voltage,
adjustment, Minimum Operational Loop Current, and AC
Impedance as predefined for your country's analog line
characteristics.
The default setting is FCC for USA.
DTMF Duration Set the duration of a DTMF tone on the FXO trunk.
DTMF Gap Set the interval between each DTMF tone on the FXO trunk.
Extension Preference
Below are default extension ranges. You can change the extension range according to your
needs.
Note: PBX treats Ring Group, Paging Group, Conference, Queue as extensions.
Extension users can dial the extension numbers to reach them directly.
Feature Code
Feature codes are used to enable and disable certain features available in the Yeastar
Cloud PBX. Extension users can dial feature codes on their phones to use that particular
feature.
Admin Guide | 1 - Admin Guide | 179
Go to Settings > PBX > General > Feature Code to view or change the feature code
settings.
• Feature Code Digit Timeout: The timeout to input next digit. The default is 4000 ms.
Recording
Call Forwarding
Voicemail
Check Voicemail *2
Transfer
Attended Transfer *3
DND
Call Pickup
Call Pickup *4
Time Condition
Intercom
Admin Guide | 1 - Admin Guide | 180
Recording
Intercom *5
Call Monitor
Listen *90
Whisper *91
Barge-in *92
Call Parking
Call Parking *6
SIP Settings
The SIP configurations require professional knowledge of SIP protocol, incorrect
configuration may cause calling issues on the SIP extensions and SIP trunks.
Go to Settings > PBX > General > SIP to configure the SIP settings.
Option Description
UDP Port UDP Port used for SIP registrations. The default is 5060.
TCP Port TCP Port used for SIP registrations. The default is 5060.
Registration Timers
Max Registration Time Maximum duration (in seconds) of incoming registrations and
subscriptions. The default is 3600 seconds.
Min Registration Time Minimum duration (in seconds) of incoming registration and
subscriptions. The default is 60 seconds.
Qualify Frequency How often to send SIP OPTIONS packet to SIP device to check if the
device is up. The default is 30 per second.
Registration Attempts The number of registration attempts before giving up (0 for no limit).
Default Incoming/Outgoing
Registration Time Default duration (in seconds) of incoming/outgoing registration. The
default is 120 seconds.
Option Description
Subscription Timer
Max Subscription Time Maximum duration (in seconds) of incoming subscriptions. The default is
3600 seconds.
Min Subscription Time Minimum duration (in seconds) of incoming subscriptions. The default is
90 seconds.
SIP Codec
A codec is a compression or decompression algorithm that used in the transmission of
voice packets over a network or the Internet.
Codec Selection
Yeastar Cloud PBX supports G711 a-law, u-law, GSM, H261, H263, H263P,
H264, SPEEX, G722, G726, ADPCM, G729A, MPEG4, and iLBC.
Note:
• You need to choose at least one same code on the PBX and on your
phones, or there may be a problem of the call.
• If you want to make video calls, you need to select H261, H263, H263P,
H264 or MPEG4 codec on the PBX and on your phones.
iLBC Settings
The iLBC codec supports two modes: 20ms and 30ms frame length modes,
To get better voice quality, you need to set the iLBC mode according to your
SIP endpoints.
Note: Linkus uses iLBC 20ms mode. When Linkus is enabled, this option is
switched to 20ms mode automatically.
TLS Settings
Option Description
TLS Port TLS Port used for SIP registrations. The default is 5061.
TLS Client Method Specify protocol for outbound client connections. The default is sslv2.
Admin Guide | 1 - Admin Guide | 182
Session Timer
A periodic refreshing of a SIP session that allows both the user agent and proxy to
determine if the SIP session is still active.
Option Description
Session-timers
Choose the session timers mode on the system:
Min-SE The min refresh interval in seconds, it must not be less than 90.
Qos
QoS (Quality of Service) is a major issue in VoIP implementations. The issue is how to
guarantee that packet traffic for a voice or other media connection will not be delayed or
dropped due interference from other lower priority traffic.
When the network capacity is insufficient, QoS could provide priority to users by setting the
value.
Option Description
T.38
Adjust T.38 settings if T.38 Fax don't work.
Option Description
No T.38 Attributes in Re-invite SDP If this option is selected, SDP re-invite packet will not contain T.38
attributes.
Admin Guide | 1 - Admin Guide | 183
Option Description
T.38 Max BitRate Adjust the max BitRate for T.38 fax.
Option Description
Option Description
Inband Progress This Inband Progress setting applies to all the extensions.
Get Caller ID From Decide the system will retrieve Caller ID from which header field.
Get DID From Decide the system will retrieve DID from which header field.
Security
Blocked IP Address
The PBX will block an IP address for too many failed login attempts, too many failed
registration attempts, or too many failed authentications for Auto Provisioning.
The blocked IP addresses would be listed in the Blocked IP Address table. If a trusted IP
address was blocked by the PBX, you can go to Settings > System > Security > IP Auto
Defense > Blocked IP Address to delete the IP address.
Service
All the PBX service statuses and ports are displayed on the security Service page.
Admin Guide | 1 - Admin Guide | 185
Go to Settings > System > Security > Service to configure the service settings.
Option Description
Auto Logout Time (min) After the set time of inactivity, the session will automatically log out. The
default time is 15 minutes.
SIP UDP Port SIP registration port. The default SIP UDP port is 5060.
Enable SIP TCP Whether to enable SIP TCP or not. The default port is 5060.
Enable SIP TLS Whether to enable SIP TLS or not. The default port is 5061.
User Permission
By default, the extension users can log in the system and check their own settings and
CDR. You can set different permission to the users according to their roles and duty.
Super Admin has the highest privilege. The super administrator can access all pages on S-
Series Web and make all the configurations on the system.
• Username: admin
• Username: The extension number or the email address of the extension user.
Note:
• Administrator and Custom User can have the same permission. The different
between the two role type:
Scenarios
In the following scenarios, you may need to add permissions for the extension users
according to their roles.
• For an HR, he/she may need the permission to add extension, configure extension's
outbound route privilege when there are new staffs.
• For a supervisor, he/she will have permission to check the CDR and recordings, and
have no permission to configure the system or other extensions.
Procedures
1. Log in the PBX web interface by the super admin account, go to Settings > System >
User Permission, click Add.
2. On the configuration page, select the User.
3. Set the Set Privilege As.
• Administrator: All the permissions are enabled for the user by default.
• Custom User: No permission is enabled for the user by default.
4. Click the Settings, CDR and Recordings, Monitor, Application, Contacts, and
Others tabs, and check or uncheck the relevant options for the user.
5. Click Save and Apply.
Results: When the user logs in the PBX web interface by the extension user account,
he/she can access the permitted configuration page.
On the Date & Time configuration page, you can see the current time of the PBX.
You can set the PBX time to be synchronized with a NTP server or set the time manually.
Admin Guide | 1 - Admin Guide | 187
Email
The system email can be used to reset password, send voicemail to email, send alert event
emails, and send fax to email. To make these features work, you need to set up the PBX
system email.
• STARTTLS: If you enable TLS, the STARTTLS is enabled by default . If the mail
server doesn't support STARTTLS, do not select this option.
2. Click Test to check if the email works.
3. Click Save to save the email settings.
Auto Cleanup
Auto Cleanup is a feature that can auto clean your CDR, logs, voicemails, one-touch
recordings periodically.
Max Number of CDR Set the maximum number of CDR that should be retained. The old CDR
will be deleted when the threshold is reached.
Admin Guide | 1 - Admin Guide | 189
CDR Preservation Duration Set the maximum number of days that CDR should be retained.
Max Number of Files Set the maximum number of voicemail and one touch recording files
that should be retained. The old CDR will be deleted when the threshold
is reached.
Files Preservation Duration Set the maximum number of minutes that voicemails and one touch
recordings should be retained.
Max Size of Total Logs Limit the total size of pbxlog files in syslog.
Event Center
You can set the PBX to send notifications when specific events or errors occur, notifying you
via email.
For example, the system can automatically send a notification when the network connection
is lost, VoIP trunk registration is failed, storage volume is running out of space, or the
administrator password is changed.
Event Settings
Go to Settings > Event Center > Event Settings to configure the event settings.
• Record
indicates that Record function is enabled. When the event occurs, the PBX will
record the event in Event Log.
indicates that Record function is disabled. When the event occurs, the PBX will
NOT record the event in Event Log.
• Notification
Admin Guide | 1 - Admin Guide | 190
indicates that Notification function is enabled. When the event occurs, the PBX will
send notification to the Notification Contacts.
indicates that Notification function is disabled. When the event occurs, the PBX will
NOT send notification to the Notification Contacts.
• Edit Notification
Event Log
Go to Settings > Event Center > Event Log to search and check event logs.
2. On the configuration page, choose a contact and set the notification method.
Admin Guide | 1 - Admin Guide | 191
◦ Email: The PBX will send notifications to the email address of the contact.
◦ Call Extension: The PBX will call the extension number of the contact when
the event occurs.
◦ Call Mobile: The PBX will call the mobile number of the contact when the
event occurs.
• Email: If you choose Notification Mode to Email, you need to set the email
address of the contact.
Remote Management
Yeastar Remote Management provides an affordable, low maintenance solution for easily
deploying Yeastar VoIP PBX and VoIP gateways across multiple locations, reducing
complexity and providing deep visibility and control.
Compatibility
The following Yeastar products supports Remote Management feature:
API
Yeastar Cloud PBX provides API interfaces for you to integrate a third-party software or
device.
Compatibility
API feature is supported on Yeastar Cloud PBX v81.4.0.8 or later.
API Guide
For more information of API, refer to Yeastar Cloud PBX- API guide.
In the API guide, we introduces how to enable and configure API on Yeastar Cloud PBX,
and provides API references.
Maintenance
Maintenance gives you access to upgrade PBX firmware, check logs and troubleshooting.
Upgrade Firmware
Note:
Admin Guide | 1 - Admin Guide | 193
• Back up the PBX configurations before you start to update the PBX firmware.
• If “Reset configuration to Factory Defaults” is enabled, the system will reset to factory
default settings after upgrading.
• When update the firmware, please don’t turn off the power. Or the system will get
damaged.
Related tasks
Create a Backup File
Upgrade Firmware
You can check for new version immediately or schedule automatic firmware check, if the
PBX has a new released version, upgrade the PBX firmware with just one click.
Note: Make sure that the PBX can access the Internet, or the upgrade will fail.
If a new version is detected, you can click New check the release notes and decide
whether to upgrade or not.
This option notifies you that there are updates available. It requires user interaction
to download them and install them.
•
3. Click Save and Apply.
If a new version is detected, you can click New check the release notes and decide
whether to upgrade or not.
Note:
• For PBX version before 81.5.0.7, you can not back up one-touch recording files and
voicemail files.
• For PBX version 81.5.0.7 or later, you can back up one-touch recording files and
voicemail files.
5. Click Save.
The created backup file will appear on the Backup and Restore page.
Note: The file format is .bak and the file name should not contain special characters.
4. Click Upload.
The uploaded backup file will appear on the Backup and Restore page.
Note:
• You cannot restore a backup file that is downloaded from a different PBX model.
• If a backup file is created from a newer version of PBX, you cannot restore this backup
file. For example, restore a backup file (v30.7.0.35) to PBX (v30.6.0.16) would not
work.
• You can restore a backup file that is created from a older version of PBX. For example,
restore a backup file (v30.6.0.16) to PBX(v30.7.0.35) would work.
Note: When the PBX is rebooting, all the on-going calls will be terminated.
4. Click Reset.
System Log
The PBX automatically trace the PBX information, notices, warnings, errors, debug logs,
and web logs, then generate log files. You can download the system logs on the PBX web
interface, and check the logs.
Go to Maintenance > System Log to trace real-time logs or download the generated
system logs.
Admin Guide | 1 - Admin Guide | 198
System Log
The PBX generates system logs everyday. The system logs are compressed into a tar file.
You can check the system logs on the System Log page.
Click to download the log file and open the log file by Notepad++ or other editor
software to check the logs.
Operation Log
The PBX records all the users' operations, and keep the logs in Operation Log.
Go to Maintenance > Operation Log to search and check the operation logs.
Admin Guide | 1 - Admin Guide | 199
Troubleshooting
Yeastar Cloud PBXEthernet Capture Tool, IP Ping and Traceroute can be used to debug
and capture packets.
b. On the Time Settings dialog box, select the time period in the Timeout drop-down
menu, click OK.
Note: When the connection times out, the SSH tunnel will be closed, you will
not be able to access PBX via SSH.
3. To get more logs in the window, set the Lines of scrollback to a larger value, click
Apply.
Admin Guide | 1 - Admin Guide | 201
Tip: After copying the SSH password, right click on the Putty interface to paste
password.
2. Click Start.
The PBX will start to capture the Ethernet packet. During this time, you should
duplicate the problem of your VoIP trunks or extensions.
Decompress the .tarfile and use Wireshark software to open the packet file.
Admin Guide | 1 - Admin Guide | 202
Ping IP Address
A ping utility sends test messages from the local client to a remote target over the TCP/IP
network connection. You can use IP Ping tool to test if the PBX can access the target IP
address.
Traceroute
Traceroute is a common diagnostic tool for displaying the route (path) and measuring transit
delays of packets across a network.
PBX Monitor
The PBX monitors the status of Trunks, Extensions, Concurrent Call, Conference.
You can log in the PBX web interface, go to PBX Monitor to check the real-time status of
your trunks, extensions, and conferences.
Registered
Registering
• Unreachable
• Registration failed, caused by:
◦ wrong password
◦ wrong authentication name
◦ wrong user name
◦ transport type inconsistent
Concurrent Call
Check the maximum supported concurrent calls and the real-time concurrent calls on the
PBX.
Admin Guide | 1 - Admin Guide | 204
Monitor Conference
Check how many conferences are created on the PBX, and monitor the status of the
conferences.
Resource Monitor
Monitor the CPU usage, memory usage, disk utilization and network flow.
You can go to Resource Monitor to check the information or click the shortcut icon at the
right-top corner.
Admin Guide | 1 - Admin Guide | 205
Information
Check the basic information of the PBX.
• Product
• Serial Number
• Hardware Version
• Software Version
• System Time: The current time on the PBX.
• Uptime: The system up time since the last reboot.
• Extensions/Max Extensions: The number of added extensions/Maximum number of
extensions allowed to be added
Network
Check the status of local network, cellular network, and VPN network.
Storage Usage
Check the usage of local storage in the PBX.
Recording Usage
Searching Criteria
You can search CDR and recordings by the following criteria:
• Time: Set the start date and the end date to filter the call logs that are in the date
duration.
• Call From: The number or the name of the caller.
• Call To: The number or the name of the callee.
• Call Duration: The time between the call started and the call ended. Enter a value to
filter the call logs that have call duration equal or greater than this value.
• Talk Duration: The time between the call answered and the call ended. Enter a value
to filter the call logs that have talk duration equal or greater than this value.
• Status: Call status, including "answered", "no answered", "busy", "failed", and "has
voicemail".
• Communication Type: Communication type, including "internal", "inbound",
"outbound", "callback", "PBX warning call", "transfer", and "multisite interconnect".
• Include Recording Files: Check the option if you want to filter the calls that had been
recorded.
2. Set the Time to filter the call logs during the date duration.
3. If you want to search recording files, check the option Include Recording Files.
5. Click Search.
The filtered call logs will display.
Admin Guide | 1 - Admin Guide | 207
2. Set the Time to filter the call logs during the date duration.
6. Click Search.
The call logs that match the fuzzy searching will display.