Embed Size (px)
Citation preview
深圳星昊通科技有限公司 www.hiastar.com
1
FreePBX-12 中文用户使用指南
作者:James.zhu，邮箱：[email protected] [email protected]
获得开源通信技术信息，请关注微信公众号：asterisk-cn
www.freesip.org 论坛免费技术支持，开源通信技术 wiki：www.freepbx.org.cn
深圳星昊通科技有限公司 www.hiastar.com
2
FreePBX/Asterisk/FreeSWITCH 硬件整体解决方案
Asterisk/FreeSWITCH 语音板卡系列 VEGA 数字 E1/模拟网关系列（支持许可证端口升
级,内置 PROXY 功能，支持 SIP/PSTN 逃生）
DIY 网关（可支持一体机或独立安装，
最大 32E1， 网关界面+语音卡）
FreePBX 一体机设备（支持不同并发处理）
SIP 终端话机 FreePBX 商业模块（zulu 终端，CRM 对接/弹屏等）
PortSIP WebRTC 网关
Sangoma 边界回话控制器（5-4000 呼叫）
深圳星昊通科技有限公司 www.hiastar.com
3
目录
如何安装 FreePBX ISO 版本 ..................................................... 32
在 Ubuntu 12.04 环境下安装 FreePBX ............................................ 39
系统初始设置 .......................................................... 40
安装 Google 语音包，中国用户如果不使用此应用模块，可以忽略此步骤 ....... 41
安装配置 Asterisk ...................................................... 41
安装配置 FreePBX ...................................................... 42
启动 FreePBX .......................................................... 44
在 Centos 6.5 安装 FreePBX 12 ................................................. 45
Install Centos 6.5 ....................................................... 45
Initial System Setup ................................................. 46
Install Dependencies for Google Voice (If needed/wanted) ............... 47
Add the Asterisk User ................................................. 48
添加一个 Asterisk 用户 ................................................. 48
Install and Configure Asterisk ........................................ 48
Compile and install pjproject ......................................... 49
Compile and Install jansson ........................................... 49
Compile and install Asterisk .......................................... 49
Install Asterisk-Extra-Sounds ......................................... 51
Install and Configure FreePBX ......................................... 51
Start FreePBX ......................................................... 53
Install and Setup Commercial Modules................................... 53
安装 FreePBX Distro 后，需要设置的设置 ........................................ 54
安装完 FreePBX 以后，几个参数需要设置：.................................... 54
Login to the PBX Graphical User Interface ("GUI"): ............................ 54
Set a Static IP Address and Configure DNS..................................... 55
Configure Asterisk SIP Settings .............................................. 56
Configure E-Mail Settings .................................................... 56
Configure Email Server .................................................... 56
Configure E-Mail Alert Destination Addresses .............................. 56
了解 FreePBX 主要模块 ......................................................... 58
Configure Backups ............................................................ 60
Consider the Paid Modules .................................................... 61
Administrators 模块用户指南 .................................................. 61
介绍 ..................................................................... 61
登录 ..................................................................... 61
创建用户 ................................................................. 62
Save User: ............................................................ 64
Announcements 语音播报模块使用指南 ........................................... 64
总览 ..................................................................... 64
登录 ..................................................................... 65
创建一个语音播报流程 ...................................................... 65
Description ........................................................... 65
深圳星昊通科技有限公司 www.hiastar.com
4
Repeat ................................................................ 65
Return to IVR ......................................................... 66
Don't Answer Channel .................................................. 66
Destination after Playback ............................................ 66
Save .................................................................. 66
Editing/Deleting an announcement .......................................... 66
Asterisk CLI 模块 ........................................................... 67
Asterisk CLI 模块的作用 ................................................... 67
如何获得 Asterisk CLI 模块 ................................................. 67
使用 ..................................................................... 67
通过系统控制台: ........................................................... 67
通过浏览器:............................................................... 68
用户可以通过浏览器，登录界面，执行 asterisk CLI 命令来查看 asterisk 状态信息。
...................................................................... 68
Asterisk Info 模块使用指南 ................................................... 68
总览 ..................................................................... 68
登录 ..................................................................... 68
Reports .................................................................. 68
总结 .................................................................. 68
Registries ............................................................ 69
Peers ................................................................. 69
SIP Info .............................................................. 70
IAX Info .............................................................. 70
Conferences Report .................................................... 70
Voicemail Users Report ................................................ 70
Queues Report ......................................................... 70
Asterisk 系统日志文件 ........................................................ 71
Asterisk Logfiles ......................................................... 71
Asterisk Managers 用户使用指南 ............................................... 72
总览 ..................................................................... 72
登录 ..................................................................... 72
添加 Manager.............................................................. 72
Manager 信息 .......................................................... 72
Rights ................................................................ 73
保存 ..................................................................... 74
Asterisk 电话薄模块使用指南 .................................................. 74
介绍和总览 ............................................................... 75
登录 ..................................................................... 75
创建一个电话薄记录 ........................................................ 76
Name .................................................................. 76
Number ................................................................ 76
Speed dial code ....................................................... 76
Set Speed Dial ........................................................ 76
Save your changes ..................................................... 76
深圳星昊通科技有限公司 www.hiastar.com
5
Import from CSV ........................................................... 77
File .................................................................. 77
Asterisk REST 接口用户使用指南 ............................................... 78
介绍 ..................................................................... 78
登录 ..................................................................... 78
首先运行 ................................................................. 78
Enable the Asterisk REST Interface .................................... 79
Pretty Print JSON Responses ........................................... 79
添加用户 ................................................................. 79
REST Interface User Name .............................................. 79
REST Interface User Password .......................................... 79
Password Type ......................................................... 80
Read Only ............................................................. 80
黑名单模块用户使用指南 ....................................................... 80
o Overview .............................................................. 80
o Logging in ............................................................ 80
o Blacklisting a number ................................................. 80
o Number ................................................................ 80
o Description ........................................................... 80
o Submit Changes ........................................................ 80
o Blocking Unknown Caller ID Calls ...................................... 80
o Feature Codes to Block Numbers ........................................ 80
总览 ..................................................................... 80
登录 ..................................................................... 80
过滤黑名单中的号码 ........................................................ 81
Number ................................................................ 81
Description ........................................................... 81
Submit Changes ........................................................ 81
过滤未知来电呼叫 .......................................................... 81
使用快捷键过滤号码 ........................................................ 81
Bulk DID 模块用户使用指南 .................................................... 82
总览 ..................................................................... 82
登录 ..................................................................... 82
导出 DID 号码............................................................. 82
导入 DID .................................................................. 85
总览 ..................................................................... 86
登录 ..................................................................... 86
导出分机 ................................................................. 86
分机批处理的 CSV 文件列 ................................................ 86
导入分机 ................................................................ 115
呼叫前转用户使用指南 ........................................................ 116
o Overview ............................................................. 116
o Feature codes ........................................................ 116
o Conditions ........................................................... 116
深圳星昊通科技有限公司 www.hiastar.com
6
o Busy ................................................................. 116
o No Answer/Unavailable ................................................ 116
o ALL (unconditional) .................................................. 116
o Usage from phone by user ............................................. 116
o Usage from remote phone .............................................. 116
o Settings ............................................................. 116
o Call Forward Ring Time ............................................... 116
o Call Forward Ringtimer Default ....................................... 116
总览 .................................................................... 116
功能快捷键 .............................................................. 117
条件 .................................................................... 117
Busy ................................................................. 117
No Answer/Unavailable ................................................ 117
ALL (unconditional) .................................................. 117
用户通过第三方远程终端操作的方法 ......................................... 118
Settings ................................................................ 118
Call Forward Ring Time ............................................... 118
Call Forward Ringtimer Default ....................................... 119
Call History - UCP .......................................................... 119
Overview ................................................................ 119
Usage ................................................................... 119
总览 ........................................................................ 119
Usage ....................................................................... 119
捕捉 TCM 信息方法- TCPDumps .................................................. 121
证书管理员使用指南 .......................................................... 121
o Overview ............................................................. 121
o Logging In ........................................................... 121
o Managing Certificate Authority (CA)................................... 121
o Upload a new Certificate Authority ................................... 121
o Host Name ............................................................ 121
o Organization Name .................................................... 121
o Passphrase ........................................................... 122
o Save Passphrase ...................................................... 122
o Private Key .......................................................... 122
o Certificate .......................................................... 122
o Generate a new Certificate Authority.................................. 122
o Host Name ............................................................ 122
o Organization Name .................................................... 122
o Passphrase ........................................................... 122
o Save Passphrase ...................................................... 122
o New Certificate ...................................................... 122
o Generate a New Certificate ........................................... 122
o Certificate authority o
122
深圳星昊通科技有限公司 www.hiastar.com
7
o Name ................................................................. 122
o Description .......................................................... 122
o Upload New Certificate ............................................... 122
o Name ................................................................. 122
o Description .......................................................... 122
o Private Key .......................................................... 122
o Certificate .......................................................... 122
o Editing a Certificate ................................................ 122
o Managing the Certificate Authority ................................... 122
总览 .................................................................... 122
Managing Certificate Authority (CA) ...................................... 122
Upload a new Certificate Authority ................................... 123
Generate a new Certificate Authority.................................. 124
Generate a New Certificate ........................................... 125
Upload New Certificate ............................................... 125
Editing a Certificate .................................................... 127
Managing the Certificate Authority ....................................... 127
会议模块用户指南 ............................................................ 128
总览 .................................................................... 128
登录 .................................................................... 128
Creating a Conference Room ............................................... 129
Conference Number .................................................... 129
Conference Name ...................................................... 129
User PIN ............................................................. 129
Admin PIN ............................................................ 129
Join Message ......................................................... 130
Talker Detection ..................................................... 131
Quiet Mode ........................................................... 131
User Count ........................................................... 131
User Join/Leave ...................................................... 131
Music on Hold ........................................................ 131
Music on Hold Class .................................................. 131
Allow Menu ........................................................... 131
Record Conference .................................................... 131
Maximum Participants ................................................. 132
Mute on Join ......................................................... 132
OTHER Options ........................................................ 132
如果开启 Meetme 菜单或者按 *键访问菜单 ................................ 132
如何对接两个 FreePBX ......................................................... 133
1. Configure an IAX2 Trunk on System1 ....................................... 133
2. 配置系统 1 中的呼出路由 ................................................... 135
3. 配置系统 2 的 IAX2 中继 ................................................... 136
4. 在系统 2 中设置一个呼出路由 ............................................... 137
是否需要设置端口转发? ....................................................... 139
深圳星昊通科技有限公司 www.hiastar.com
8
如何对接两个以上的系统? ..................................................... 139
为什么不使用 SIP 中继? ....................................................... 140
Contact Manager 模块 ........................................................ 140
总览 .................................................................... 140
Adding a New Group ....................................................... 141
Internal Groups .......................................................... 141
External Groups .......................................................... 143
User Manager............................................................. 144
Directory 模块用户使用指南 .................................................. 146
介绍 .................................................................... 146
Accessing the Directory Module ........................................... 147
Adding a Directory ....................................................... 147
Directory Name ....................................................... 147
Directory Description ................................................ 147
CallerID Name Prefix ................................................. 147
Alert Info ........................................................... 148
Announcement ......................................................... 148
Invalid Retries ...................................................... 148
Invalid Retry Recording .............................................. 148
Invalid Recording .................................................... 148
Invalid Destination .................................................. 148
Return to IVR ........................................................ 149
Announce Extension ................................................... 149
Adding Directory Entries ............................................. 149
Extension fields ..................................................... 150
Submit ............................................................... 150
Edit/Delete Directory .................................................... 151
Do Not Disturb (DND) 免打扰模块用户使用指南.................................. 151
总览 .................................................................... 152
Controlling DND .......................................................... 152
Feature Code ......................................................... 152
User Control Panel ................................................... 152
REST Apps ............................................................ 153
Asterisk 功能代码介绍 ....................................................... 154
o Introduction ......................................................... 154
o Blacklist Feature Codes .............................................. 154
o Blacklist a number ................................................... 154
o Blacklist the last caller ............................................ 154
o Remove a number from the blacklist ................................... 154
o Call Forwarding Feature Codes ........................................ 154
o Call Forward All Activate ............................................ 154
o Call Forward All Deactivate .......................................... 154
o Call Forward All Prompting Deactivate................................. 154
o Call Forwarding Busy Activate ........................................ 154
深圳星昊通科技有限公司 www.hiastar.com
9
o Call Forwarding Busy Deactivate ...................................... 154
o Busy Call Forward No Answer/Unavailable Activate ...................... 154
o Call Forward No Answer/Unavailable Deactivate ......................... 154
o Call Forward No Answer/Unavailable Activate ........................... 154
o Call Forward Toggle .................................................. 154
o Call Waiting Feature Codes ........................................... 154
o Call Waiting Activate ................................................ 154
o Call Waiting Deactivate .............................................. 154
o Core Feature Codes ................................................... 154
o Asterisk General Call Pick ........................................... 154
o ChanSpy .............................................................. 154
o Directed Call Pickup ................................................. 154
o In-Call Asterisk Attended Transfer ................................... 154
o In-Call Asterisk Blind Transfer ...................................... 154
o User Logoff .......................................................... 154
o User Login ........................................................... 154
o ZapBarge ............................................................. 154
o Call Flow Control .................................................... 154
o Dictation ............................................................ 154
o Do Not Disturb (DND) ................................................. 154
o DND Activate ......................................................... 154
o DND Deactivate ....................................................... 154
o DND Toggle ........................................................... 154
o Follow Me ............................................................ 154
o Info Services ........................................................ 154
o Call Trace ........................................................... 154
o Directory ............................................................ 154
o Echo Test ............................................................ 154
o Speak Your Exten Number .............................................. 154
o Speaking Clock ....................................................... 154
o Paging and Intercom .................................................. 154
o Intercom Prefix ...................................................... 155
o User Intercom Allow .................................................. 155
o User Intercom Disallow ............................................... 155
o Parking Lot .......................................................... 155
o Pickup ParkedCall Any ................................................ 155
o Phonebook Directory .................................................. 155
o Phonebook dial-by-name directory ..................................... 155
o Queues ............................................................... 155
o Queue Toggle ......................................................... 155
o Recordings ........................................................... 155
o Check Recording ...................................................... 155
o Save Recording ....................................................... 155
o Time Conditions ...................................................... 155
深圳星昊通科技有限公司 www.hiastar.com
10
o Voicemail ............................................................ 155
o Dial Voicemail ....................................................... 155
o My Voicemail ......................................................... 155
Introduction............................................................. 155
Blacklist Feature Codes .................................................. 155
Blacklist a number ................................................... 155
Blacklist the last caller ............................................ 155
Remove a number from the blacklist ................................... 155
Call Forwarding Feature Codes ............................................ 155
Call Forward All Activate ............................................ 156
Call Forward All Deactivate .......................................... 156
Call Forward All Prompting Deactivate................................. 156
Call Forwarding Busy Activate ........................................ 156
Call Forwarding Busy Deactivate ...................................... 156
Busy Call Forward No Answer/Unavailable Activate ...................... 156
Call Forward No Answer/Unavailable Deactivate ......................... 156
Call Forward No Answer/Unavailable Activate ........................... 156
Call Forward Toggle .................................................. 156
Call Waiting Feature Codes ............................................... 156
Call Waiting Activate ................................................ 157
Call Waiting Deactivate .............................................. 157
Core Feature Codes ....................................................... 157
Asterisk General Call Pick ........................................... 157
ChanSpy .............................................................. 157
Directed Call Pickup ................................................. 157
In-Call Asterisk Attended Transfer ................................... 157
In-Call Asterisk Blind Transfer ...................................... 158
User Logoff .......................................................... 158
User Login ........................................................... 158
ZapBarge ............................................................. 158
Call Flow Control ........................................................ 158
Dictation ............................................................... 158
Do Not Disturb (DND) ..................................................... 158
DND Activate ......................................................... 158
DND Deactivate ....................................................... 158
DND Toggle ........................................................... 158
Follow Me ............................................................... 159
Info Services............................................................ 159
Call Trace ........................................................... 159
Directory ............................................................ 159
Echo Test ............................................................ 159
Speak Your Exten Number .............................................. 159
Speaking Clock ....................................................... 159
Paging and Intercom ...................................................... 159
深圳星昊通科技有限公司 www.hiastar.com
11
Intercom Prefix ...................................................... 159
User Intercom Allow .................................................. 160
User Intercom Disallow ............................................... 160
Parking Lot.............................................................. 160
Pickup ParkedCall Any ................................................ 160
Phonebook Directory ...................................................... 160
Phonebook dial-by-name directory ..................................... 160
Queues .................................................................. 160
Queue Toggle ......................................................... 160
Recordings .............................................................. 160
Check Recording ...................................................... 160
Save Recording ....................................................... 161
Time Conditions .......................................................... 161
Voicemail ............................................................... 161
Dial Voicemail ....................................................... 161
My Voicemail ......................................................... 161
管理员功能代码使用指南 ...................................................... 161
总览 .................................................................... 161
Logging in .............................................................. 162
修改功能代码热键 ......................................................... 162
Enable or Disable the Feature Code ....................................... 163
FreePBX 脚本安全扫描 ........................................................ 163
如何一步步创建语音 IVR ....................................................... 164
IVR 实例 1 ............................................................... 164
IVR 实例 2 .............................................................. 165
IVR 模块用户使用指南 ........................................................ 165
总览 .................................................................... 166
Logging In .............................................................. 166
Creating a new IVR ....................................................... 166
IVR Name ............................................................. 166
IVR Description ...................................................... 166
Announcement ......................................................... 167
Direct Dial .......................................................... 168
Timeout .............................................................. 168
Invalid Retries ...................................................... 168
Invalid Retry Recording .............................................. 168
Append Original Announcement ......................................... 168
Invalid Recording .................................................... 168
Invalid Destination .................................................. 169
Timeout Retries ...................................................... 169
Timeout Retry Recording .............................................. 169
Append Original Announcement ......................................... 169
Timeout Recording .................................................... 169
Timeout Destination .................................................. 169
深圳星昊通科技有限公司 www.hiastar.com
12
Return to IVR after VM ............................................... 169
IVR Entries.............................................................. 170
Ext .................................................................. 170
Destination .......................................................... 170
Return ............................................................... 170
Languages 语言模块使用指南 .................................................. 171
总览 .................................................................... 171
Logging In .............................................................. 171
Settings ................................................................ 172
Description .......................................................... 172
Language Code ........................................................ 172
Destination .......................................................... 176
Call Routing............................................................. 176
自动登录 FreePBX 12 以上版本 ................................................. 177
通过 CLI 管理模块访问： ...................................................... 178
管理员模块用户使用指南 ...................................................... 180
总览 .................................................................... 180
Logging in .............................................................. 180
Update Notifications ..................................................... 181
Repositories............................................................. 181
Basic ................................................................ 182
Extended ............................................................. 182
Unsupported .......................................................... 182
Commercial ........................................................... 182
Upload Modules ........................................................... 182
Module Management ........................................................ 183
Update ............................................................... 183
Enable ............................................................... 184
Disable .............................................................. 185
Install .............................................................. 185
Uninstall ............................................................ 186
Alternative management ................................................... 186
使用主机防火墙保护 Asterisk/FreePBX ......................................... 186
o Rules for a Free PBX Host Server ......................................... 186
o IP Tables rules .......................................................... 186
o Port Names .............................................................. 186
o Fail 2 Ban .............................................................. 186
o VOIP Blacklist ........................................................... 186
Free PBX 服务器防火墙设置 ................................................... 186
IP Tables rules .......................................................... 186
Port Names ........................................................... 188
Fail 2 Ban .............................................................. 188
VOIP Blacklist ........................................................... 190
设置 CallerID ............................................................... 190
深圳星昊通科技有限公司 www.hiastar.com
13
总览 .................................................................... 191
Logging In .............................................................. 191
Setting a CallerID ....................................................... 191
Description .......................................................... 191
CallerID Name ........................................................ 191
CallerID Number ...................................................... 192
Destination .......................................................... 192
Save ................................................................. 192
配合系统变量工作 ......................................................... 192
时间条件用户模块使用指南 .................................................... 193
总览 .................................................................... 193
Logging in .............................................................. 193
Creating a Time Condit ................................................... 194
Time Condition Name ...................................................... 194
Enable Override Code ................................................. 194
Time Group Drop-down ................................................. 195
Destination if time matches .......................................... 195
Destination if time does not match ................................... 195
Save Changes ......................................................... 195
Editing/Deleting ......................................................... 195
Deleting ............................................................. 195
Editing .............................................................. 196
时间组用户使用指南 .......................................................... 196
总览 .................................................................... 196
Logging In .............................................................. 196
Adding a time Group ...................................................... 197
Description .......................................................... 197
New Time ............................................................. 198
Assigning Time Groups to Time Conditions Via the Time Conditions Module ... 198
Assign Time Groups to Outbound Routes .................................... 198
Voicemail – 分机级别的管理 ................................................. 198
o Overview ............................................................. 198
o Logging in ........................................................... 198
o Existing User ........................................................ 198
o New Extension ........................................................ 198
o Settings ............................................................. 198
o Status ............................................................... 198
o Voicemail Password ................................................... 198
o Email Address ........................................................ 198
o Pager Email Address .................................................. 198
o Email Attachment ..................................................... 199
o Play CID ............................................................. 199
o Play Envelope ........................................................ 199
o Delete Voicemail ..................................................... 199
深圳星昊通科技有限公司 www.hiastar.com
14
o VM Options ........................................................... 199
o VM Context ........................................................... 199
总览 .................................................................... 199
Logging in .............................................................. 199
Existing User ........................................................ 199
New Extension ........................................................ 199
Settings ................................................................ 199
Status ............................................................... 200
Voicemail Password ................................................... 200
Email Address ........................................................ 200
Pager Email Address .................................................. 200
Email Attachment ..................................................... 200
Play CID ............................................................. 200
Play Envelope ........................................................ 200
Delete Voicemail ..................................................... 200
VM Options ........................................................... 200
VM Context ........................................................... 202
Voicemail 管理员高级设置 .................................................... 203
o Overview ............................................................. 203
o Logging in ........................................................... 203
o Settings ............................................................. 203
attach ............................................................... 203
pbxskip .............................................................. 203
serveremail .......................................................... 203
fromstring ........................................................... 203
maxsilence ........................................................... 203
silencethreshold ..................................................... 203
skipms ............................................................... 203
review ............................................................... 203
operator ............................................................. 203
nextaftercmd ......................................................... 203
format ............................................................... 203
maxmessage ........................................................... 203
minmessage ........................................................... 203
maxsecs .............................................................. 203
minsecs .............................................................. 203
pollmailboxes ........................................................ 203
pollfreq ............................................................. 203
imapserver ........................................................... 203
imapflags ............................................................ 203
imapfolder ........................................................... 203
expungeonhangup ...................................................... 203
imapgreetings ........................................................ 203
forcename ............................................................ 203
深圳星昊通科技有限公司 www.hiastar.com
15
forcegreetings ....................................................... 203
总览 .................................................................... 203
Logging in .............................................................. 203
Settings ................................................................ 204
attach ............................................................... 204
pbxskip .............................................................. 204
serveremail .......................................................... 204
fromstring ........................................................... 204
maxsilence ........................................................... 204
silencethreshold ..................................................... 205
skipms ............................................................... 205
review ............................................................... 205
operator ............................................................. 205
nextaftercmd ......................................................... 205
format ............................................................... 205
maxmessage ........................................................... 206
minmessage ........................................................... 206
maxsecs .............................................................. 206
minsecs .............................................................. 206
pollmailboxes ........................................................ 206
pollfreq ............................................................. 206
imapserver ........................................................... 206
imapflags ............................................................ 206
imapfolder ........................................................... 206
expungeonhangup ...................................................... 207
imapgreetings ........................................................ 207
forcename ............................................................ 207
forcegreetings ....................................................... 207
Voicemail 管理员 –时区设置 ................................................. 207
o Overview ............................................................. 207
o Logging in ........................................................... 207
o Settings ............................................................. 207
o New Name ............................................................. 207
o New Timezone Definition .............................................. 207
o Timezones ............................................................ 207
o Values ............................................................... 207
总览 .................................................................... 207
Logging in .............................................................. 207
Settings ................................................................ 208
New Name ............................................................. 208
New Timezone Definition .............................................. 208
语音邮箱留言组用户使用指南 .................................................. 219
o Overview ............................................................. 219
o Logging in ........................................................... 219
深圳星昊通科技有限公司 www.hiastar.com
16
o Adding a VMBlast Group ............................................... 219
o VMBlast Number ....................................................... 219
o Group Description .................................................... 219
o Audio Label .......................................................... 219
o Optional Password .................................................... 219
o Voicemail Box List ................................................... 219
o Default VMBlast Group ................................................ 219
o Save ................................................................. 219
总览 .................................................................... 219
Logging in .............................................................. 219
Adding a VMBlast Group ................................................... 220
VMBlast Number ....................................................... 220
Group Description .................................................... 220
Audio Label .......................................................... 221
Optional Password .................................................... 221
Voicemail Box List ................................................... 221
Default VMBlast Group ................................................ 221
Save ................................................................. 221
FreePBX 热备用户使用指南 .................................................... 221
o Introduction ......................................................... 221
o This article assumes the following ................................... 221
o Setup ................................................................ 221
o SSH Keys ............................................................. 221
o Creating Backup Job .................................................. 221
o Failing over to backup server ........................................ 221
o Network .............................................................. 221
Introduction............................................................. 221
本文假设用户已经满足了以下需求： ..................................... 222
Setup ................................................................... 222
SSH Keys ............................................................. 222
Creating Backup Job .................................................. 224
Failing over to backup server ........................................ 228
Asterisk SIP 设置用户指南 ................................................... 230
总览 .................................................................... 230
登录 .................................................................... 230
NAT 设置 ................................................................ 230
Allow Anonymous inbound SIP Calls .................................... 231
Local Networks ....................................................... 231
RTP Settings ......................................................... 231
Codecs ............................................................... 231
保存 .................................................................... 232
呼叫录音设置探究 ............................................................ 232
呼叫录音模块使用指南 ........................................................ 234
总览 .................................................................... 235
深圳星昊通科技有限公司 www.hiastar.com
17
登录 .................................................................... 235
添加呼叫录音............................................................. 235
Description .......................................................... 235
Call Recording Mode .................................................. 236
Destination .......................................................... 236
Submit Changes ........................................................... 236
模块级别录音............................................................. 236
Extension Level ...................................................... 236
Queue Level .......................................................... 238
Inbound Routes ....................................................... 238
Permissions and Conflicts ................................................ 239
Inbound Route ........................................................ 239
Queues ............................................................... 239
Extensions ........................................................... 239
回拨模块使用指南 ............................................................ 240
总览 .................................................................... 240
登录 .................................................................... 240
创建一个回拨............................................................. 240
Callback Description ................................................. 241
Callback Number ...................................................... 241
Delay Before Callback ................................................ 241
Destination after Callback ........................................... 241
Save ................................................................. 241
CallerID 查询源模块使用指南 ................................................. 241
总览 .................................................................... 242
登录 .................................................................... 242
创建一个 Caller ID Lookup Source ......................................... 243
Source Description ................................................... 243
Source Type .......................................................... 243
Hooking Inbound Routes to Lookups .................................... 247
Camp-On 回拨服务模块使用指南 ................................................ 247
总览 .................................................................... 247
Settings ................................................................ 247
Extension ............................................................ 247
Advance Settings ..................................................... 249
创建新用户 .................................................................. 252
Creating a new User .................................................. 252
UCP- FreePBX 12 or newer ........................................... 252
XMPP ................................................................. 252
Rest API ............................................................. 252
iSymphony and XactView ............................................... 252
创建一个新用户 ........................................................... 252
UCP- 用户管理模板 ...................................................... 254
XMPP .................................................................... 256
深圳星昊通科技有限公司 www.hiastar.com
18
Rest API ................................................................ 256
iSymphony 和 XactView 用户 ............................................... 257
自定义分机用户使用指南 ...................................................... 258
Overview .................................................................... 258
Logging In .............................................................. 258
Creating a Custom Extension .............................................. 258
Custom Extension ..................................................... 259
Description .......................................................... 259
Notes ................................................................ 259
Save .................................................................... 259
DISA 模块用户使用指南 ....................................................... 259
总览 .................................................................... 259
Logging In .............................................................. 260
Adding a DISA............................................................ 260
DISA Name ............................................................ 260
PIN .................................................................. 260
Response Timeout ..................................................... 260
Digit Timeout ........................................................ 260
Caller ID ............................................................ 261
Context .............................................................. 261
Allow Hangup ......................................................... 261
Submit ............................................................... 261
开启 CDR 记录的 CSV 文件格式 ................................................. 261
如何编辑分机 ................................................................ 261
总览 .................................................................... 262
登录 .................................................................... 262
编辑分机 ................................................................ 262
删除分机 ................................................................ 262
分机模块 - IAX2 分机 ........................................................ 263
总览 .................................................................... 263
Logging in .............................................................. 263
Adding a IAX2 Extension .................................................. 264
Extension Number ..................................................... 264
Display Name ......................................................... 264
CID Num Alias ........................................................ 264
Sip Alias ............................................................ 265
Extension Options ........................................................ 265
Outbound CID ......................................................... 265
Ring Time ............................................................ 265
Call Forward Ring Time ............................................... 265
Outbound Concurrency Limit ........................................... 266
Call Waiting ......................................................... 266
Internal Auto Answer ................................................. 266
Call Screening ....................................................... 266
深圳星昊通科技有限公司 www.hiastar.com
19
Pinless Dialling ..................................................... 266
Emergency CID ........................................................ 266
Queue State Detection ................................................ 266
Device Options ........................................................... 267
Secret ............................................................... 267
Optional Destinations .................................................... 267
No Answer ............................................................ 267
Busy ................................................................. 267
Not Reachable ........................................................ 267
CID Prefix ........................................................... 267
分机模块 – 其他自定义分机 .................................................. 268
总览 .................................................................... 268
Logging in .............................................................. 268
Adding a DAHDI Extension ................................................. 269
Extension Number ..................................................... 269
分机号码关联用户本身，一旦创建以后，不能被修改。在实例中，我们设置了分机为
“5000”。我们建议使用 3 或者 4 位的数字号码。 .......................... 269
Display Name ......................................................... 269
CID Num Alias ........................................................ 269
Sip Alias ............................................................ 270
Extension Options ........................................................ 270
Outbound CID ......................................................... 270
Ring Time ............................................................ 270
Call Forward Ring Time ............................................... 270
Outbound Concurrency Limit ........................................... 271
Call Waiting ......................................................... 271
Internal Auto Answer ................................................. 271
Call Screening ....................................................... 271
Pinless Dialling ..................................................... 271
Emergency CID ........................................................ 271
Queue State Detection ................................................ 271
Device Options ........................................................... 272
Dial ................................................................. 272
Optional Destinations .................................................... 272
No Answer ............................................................ 272
Busy ................................................................. 272
Not Reachable ........................................................ 272
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。
..................................................................... 272
CID Prefix ........................................................... 272
分机模块 - PJSIP 分机 ....................................................... 273
总览 .................................................................... 273
Logging in .............................................................. 274
Adding a SIP Extension ................................................... 274
深圳星昊通科技有限公司 www.hiastar.com
20
Extension Number ..................................................... 274
Display Name ......................................................... 274
CID Num Alias ........................................................ 275
Sip Alias ............................................................ 275
Extension Options ........................................................ 275
Outbound CID ......................................................... 275
Ring Time ............................................................ 275
Call Forward Ring Time ............................................... 276
Outbound Concurrency Limit ........................................... 276
Call Waiting ......................................................... 276
Internal Auto Answer ................................................. 276
Call Screening ....................................................... 276
Pinless Dialling ..................................................... 276
Emergency CID ........................................................ 276
Queue State Detection ................................................ 277
Device Options ........................................................... 277
Secret ............................................................... 277
DTMF Signalling ...................................................... 277
Mailbox .............................................................. 277
Transport ............................................................ 278
设备电话驻留............................................................. 278
Optional Destinations .................................................... 278
No Answer ............................................................ 278
Busy ................................................................. 278
Not Reachable ........................................................ 278
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。
..................................................................... 278
CID Prefix ........................................................... 278
Follow Me User Guide ........................................................ 279
总览 .................................................................... 279
分机随行模块支持用户在同一时间对多个呼叫目的地同时振铃。分机随行支持通过界
面设置基于每个分机的分机随行。如果分机开启了分机随行功能，用户则可以通过 UCP
模块来设置一些选项。所有当前的系统分机都显示在界面上，用户可以点击编辑按钮
来编辑分机随行；如果当前分机不支持分机随行的话，系统则显示添加按钮。 .. 279
Logging In .............................................................. 280
Enabling Follow Me for an extension ...................................... 280
Disable .............................................................. 281
Initial Ring Time .................................................... 281
Ring Strategy ........................................................ 281
Ring Time ............................................................ 282
Follow-Me List ....................................................... 282
Announcement ......................................................... 283
Play Music on Hold ................................................... 283
CID Name Prefix ...................................................... 283
深圳星昊通科技有限公司 www.hiastar.com
21
Alert Info ........................................................... 283
Remote Announce ...................................................... 284
To-Late Announce ..................................................... 284
Change External CID Configuration .................................... 284
Mode ................................................................. 284
IAX Settings User Guide ..................................................... 285
总览 .................................................................... 285
Logging in .............................................................. 287
Settings ................................................................ 287
Audio Codecs ......................................................... 287
Codec Priority ....................................................... 289
Bandwidth ............................................................ 290
Video Support ........................................................ 290
Registration Settings .................................................... 291
Jitter Buffer Settings ................................................... 291
Jitter Buffer ........................................................ 291
Force Jitter Buffer .................................................. 291
Jitter Buffer Size ................................................... 292
Max Interpolations ................................................... 292
Advanced General Settings ................................................ 292
Language ............................................................. 292
Bind Address ......................................................... 293
Bind Port ............................................................ 293
Delay Auth Rejects ................................................... 293
Other IAX Settings ................................................... 293
Save .................................................................... 293
Misc Applications 其他杂项模块使用指南 ...................................... 293
总览 .................................................................... 293
Logging in .............................................................. 294
Adding a Misc Application ................................................ 294
Description .......................................................... 294
Feature Code ......................................................... 294
Feature Status ....................................................... 295
Destination .......................................................... 295
MoH 音乐等待模块用户使用指南 ................................................ 295
总览 .................................................................... 295
Logging In .............................................................. 296
Adding Music Categories .................................................. 296
Category Name ........................................................ 297
Adding Static Music ...................................................... 297
Upload a WAV or MP3 File ............................................. 298
Disable/Enable Random Play ........................................... 298
MoH List ............................................................. 299
Adding Streaming Music ................................................... 299
深圳星昊通科技有限公司 www.hiastar.com
22
Category Name ........................................................ 299
Application path ..................................................... 299
Optional Format ...................................................... 299
寻呼对讲模块用户使用指南 .................................................... 300
总览 .................................................................... 300
Logging In .............................................................. 301
General Settings ......................................................... 301
Auto Answer Announcement ............................................. 301
New Paging Group ......................................................... 301
Paging Extensions .................................................... 302
Group Description .................................................... 302
Device List .......................................................... 302
Busy Extensions ...................................................... 302
Duplex ............................................................... 303
Default Page Group ................................................... 303
Paging Pro .............................................................. 303
Busy Page Groups ..................................................... 303
Page Announcement .................................................... 304
CID Pre-pend ......................................................... 304
Paging Scheduler ..................................................... 304
电话驻留模块用户使用指南 .................................................... 305
总览 .................................................................... 306
Configuration............................................................ 306
Parking Lot Extension ................................................ 307
Parking Lot Name ..................................................... 307
Parking Lot Starting Position ........................................ 307
Number of Slots ...................................................... 307
Parking Timeout ...................................................... 307
Parked Music Class ................................................... 307
BLF Capabilities ..................................................... 307
Use Next Slot ........................................................ 307
Returned Call Behaviour .................................................. 308
Pickup Courtesy Tone ................................................. 308
Transfer Capability .................................................. 308
Re-Parking Capability ................................................ 308
Parking Alert-Info ................................................... 308
CallerID Prepend ..................................................... 309
Auto CallerID Prepend ................................................ 309
Announcement ......................................................... 309
Alternate Destination .................................................... 309
Come Back to Origin .................................................. 310
Destination .......................................................... 310
队列优先级模块使用指南 ...................................................... 310
Overview ................................................................ 310
深圳星昊通科技有限公司 www.hiastar.com
23
Logging in .............................................................. 310
Adding a Queue Priority .................................................. 311
Description .......................................................... 311
Priority ............................................................. 311
Destination .......................................................... 311
队列模块用户使用指南 ..................................................... 312
Introduction............................................................. 312
Logging in .............................................................. 314
Adding a Queue ........................................................... 314
Base options ......................................................... 314
Queue General Options ................................................ 318
Timing and Agent Options ............................................. 321
Capacity Options ..................................................... 323
Queue Announcement Options ........................................... 325
Events Stats and Advanced ............................................ 326
Fail Over Destination ................................................ 327
Other Option Sections ................................................ 327
Editing and Deleting Queues .............................................. 327
振铃组模块用户使用指南 ...................................................... 327
总览 .................................................................... 327
Logging In .............................................................. 328
Adding a Ring Group ...................................................... 328
Group Description .................................................... 329
Ring Strategy ........................................................ 329
Extension List ....................................................... 329
Announcement ......................................................... 330
Play Music On Hold ................................................... 330
CID Name Prefix ...................................................... 330
Alert Info ........................................................... 330
Ignore CF Settings ................................................... 330
Skip Busy Agent ...................................................... 330
Enable Call Pickup ................................................... 330
Confirm Calls ........................................................ 331
Remote Announce ...................................................... 331
Too-Late Announce .................................................... 331
Change External CID Configuration .................................... 331
Fixed CID Value ...................................................... 332
Call Recording ....................................................... 332
Destination if no answer ............................................. 333
Save .................................................................... 333
订阅 BLF 检测语音邮箱 ........................................................ 333
TTS(语音合成) 引擎用户使用指南 .............................................. 333
总览 .................................................................... 334
Logging in .............................................................. 334
深圳星昊通科技有限公司 www.hiastar.com
24
Adding an Engine ......................................................... 334
Engine Name .......................................................... 334
Engine Path .......................................................... 334
Save ................................................................. 334
TTS 语音合成模块用户使用指南 ................................................ 334
总览 .................................................................... 335
Logging In .............................................................. 335
Adding a Text to Speech .................................................. 335
Name ................................................................. 335
Text ................................................................. 336
Choose TTS Engine .................................................... 336
Destination .......................................................... 336
唤醒呼叫用户使用指南 ........................................................ 336
总览 .................................................................... 337
Logging in .............................................................. 337
Usage ................................................................... 337
Removing a call from the UI .......................................... 338
Module Configuration ................................................. 338
System Settings ...................................................... 339
自定义目的地模块使用指南 .................................................... 340
总览 .................................................................... 340
Logging In .............................................................. 340
Creating a Custom Destination ............................................ 340
Custom Destination ................................................... 341
Destination Quick Pick ............................................... 341
Description .......................................................... 341
Notes ................................................................ 341
Save ................................................................. 341
Using Custom Destination ................................................. 341
总览 .................................................................... 342
Logging In ........................................................... 342
Mapping a channel to a phone number ...................................... 343
Channel .............................................................. 343
Description .......................................................... 343
DID .................................................................. 343
Save ................................................................. 343
DAHDI 语音板卡配置指南 ...................................................... 344
总览 .................................................................... 345
登录 .................................................................... 345
基本设置 ................................................................ 346
Global Settings ...................................................... 347
Modprobe Settings .................................................... 351
Module Settings ...................................................... 352
Digital Card Setup ....................................................... 356
深圳星昊通科技有限公司 www.hiastar.com
25
T1/E1/PRI and BRI Settings ........................................... 356
GSM Card ............................................................. 357
Analog Card Setup ........................................................ 358
FXO .................................................................. 358
FXS .................................................................. 359
FXO Channel Setup .................................................... 359
FXS Channel Setup .................................................... 361
分机模块 – 语音卡 FXS 分机 .................................................. 362
总览 .................................................................... 363
登录 .................................................................... 363
添加一个新 FXS 分机 ...................................................... 363
Extension Number ..................................................... 364
Display Name ......................................................... 364
CID Num Alias ........................................................ 364
Sip Alias ............................................................ 364
Extension Options ........................................................ 365
Outbound CID ......................................................... 365
Ring Time ............................................................ 365
Call Forward Ring Time ............................................... 365
Outbound Concurrency Limit ........................................... 365
Call Waiting ......................................................... 366
Internal Auto Answer ................................................. 366
Call Screening ....................................................... 366
Pinless Dialling ..................................................... 366
Emergency CID ........................................................ 366
Queue State Detection ................................................ 366
Device Options ........................................................... 367
Channel .............................................................. 367
Parking Lot .......................................................... 367
Optional Destinations .................................................... 367
No Answer ............................................................ 367
Busy ................................................................. 367
Not Reachable ........................................................ 367
CID Prefix ........................................................... 368
呼入路由实例 ................................................................ 368
DeadRestricted ....................................................... 368
DID Number Route ..................................................... 368
SuperCaller .......................................................... 368
呼入路由用户使用指南 ........................................................ 369
Overview ................................................................ 369
Logging In .............................................................. 370
Adding an Inbound Route .................................................. 370
Description .......................................................... 370
DID (Direct Inward Dialling) ......................................... 371
深圳星昊通科技有限公司 www.hiastar.com
26
CID (Caller ID) ...................................................... 371
CID Priority Route ................................................... 371
Options .............................................................. 372
Other Settings ....................................................... 373
Privacy Manager ...................................................... 373
FAX DETECT SECTION ................................................... 374
CID LOOKUP SOURCE SECTION ............................................ 375
Call Recording ....................................................... 375
SET DESTINATION SECTION .............................................. 376
呼出路由配置实例 ............................................................ 376
呼出路由配置实例: ........................................................... 376
1. Route Name: EMERGENCY ............................................. 376
2. Route Name: Restricted ............................................ 377
3. Route Name: BlockPublicPhone ...................................... 378
4. Route Name: BlockCallerID ......................................... 378
5. Route Name: Normal ................................................ 379
外呼路由模块用户使用指南 .................................................... 380
总览 .................................................................... 380
Logging In .............................................................. 381
Adding an Outbound Route ................................................. 381
Route Name ........................................................... 381
Route CID ............................................................ 382
Route Password ....................................................... 382
Route Type ........................................................... 382
Music On Hold ........................................................ 382
Time Group ........................................................... 383
Route Position ....................................................... 383
Call Recording ....................................................... 383
Pin Set .............................................................. 383
Call Limit ........................................................... 383
Notification ......................................................... 384
Dial Patterns ........................................................ 384
Trunk Sequence for Matched Routes .................................... 386
Optional Destination on Congestion ................................... 387
Save ................................................................. 387
路由器设置 .................................................................. 387
Port Forwarding ............................................................. 387
Firewall Settings ........................................................... 388
Quality of Service Settings ................................................. 388
中继配置实例: ............................................................... 388
1. Dead/Restricted Trunk using SIP Protocol: ........................... 388
2. 一般运营商 SIP 中继设置: ............................................ 388
3. 使用自定义的中继支持呼叫方通过 SIP 地址拨号 .......................... 390
4. Connecting two FreePBX systems: ..................................... 391
深圳星昊通科技有限公司 www.hiastar.com
27
关于 PEER 中的参数含义? ...................................................... 391
Trunks 模块用户使用指南 ..................................................... 394
o Overview ............................................................. 394
o Logging in ........................................................... 394
o Adding a Trunk ....................................................... 394
o General Settings ..................................................... 395
o Trunk Name ........................................................... 395
o Outbound CallerID .................................................... 395
o CID Options .......................................................... 395
o Allow Any CID ........................................................ 395
o Block Foreign CIDs ................................................... 395
o Remove CNAM .......................................................... 395
o Force Trunk CID ...................................................... 395
o Maximum Channels ..................................................... 395
o Continue if Busy ..................................................... 395
o Disable Trunk ........................................................ 395
o Dial Pattern Manipulation Rules ...................................... 395
o Prepend .............................................................. 395
o Prefix ............................................................... 395
o Match pattern ........................................................ 395
o Dialled Rules Wizard ................................................. 395
o Always dial with prefix .............................................. 395
o Remove prefix from local numbers ..................................... 395
o Setup directory assistance ........................................... 395
o Lookup numbers for local trunk ....................................... 395
o Upload from CSV ...................................................... 395
o Outbound Dial Prefix ................................................. 395
o SIP (chan_sip)/IAX2 Specific Settings................................. 395
o Trunk Name ........................................................... 395
o PEER Details ......................................................... 395
o USER Context ......................................................... 395
o USER Details ......................................................... 395
o Register String ...................................................... 395
o DAHDI Specific Settings .............................................. 395
o DAHDI Trunks ......................................................... 395
o SIP TRUNK(PJSIP) ..................................................... 395
o Simple ............................................................... 395
o Permanent Auth Rejection ............................................. 395
o Retry Interval ....................................................... 395
o Expiration ........................................................... 395
o Forbidden Retry Interval ............................................. 395
o Max Retries .......................................................... 395
o Qualify Frequency .................................................... 395
o Username ............................................................. 395
深圳星昊通科技有限公司 www.hiastar.com
28
o Secret ............................................................... 395
o SIP Server ........................................................... 395
o SIP Server Port ...................................................... 395
o Outbound Proxy ....................................................... 395
o Contact User ......................................................... 395
o Context .............................................................. 396
o Transport ............................................................ 396
o Codecs ............................................................... 396
o Advanced ............................................................. 396
o Client URI ........................................................... 396
o Server URI ........................................................... 396
o AOR Contact .......................................................... 396
o ENUM TRUNK ........................................................... 396
o DUNDi Trunk .......................................................... 396
o DUNDi Mapping ........................................................ 396
o Custom Trunk ......................................................... 396
o Custom Dial String ................................................... 396
总览 .................................................................... 396
Logging in .............................................................. 396
Adding a Trunk ........................................................... 397
General Settings ......................................................... 397
Trunk Name ........................................................... 398
Outbound CallerID .................................................... 398
CID Options .......................................................... 398
Maximum Channels ..................................................... 398
Continue if Busy ..................................................... 399
Disable Trunk ........................................................ 399
Dial Pattern Manipulation Rules ...................................... 399
Dialled Rules Wizard ................................................. 400
Outbound Dial Prefix ................................................. 401
SIP (chan_sip)/IAX2 Specific Settings .................................... 401
Trunk Name ........................................................... 402
PEER Details ......................................................... 402
USER Context ......................................................... 402
USER Details ......................................................... 402
Register String ...................................................... 402
DAHDI Specific Settings .................................................. 402
DAHDI Trunks ......................................................... 403
SIP TRUNK(PJSIP) ......................................................... 404
Simple // simple 配置方式 ........................................... 404
Advanced ............................................................. 406
ENUM TRUNK .............................................................. 406
DUNDi Trunk.............................................................. 407
DUNDi Mapping ........................................................ 407
深圳星昊通科技有限公司 www.hiastar.com
29
Custom Trunk............................................................. 407
Custom Dial String ................................................... 408
高级模块设置的作用是什么？ .................................................. 408
高级设置中每个选项的含义是什么？ ............................................ 409
Fax – UCP 使用指南 ......................................................... 410
总览 ........................................................................ 410
Viewing Faxes ............................................................... 410
Sending Faxes ............................................................... 412
Fax Settings ................................................................ 416
UCP- 用户 Presence 模块使用指南 .............................................. 419
总览 .................................................................... 419
Changing your status ..................................................... 419
Usage ................................................................... 419
On UCP Login Set Status To ........................................... 419
On Browser Close or UCP Logout Set Status To .......................... 420
Automatic Actions based on status type ................................ 420
Print Extensions 打印分机模块 ............................................... 421
总览 .................................................................... 421
Logging in .............................................................. 422
Usage ................................................................... 422
Advanced Settings ........................................................... 423
高级模块设置的作用是什么？ .................................................. 423
高级设置中每个选项的含义是什么？ ............................................ 424
Presence State 状态模块使用指南 .............................................. 425
总览 ........................................................................ 425
Logging in .............................................................. 425
Current states ........................................................... 426
Add ..................................................................... 426
Type ................................................................. 427
Message .............................................................. 427
Editing ................................................................. 427
Deleting ................................................................ 428
通过 UCP 设置用户侧功能 ...................................................... 428
o Overview ................................................................ 428
o Usage ................................................................... 428
o Find Me/Follow Me ........................................................ 428
o Enable .................................................................. 428
o Follow Me List ........................................................... 428
o Announcement............................................................. 428
o Ring <Exten> First For ................................................... 428
o Ring Followme List For ................................................... 428
o Use Confirmation ......................................................... 428
o Remote Announce .......................................................... 428
o Too-Late Announce ........................................................ 428
深圳星昊通科技有限公司 www.hiastar.com
30
o Call Forwarding .......................................................... 429
o CallForward Ringtimer .................................................... 429
o Unconditional............................................................ 429
o Unavailable.............................................................. 429
o Busy .................................................................... 429
o Do Not Disturb ........................................................... 429
o Call Waiting............................................................. 429
o Where is save button? .................................................... 429
总览 .................................................................... 429
Usage ................................................................... 429
Find Me/Follow Me .................................................... 429
Call Forwarding ...................................................... 431
Do Not Disturb ....................................................... 432
Call Waiting ......................................................... 433
Voicemail – 用户侧管理界面 UCP .............................................. 433
Overview ................................................................ 433
Managing Voicemail Messages .............................................. 433
Managing Voicemail Settings. ............................................. 433
Managing Voicemail Greetings. ............................................ 433
总览 ........................................................................ 433
Managing Voicemail Messages ................................................. 433
Managing Voicemail Settings. ................................................ 436
Managing Voicemail Greetings. ............................................... 439
总览 .................................................................... 442
Logging In .............................................................. 442
Generating a Weak Passwords Report ....................................... 442
Creating New Extensions with Strong Passwords ............................ 443
Removing Strong Password Requirement ..................................... 443
Tips .................................................................... 443
WebRTC UCP 电话配置 ......................................................... 444
总览 .................................................................... 445
Requirements............................................................. 445
服务器端配置要求 ..................................................... 445
Documentation Disclaimers ................................................ 445
客户侧环境要求 ........................................................... 445
Installation............................................................. 446
确认用户模块更新到最新状态 ........................................... 446
Install Needed Modules ............................................... 446
Enabling WebRTC .......................................................... 447
Certificates ......................................................... 447
Add Certificate ...................................................... 449
Enabling WebRTC Phone for a user ..................................... 451
Using The WebRTC Phone ................................................... 452
Troubleshooting .......................................................... 454
深圳星昊通科技有限公司 www.hiastar.com
31
常见问题解答 ................................................................ 455
深圳星昊通科技有限公司 www.hiastar.com
32
如何安装 FreePBX ISO版本
以下安装方式是最简单的自动安装方式.
1. 从官方下载官方的 ISO 镜像文件 http://schmoozecom.com/distro-download.php.
深圳星昊通科技有限公司 www.hiastar.com
33
2. 把 ISO 文件刻录到 DCD 或者 CD 的光盘中。 Windows 7 操作系统有系统自带的光盘刻
录工具，用户可以通过系统工具刻录，也可以下载免费的光盘刻录工具来刻录 ISO 文件。
3. 选择需要安装 ISO 光盘的机器。所有此电脑中的数据将被清除覆盖。此 Bios 修改启动
设置，修改为此光盘启动模式。把光盘插入电脑的 DVD 或者 CD 中就可以启动安装步骤。
注意，用户电脑必须连接外部网络。
如果通过 USB 安装 ISO 文件，用户可能会遇到一个 "kickstart" 错误。如果真的遇到这
个错误，用户不要过多担心，按照提示步骤，一步步进行下去。
深圳星昊通科技有限公司 www.hiastar.com
34
4. 安装工具将显示以下几个选项，要求用户选择安装：
注意以下几个选项说明：
安装选项
Full Install
o 这是很多客户的安装方法。如果电脑带两个硬盘的话，FreePBX 会清理硬盘数据，
自动安装 FreePBX 并且设置 RADI 1 磁盘阵列镜像。我们推荐使用两个硬盘安装，
一个硬盘作为 FreePBX 的工作空间，另外一个硬盘可以作为磁盘阵列的 RADI 1
备份。
Full Install – No RAID
o 此选项选择直接安装 FreePBX Distro ISO 光盘，无需自动配置 RAID 1 mirror。
Full Install – Advanced
o 此选项支持手动配置硬盘分区和 RADI 卷的创建。
HA Install – Requires 250G or larger disk
o 选择此选项的话，用户计划未来部署 FreePBX 的高可靠性解决方案，未来设置两
个 FreePBX Distro 服务器镜像。
深圳星昊通科技有限公司 www.hiastar.com
35
5. 系统将显示安装包的安装进度，这个过程大概需要 3-5 分钟。
6. 系统重启用户，会进一步配置网络设置。用户根据自己公司网络情况，配置获取 IP
地址的方式。
完成以后，点击 OK，系统将开始配置网络环境。
7. 最后用户需要根据自己的不同地理位置，配置时区，选择相应的时区，点击 "OK" 。
8. 安装工具将要求输入 Root 密码。这个密码是 Linux 后台 root 登录密码。
深圳星昊通科技有限公司 www.hiastar.com
36
9. 安装工具将检查系统的硬件依赖关系，格式化硬盘，安装软件包。整个过程需要大概
2 分钟时间。完成安装后，系统会重新启动。
10. 检测网络连接，安装其他几个软件包和更新的软件包。根据网络环境的不同，这个过
程需要大概 10-15 分钟时间。
深圳星昊通科技有限公司 www.hiastar.com
37
11. 完成安装以后，系统提示用户进入 Linux 后台，执行命令行，输入 root 用户密码。
此密码是以前输入的密码。
12. 输入密码后，系统将自动显示 FreePBX 的 IP 地址。
深圳星昊通科技有限公司 www.hiastar.com
38
13. 使用其他电脑的浏览器，访问系统提示的 IP 地址。如果是第一次登录系统，系统会
要求用户创建管理员名称，密码和电子邮箱。注意，这个密码不会修改 linux 后台登陆密码，
仅作为 FreePBX 界面登录使用。
14. 登录界面以后，系统显示以下四个选项:
PBX Administrator 支持用户作为管理员登录 PBX，配置和管理 PBX 系统
The User Control Panel 支持系统用户登录本帐号的功能访问
The Operator Panel 支持面板操作员来控制呼叫
Official FreePBX Support 访问此链接获得 FreePBX 官方免费支持
深圳星昊通科技有限公司 www.hiastar.com
39
15. 到此为止，用户已经成功安装好了 FreePBX Distro ISO 光盘版本。
安装完成以后，用户需要进一步对 FreePBX 进行配置使得 FreePBX 可以正常工作。
在 Ubuntu 12.04 环境下安装 FreePBX
关于商业版本安装：
商业模块目前不支持在 Ubuntu 平台安装部署。只有 FreePBX Distro 光盘安装才能支持
商业模块，请下载光盘安装文件安装。
Install Ubuntu 12.04 Server LTS 32 or 64-bit
o Initial System Setup
Configure your root password.
Switch to the Root User
Update Your System
Install Required Dependencies
Install PearDB
Reboot server
o Install Dependencies for Google Voice
Install iksemel
o Install and Configure Asterisk
Download Asterisk source files.
Compile and install DAHDI.
Compile and install LIBPRI.
Compile and install Asterisk
Install Asterisk-Extra-Sounds
o Install and Configure FreePBX
Download and extract FreePBX.
Now create the Asterisk user and set ownership permissions.
A few small modifications to Apache.
Configure Asterisk database in MYSQL.
Set permissions on MYSQL database.
Restart Asterisk and install FreePBX.
Finally, one last mod and start FreePBX.
o Start FreePBX
Navigate:
深圳星昊通科技有限公司 www.hiastar.com
40
系统初始设置
配置 root 密码
sudo passwd root
切换到 Root 用户
sudo -i
更新用户系统
apt-get update && sudo apt-get upgrade -y
安装依赖关系包
apt-get install -y build-essential linux-headers-`uname -r` openssh-server
apache2 mysql-server mysql-client bison flex php5 php5-curl php5-cli php5-mysql
php-pear php-db php5-gd curl sox libncurses5-dev libssl-dev libmysqlclient15-dev
mpg123 libxml2-dev libnewt-dev sqlite3 libsqlite3-dev pkg-config automake libtool
autoconf git subversion uuid uuid-dev
安装 PearDB
pear uninstall db
pear install db-1.7.14
如果用户看到以下告警信息:
WARNING: "pear/DB" is deprecated in favor of "pear/MDB2"
忽略此信息
执行以下命令，重新启动服务器
reboot
深圳星昊通科技有限公司 www.hiastar.com
41
安装 Google 语音包，中国用户如果不使用此应用模块，可以忽略此步骤
Install iksemel
cd /usr/src
wget https://iksemel.googlecode.com/files/iksemel-1.4.tar.gz
tar xf iksemel-1.4.tar.gz
cd iksemel-*
./configure
make
make install
安装配置 Asterisk
下载 Asterisk 源代码文件
cd /usr/src
wget
http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-co
mplete-current.tar.gz
wget
http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz
wget
http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11-current.tar.gz
编译和安装 DAHDI（安装 Asterisk 语音卡驱动）
cd /usr/src
tar xvfz dahdi-linux-complete-current.tar.gz
cd dahdi-linux-complete-*
make all
make install
make config
深圳星昊通科技有限公司 www.hiastar.com
42
编译安装 LIBPRI（如果安装数字语音卡需要安装此协议栈，否则无需安装）
cd /usr/src
tar xvfz libpri-1.4-current.tar.gz
cd libpri-*
make
make install
编译安装 Asterisk
cd /usr/src
tar xvfz asterisk-11-current.tar.gz
cd asterisk-*
./configure
contrib/scripts/get_mp3_source.sh
make menuselect
make
make install
make config
安装 Asterisk-Extra-Sounds 语音提示文件包
cd /var/lib/asterisk/sounds
wget
http://downloads.asterisk.org/pub/telephony/sounds/asterisk-extra-sounds-en-g
sm-current.tar.gz
tar xfz asterisk-extra-sounds-en-gsm-current.tar.gz
rm asterisk-extra-sounds-en-gsm-current.tar.gz
安装配置 FreePBX
下载解压 FreePBX.
export VER_FREEPBX=2.11
cd /usr/src
深圳星昊通科技有限公司 www.hiastar.com
43
git clone http://git.freepbx.org/scm/freepbx/framework.git freepbx
cd freepbx
git checkout release/${VER_FREEPBX}
创建 Asterisk 用户，设置访问权限。
adduser asterisk --disabled-password --gecos "Asterisk User"
chown asterisk. /var/run/asterisk
chown -R asterisk. /etc/asterisk
chown -R asterisk. /var/{lib,log,spool}/asterisk
chown -R asterisk. /usr/lib/asterisk
mkdir /var/www/html
chown -R asterisk. /var/www/
修改 Apache 设置
sed -i 's/\(^upload_max_filesize = \).*/\120M/' /etc/php5/apache2/php.ini
cp /etc/apache2/apache2.conf /etc/apache2/apache2.conf_orig
sed -i 's/^\(User\|Group\).*/\1 asterisk/' /etc/apache2/apache2.conf
service apache2 restart
配置 MYSQL 中的 Asterisk 数据库。
export ASTERISK_DB_PW=amp109
mysqladmin -u root create asterisk -p
mysqladmin -u root create asteriskcdrdb -p
mysql -u root asterisk -p < SQL/newinstall.sql
mysql -u root asteriskcdrdb -p < SQL/cdr_mysql_table.sql
设置 MYSQL 数据库的访问权限。
mysql -u root -p -e "GRANT ALL PRIVILEGES ON asterisk.* TO asteriskuser@localhost
IDENTIFIED BY '${ASTERISK_DB_PW}';"
mysql -u root -p -e "GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO
asteriskuser@localhost IDENTIFIED BY '${ASTERISK_DB_PW}';"
mysql -u root -p -e "flush privileges;"
深圳星昊通科技有限公司 www.hiastar.com
44
重新启动 Asterisk，安装 FreePBX.
./start_asterisk start
./install_amp --webroot /var/www
amportal a ma installall
amportal a reload
注意：** If “. /install_amp” 执行不成功，输入命令:
./install_amp --username=asteriskuser --password=$ASTERISK_DB_PW --webroot
/var/www
最后，做系统文件链接，启动 FreePBX.
ln -s /var/lib/asterisk/moh /var/lib/asterisk/mohmp3
amportal start
启动 FreePBX
通过了另外用户电脑访问:
http://yourlocalipaddress/html 或者 http://localhost/admin
注意：如果开启或者更新 FreePBX模块后，用户可能看到以下错误信息：
Symlink from modules failed
解决这个问题，需要删除以下文件:
cd /etc/asterisk
rm ccss.conf confbridge.conf features.conf sip.conf iax.conf logger.conf
extensions.conf sip_notify.conf
如果通过 FreePBX 页面访问 ‘Module Admin’ 删除安装，然后重新安装 ‘Camp On’
模块，这样就可以解决 Symlink 问题。
深圳星昊通科技有限公司 www.hiastar.com
45
在 Centos 6.5 安装 FreePBX 12
Install Centos 6.5
Install Centos 6.5
o Initial System Setup
Disable selinux
Update Your System
Install Additional Required Dependencies
IPTables
Auto Start MySQL
Auto Start Apache
Install PearDB
Reboot server
o Install Dependencies for Google Voice (If needed/wanted)
Install iksemel
o Add the Asterisk User
o Install and Configure Asterisk
Download Asterisk source files.
Compile and install DAHDI and LibPRI
o Compile and install pjproject
o Compile and Install jansson
o Compile and install Asterisk
o Install Asterisk-Extra-Sounds
o Install and Configure FreePBX
Download and extract FreePBX.
Set ownership permissions.
A few small modifications to Apache.
Configure Asterisk database in MYSQL.
Set permissions on MYSQL database.
Restart Asterisk and install FreePBX.
Finally, one last mod and start FreePBX.
o Start FreePBX
Navigate:
o Install and Setup Commercial Modules
Enable the FreePBX Commercial yum repos
yum clean all to clean out yum cache so it will find out new RPMs
yum install needed RPMs for Commercial Modules
Restart Apache and Install Sysadmin
For Further information see: CentOS and RHEL based systems.
深圳星昊通科技有限公司 www.hiastar.com
46
Initial System Setup
用户必须是 root 用户!
必须关闭 selinux。selinux 可能引起安装错误。
Disable selinux
在 /etc/sysconfig/selinux , 修改以下几行:
sed -i 's/\(^SELINUX=\).*/\SELINUX=disabled/' /etc/sysconfig/selinux
reboot 启动系统，执行命令 sestatus 查看 selinux 状态。结果应该是:
SELinux status: disabled
Update Your System
yum -y update
yum groupinstall core
yum groupinstall base
Install Additional Required Dependencies
执行以下命令安装系统所需的依赖包
yum install gcc gcc-c++ lynx bison mysql-devel mysql-server php php-mysql php-pear
php-mbstring tftp-server httpd make ncurses-devel libtermcap-devel sendmail
sendmail-cf caching-nameserver sox newt-devel libxml2-devel libtiff-devel
audiofile-devel gtk2-devel subversion kernel-devel git subversion kernel-devel
php-process crontabs cronie cronie-anacron wget vim php-xml uuid-devel libtool
sqlite-devel
IPTables
用户必须关闭默认的 iptables，安装完成用户可以重新开启。
查看当前状态:
chkconfig iptables --list
关闭 iptables:
chkconfig --level 0123456 iptables off
深圳星昊通科技有限公司 www.hiastar.com
47
停止系统服务:
service iptables stop
Auto Start MySQL
确定 mysql 已经运行。通常情况下，需要在系统启动时也同时启动 mysql。所以，我们要
在系统中添加一个启动任务:
chkconfig --level 345 mysqld on
通过命令启动 mysqld :
service mysqld start
Auto Start Apache
用户必须确认 Apache 也是正在运行的，所以用户才能访问 FreePBX 管理员界面，在系
统启动任务中添加以下命令:
chkconfig --level 345 httpd on
手动启动 apache 命令:
service httpd start
Install PearDB
pear channel-update pear.php.net
pear install db-1.7.14
用户可以收到以下告警信息:
WARNING: "pear/DB" is deprecated in favor of "pear/MDB2"
此消息现在可以忽略
Reboot server
reboot
Install Dependencies for Google Voice (If needed/wanted)
安装 iksemel // 如果无需 Google 语音服务，则无需安装
cd /usr/src
wget https://iksemel.googlecode.com/files/iksemel-1.4.tar.gz
tar xf iksemel-*.tar.gz
深圳星昊通科技有限公司 www.hiastar.com
48
cd iksemel-*
./configure
make
make install
Add the Asterisk User
添加一个 Asterisk 用户
adduser asterisk -M -c "Asterisk User"
Install and Configure Asterisk
下载 Asterisk 源代码：
cd /usr/src
wget
http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-
complete-current.tar.gz
wget
http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz
wget
http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-13-current.tar.
gz
git clone https://github.com/akheron/jansson.git
wget http://www.pjsip.org/release/2.2.1/pjproject-2.2.1.tar.bz2
Compile and install DAHDI and LibPRI
注意：如果用户没有安装 Asterisk 语音卡的话，则无需安装这两个软件包，可以忽略此步。
cd /usr/src
tar xvfz dahdi-linux-complete-current.tar.gz
tar xvfz libpri-1.4-current.tar.gz
rm -f dahdi-linux-complete-current.tar.gz libpri-1.4-current.tar.gz
cd dahdi-linux-complete-*
make all
深圳星昊通科技有限公司 www.hiastar.com
49
make install
make config
cd /usr/src/libpri-1.4.*
make
make install
Compile and install pjproject
注意：如果用户使用的是 64 bit 系统，必须首先执行以下配置:
--libdir=/usr/lib64
cd /usr/src
tar -xjvf pjproject-2.2.1.tar.bz2
cd pjproject-2.2.1
CFLAGS='-DPJ_HAS_IPV6=1' ./configure --prefix=/usr --enable-shared
--disable-sound\
--disable-resample --disable-video --disable-opencore-amr
--libdir=/usr/lib64
make dep
make
make install
Compile and Install jansson
注意：如果用户使用的是 64 bit 系统，必须首先执行以下配置命令:
--libdir=/usr/lib64
cd /usr/src/jansson
autoreconf -i
./configure --libdir=/usr/lib64
make
make install
Compile and install Asterisk
深圳星昊通科技有限公司 www.hiastar.com
50
注意：如果用户使用的是 64 bit 系统，必须首先执行以下命令:
--libdir=/usr/lib64
cd /usr/src
tar xvfz asterisk-13-current.tar.gz
rm -f asterisk-13-current.tar.gz
cd asterisk-*
contrib/scripts/install_prereq install
./configure --libdir=/usr/lib64
contrib/scripts/get_mp3_source.sh
make menuselect
系统将要求用户检查所需要的软件包。大部分情况下，以下基本的功能包已经默认安装。
有一些特别的模块可能需要用户自己添加模块选项。例如，如果用户需要支持 mp3 语音格式，
则需要开启 'format_mp3' 模块，系统将编译此模块。
选择 'Save & Exit' ，用户可以进行执行以下命令：
make
make install
make config
ldconfig
深圳星昊通科技有限公司 www.hiastar.com
51
Install Asterisk-Extra-Sounds
注意：我们现在安装的是 (8khz) 'wav' 语音文件和 G722 (High Definition
'Wideband') 语音文件：
mkdir -p /var/lib/asterisk/sounds
cd /var/lib/asterisk/sounds
wget
http://downloads.asterisk.org/pub/telephony/sounds/asterisk-extr
a-sounds-en-wav-current.tar.gz
tar xfz asterisk-extra-sounds-en-wav-current.tar.gz
rm -f asterisk-extra-sounds-en-wav-current.tar.gz
# Wideband Audio download
wget
http://downloads.asterisk.org/pub/telephony/sounds/asterisk-extr
a-sounds-en-g722-current.tar.gz
tar xfz asterisk-extra-sounds-en-g722-current.tar.gz
rm -f asterisk-extra-sounds-en-g722-current.tar.gz
Install and Configure FreePBX
下载解压 FreePBX 源代码.
wget http://mirror.freepbx.org/freepbx-12.0.3.tgz
tar vxfz freepbx-12.0.3.tgz
Set ownership permissions. // 设置系统权限，这一步非常重要。
chown asterisk. /var/run/asterisk
chown -R asterisk. /etc/asterisk
chown -R asterisk. /var/{lib,log,spool}/asterisk
chown -R asterisk. /usr/lib/asterisk
chown -R asterisk. /usr/lib64/asterisk
mkdir /var/www/html
chown -R asterisk. /var/www/
深圳星昊通科技有限公司 www.hiastar.com
52
A few small modifications to Apache.
修改 Apache 配置文件
sed -i 's/\(^upload_max_filesize = \).*/\120M/' /etc/php.ini
cp /etc/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf_orig
sed -i 's/^\(User\|Group\).*/\1 asterisk/'
/etc/httpd/conf/httpd.conf
service httpd restart
Configure Asterisk database in MYSQL.
配置创建 MYSQL 的 asterisk 数据库
cd /usr/src/freepbx
export ASTERISK_DB_PW=amp109
mysqladmin -u root create asterisk
mysqladmin -u root create asteriskcdrdb
Set permissions on MYSQL database.
设置数据库访问权限
mysql -u root -e "GRANT ALL PRIVILEGES ON asterisk.* TO
asteriskuser@localhost IDENTIFIED BY '${ASTERISK_DB_PW}';"
mysql -u root -e "GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO
asteriskuser@localhost IDENTIFIED BY '${ASTERISK_DB_PW}';"
mysql -u root -e "flush privileges;"
Restart Asterisk and install FreePBX.
cd /usr/src/freepbx
./start_asterisk start
./install_amp --installdb --username=asteriskuser
--password=${ASTERISK_DB_PW}
amportal chown
amportal a ma installall
amportal a reload
深圳星昊通科技有限公司 www.hiastar.com
53
amportal a ma refreshsignatures
amportal chown
如果用户看到错误关于 "Uncaught exception 'RuntimeException' with
message 'gpg took too long to run.'"
不用担心，重新执行 "amportal a ma installall" 可以解决此错误.
Finally, one last mod and start FreePBX.
ln -s /var/lib/asterisk/moh /var/lib/asterisk/mohmp3
amportal restart
Start FreePBX
通过浏览器访问 PBX 管理员界面:
http://yourlocalipaddress/html 或者 http://localhost/admin
Install and Setup Commercial Modules
通过 yum repos 开启 FreePBX 商业模块
wget -P /etc/yum.repos.d/ -N
http://yum.schmoozecom.net/schmooze-commercial/schmooze-commercial.
repo
yum 命令将清除所有的 yum 缓存，找到新的 RPM
yum clean all
通过 yum install 安装所需要的 RPM 商业模块
yum -y install php-5.3-zend-guard-loader sysadmin fail2ban incron
ImageMagick
深圳星昊通科技有限公司 www.hiastar.com
54
Restart Apache and Install Sysadmin
完成安装后，重新启动 Apache 和 sysadmin 管理员商业模块
service httpd restart
amportal a ma download sysadmin
amportal a ma install sysadmin
安装 FreePBX Distro 后，需要设置的设置
安装完 FreePBX 以后，几个参数需要设置：
Table of Contents
Login to the PBX Graphical User Interface ("GUI"):
Set a Static IP Address and Configure DNS
Check for FreePBX Distro Updates.
Configure Asterisk SIP Settings
Configure E-Mail Settings
o Configure Email Server
o Configure E-Mail Alert Destination Addresses
Explore the Modules
Configure a T1, PRI, FXO, or FXS Card
Configure Your Phones
Configure Backups
Consider the Paid Modules
Login to the PBX Graphical User Interface ("GUI"):
·通过另外一台同一网段的电脑，使用浏览器访问 PBX 的 IP 地址。
·如果无法获得 PBX IP 地址，请登录 PBX 的 linux 后台，使用 SSH 命令登录 PBX。输入
命令 "ifconfig" ，将显示 PBX 的 IP 地址。
·如果用户安装的是 FreePBX Distro 版本，通过浏览器访问管理界面时，系统将要求用户
创建管理员帐户，包括：用户名称，密码，和邮件。
·输入用户名和密码后，选择管理员，用户将看到 PBX 的配置界面。
深圳星昊通科技有限公司 www.hiastar.com
55
注意：这个用户名称和密码不会修改 Linux 系统后台登陆的 root 用户信息。管理员界面用户
名称和密码仅仅用来登录 FreePBX GUI 界面管理系统。
Set a Static IP Address and Configure DNS
·第一次安装 FreePBX 以后，FreePBX 的 IP 地址是通过 DHCP 获得的。为了保持 FreePBX 分
机注册稳定性，建议 FreePBX IP 地址修改为静态 IP 地址。
·如果使用 FreePBX Distro 或者其他的 FreePBX 2.10 以上的发布版本，可以通过界面
来配置静态 IP 地址。点击 Admin，然后进入系统管理员模块，点击网络设置界面，会出现以
下截图:
·修改 IP Protocol 为 "None" ，然后输入静态 IP 地址，并且设置 IP 地址的子掩码和
默认网关地址 (通常为 192.168.1.1)。
·完成配置以后，点击 save settings。
·继续配置 DNS 服务器地址，需要登录界面手动设置 DNS。
深圳星昊通科技有限公司 www.hiastar.com
56
·在系统管理员模块下，点击 DNS 会看到以下截图:
注意：发布版本默认安装了 DNSMASQ 确保系统一直保持 DNS 服务，如果网络断网以后，
DNSMASQ 将不会继续工作，用户需要在 DNS 服务器的列表中添加 127.0.0.1 。最后那个地址
是 Google 地址。当然用户可以根据自己的网络环境，添加本地的 DNS 地址。完成设置后点击
"Submit"。
Configure Asterisk SIP Settings
▪配置 SIP 帐户地址，需要注意到是检查 "IP Configuration" 部分，错误的配置可能导
致语音单通的问题。
▪确认设置了 external IP 和 local subnets。
Configure E-Mail Settings
Configure Email Server
▪查看系统管理员模块的使用指南，配置邮箱帐号和转发服务器设置。
Configure E-Mail Alert Destination Addresses
FreePBX 有多个模块来支持各种环境下邮件告警。
检查界面设置，输入正确的邮箱地址，以便管理员可以成功收到系统的研究告警信息:
深圳星昊通科技有限公司 www.hiastar.com
57
▪ Admin > System Admin>Notifications Settings
○ From Address: 输入邮件地址，例如. [email protected]
○ Storage Notifications: (输入邮件地址)，发送存储空间告警信息。
○ Intrusion Detection Notifications: (输入邮件地址，发送网络入侵的检测信息)。
○ Abnormal Call Volume Notifications: (输入邮件地址，发送异常呼叫提醒信息)
○统计修改。
▪Settings > Advanced Settings
○ Backup Module
▪Email "From:" Address: 输入邮件地址，发送备份消息通知消息，例如:
▪点击蓝色勾选标志。
▪点击 Apply Config
▪Settings > Fax Configuration
○ Fax Options > Fax Presentation Options
▪Outgoing Email address: 输入邮箱地址，将系统接收到的传真发送到此邮箱，
○ Fax Options > Fax Feature Code Options
▪Email address: 输入默认邮箱地址接收传真，以便对传真做人工处理，例如:
○ Submit
深圳星昊通科技有限公司 www.hiastar.com
58
▪点击 Apply Config
▪ Settings > Voicemail Admin
○ Settings
▪ fromstring: 输入邮箱地址，语音邮箱告警提示将发送到此邮箱，例如：
▪ pagerfromstring: 输入邮箱地址，语音邮箱告警提示将发送到此邮箱，例如：
▪ serveremail: 和 "fromstring"设置类似。
○ Submit
▪点击 Apply Config
了解 FreePBX 主要模块
配置完整的 PBX 功能需要通过各种 FreePBX 模块来完成。
从界面的主菜单可以看出来，这些模块分成几个主要类别：
通常情况下，用户需要使用的主要模块包括了：
Advanced Settings:这个模块分类支持对各种默认设置进行修改。
General Settings: FreePBX 2.10 和早期版本用来支持各种 FreePBX 的基本设置。后期
版本这个模块则分成了不同的模块设置。具体配置请查看官方网站的模块配置文档。.
Asterisk SIP Settings: 此模块分类配置默认的 SIP 电话设置。.
Voicemail Admin: 此模块分类负责对语音邮箱进行管理。
Trunks Module: 中继在 PBX 环境中相当于电话线。中继负责接收或者发送来自于系统
外部的呼叫。如果没有中继的话，PBX 不能做任何外部呼叫或者呼入。用户可以配置 PBX 通
过中继线路对接运营商的语音服务，或者通过 PSTN 媒体网关接入到运营商提供的固定电话线
深圳星昊通科技有限公司 www.hiastar.com
59
路上包括（FXO/PRI），当然也可以通过 SIP 或者 IAX 对接到第三方的 PBX 上，通过 SIP/IAX
中继呼叫外部电话号码。
大部分运营商会提供一个对接 FreePBX 的对接帐号信息和配置指导说明书。
Extensions Module: 分机模块负责对系统中的分机进行创建设置。这个模块中，用户可
以对系统分机创建用户名称，密码和邮箱邮箱设置。注意，这个模块仅仅对 FreePBX 和
asterisk 进行设置。用户必须在其他终端配置终端话机连接到 PBX系统上，或者使用 Endpoint
Manager 模块部署系统分机。
Follow-me: 分机随行模块对指定分机进行更为复杂的呼叫路由引导。使用这个模块，用
户可以对一个分机进行呼叫振铃或者对多个分机或者外部号码进行呼叫振铃。用户同样也可以
对单点用户分机邮箱进行转移呼叫或者留言。
例如:可以使用分机随行呼叫分机 10，11，12 和你朋友的手机号码，如果无人应答的情
况下，要求呼叫流程转接到分机 17。这样的服务，可以模拟出一个运营商的电话邮箱的服务
功能，更加方便用户管理分机随行，并且不会丢失未接来电。
Ring Groups Module: 振铃组支持一个创建一个号码，呼叫进入这个振铃组以后对组内成
员振铃。振铃组必须添加一个以上的成员，例如分机 10，11，12 等等。例如用户可以创建一
个振铃组 601，其他用户呼叫这个振铃组号码时，组内成员分机 10，11，12 会同时振铃。振
铃完成以后可能进入下一个呼叫流程，例如进入分机语音邮箱 17 等等。
Inbound Routes Module: 呼入路由上系统 PBX 用来控制外部呼叫进入 PBX 时的一个控
制机制，呼入路由可以要求呼入的电话进入到任何一个设置的呼叫目的地对象。通常情况下，
系统可以设置 PBX 要求外部呼入号码或者 DID 号码进入到相应的呼叫流程，例如可以让系统分
机接听此呼叫，可以对振铃组振铃，可以进入语音邮箱，也可以进入语音 IVR，语音导航或者
其他的目的地对象。
Parking Lot: 电话驻留地模块支持用户对呼入的电话驻留到一个指定的空间，一段时间
后可以再次访问这个空间继续接听被驻留的呼叫。通常情况下，用户会把电话驻留到分机 70，
当系统通知用户在此分机下有被驻留的呼叫时，用户可以拨打分机 71 来接听此呼叫。系统中
的其他用户也可以拨打 71 来接听呼叫。
深圳星昊通科技有限公司 www.hiastar.com
60
Feature Codes Module: 功能代码模块支持用户提供 PBX 热键来完成各种业务功能，例
如呼叫前转。免打扰，语音邮箱，监听或者录音等等功能。当然用户也可以根据实际情况，开
启或关闭功能代码热键。
Paging and Intercom: 默认环境下，用户拨打 *80 加分机号码，可以实现对此分机号
码寻呼。讯呼和对讲模块定义了一个分机组号码，用户可以拨打此号码实现讯呼对讲。例如，
在小型办公环境下，定义一个对讲组，通过拨打对讲号码实现整个办公室的对讲。
Conferences Module:会议模块支持用户创建一个会议室的会议号码。用户拨打此会议室
的号码则可以进入会议室，加入会议。例如用户拨打分机 800，则可进入会议室。
System Recordings Module: 系统录音模块管理整个系统的语音录音文件。
IVR Module: 语音 IVR 模块支持创建语音 IVR 并且管理其 IVR 设置。
DISA ("Direct Inward System Access"): 外部直呼模块支持 PBX 系统外部用户呼入
到系统后，系统拨号音提示后进行二次拨号，转呼到系统外部或者实现内部对讲。为了安全的
考虑，这样的功能通常情况下要求系统必须设置密码保护功能，需要外部用户输入密码验证，
验证通过才能执行二次呼叫。通常情况下，为了节省话费，或者选择分类低的线路，外部用户
通过这样的方式呼叫其他的线路呼出。
Backup and Restore: 备份还原模块支持系统对 PBX 设置和系统录音进行备份还原。
Configure Your Phones
FreePBX 本身支持了对分机自动配置的商业模块，支持目前市场上大部分的物理 SIP 话机
厂家的产品，模块名称为 End Point Manager，更多关于这个模块的介绍，请查看官方网站
的模块说明。
Configure Backups
现在需要我们配置备份模块来设定一个定期备份的机制。提醒大家的是，备份模块请必须
先做测试，保证模块可以正常工作。
深圳星昊通科技有限公司 www.hiastar.com
61
Consider the Paid Modules
FreePBX 发布版本包括了各种 PBX 的必要功能。但是我们同时提供了一些功能丰富，实用
的商业模块，用户无需进行开发，直接安装配置就可以实现用户的需求，例如，呼叫中心外呼
模块，传真模块，会议模块，高可靠性解决方案的模块。如果对商业模块感兴趣，请访
问: http://www.freepbx.org/commercial-modules
Administrators 模块用户指南
Introduction
Logging In
User Creation
o General Settings
Username
Password
o Access Restrictions
Department Name
Extension Range
Admin Access
o Save User:
介绍
管理员模块支持用户对任何用户添加用户名称和密码，允许用户访问设置的应用模块。用
户可以选择独立的模块支持用户访问，也可以设置用户访问所有的模块
使用注意事项：一些预设平台可能有自己的认证方式，没有必要使用 FreePBX 内部设置方式。
这个方式支持用户对 freePBX 标准设置。
登录
▪ 登录 FreePBX 界面
▪ 点击最上面的 Admin
▪ 点击下拉菜单中的 Administrators
深圳星昊通科技有限公司 www.hiastar.com
62
用户将看到以下信息:
创建用户
一旦登录以后，用户可以看到当前用户列表。如果没有创建用户名单的话，可以看到最初
的用户信息。如果有显示任何用户的话，可以点击编辑此用户来对其进行设置。
使用注意事项
用户将总是看到一个用户支持了 "ALL SECTIONS" 访问。用户名称不是最重要的。可以添
加用户，如果在当前页面的话，可以点击添加用户来链接到用户列表。
基本设置
Username
这是用户登录使用的用户名称。用户名称不能有空格，并且必须是唯一的。例如一些系统
关键词 "admin," "administrator," 和 "maint" 是在系统环境中使用非常普遍的关键词，
所以尽量避免使用。使用容易记忆的名称。你可以使用公司名称或者公司名称加 "admin" 结
尾。
深圳星昊通科技有限公司 www.hiastar.com
63
Password
对用户名称设置的密码。密码不能包括空格。密码应该至少 8 个以上字符，包含大写字母，
小写字母和数字。我们没有设置密码设置的下线，但是用户在实际使用时，必须使用安全的密
码设置措施。
模块访问权限设置
Department Name
这个值得设置已经不在有效，可以为空。
Extension Range
这个值的设置范围已经不在有效，可以为空。
Admin Access
可以选择允许系统用户访问的模块列表。使用键盘的 Control 按键进行多选。
深圳星昊通科技有限公司 www.hiastar.com
64
使用注意事项
完成选项选择以后不要忘记点击 "Apply Configs" 以便获得更新，仅仅保存以后，没有
点击 Apply Config 按钮，仍然无效。
Save User:
点击 "Submit Changes" 按钮，不要忘记再点击页面顶部的 "Apply Changes" 。用户选
择可以退出界面，然后以新用户帐号登录，确认可以按照我们的要求工作。
Announcements 语音播报模块使用指南
Overview
Logging In
Creating an Announcement
o Description
o Recording
o Repeat
o Allow Skip
o Return to IVR
o Don't Answer Channel
o Destination after Playback
o Save
Editing/Deleting an announcement
总览
Announcements 语音播报模块支持对呼叫方播放一个提前录制的语音文件，语音播报完毕
后，系统做下一步的电话处理流程。不要和系统录音模块混淆。系统录音模块是用来创建实际
的系统通话录音。Announcement 语音播报模块是用来支持用户对提前录制的文件进行播放，
然后根据呼叫流程做进一步处理。一般应用场景就是通常所说的企业 IVR 语音系统。
登录
从界面菜单顶部，点击 Applications
从下拉菜单中点击 Announcements
深圳星昊通科技有限公司 www.hiastar.com
65
创建一个语音播报流程
默认加载的界面，如果没有任何新的设置文件，界面将引导用户添加 Announcement 表。
Description
添加一个播报文件的名称描述
Recording
是否需要录音，这是实际系统录音文件。
Repeat
可以通过输入按键 0-9，* 或者# 支持用户可能重复播放一个语音文件。
Allow Skip
深圳星昊通科技有限公司 www.hiastar.com
66
如果启用此选项，将支持允许用户跳过，呼叫方可以摁电话盘上的任意键跳过同时结束录
音。系统将引导用户进入到语音播报中设置的目的地流程。
Return to IVR
正常环境下，呼叫方听到语音播报后，会根据系统设置的目的地引导呼叫方进入下一个呼
叫流程。如果开启这个选项，用户会重新回到呼叫方以前进入到 IVR 流程中。这样设置非常方
便，因为一个语音播报只能路由到一个目的地，如果有多个 IVR 指到这个语音播报时，或用户
需要对每个 IVR 创建分离的语音播报。这个选项可以支持用户创建多层交互的语音 IVR 和不同
的路由目的地。
Don't Answer Channel
正常呼叫流程中，我们推荐的方式是首先应答此呼叫，然后播放语音提示。如果希望对呼
叫方播放语音例如早期媒体流时，可以开启此选项。我们不推荐开启这个选项，因为很多运营
商不支持发送早期媒体流动语音文件。
Destination after Playback
回放语音后目的地选项。在我们的实例中，我们的呼叫路由到了系统的主 IVR 菜单，我们
也记得我们选择了 Return to IVR 选项。如果是这样的设置，呼叫方会从 IVR 退出，然后退
回到接入 IVR 的目的地对象。
Save
点击 Submit changes 保存。
记得点击 Apply Changes 按钮使得系统生效。
Editing/Deleting an announcement
菜单右侧导航栏中显示了系统的语音播报列表，用户可以点击语音播报的名称做出编辑或
者修改。
点击 Submit changes 保存修改配置。
如果需要删除语音播报，则点击 Delete 删除语音播报。
深圳星昊通科技有限公司 www.hiastar.com
67
完成以后，点击 Apply Changes 按钮重新加载。
Asterisk CLI 模块
Asterisk CLI 模块的作用
Asterisk CLI 模块支持用户通过界面来执行 Asterisk CLI 命令，获得最终输出结果。
如何获得 Asterisk CLI 模块
○ 登录到 FreePBX 界面.
○ 在菜单顶部，点击 Admin
○ 点击下拉菜单中的 Asterisk CLI
使用
在输入栏中输入 Asterisk CLI 命令
按 Execute
通过系统控制台:
深圳星昊通科技有限公司 www.hiastar.com
68
通过浏览器:
用户可以通过浏览器，登录界面，执行 asterisk CLI 命令来查看 asterisk 状态信息。
Asterisk Info 模块使用指南
总览
Asterisk 信息页面可以支持用户查看 Asterisk 系统关键的状态数据，例如分机注册状
态信息或者 “BLF Hints” 功能来订阅查看其他分机的状态信息，以便快速排查问题。
使用注意
这一功能是针对 Asterisk 高级用户。
登录
▪访问菜单顶部，点击 Reports
▪点击下拉菜单中的 Asterisk Info
Reports
总结
这个状态汇总信息提供以下数据:
▪ Uptime – Asterisk 在无重启状态下，连续运行的时间.
▪ Reload – 最后一次 reload 时间。一个真正的 reload 发生在修改界面以后，并且点击
“Apply Configuration” 按钮。.
▪ Active SIP Channels – 显示目前有多少活动的 SIP 通道。请注意，这不是真正意义
的活动的呼叫数量，单个呼叫可能有 2 个或者多个 SIP 通道参与。
▪ Active IAX2 Channels -显示目前有多少活动的 IAX 通道。请注意，这不是真正意义的
活动的呼叫数量，单个呼叫可能有 2 个或者多个 IAX 通道参与。
▪ SIP Registry – 已经注册到 Asterisk 服务器的 SIP 用户数量。这里通常显示的是 SIP
中继注册数量。
深圳星昊通科技有限公司 www.hiastar.com
69
▪ IAX2 Registry – 已经注册到 Asterisk 的 IAX 用户数量，通常显示的是 IAX2 中继数
量。
▪ SIP Peers – 多少 SIP peers 在线或离线数量。一个 SIP peer 可能是一个分机或中
继
▪ IAX2 Peers – 多少 IAX2 peers 在线或离线数量。一个 IAX2 peer 可能是一个分机或
者中继。
Registries
注册将显示每个注册到 Asterisk 的连接。通常是一个 Asterisk 中继。这个状态仅仅显示
已经注册到 Asterisk 的信息，不是正在注册的中继信息。
Channels
通常看到是活动状态的通道信息。一个通道是两个设备之间的单个通信，例如从 Asterisk
到电话终端或者从中继到 Asterisk
一个呼叫会显示两个通道:
▪ 一个是从中继到 Asterisk
▪ 另外一个是从 Asterisk 到电话
Peers
Peers 是正在系统注册的设备或中继。当查看一个 peer 状态时，我们可以获得一些有用
的信息。以下信息可能是大家比较感兴趣的信息:
▪ Name – 这是分机名称或中继名称。
▪ Host – 设备 IP 地址或中继 IP 地址。
▪ Status – 显示已连接的设备状态信息。以毫秒单位。数字越大。说明网络存在的问题
比较严重。如果大于 200ms 可能引起语音问题。
深圳星昊通科技有限公司 www.hiastar.com
70
SIP Info
Sip Info 结合了 Registry 和 Peers 的信息，但是仅显示 SIP Peers 和 Registries，不
显示 IAX2 信息。
IAX Info
IAX Info 结合了 Registry 和 Peers 的信息，但是仅显示 IAXs Peers 和 Registries，
不显示 SIP 信息。
Conferences Report
显示当前会议系统中的活动电话会议呼叫信息。
请注意参考 ConfBridge 和 MeetMe。一般来说我们仅使用其中之一，可能另外一个会提
示错误信息。
Subscription Report
显示所有系统创建的 hints 列表。一个 hint 表示一个在线状态忙提示按键。一个比较简
单的例子如，系统可能有 BLF 按键使用了 101 分机，所以任何时候，如果用户 101 正在进行呼
叫，这个按键将显示红色。我们可以看到所有按键颜色状态。
Voicemail Users Report
浏览语音邮箱数量和每个语音邮箱有多少新增邮件数量。
Queues Report
队列报表显示已创建队列和相应的数据统计，例如:
▪ 等待应答的呼叫方
▪ 登录的坐席成员和当前状态
○ Paused
○ Not Paused
○ In use
深圳星昊通科技有限公司 www.hiastar.com
71
○ Not-In use
Asterisk 系统日志文件
Asterisk Logfiles
Asterisk 日志文件可以通过此模块来查看。
更多 asterisk 或者 linux 系统日志可以登录到系统后台来查看。用户必须可以使用 SSH
或者其他的 SSH 工具来访问服务器。Putty 是用户经常使用的主要工具。
通过 root 用户帐号和密码登录到 Asterisk 后台，登录后，用户可以执行以下命令来访问
系统的 asterisk 日志:
cd /var/log/asterisk
输入命令，然后回车:
ls -l
通常情况下，当天的日志文件名称为"full"，其他早期的日志文件名称为"full.xxx" 或
者 full-xxx"，这里 xxx 表示系统日期。
如果用户想查看当天的日志信息，可以通过编辑器命令或者 vi :
nano full
系统会显示日志文件的所有呼叫记录。当然也会可以翻看其他页面的日志信息。
amportal restart
注意：此命令不会马上重新启动 freepbx 和 asterisk，系统会等待 120 秒，等待系统中的呼
叫结束后才会重新启动 asterisk。用户可以通过高级设置界面来修改这个系统等待时间。
用户也可以通过 linux 查询命令来查看日志文件中特定的一些日志信息或者重新拷贝日
志信息到另外一个新的日志文件。具体命令工具包括 grep，tail 等等系统命令工具，用户可
以访问 linux 学习资源来获得更多帮助。
深圳星昊通科技有限公司 www.hiastar.com
72
Asterisk Managers 用户使用指南
Overview
Logging In
Add Manager
o Manager Information
Manager Name
Manager Secret
Deny
Permit
o Rights
Save
总览
Asterisk API 接口是一个应用程序接口支持 Asterisk Manager 和系统外部程序通过
TCP/IP 通信接口来执行命令或者读取事件信息，常用的使用场景包括呼叫器，管理后台等等
应用。
登录
▪ 从菜单顶部点击 Settings
▪ 下拉菜单中选择 Asterisk Managers
添加 Manager
Manager 信息
深圳星昊通科技有限公司 www.hiastar.com
73
Manager Name
管理员名称，无空格
Manager Secret
管理员密码.
Deny
这里定义 IP Address/Subnet Mask 限定管理 IP 范围。如果需要限定更多的 IP 段，请使
用 “&” 字符作为分隔符，例如 192.168.0.0/255.255.0.0&10.0.10.0/255.255.255.0。
Permit
这里定义允许访问的 IP Address/Subnet Mask 声明。可以像 Deny 声明一样管理用户访
问。
Rights
用户可以对系统管理员进行各种权限设置和管理，更多信息，请访问:
https://wiki.asterisk.org/wiki/display/AST/The+Asterisk+Manager+TCP+IP+API
深圳星昊通科技有限公司 www.hiastar.com
74
保存
完成以后，点击 Submit Changes
Asterisk 电话薄模块使用指南
Introduction and Overview
Logging In
Creating a Phonebook Entry
o Name
o Number
o Speed dial code
o Set Speed Dial
深圳星昊通科技有限公司 www.hiastar.com
75
o Save your changes
Import from CSV
o File
o Upload
介绍和总览
Asterisk 电话薄模块支持用户提供一个系统通用的快速拨号方式，任何电话可以通过电
话薄进行快速呼叫。
使用此功能需要开启快速拨号热键功能，它默认附带前缀 *0 。例如如果快速拨号的 100，
则需要拨打 *0100 。
注意：这个模块不管理公司目录 directory
登录
通过浏览器登录 PBX 界面.
在菜单顶部点击 Admin
在下拉菜单中点击 Asterisk Phonebook
以下截图中还没有任何电话薄记录:
深圳星昊通科技有限公司 www.hiastar.com
76
创建一个电话薄记录
Name
输入个人或业务人员名称。
Number
输入需要拨打的号码。为了保证 caller ID 可以工作，它应该匹配它收到的 caller ID。
这个号码就是用户希望拨打的号码。
Speed dial code
输入快速拨号代码。快速拨号模块必须开启。
这个号码将替换上面的号码。所以如果拨打 16025551212，用户可以直接拨打 1001 来代替。
Set Speed Dial
开启触发功能开关，将自动创建快速拨号功能，如果输入了快速拨号代码，不会检测到此
功能。
Save your changes
完成输入信息以后，点击 "Submit Changes Button" ，然后不要忘记点击 "Apply
Changes"。
保存以后的信息将显示如下
深圳星昊通科技有限公司 www.hiastar.com
77
注意： "Export in CSV" 支持用户以 CSV 文件形式导出记录。用户可以删除或编辑这些单个
的记录。
使用注意事项："Empty Phonebook" 不能退回。如果没有保存这个记录，整个记录将丢失。所
以用户可以导出一个 CSV 文件。
Import from CSV
电话薄可以通过 CSV 文件导入，以下是文件格式:
"Tango D. Frog";6025551212;82646 ，名称和号码必须是一行，一个记录一行。.
使用注意事项: “Name” 是唯一的，使用封号隔开。用户可以添加多个记录。参考导出的 CSV
文件实例。
File
点击 "Chose File" 现在以前导出的文件导入
Upload
点击 "Upload button"，然后点击 "Apply Changes" 。用户记录将会显示在记录页面。
使用注意事项:这个模块使用号码作为数据记录的 key，如果输入同样的号码，将覆盖整个此
记录.
深圳星昊通科技有限公司 www.hiastar.com
78
Asterisk REST 接口用户使用指南
Introduction
Logging In
First Run
o Enable the Asterisk REST Interface
o Pretty Print JSON Responses
Adding User
o REST Interface User Name
o REST Interface User Password
o Password Type
Crypt
Plain Text
o Read Only
介绍
Asterisk REST 接口用户模块是用来创建用户，以便支持 Asterisk Rest 接口。
▪ 这个模块要求至少 Asterisk 12 以上版本.
▪ 这个模块必须先从高级设置那里开启。
登录
登录到 FreePBX 界面。
菜单顶部点击 Settings。
在下拉菜单中点击 Asterisk REST Interface User。
首先运行
这个模块在高级设置里面默认是关闭状态。.
▪ 点击顶部的 Settings
▪ 在下拉菜单中点击 Advanced Settings
深圳星昊通科技有限公司 www.hiastar.com
79
Enable the Asterisk REST Interface
是否开启 Asterisk REST 接口.
Pretty Print JSON Responses
JSON 响应消息
添加用户
REST Interface User Name
调用 REST API 用户名称
REST Interface User Password
调用 REST API 密码
深圳星昊通科技有限公司 www.hiastar.com
80
Password Type
Crypt
以 Crypt(3) 加密方式保存密码
Plain Text
以普通文本格式保存
Read Only
开启用户读写权限设置.
黑名单模块用户使用指南
Overview
Logging in
Blacklisting a number
o Number
o Description
o Submit Changes
Blocking Unknown Caller ID Calls
Feature Codes to Block Numbers
总览
黑名单模块支持在 PBX 系统中的某些电话用户进行过滤。如果呼叫方是被列入黑名单中，
电话呼入系统后，PBX 将播放一些语音信息，例如，呼叫方可能听到"你说拨打的号码是无效
号码，请检查重新呼叫。"
登录
▪ 在菜单顶部点击 Admin
▪ 在下拉菜单中点击 Blacklist
深圳星昊通科技有限公司 www.hiastar.com
81
过滤黑名单中的号码
为了对黑名单电话号码进行过滤，添加以下信息。
Number
希望过滤的号码，例如，我们例子中的号码 9208861234。
Description
添加号码持有人描述，例如，“Ex Stalker Employee John”。
Submit Changes
完成以后，点击 "Submit Changes"。
过滤未知来电呼叫
同样，用户可以选择过滤所有系统中的黑名单号码。点击选项 “Block Unknown/Blocked
Caller ID” 然后提交。
如果用户的号码是在黑名单中的号码，呼入以后系统将播放系统用户号码不在服务状态。
使用快捷键过滤号码
用户同样可以通过快捷键对黑名单号码进行管理。如果用户登录系统界面后，可以看到所
有默认的快捷键。以下是对黑名单管理的快捷键默认设置：
深圳星昊通科技有限公司 www.hiastar.com
82
拨打 *30 将提示用户输入需要过滤的号码，并且添加到黑名单中。
拨打 *32 将把最后一次呼叫用户的号码添加到黑名单。
拨打 *31 将提示系统用户从黑名单中删除一个已过滤的号码。
Bulk DID 模块用户使用指南
Overview
Logging in
Exporting DID's
Importing DID's
总览
DID 批处理模块支持用户从 CSV 导入呼入路由。如果用户有多个号码时，通过此方式可
以节省用户配置时间。
登录
从顶部菜单中点击 Applications
从下拉菜单中点击 Bulk DID's
导出 DID 号码
用户可以使用 CSV 导出所有的 DID 号码。导出以后，修改 DID 号码以后重新导入。
从主页摁“Export DIDs”按钮用户可以下载 DID 的 CSV 文件。
用户可以通过 Excel 文件编辑器打开 CSV 文件，编辑文件或者添加新的记录。
CSV Fields
action,DID,description,destination,cidnum,pricid,alertinfo,grppre,mohclass,ri
nging,delay_answer,privacyman,pmmaxretries,pmminlength,cidlookup,langcode,faxdete
ct,faxdetectiontype,faxdetectiontime,faxdestination
深圳星昊通科技有限公司 www.hiastar.com
83
用户可以修改以下表中的顺序，但是列名称不能修改，它是系统预留名称。
# Field Default Allowed Field
Details Description
1 action add,
edit, del
Add, Edit, or Delete an Inbound
Route.
2 DID DID Number The incoming DID to match
3 description Description Provide a meaningful description
of what this incoming route is
4 destination Destination
The context, extension, priority
to go to when this DID is matched.
Example: app-daynight,0,1
5 cidnum Caller ID
Number
Define the Caller ID Number to be
matched on incoming calls. Leave
this field blank to match any or no
CID info. In addition to standard
dial sequences, you can also put
Private, Blocked, Unknown,
Restricted, Anonymous and
Unavailable in order to catch these
special cases if the Telco
transmits them.
6 pricid CHECKED CID Priority
Route
This effects CID ONLY routes where
no DID is specified. If checked,
calls with this CID will be routed
to this route, even if there is a
route to the DID that was called.
Normal behavior is for the DID
route to take the calls. If there
is a specific DID/CID route for
this CID, that route will still
take the call when that DID is
called
7 alertinfo Alert Info ALERT_INFO can be used for
distinctive ring with SIP devices.
8 grppre CID Name
Prefix
You can optionally prefix the
Caller ID name. ie: If you prefix
with "Sales:", a call from John Doe
would display as "Sales:John Doe"
on the extensions that ring.
9 mohclass default Music On
Hold Class Defaults to "default"
深圳星昊通科技有限公司 www.hiastar.com
84
10 ringing CHECKED Signal
Ringing
Some devices or providers require
RINGING to be sent before ANSWER.
You'll notice this happening if
you can send calls directly to a
phone, but if you send it to an IVR,
it won't connect the call.
11 delay_answe
r
Pause Before
Answer
An optional delay to wait before
processing this route. Setting
this value will delay the channel
from answering the call. This may
be handy if external fax equipment
or security systems are installed
in parallel and you would like them
to be able to seize the line
12 privacyman 1 to
enable
Privacy
Manager
If no Caller ID is sent, Privacy
Manager will asks the caller to
enter their 10 digit phone number.
The caller is given 3 attempts. The
number of digits and attempts can
be defined in privacy.conf. If a
user has Call Screening enabled,
the incoming caller will be asked
to enter their CallerId here if
enabled, and then to say their name
once determined that the called
user requires it.
13 pmmaxretrie
s 1 to 10
Max
attempts
Number of attempts the caller has
to enter a valid callerID, only
valid if privacyman is set to 1
14 pmminlength 1 to 15 Min Length
Minimum amount of digits callerID
needs to contain in order to be
considered valid, only valid if
privacyman is set to 1
15 cidlookup Number CID Lookup
ID
Number representing the index id
for Caller ID Lookup Source
16 langcode Language
Code
Valid
Language
Code
A valid Asterisk language code such
as 'en', 'fr' or 'sv'
17 faxdetect yes or no Detect
Faxes Attempt to detect faxes on this DID
深圳星昊通科技有限公司 www.hiastar.com
85
18 faxdetectio
ntype
dahdi,
nvfax,
sip
Fax
Detection
type
Type of fax detection to use
19 faxdetectio
ntime 2 to 10
Fax
Detection
Time
How long to wait and try to detect
fax. Please note that callers to a
Dahdi channel will hear ringing for
this amount of time (i.e. the
system wont "answer" the call, it
will just play ringing).
20 faxdestinat
ion Destination
Where to send the call if we detect
that its a fax.
导入 DID
用户可以在任何时候导入 DID 的 CSV 格式。建议用户先从 PBX 导出一个可使用的 DID，这
样可以看到实际的数据 CSV 格式。在顶部看到的每个栏名称实际上是和 GUI 的完全一致。
只有一个不同的地方就是呼入路由模块中的 action 值。这个 action 值定义每个数据的
下一步指令。支持的选项包括:
▪ add – 如果是新 DID 数据，可以设置为 “add.”
▪ del – 如果计划从 PBX 中删除数据，可以设置为 “del.”
▪ edit – 如果想重新编辑这个数据，可以设置为 “edit.”
如果需要导入新的 CSV 文件，点击 “Choose File” 选项，从本地电脑中选取你需要的
文件。完成以后，摁 “Load File” 按钮。
分机批处理模块使用指南
Overview
Logging in
Exporting Extensions
o Bulk Extensions CSV File Columns
Importing Extensions
深圳星昊通科技有限公司 www.hiastar.com
86
总览
分机批处理支持用户从 CSV 文件导入用户分机。当部署大型系统时，需要创建很多分机时，
用户使用此功能会非常方便，并且节省时间。
注意：分机批处理需要花费一定的时间。对 100 个分机的系统，这个流程大约需要 30-60 秒左右。如果是
2000 个分机的系统，添加 100 个分机需要大概 5 分钟的时间。
登录
从菜单点击 Applications
从下拉菜单中点击 Bulk Extensions
导出分机
用户可以把当前的分机导出到一个 CSV 文件。用户可以修改任何分机，然后重新导入这
些分机。
在主界面点击 “Export Extensions” 按钮，系统会下载当前分机的 CSV 文件。
用户可以使用任何应用软件打开这个文件。
分机批处理的 CSV 文件列
这个表解释了 CSV 文件中的每一列的含义。用户可以修改列的顺序，但是列的名称是系统
预留名称，不能修改。
# Name Default Allowed On Details
Extensions page
1 action add,
del,
edit
Add, Delete,
or Edit an
Extension.
2 extension User Extension
The
extension
number to
dial to
reach this
user.
3 name Display Name The caller
id name for
calls from
this user
深圳星昊通科技有限公司 www.hiastar.com
87
will be set
to this
name. Only
enter the
name, NOT
the number.
4 cid_masque
rade
CID Num Alias The CID
Number to
use for
internal
calls
5 sipname SIP Alias If you want to
support direct
sip dialing of
users
internally or
through
anonymous sip
calls, you can
supply a
friendly name
that can be
used in
addition to
the user's
extension to
call them.
6 outboundcid Outbound CID Overrides the
caller id when
dialing out a
trunk. Any
setting here
will override
the common
outbound caller
id set in the
Trunks admin.
Format: "calle
r name"
<#######>
Leave this field
blank to disable
深圳星昊通科技有限公司 www.hiastar.com
88
the outbound
CallerID feature
for this user.
7 ringtimer 0 0-120 Ring Time Number of
seconds to ring
prior to going to
Voicemail. 0
(Default) will
use the value set
in the General
Tab. If no
Voicemail is
configured this
will be ignored.
8 callwaiting enabled enabled,
disabled
Call Waiting Set the
initial/current
Call Waiting
state for this
user's
extension.
9 call_screen 0 0,
nomemor
y,
memory
Call Screening Call Screening
requires external
callers to say their
name, which will be
played back to the
user and allow the
user to accept or
reject the call.
Screening with
memory only
verifies a caller
for their caller-id
once. Screening
without memory
always requires a
caller to say their
name. Either mode
will always
announce the caller
based on the last
introduction saved
with that CallerID.
If any user on the
system uses the
深圳星昊通科技有限公司 www.hiastar.com
89
memory option, when
that user is called,
the caller will be
required to
re-introduce
themselves and all
users on the system
will have that new
introduction
associated with the
caller's
CallerID.Set the
initial/current
Call Waiting state
for this user's
extension.
10 pinless enabled,
disabled
Pinless Dialing" Enabling Pinless
Dialing will
allow this
extension to
bypass any pin
codes normally
required on
outbound calls
11 password For logging in
and out of
devices in
deviceanduser
mode, not
available on
Extensions page.
12 noanswer_des
t
Text in
the
format
context,
exten,pr
iority
that is
an
active
dialplan
destinat
ion on
the
Optional
Destinations, No
Answer (Extensions
page)
Optional:
Setting a
destination here
where to send the
call if the
called extension
was not answered
深圳星昊通科技有限公司 www.hiastar.com
90
system
13 noanswer_cid Optional
Destinations, CID
Prefix (Extensions
page)
You can
optionally
prefix the
Caller ID name
when sending the
call to the above
destination. ie:
If you prefix
with 'No
Answer:', a call
to John Doe that
was not answered
would display as
'No Answer:John
Doe' on the
extensions
belonging to the
destination
selected
14 busy_dest Text in
the
format
context,
exten,pr
iority
that is
an
active
dialplan
destinat
ion on
the
system
Optional
Destinations, Busy
(Extensions page)
Optional:
Setting a
destination here
where to send the
call if the
extension was
busy
15 busy_cid Optional
Destinations, CID
Prefix (Extensions
page)
You can
optionally
prefix the
Caller ID name
when sending the
call to the above
destination. ie:
If you prefix
with 'Busy:', a
call to John Doe
深圳星昊通科技有限公司 www.hiastar.com
91
that was busy
would display as
'Busy:John Doe'
on the
extensions
belonging to the
destination
selected
16 chanunavail_
dest
Text in
the
format
context,
exten,pr
iority
that is
an
active
dialplan
destinat
ion on
the
system
Optional
Destinations, Not
Reachable (Extensions
page)
Optional:
Setting a
destination here
where to send the
call if the
extension was
not reached
17 chanunavail_
cid
Optional
Destinations, CID
Prefix (Extensions
page)
You can
optionally
prefix the
Caller ID name
when sending the
call to the above
destination. ie:
If you prefix
with 'Not
Reached:', a
call to John Doe
that was busy
would display as
'Not
Reached:John
Doe' on the
extensions
belonging to the
destination
selected
18 emergency_ci
d
Emergency CID This caller id
will always be
深圳星昊通科技有限公司 www.hiastar.com
92
set when dialing
out an Outbound
Route flagged as
Emergency. The
Emergency CID
overrides all
other caller id
settings.
19 tech sip,
iax2,
zap,
custom
Device channel
type.
20 hardware generic,
custom,
(can
leave
blank)
21 devinfo_chan
nel
channel See zapata.conf.
22 devinfo_secr
et
secret See sip.conf
file or iax.conf
file.
23 devinfo_notr
ansfer
yes notransfer See iax.conf
file.
24 devinfo_dtmf
mode
rfc2833 dtmfmode See sip.conf
file.
25 devinfo_canr
einvite
no canreinvite See sip.conf
file.
26 devinfo_cont
ext
from-int
ernal
context Device context.
27 devinfo_imme
diate
no immediate See zapata.conf
file.
28 devinfo_sign
alling
fxo_ks signalling See zapata.conf
file.
29 devinfo_echo
cancel
yes echocancel See zapata.conf
file.
30 devinfo_echo
cancelwhenbr
idged
no echocancelwhenbridge
d
See zapata.conf
file.
31 devinfo_echo
training
800 echotraining See zapata.conf
file.
32 devinfo_busy
detect
no busydetect See zapata.conf
file.
33 devinfo_busy 7 busycount See zapata.conf
深圳星昊通科技有限公司 www.hiastar.com
93
count file.
34 devinfo_call
progress
no callprogress See zapata.conf
file.
35 devinfo_host dynamic host See sip.conf
file or iax.conf
file.
36 devinfo_type friend type See sip.conf
file or iax.conf
file.
37 devinfo_nat yes nat See sip.conf
file.
38 devinfo_port port See sip.conf
file or iax.conf
file. Default
for sip is 5060,
iax2 is 4569.
39 devinfo_qual
ify
yes qualify See sip.conf
file or iax.conf
file.
40 devinfo_call
group
callgroup See sip.conf
file.
41 devinfo_pick
upgroup
pickupgroup See sip.conf
file.
42 devinfo_disa
llow
disallow See conf file for
device tech.
Codec(s) to
disallow.
43 devinfo_allo
w
allow See conf file for
device tech.
Codec(s) to
allow.
44 devinfo_dial dial See conf file for
device tech.
Default is
TECH/exten, i.e
SIP/101. For zap
it is
TECH/channel,
i.e. ZAP/1.
45 devinfo_acco
untcode
accountcode See conf file for
device tech.
46 devinfo_mail
box
mailbox See conf file for
device tech.
Default is
深圳星昊通科技有限公司 www.hiastar.com
94
exten@device,
i.e 101@device.
47 devinfo_deny deny Network/Mask of
IP address range
to deny. Default
is
0.0.0.0/0.0.0.0
(or everything).
48 devinfo_perm
it
permit Network/Mask of
IP address range
to permit.
Default is
0.0.0.0/0.0.0.0
(or everything).
Valid examples
would be:
192.168.1.0/255
.255.255.0 (all
IP addresses
from
192.168.1.0-255
) or
10.1.0.42/255.2
55.255.255 (a
single address).
49 devicetype fixed fixed,
adhoc
Extensions
require that
devicetype be
fixed. If
devicetype is
adhoc, FreePBX
must manage it in
Device and Users
mode, not
Extensions mode.
50 deviceid Defaults to be
the value of
extension (see
item 2 of this
table).
51 deviceuser Fixed devices
will always be
mapped to this
user. Adhoc
深圳星昊通科技有限公司 www.hiastar.com
95
devices will be
mapped to this
user by default.
If selecting
'New User', a new
User Extension
of the same
Device ID will be
set as the
Default User.
52 description The caller id
name for this
device will be
set to this
description
(until it is
logged into -
possible when
adhoc devicetype
is used).
53 dictenabled disabled enabled,
disabled
Dictation Service
54 dictformat ogg ogg,
gsm, wav
Dictation Format
55 dictemail Email Address The email
address that
completed
dictations are
sent to.
56 langcode Language Code The language
code for this
user. This will
result in
messages such as
voiclangcode
prompts to use
the selected
language if
installed.
57 vm disabled enabled,
disabled
Status Set Voicemail
status for this
user.
58 vmpwd Voicemail Password This is the
深圳星昊通科技有限公司 www.hiastar.com
96
password used to
access the
Voicemail
system.
This password
can only contain
numbers.
A user can change
the password you
enter here after
logging into the
Voicemail system
(*98) with a
phone.
59 email Email Address The email
address that
Voicemails are
sent to.
60 pager Pager Email Address Pager/mobile
email address to
which short
Voicemail
notifcations are
sent.
61 attach attach=n
o
attach=y
es,
attach=n
o
Email Attachment Option to attach
Voicemails to
email.
62 saycid saycid=n
o
saycid=y
es,
saycid=n
o
Play CID Read back
caller's
telephone number
prior to playing
the incoming
message, and
just after
announcing the
date and time the
message was
left.
63 envelope envelope
=no
envelope
=yes,
envelope
Play Envelope Envelope
controls whether
or not the
深圳星昊通科技有限公司 www.hiastar.com
97
=no Voicemail system
will play the
message envelope
(date/time)
before playing
the Voicemail
message. This
settng does not
affect the
operation of the
envelope option
in the advanced
Voicemail menu.
64 delete delete=n
o
delete=y
es,
delete=n
o
Delete Vmail If set to "yes"
the message will
be deleted from
the Voicemailbox
(after having
been emailed).
Provides
functionality
that allows a
user to receive
their Voicemail
via email alone,
rather than
having the
Voicemail able
to be retrieved
from the Web
interface or the
Extension
handset.
CAUTION: MUST
HAVE attach
Voicemail to
email SET TO YES
OTHERWISE YOUR
MESSAGES WILL BE
LOST FOREVER.
65 options VM Options Separate options
with pipe ( | )
ie:
深圳星昊通科技有限公司 www.hiastar.com
98
review=yes|maxm
essage=60
66 vmcontext default VM Context This is the
Voicemail
Context which is
normally set to
default. Do not
change unless
you understand
the
implications.
67 vmx_state checked,
(leave
blank to
disable)
VmX Locater™ Enable/Disable
the VmX Locater
feature for this
user. When
enabled all
settings are
controlled by
the user in the
User Portal
(ARI). Disabling
will not delete
any existing
user settings
but will disable
access to the
feature
68 vmx_unavail_
enabled
checked,
(leave
blank to
disable)
Use When: unavailable
69 vmx_busy_ena
bled
checked,
(leave
blank to
disable)
Use When: busy
70 vmx_play_ins
tructions
checked,
(leave
blank to
disable)
Voicemail
Instructions:
Standard Voicemail
prompts.
Uncheck to play a
beep after your
personal
Voicemail
greeting.
71 vmx_option_0
_system_defa
ult
checked,
(leave
blank to
disable)
Go To Operator Pressing 0
during your
personal
Voicemail
深圳星昊通科技有限公司 www.hiastar.com
99
greeting goes to
the Operator.
Uncheck to enter
another
destination
here. This
feature can be
used while still
disabling VmX to
allow an
alternative
Operator
extension
without
requiring the
VmX feature for
the user.
72 vmx_option_0
_number
Press 0: Pressing 0
during your
personal
Voicemail
greeting goes to
the Operator.
Uncheck to enter
another
destination
here. This
feature can be
used while still
disabling VmX to
allow an
alternative
Operator
extension
without
requiring the
VmX feature for
the user.
73 vmx_option_1
_system_defa
ult
checked,
(leave
blank to
disable)
74 vmx_option_1
_number
Press 1: The remaining
options can have
深圳星昊通科技有限公司 www.hiastar.com
100
internal
extensions,
ringgroups,
queues and
external numbers
that may be rung.
It is often used
to include your
cell phone. You
should run a test
to make sure that
the number is
functional any
time a change is
made so you don't
leave a caller
stranded or
receiving
invalid number
messages.
75 vmx_option_2
_number
Press 2: Use any
extensions,
ringgroups,
queues or
external
numbers.
Remember to
re-record your
personal
Voicemail
greeting and
include
instructions.
Run a test to
make sure that
the number is
functional.
76 account Follow Me: (Follow Me
page)
Extension of
account.
77 ddial checked,
(or
leave
blank)
Disable: (Follow Me
page)
By default (not
checked) any
call to this
extension will
深圳星昊通科技有限公司 www.hiastar.com
101
go to this
Follow-Me
instead,
including
directory calls
by name from
IVRs. If
checked, calls
will go only to
the extension.
However,
destinations
that specify
FollowMe will
come here.
Checking this
box is often used
in conjunction
with VmX
Locater, where
you want a call
to ring the
extension, and
then only if the
caller chooses
to find you do
you want it to
come here.
78 pre_ring 0 0-60 Initial Ring Time:
(Follow Me page)
This is the
number of
seconds to ring
the primary
extension prior
to proceeding to
the follow-me
list. The
extension can
also be included
in the follow-me
list. A 0 setting
will bypass
this.
79 strategy ringallv
2
ringallv
2,
Ring Strategy:
(Follow Me page)
ringallv2: ring
primary
深圳星昊通科技有限公司 www.hiastar.com
102
ringallv
2-prim,
ringall,
ringall-
prim,
hunt,
hunt-pri
m,
memoryhu
nt,
memoryhu
nt-prim,
firstava
ilable,
firstnot
onphone
extension for
initial ring
time followed by
all additional
extensions until
one answers
ringall: ring
all available
channels until
one answers
(default)
hunt: take turns
ringing each
available
extension
memoryhunt: ring
first extension
in the list, then
ring the 1st and
2nd extension,
then ring 1st 2nd
and 3rd
extension in the
list.... etc.
*-prim: these
modes act as
described above.
However, if the
primary
extension (first
in list) is
occupied, the
other extensions
will not be rung.
If the primary is
FreePBX DND, it
won't be rung. If
the primary is
FreePBX CF
unconditional,
then all will be
rung
firstavailable:
ring only the
深圳星昊通科技有限公司 www.hiastar.com
103
first available
channel
firstnotonphone
: ring only the
first channel
which is not off
hook - ignore CW
80 grptime 20 0-60 Ring Time (max 60 sec)
(Follow Me page)
Time in seconds
that the phones
will ring. For
all hunt style
ring strategies,
this is the time
for each
iteration of
phone(s) that
are rung
81 grplist User's
own
extensio
n
List of
extensio
ns
(hyphen
separate
d)
Follow-Me List:
(Follow Me page)
extension-exten
sion-extension-
... (extension
is numeric;
multiple
extensions
separated by
'-')
You can include
an extension on a
remote system,
or an external
number by
suffixing a
number with a
pound (#). ex:
2448089# would
dial 2448089 on
the appropriate
trunk (see
Outbound
Routing).
82 annmsg_id blank or
0 (means
None)
any
recordin
g id
active
Announcement: (Follow
Me page)
Message to be
played to the
caller before
dialing this
深圳星昊通科技有限公司 www.hiastar.com
104
on
system
group.
To add
additional
recordings
please use the
'System
Recordings' MENU
to the left
83 ringing Ring Ring,
default,
none, or
any
active
Music On
Hold
class on
the
system
Play Music On Hold?
(Follow Me page)
If you select a
Music on Hold
class to play,
instead of
'Ring', they
will hear that
instead of
Ringing while
they are waiting
for someone to
pick up.
84 grppre CID Name Prefix:
(Follow Me page)
You can
optionally
prefix the
Caller ID name
when ringing
extensions in
this group. ie:
If you prefix
with 'Sales:', a
call from John
Doe would
display as
'Sales:John Doe'
on the
extensions that
ring.
85 dring Valid
alert
info
text
recogniz
ed by SIP
phone
Alert Info: (Follow Me
page)
You can
optionally
include an Alert
Info which can
create
distinctive
rings on SIP
phones.
深圳星昊通科技有限公司 www.hiastar.com
105
86 needsconf CHECKED
or
(blank)
Confirm Calls:
(Follow Me page)
Enable this if
you're calling
external numbers
that need
confirmation -
eg, a mobile
phone may go to
Voicemail which
will pick up the
call. Enabling
this requires
the remote side
push 1 on their
phone before the
call is put
through. This
feature only
works with the
ringall/ringall
-prim ring
strategy
87 remotealert_
id
blank or
0 (means
Default)
any
recordin
g id
active
on the
system
Remote Announce:
(Follow Me page)
Message to be
played to the
person RECEIVING
the call, if
'Confirm Calls'
is enabled.
To add
additional
recordings use
the 'System
Recordings' MENU
to the left
88 toolate_id blank or
0 (means
Default)
any
recordin
g id
active
on the
system
Too-Late Announce:
(Follow Me page)
Message to be
played to the
person RECEIVING
the call, if the
call has already
been accepted
before they push
1.
To add
深圳星昊通科技有限公司 www.hiastar.com
106
additional
recordings use
the 'System
Recordings' MENU
to the left
89 postdest Text in
the
format
context,
exten,pr
iority
that is
an
active
dialplan
destinat
ion on
the
system
Destination if no
answer: (Follow Me
page)
90 faxenabled true or
blank
Enabled Enables fax if
setting is set
to true. If
left blank fax
settings are
removed
91 faxemail Valid
address
Fax Email Email address
where fax should
be emailed to
92 cfringtimer 0 -1-120 Call Forward Ring Time Number of
seconds to ring
during a Call
Forward, Call
Forward Busy or
Call Forward
Unavailable call
prior to
continuing to
voicemail or
specified
destination.
Setting to
Always will not
return, it will
just continue to
深圳星昊通科技有限公司 www.hiastar.com
107
ring. Default
will use the
current Ring
Time. If
voicemail is
disabled and
their is not
destination
specified, it
will be forced
into Always mode
93 concurrency_
limit
0 0-120 Outbound Concurrency
Limit
Maximum number
of outbound
simultaneous
calls that an
extension can
make. This is
also very useful
as a Security
Protection
against a system
that has been
compromised. It
will limit the
number of
simultaneous
calls that can be
made on the
compromised
extension.
94 answermode disabled disabled
,interco
m
Internal Auto Answer When set to
Intercom, calls
to this
extension/user
from other
internal users
act as if they
were intercom
calls meaning
they will be
auto-answered if
the endpoint
supports this
feature and the
深圳星昊通科技有限公司 www.hiastar.com
108
system is
configured to
operate in this
mode. All the
normal white
list and black
list settings
will be honored
if they are set.
External calls
will still ring
as normal, as
will certain
other
circumstances
such as blind
transfers and
when a Follow Me
is configured
and enabled. If
Disabled, the
phone rings as a
normal phone.
95 qnostate usestate usestate
,ignores
tate
Queue State Detection If this
extension is
part of a Queue
then the Queue
will attempt to
use the user's
extension state
or device state
information when
determining if
this queue
member should be
called. In some
uncommon
situations such
as a Follow-Me
with no physical
device, or some
virtual
extension
scenarios, the
深圳星昊通科技有限公司 www.hiastar.com
109
state
information will
indicate that
this member is
not available
when they are.
Setting this to
'Ignore State'
will make the
Queue ignore all
state
information thus
always trying to
contact this
member. Certain
side affects can
occur when this
route is taken
due to the nature
of how Queues
handle Local
channels, such
as subsequent
transfers will
continue to show
the member as
busy until the
original call is
terminated. In
most cases, this
SHOULD BE set to
'Use State'.
96 devinfo_trus
trpid
yes yes,no trustrpid Whether Asterisk
should trust the
RPID settings
from this
device. Usually
should be yes for
CONNECTEDLINE()
functionality to
work if
supported by the
endpoint.
97 devinfo_send no no,yes,p sendrpid Whether Asterisk
深圳星昊通科技有限公司 www.hiastar.com
110
rpid ai should send RPID
(or PAI) info to
the device.
Usually should
be enabled to the
settings used by
your device for
CONNECTEDLINE()
functionality to
work if
supported by the
endpoint.
98 devinfo_qual
ifyfreq
60 qualifyfreq Frequency in
seconds to send
qualify messages
to the endpoint.
99 devinfo_tran
sport
udp 'udp,tcp
,tls','t
cp,udp,t
ls','tls
,udp,tcp
','udp',
'tcp','t
ls'
transport This sets the
allowed
transport
settings for
this device and
the default
(Primary)
transport for
outgoing. The
default
transport is
only used for
outbound
messages until a
registration
takes place.
During the peer
registration the
transport type
may change to
another
supported type
if the peer
requests so. In
most common
cases, this does
not have to be
changed as most
深圳星昊通科技有限公司 www.hiastar.com
111
devices register
in conjunction
with the
host=dynamic
setting. If you
are using TCP
and/or TLS you
need to make sure
the general SIP
Settings are
configured for
the system to
operate in those
modes and for
TLS, proper
certificates
have been
generated and
configured.
100 devinfo_encr
yption
no no,yes encryption Whether to offer
SRTP encrypted
media (and only
SRTP encrypted
media) on
outgoing calls
to a peer. Calls
will fail with
HANGUPCAUSE=58
if the peer does
not support
SRTP. Defaults
to no.
101 devinfo_vmex
ten
vmexten Asterisk
dialplan
extension to
reach voicemail
for this device.
Some devices use
this to
auto-program the
voicemail button
on the endpoint.
If left blank,
the default
深圳星昊通科技有限公司 www.hiastar.com
112
vmexten setting
is automatically
configured by
the voicemail
module. Only
change this on
devices that may
have special
needs.
102 cc_agent_pol
icy
generic never,ge
neric,na
tive
Caller Policy Asterisk:
cc_agent_policy
. Used to enable
Camp-On for this
user and set the
Technology Mode
that will be used
when engaging
the feature. In
most cases
'Generic Device'
should be chosen
unless you have
phones designed
to work with
channel specific
capabilities.
103 cc_monitor_p
olicy
generic never,ge
neric,na
tive
Callee Policy Asterisk:
cc_monitor_poli
cy. Used to
control if other
phones are
allowed to Camp
On to this
extension. If
so, it sets the
technology mode
used to monitor
the availability
of the
extension. If no
specific
technology
support is
available then
深圳星昊通科技有限公司 www.hiastar.com
113
it should be set
to a 'Generic
Device'. In this
mode, a callback
will be
initiated to
this extension
when it changes
from an InUse
state to
NotInUse. If it
was busy when
first attempted,
this will be when
the current call
has ended. If it
simply did not
answer, then
this will be the
next time this
phone is used to
make or answer a
call and then
hangs up. It is
possible to set
this to take
advantage of
'Native
Technology
Support' if
available and
automatically
fallback to the
'Generic Mode'
when not.
104 recording_in
_external
always,d
ontcare,
never
Inbound External
Calls
Recording of
inbound calls
from external
sources.
105 recording_ou
t_external
always,d
ontcare,
never
Outbound External
Calls
Recording of
outbound calls
to external
sources.
106 recording_in always,d Inbound Internal Recording of
深圳星昊通科技有限公司 www.hiastar.com
114
_internal ontcare,
never
Calls calls received
from other
extensions on
the system.
107 recording_ou
t_internal
always,d
ontcare,
never
Outbound Internal
Calls
Recording of
calls made to
other extensions
on the system.
108 recording_on
demand
enabled,
disabled
On Demand Recording Enable or
disable the
ability to do on
demand
(one-touch)
recording. The
overall calling
policy rules
still apply and
if calls are
already being
recorded they
can not be
paused.
109 recording_pr
iority
0-20 Record Priority
Policy
Call recording
policy priority
relative to
other extensions
when there is a
conflict between
an extension
wanting
recording and
the other not
wanting it. The
higher of the two
determines the
policy, on a tie
the global
policy (caller
or callee)
determines the
policy.
110 add_xactview
111 xactview_aut
oanswer
深圳星昊通科技有限公司 www.hiastar.com
115
112 xactview_ema
il
113 xactview_cel
l
114 jabber_host
115 jabber_domai
n
116 jabber_resou
rce
117 jabber_port
118 jabber_usern
ame
119 jabber_passw
ord
120 xactview_cre
ateprofile
121 xactview_pro
filepassword
122 xmpp_user
123 xmpp_pass
导入分机
用户可以在任何时间导入 CSV 分机。如果计划这样做的话，我们建议先导出一个分机的数
据，这样就可以了解 CSV 文件的格式。
这些文件中的值域和界面看到的是完全一样的。只有 action 值域是需要注意，就是
action 值域，它会对每个数据进行相关的定义。
支持以下几个选项:
add – 如果这个数据是一个新的分机，用户可以设置为 “add.”
del – 如果用户计划从 PBX 中删除这个数据的话，用户可以设置为 “del.”
edit – 如果用户希望编辑这个数据，可以设置为 “edit.”
如果需要导入新的 CSV 文件，点击 “Choose File” 选项，从本地电脑点击用户需要导
入的 CSV 文件，然后点击 “Load File” 按钮完成导入。
深圳星昊通科技有限公司 www.hiastar.com
116
呼叫前转用户使用指南
Overview
Feature codes
Conditions
o Busy
o No Answer/Unavailable
o ALL (unconditional)
Usage from phone by user
Usage from remote phone
Settings
o Call Forward Ring Time
o Call Forward Ringtimer Default
总览
呼叫前转是通过功能快捷键实现对分机的呼叫管理。呼叫前转功能支持在分机之间进行有
条件的前转呼叫。
深圳星昊通科技有限公司 www.hiastar.com
117
功能快捷键
快捷键功能可以通过快捷键模块来进行管理。
条件
呼叫前转可以基于各种条件来实现
Busy
这个策略使用在当用户处于电话接听状态或者免打扰状态时。当其中一个条件为真时，电
话将前转到指定的设置。
No Answer/Unavailable
这个策略使用在当用户无应答此通话或者此分机没有注册时。
ALL (unconditional)
这个策略将对呼叫进行前转，无论用户处于什么状态。
深圳星昊通科技有限公司 www.hiastar.com
118
用户提供终端操作的方法：
以下快捷键可以通过管理员中的功能代码模块来进行修改或者管理.
Code Action
*72 Activate call forwarding ALL
*73 Deactivate call forward ALL
*90 Activate call forward BUSY
*91 Deactivate call forward BUSY
*52 Activate call forward NO ANSWER
*53 Deactivate call forward NO ANSWER
用户通过第三方远程终端操作的方法
用户可以通过远程终端来帮助不同的分机激活快捷键功能。注意，以下快捷键使用在其他
内部分机中，而不是本机。输入以下代码，提示音后输入源和目的地.
Code Action
*720 Activate call forwarding ALL
*730 Deactivate call forward ALL
*900 Activate call forward BUSY
*910 Deactivate call forward BUSY
*520 Activate call forward NO ANSWER
*530 Deactivate call forward NO ANSWER
Settings
管理某些设置.
Call Forward Ring Time
从分机设置.
深圳星昊通科技有限公司 www.hiastar.com
119
在呼叫前转中的振铃时长。呼叫前转忙或呼叫前转无效优先于语音邮箱或指定的目的地设
置。设置为 Always 将不会返回，它将继续振铃。默认设置将使用当前的振铃时长。如果语音
邮箱已经关闭，并且没有设置目的地的话，系统将强制进入 Always 模式。
Call Forward Ringtimer Default
From Advanced Settings
这是一个默认的时长，以秒为单位，系统会尝试连接一个呼叫，呼叫已经在服务器侧的
CF，CFU 和 CFB 选项设置为前转。如果用户的 SIP 终端侧 CF 例如 SIP redirects，那么将不
会有什么影响。如果设置 default 为 0，系统将使用标准的振铃时间。如果设置为-1 ，振铃
将不受限制，工作状态和目前的一些 PBX 一样。如果设置为其他值，系统将按照设置的振铃时
间振铃，直到进入到用户的语音邮箱。这些值可以覆盖每个分机的设置。
Call History - UCP
Overview
Usage
总览
呼叫历史支持用户查看呼入和呼出的呼叫记录，以及相关的呼叫录音。
Usage
在我们的实例中，我们设置了多个分机号码（这些号码是在用户管理模块中定义的）。
选择一个想要查看的分机号码，点击 Call History 就可以查看相关记录信息。
深圳星昊通科技有限公司 www.hiastar.com
120
我们看到分机的呼叫记录。
每个呼叫有以下几个字段
o Date- Date and Time call was received or placed.
o Description-For each call we have the following icons under the
Description
o
图例 含义
呼出呼叫
呼入呼叫
转入到语音邮箱的呼叫
电话会议会议室呼叫
o Duration- 通话时长- Hours- Minutes-Seconds
o Controls- 如果此通话有关联的通话录音，将显示一个通话路由图标，可以点击
下载播放。
深圳星昊通科技有限公司 www.hiastar.com
121
用户可以通过搜索栏来搜索历史记录信息：
捕捉 TCM 信息方法- TCPDumps
TCP Dump
1.如果需要通过端口 5060 捕捉数据时，可以使用此命令。此命令将在 tmp 路径下创建一
个文件，名称为 capture.pcap 。如果此文件大于 50MP 时，系统会自动创建另外一个文件。
○ tcpdump -s0 -w/tmp/capture.pcap -C50 udp and port 5060
2.如果仅计划对某个 IP 地址捕捉数据时，可以执行命令
○ tcpdump -s0 -w/tmp/capture.pcap -C50 udp and port 5060 and host 129.33.194.122
3.用户可以通过 wireshark 工具，导入捕捉数据，进行分析-> Telephony -> VoIP Calls ,
现在用户希望检查的会话，点击 flow。如果已经捕捉了 RTP 数据，输入命令时带
(Option: -T rtp)，就可以捕捉到通话的语音流。
4.通过 screen 执行这个命令，用户输入以下命令，加标签文件名称，主机名称和时间戳：
○screen -dm tcpdump -s0 -w/tmp/capture-dep`hostname -s`-`date
+%Y%m%d-%H%M%Z`.pcap -C150 udp and port 5060
证书管理员使用指南
Overview
Logging In
Managing Certificate Authority (CA)
o Upload a new Certificate Authority
Host Name
Organization Name
深圳星昊通科技有限公司 www.hiastar.com
122
Passphrase
Save Passphrase
Private Key
Certificate
o Generate a new Certificate Authority
Host Name
Organization Name
Passphrase
Save Passphrase
New Certificate
o Generate a New Certificate
Certificate Authority
Name
Description
o Upload New Certificate
Name
Description
Private Key
Certificate
Editing a Certificate
Managing the Certificate Authority
总览
证书管理员是用来对 FreePBX 系统中的安全证书进行管理的模块。
登录
从菜单顶部点击 Admin
下拉菜单中点击 Certificate Management
Managing Certificate Authority (CA)
深圳星昊通科技有限公司 www.hiastar.com
123
在右边的导航菜单中点击 Certificate Authority Settings
Upload a new Certificate Authority
Host Name
DNS 或者主机名称
Organization Name
组织名称
Passphrase
密码用来访问此证书，并且生成新的客户端证书。如果用户没有使用这个秘密，生成新证
书时，私钥就不再加密。生成的结果将不再受任何保护。如果用户不提供密码的话，当每次上
传新证书时，用户必须提供一个密码。
Save Passphrase
在数据库中保存密码，新证书将自动生成。
注意：密码将以普通文本的形式保存，系统将提供告警提示。
深圳星昊通科技有限公司 www.hiastar.com
124
Private Key
用户私钥文件
Certificate
用户证书文件
Generate a new Certificate Authority
Host Name
DNS 主机名称
Organization Name
组织名称
Passphrase
密码用来访问此证书，并且生成新的客户端证书。如果用户没有使用这个秘密，生成新证
书时，私钥就不再加密。生成的结果将不再受任何保护。如果用户不提供密码的话，当每次上
传新证书时，用户必须提供一个密码。
Save Passphrase
在数据库中保存密码，新证书将自动生成。
注意：密码将以普通文本的形式保存，系统将提供告警提示。
深圳星昊通科技有限公司 www.hiastar.com
125
New Certificate
点击右栏菜单，点击 New Certificate.
Generate a New Certificate
Certificate Authority
选择一个合适的证书。可能系统同时保存了多个证书。
Name
证书名称
Description
证书描
深圳星昊通科技有限公司 www.hiastar.com
126
Upload New Certificate
Name
名称
Description
证书描述
Private Key
私钥文件
Certificate
证书文件
深圳星昊通科技有限公司 www.hiastar.com
127
Editing a Certificate
点击相应编辑的文件
从这里用户可以删除或者上传其他新文件。
点击上传新证书文件
Managing the Certificate Authority
深圳星昊通科技有限公司 www.hiastar.com
128
通常情况下用户无需做任何操作，按钮在默认环境下是关闭的。
如果用户决定开启这些功能的话，可以点击开启，用户可以删除，重新生成证书文件或者
上传新文件。
会议模块用户指南
Overview
Logging In
Creating a Conference Room
o Conference Number
o Conference Name
o User PIN
o Admin PIN
o Join Message
o Leader Wait
o Talker Optimization
o Talker Detection
o Quiet Mode
o User Count
o User Join/Leave
o Music on Hold
o Music on Hold Class
o Allow Menu
o Record Conference
o Maximum Participants
o Mute on Join
o OTHER Options
Conference User Guide
o Meetme Menus if enabled (press * to access the menu)
总览
会议模块用来创建一个会议分机，其他用户拨打此号码以后，进入一个会议室，然后互相
之间可以进行会议通话。同样的道理，系统可以支持系统外部号码通过拨打一个默认的会议号
码来加入会议。
登录
从菜单顶部，点击 Applications
在下拉菜单中点击 Conferences
深圳星昊通科技有限公司 www.hiastar.com
129
Creating a Conference Room
Conference Number
创建一个会议室号码，会议代表可以拨打此号码进入电话会议。
Conference Name
会议名称，用来区别于其他的会议室名称。
User PIN
要求电话会议代表进入会议室时输入密码验证。这是一个可选设置。
Admin PIN
会议管理员密码。此选项是可选的，如果使用了 'leader wait' ，则需要管理员输入密
码验证管理员身份。
深圳星昊通科技有限公司 www.hiastar.com
130
Join Message
当会议代表进入会议室前，对代表播放的语音提示。如果加入其他的录音文件，请使用
"System Recordings" 菜单中的选项。
Leader Wait
等待时间，直到会议主持人或者管理员进入到会议室。
深圳星昊通科技有限公司 www.hiastar.com
131
Talker Optimization
开启会议发言人优化设置。当开启此设置以后，Asterisk 将把不发言的代表设置为静音
状态，通过这样的优化方式，没有语音解码处理，并且收到的语音不会被处理，这样节省了数
据传输带宽，并且减少了背景噪音。
Talker Detection
设置发言人检测的话，asterisk 将通过 AMI 发送一个事件，来确认此通道是否正在进行
语音通话。发言人状态可以通过 CLI 命令下的 meetme 命令来查看。
Quiet Mode
退出模式 (不播放进入/离开语音提示)。
User Count
播报会议室总人数。
User Join/Leave
播报用户加入或者离开状态。如果开启此选项，所有会议代表在进入会议室之前都将需要
报告用户名称，并且系统会播报他们的名称。
Music on Hold
当会议室只有一个用户时，开启音乐等待功能。
Music on Hold Class
对进入会议的代表播放语音，等待会议开始。如果需要选择不同的音乐等待时，选择
"inherit"。
Allow Menu
当系统收到“*”时，当前用户菜单状态。
Record Conference
对电话会议进行录音。
深圳星昊通科技有限公司 www.hiastar.com
132
Maximum Participants
最多参加会议人数。
Mute on Join
进入会议室时对每个用户静音。请注意，如果没有设置 'Leader Wait' 到 yes 状态，用
户必须开启 'Allow Menu' ，并且设置为 Yes，取消自己静音设置。
OTHER Options
其他设置选项，参考已安装模块，例如 VQ Plus 和 iSymphony。
如果开启 Meetme 菜单或者按 *键访问菜单
DIGIT ADMIN USER NON-ADMIN USER
1 Mute/Un-Mute Self Mute/Un-Mute Self
2 Lock/Unlock Conference Disabled
3 Eject last user who joined conference Disabled
4 Decrease Listen Volume of Conference with each 4 you
press - end with 8 Same for user
5 Disabled Disabled
6 Increase Listen Volume of Conference with each 4 you
press - end with 8 Same for user
7 Decrease Talk volume - end with 8 Same for user
8 More options menu (see below) / End volume
adjustment
Exit this menu / End volume
adjustment
9 Increase Talk volume - end with 8 Same for user
0 Disabled Disabled
* Play menu options Same for user
# Disabled Disabled
"8" MORE OPTIONS MENU
DIGIT ADMIN USER
1 List users currently in the conference
2 Kick out all non-administrator users
3 Mute or unmute all non-administrator users
4 Record this conference
8 Exit this menu and return to the conference
深圳星昊通科技有限公司 www.hiastar.com
133
如何对接两个 FreePBX
用户可以通过 IP 对接两个不同地方的 FreePBX，以下是两个地方对接的举例：
系统 1: Los Angeles
Extensions Numbered: 40 to 49
系统 2: New York
Extensions Numbered: 50 to 59
简单 4 步实现 PBX 对接:
1. 在系统 1 中配置一个 IAX2 Trunk，这个 IAX 中继将和系统 2 的对接.
2. 在系统 1 中配置一个呼出路由.这个路由将呼叫到系统 2.
3. 在系统 2 中配置一个 IAX 中继. 这个中继将对将系统 1.
4. 在系统 2 中配置一个呼出路由. 这个路由将负责发送系统 2 的呼叫到系统 1.
1. Configure an IAX2 Trunk on System1
访问系统 1 中的中继模块.
点击添加 "Add Trunk" ，右边菜单将显示添加中继类型.
选择一个 IAX2 Trunk.
在中继设置中填写这些设置:
Trunk Name: System2
Outbound Caller ID: CallerID
Dialed Number Manipulation Rules: 通常为空。
Trunk Name: System2
深圳星昊通科技有限公司 www.hiastar.com
134
PEER Details:
username=System1
secret=password
host=system2ipaddress
type=friend
context=from-internal
qualify=yes
qualifyfreqok=25000
transfer=no
trunk=yes
forceencryption=yes
encryption=yes
auth=md5
Registration String: 为空
注意:
1. 用户自己替换 System1, System2, CallerID 和密码设置。.
2. 注意大小写区分: System1 和 system1 或者 SYSTEM1 不同。.
3. 如果呼叫有问题，可能是加密路由没有安装。删除两边系统的 peer details 设置的最
后 3 行。
4. 如果仅想呼叫远端系统，不允许对端系统直接呼叫本端，则修改
"context=from-internal"成 "context=from-trunk".
深圳星昊通科技有限公司 www.hiastar.com
135
5. 如果其中一个系统的 IP 地址是动态 IP 地址，用户应该使用动态 DNS 服务注册或者使用
域名来代替 host 值中的 IP 地址。
2. 配置系统 1 中的呼出路由
访问系统 1 中的呼出路由模块.
点击 "Add Route" 链接，会出现中继模块设置选项.
在路由设置中设置这些参数:
Route Name: InterOfficetoSystem2
Route CID: YOURNUMBER
Route Type: CHECK Intra-Company.
Dial Patterns that will use this Route: // 注意此处拨号匹配模式设置
Pattern
s:
() + |
5X
() + |
*805X
() + *81
| .
拨号匹配模式的作用:
如果用户拨打分机 50 到 59, 呼叫则被发送到系统 2.
如果用户拨打 *80 (或者按电话机 intercom 按键) ，然后拨打分机 50 到
59, 呼叫被发送到系统 2.
如果用户拨打 *81 ，然后拨打其他号码， *81 呼出前将被移除，系统将发
送剩余的其他号码到系统 2.
Trunk Sequence: System2
深圳星昊通科技有限公司 www.hiastar.com
136
注意:
1. 如果用户测试系统的分机不是我们实例中的分机，可以修改到用户自己的分机设置习惯。
更多拨号模式匹配的问题参考 Dial Patterns tooltip.
2. 如果系统 2 的分机号码和系统 1 的分机号码一样的话，需要删除前两个拨号匹配模式。.
3. 如果不想让系统 1 的用户拨打 *81 ，必须删除系统 2 的第三个 Dial Pattern.
4. 如果系统 2 的用户的号码和系统 1 的号码一样，不想让系统 1 的用户拨打任何系统 2，
例如*81 的功能热键，用户应该删除所有的 dial patterns ，替换成如下设置:
() + *81
| 5X
() + *81
| *805X
如果用户拨打 *81 ，然后拨打 50 到 59 之间的分机, *81 将被移除，其
余号码将被发送到系统 1
如果用户拨打了 *81 ，然后 *80 和分机 50 到 59, *81 将被移除，其余
号码被发送到系统 1，则支持了 intercom 呼叫。
3. 配置系统 2 的 IAX2 中继
访问系统 2 的中继模块
点击添加 "Add Trunk" 菜单链接，右侧将出现中继模块设置.
选择创建一个 IAX2 Trunk.
在 trunk 设置中填写以下信息:
Trunk Name: System1
Outbound Caller ID: CallerID
Dialed Number Manipulation Rules: Usually Blank
Trunk Name: System1
PEER Details:
username=System2
secret=password
深圳星昊通科技有限公司 www.hiastar.com
137
host=system1ipadd
ress
type=friend
context=from-inte
rnal
qualify=yes
qualifyfreqok=250
00
transfer=no
trunk=yes
forceencryption=y
es
encryption=yes
auth=md5
Registration String: Blank.
4. 在系统 2 中设置一个呼出路由
访问系统 2 中的呼出路由模块.
点击顶部的 "Add Route" 链接，右侧会出现中继模块菜单.
在路由设置中填写以下参数:
Route Name: InterOfficetoSystem1
Route CID: YOURNUMBER
深圳星昊通科技有限公司 www.hiastar.com
138
Route Type: CHECK Intra-Company.
Dial Patterns that will use this Route: // 注意保护模式匹配设置，涉及了系统 2
用户如何拨打电话到系统 1
Pattern:
() + | 4X
() + |
*804X
() + *81
| .
如何呼叫:
如果用户拨打分机 40 到 49, 呼叫被发送到 System1.
如果用户拨打 *80 (按电话机按钮 intercom button) ，然后拨打分机 40
到 49, 呼叫被发送到系统 1.
如果用户拨打了 *81 和其他号码， *81 前缀将被移除，其余号码被发送
到系统 1.
Trunk Sequence: System1
Note:
1. 如果用户的系统分机不是 40 到 49 的范围，例如可能是 4XX，请用户修改到相应的拨
号模式匹配。
2. 如果系统 1 中的分机号码和系统 2 的分机号码一样，应该删除拨号模式中的前两个匹
配模式。
3. 如果不想让系统 2 的用户拨打 l *81 和其他的功能热键，请删除第三个拨号模式。.
4.如果系统 1 的分机号码和系统 2 的分机号码一样，不想让系统 2 的分机拨打 *81 和系
统 1 的功能热键号码，请删除所有的拨号模式，使用以下方式替换:
() + *81 |
4X
() + *81 |
*804X
如果用户拨打 *81 ，然后拨打 40 - 49, *81 前缀将被移除，其余号码
被发送到系统 1
如果用户拨打 *81 和 *80 ，然后拨打 40 到 49 之间的号码， *81 将被
移除，其余号码被发送到系统 1
以上方式在 intercom 内部呼叫时使用。
深圳星昊通科技有限公司 www.hiastar.com
139
是否需要设置端口转发?
无需设置端口转发设置
如果用户使用 IAX2 Trunks ，并且设置正确的话，所有 IAX2 端口将对地方开放。
如何对接两个以上的系统?
有两种方法可实现这个需求。
1. 用户可以独立设置每个对接的系统，例如：
System 1 to System 2
System 1 to System 3
System 2 to System 1
System 2 to System 3
System 3 to System 1
System 3 to System 2
2. 用户也可以这样，也需要在系统 2 的拨号规则中做路由的逻辑判断：
对接 System 1 到 System 2
对接 System 2 到 System 3
在系统 1 中配置呼出路由，发送呼叫到系统 2，系统 2 转发呼叫到系统 3..
在系统 3 中配置呼出路由，发送呼叫到系统 2，然后系统 2 转发呼叫到系统 1.
两种方式中，第一种方式相对可靠一些，可以保证每个系统的相对稳定。
深圳星昊通科技有限公司 www.hiastar.com
140
为什么不使用 SIP 中继?
如果使用 SIP 中继进行两个系统的对接，用户至少保证其中一个系统必须设置外部端口转
发。设置方法相对复杂，同时需要特别设置防火墙，保证无权限的用户不能访问此系统。SIP
中继设置将在其他章节中进行讨论。
Contact Manager 模块
Contact Manager 模块用来在 groups 中添加 contacts。Contacts 可以被 Contacts Rest
App 和 UCP 调用。这些 contacts 可以划分成内部和外部两个类别，默认的 groups 称之为
"User Manager" ，包括了所有的用户，不能被删除。
Overview
Adding a New Group
Internal Groups
External Groups
User Manager
总览
Add New Group- 添加一个新 contacts 组。
Internal Groups- 这是内部组，contacts 信息是通过 User Management 模块获得。
External Groups- 这是外部 contact 组，可能包括客户和采购商。
·User Manager- 默认的 contacts 组，包括所有用户管理模块中的用户信息。
深圳星昊通科技有限公司 www.hiastar.com
141
Adding a New Group
从右菜单中点击 "Add New Group" 。
可以看到不同的用户组选项：
修改以后，点击提交。
Internal Groups
在 "Internal Groups" 选项中，应该可以看到所有已经创建的内部组。这些组应该是
我们的 "Employees." 或者我们通常说的公司员工组。
深圳星昊通科技有限公司 www.hiastar.com
142
点击相应的选项，可以编辑这些信息：
从我们我们可以查看所有的用户，并且可以修改所有的用户信息。
完成修改以后，点击 "Submit" 按钮，提交修改。
如果要修改用户信息，系统将显示以下信息截图。用户电话号码等等都在 User
Management 模块中定义
深圳星昊通科技有限公司 www.hiastar.com
143
External Groups
用户可以从 "External Groups" 的选项中看到所有已创建的 External groups。在这
个例子中，我们看到了一个组，名称为 "Vendors."
深圳星昊通科技有限公司 www.hiastar.com
144
点击以后，会看到以下截图：
从这里可以看到有很多用户在这个组中。用户可以修改组名称，可以编辑删除用户和数
据。
完成修改以后，点击 "Submit" 按钮。
User Manager
在 "User Manager" 选项中可以看到所有的默认组，包括所有的用户，但是这个组不能
删除。
深圳星昊通科技有限公司 www.hiastar.com
145
点击以后，会看到以下截图：
从这里可以看到所有 PBX 系统中的用户信息。
点击 "Submit" 按钮完成修改任务。
深圳星昊通科技有限公司 www.hiastar.com
146
Directory 模块用户使用指南
Introduction
Accessing the Directory Module
Adding a Directory
o Directory Name
o Directory Description
o CallerID Name Prefix
o Alert Info
o Announcement
o Invalid Retries
o Invalid Retry Recording
o Invalid Recording
o Invalid Destination
o Return to IVR
o Announce Extension
o Adding Directory Entries
All Extensions
Custom Entry
Extension
o Extension fields
Name
Name Announcement
Dial
o Submit
Edit/Delete Directory
介绍
目录模块支持用户创建一个用户的目录模块，呼叫方可以通过 IVR 等等模块来访问这个目
录模块。用户可以创建以公司为目录单元的模块，或者以部门为目录单元的模块。当选择目录
成员时，系统可以让呼叫方指定应该走的路径或者流程，例如当查询公司 CEO 时，也可以拨打
CEO 的助理来接听。
深圳星昊通科技有限公司 www.hiastar.com
147
Accessing the Directory Module
点击顶部菜单 Applications
在下拉菜单中点击 Directory
Adding a Directory
添加一个新的目录模块，点击 Add a new Directory 按钮
Directory Name
设置一个目录的名称，例如 "sales" 或者 "support"
Directory Description
提供一个目录的描述。
CallerID Name Prefix
当呼叫方呼叫进入这个目录时，对呼叫方在 CallerID name 中添加一个前缀。
深圳星昊通科技有限公司 www.hiastar.com
148
Alert Info
当呼叫来自于目录模块时，对 SIP 终端设备发送一个支持 distinctive ring 的呼叫。
Announcement
当呼叫方进入到这个目录时，对呼叫方播报问候语。
Invalid Retries
当呼叫方输入无效输入时，系统允许尝试的次数。
Invalid Retry Recording
当呼叫方进入无效的目录时，播报无效语音提示。
Invalid Recording
当呼叫方摁按键 0 或者被发送到无效目的地时，播报的语音信息。
Invalid Destination
当呼叫方测试次数超出限定的次数时，系统将发送呼叫方到一个指定的目的地。
深圳星昊通科技有限公司 www.hiastar.com
149
Return to IVR
如果呼叫方来自于 IVR 语音导航，而且已经选择了选择框时，呼叫方将被发送到初始时的
IVR 流程。
Announce Extension
当用户选择了选择框时，在呼叫方转接到分机之前，对呼叫方播报目的地分机号码。
Adding Directory Entries
点击蓝色的 +符合
选择一个有效选项。
All Extensions
对每个分机添加一个人口。
Custom Entry
指定一个完整的拨号字符串。这个功能可以支持呼叫手机或者外部的通信接口资源。
Extension
在下拉菜单中点击单个的分机。
深圳星昊通科技有限公司 www.hiastar.com
150
Extension fields
Name
匹配分机用户名称。当系统要求输入人名前三个字母时，例如 Bartholomew，呼叫方可以
对 BAR 输入 227。
Name Announcement
如果匹配名称时，对呼叫方播报的语音信息，这个选项可以支持语音邮箱，TTS，或者其
他录音文件。
Dial
系统拨打的目的地。系统默认的是用户分机，也可以修改到其他的分机。这个功能非常有
用，可以通过行政文员呼叫管理人员的助理，而不是分机本身。
Submit
点击 submit 保存修改设置。
深圳星昊通科技有限公司 www.hiastar.com
151
Edit/Delete Directory
用户可以点击右栏的目录名称删除不需要的目录。
删除目录，点击 Delete Directory NAME
编辑以后，点击提交 Submit.
Do Not Disturb (DND) 免打扰模块用户使用指南
Overview
Controlling DND
o Feature Code
o User Control Panel
Direct Change
Automated Change
o REST Apps
深圳星昊通科技有限公司 www.hiastar.com
152
总览
DND 模块支持用户分机对呼叫实行拒绝请求。这个流程在在拨号规则的执行级别运行。注
意，免打扰功能也可以在用户终端的级别上设置。
Controlling DND
Feature Code
Code Description
*78 激活免打扰 DND. 如果 DND 已经被激活，则无任何动作。
*79 关闭免打扰 DND. 如果 DND 已经处于关闭状态，则无任何动作。
*76 触发免打扰 DND. 这个热键可以对关闭免打扰的进行激活。
User Control Panel
对 FreePBX 12 以上版本的用户，可以通过 UCP 访问。UCP 模块对 DND 状态管理的方式和
热键使用的方式相同。
Direct Change
在设置标签处，触发 DND 开启或者关闭。
深圳星昊通科技有限公司 www.hiastar.com
153
Automated Change
在 Presence State 设置中，用户可以基于系统用户的在线状态来设置 DND。
REST Apps
如果用户在终端侧使用 REST ，用户可以触发 DND 选项。参考 REST apps page 获得支持
的设备信息。
深圳星昊通科技有限公司 www.hiastar.com
154
Asterisk 功能代码介绍
Introduction
Blacklist Feature Codes
o Blacklist a number
o Blacklist the last caller
o Remove a number from the blacklist
Call Forwarding Feature Codes
o Call Forward All Activate
o Call Forward All Deactivate
o Call Forward All Prompting Deactivate
o Call Forwarding Busy Activate
o Call Forwarding Busy Deactivate
o Busy Call Forward No Answer/Unavailable Activate
o Call Forward No Answer/Unavailable Deactivate
o Call Forward No Answer/Unavailable Activate
o Call Forward Toggle
Call Waiting Feature Codes
o Call Waiting Activate
o Call Waiting Deactivate
Core Feature Codes
o Asterisk General Call Pick
o ChanSpy
o Directed Call Pickup
o In-Call Asterisk Attended Transfer
o In-Call Asterisk Blind Transfer
o User Logoff
o User Login
o ZapBarge
Call Flow Control
Dictation
Do Not Disturb (DND)
o DND Activate
o DND Deactivate
o DND Toggle
Follow Me
Info Services
o Call Trace
o Directory
o Echo Test
o Speak Your Exten Number
o Speaking Clock
Paging and Intercom
深圳星昊通科技有限公司 www.hiastar.com
155
o Intercom Prefix
o User Intercom Allow
o User Intercom Disallow
Parking Lot
o Pickup ParkedCall Any
Phonebook Directory
o Phonebook dial-by-name directory
Queues
o Queue Toggle
Recordings
o Check Recording
o Save Recording
Time Conditions
Voicemail
o Dial Voicemail
o My Voicemail
Introduction
本文档介绍 Asterisk 环境下经常使用的功能代码。请注意，asterisk 功能代码可能有
其他模块的加入，完整的代码介绍请参考 asterisk 官方文档。
Blacklist Feature Codes
黑名单功能代码.
Blacklist a number
在黑名单模块中添加一个号码。系统将对所有通过此号码呼入的呼叫播放一个挂机录音。
Blacklist the last caller
把最后一个呼叫添加到黑名单模块中。系统对所有通过此号码呼入的呼叫播放一个挂机录
音。
Remove a number from the blacklist
从黑名单中移除一个号码。
Call Forwarding Feature Codes
呼叫前转功能代码。
深圳星昊通科技有限公司 www.hiastar.com
156
Call Forward All Activate
前转通话从一个分机到另外一个号码。
Call Forward All Deactivate
关闭所有呼叫前转。
Call Forward All Prompting Deactivate
对分机用户提示关闭呼叫前转。
Call Forwarding Busy Activate
分机遇忙时执行前转。
Call Forwarding Busy Deactivate
分机遇忙时关闭呼叫前转。
Busy Call Forward No Answer/Unavailable Activate
在分机无应答状态几秒钟之后，执行前转。
Call Forward No Answer/Unavailable Deactivate
当分机无效或无应答时，关闭呼叫前转。
Call Forward No Answer/Unavailable Activate
用户无效或者无应答时，开启呼叫前转。
Call Forward Toggle
呼叫前转开关切换。
注意：每个分机的呼叫前转状态可以通过 Extension Settings 模块查看。
Call Waiting Feature Codes
呼叫等待功能代码。
深圳星昊通科技有限公司 www.hiastar.com
157
Call Waiting Activate
如果电话终端支持多路呼叫功能，当分机处于通话状态时，允许接收其他呼叫，呼叫加入
等待状态。
Call Waiting Deactivate
关闭呼叫等待。如果此分机处于通话状态，另外有其他呼叫接入到此分机时，这个呼叫被
转入到忙状态目的地。这个忙状态目的地在 Extensions 模块中设置。
注意：呼叫等待状态可以通过分机设置模块查看。
Core Feature Codes
核心功能代码
Asterisk General Call Pick
电话抢接功能。实现抢接功能必须满足以下几个条件：
正在振铃的分机必须在同一振铃组内。
需要抢接的分机必须在 Extension 模块中的同一个接听组内。如果用户希望办公室的
所有分机都可以进行抢接，那么必须对每一个分机中的 callgroup 和 pickupgroup 进行
修改，设置为 1。
ChanSpy
检测 PBX 中的呼叫。摁 (*) 键，循环监听不同的通道。呼叫双方则不会听到监听用户。
Directed Call Pickup
输入此功能代码加分机号码（正在振铃）可以对正在振铃的分机抢接。
In-Call Asterisk Attended Transfer
输入此功能代码对通话进行询转。询问转接对象，同意接听，输入 ??***，然后转此通
话到第三方。
深圳星昊通科技有限公司 www.hiastar.com
158
In-Call Asterisk Blind Transfer
输入此功能代码，直接转接此通话到第三方接听对象，无需询问第三方是否接听。当用户
听到拨号音后，然后输入第三方对象的号码则可以实现盲转。
User Logoff
当 FreePBX 配置成 Device&User 模式的环境下，使用此功能代码退出设备.
User Login
当 FreePBX 配置成 Device&User 模式的环境下，使用此功能代码登录设备。
ZapBarge
此代码允许用户对语音板卡的通道进行监听。
Call Flow Control
使用此代码来开启或者关闭 Call Flow Controls 模块设置。
Dictation
Asterisk 录音回放，支持用户进行录音，然后回放系统中的录音。
Do Not Disturb (DND)
免打扰功能
DND Activate
对分机设置免打扰。所有对此分机的呼叫将返回一个忙音信号。或者发送此呼叫进入到语
音邮箱。
DND Deactivate
设置此分机状态为免打扰关闭状态。
DND Toggle
对分机免打扰状态进行切换。
深圳星昊通科技有限公司 www.hiastar.com
159
注意：所有分机的免打扰状态都可以在分机设置模块中看到。设备免打扰的设置完全依赖于设
备本身。
Follow Me
Findme Follow Toggle: 切换分机随行开启或关闭状态。仅支持已设置了分机随行分机。更
多设置请参考分机随行模块配置。
Info Services
系统服务信息
Call Trace
播报此分机最后接收到通话的 Caller ID 。
Directory
此功能在 FreePBX 中已暂停支持。
Echo Test
拨打此功能代码听系统回放的回声测试。
Speak Your Exten Number
播报本分机号码。
Speaking Clock
播报当前系统时间。
Paging and Intercom
内部寻呼对讲功能
Intercom Prefix
拨打此功能代码加分机号码对此分机寻呼，而不是对此分机振铃。
深圳星昊通科技有限公司 www.hiastar.com
160
User Intercom Allow
此分机开启对讲呼叫。
User Intercom Disallow
此分机关闭对讲呼叫。
Parking Lot
Pickup ParkedCall Any
驻留地在驻留模块中配置以后，用户可以把呼叫驻留到 Extension 70。呼叫转接完成之
前，用户可以听到 Extension 号码，这个号码就是呼叫振铃的号码，通常是 71, 72, 73, 74,
以此类推。功能代码支持系统用户 重新接听被驻留的呼叫，无需知道哪个 Extension 号码
驻留了呼叫。
Phonebook Directory
Phonebook dial-by-name directory
目录系统支持系统用户通过拨打号码的前三位数字关联，通过分机模块来查找分机号码。
同样，也可以支持 Asterisk 电话薄中定义的号码来执行呼叫。
Queues
Queue Toggle
允许动态队列成员进行队列登录退出状态切换。参考队列模块了解如何在队列中指定一个
动态成员。
Recordings
Check Recording
此功能代码配合系统录音模块一起使用，在录音保存之前对录音文件进行监听。
深圳星昊通科技有限公司 www.hiastar.com
161
Save Recording
此功能配合系统录音模块使用，对语音进行录音，保存语音文件后为其他模块使用 (播报
声明，语音 IVR等等)。到系统录音模块，点击 Add Recording，输入分机号码，然后点击 "Go"，
按照指令进行下一步操作。
Time Conditions
此功能代码在时间条件模块中定义。
Voicemail
Dial Voicemail
用来检查系统中的语音邮箱。
My Voicemail
通过拨打功能代码，检查分机关联的语音邮箱。
管理员功能代码使用指南
Overview
Logging in
Changing a Feature Code
Enable or Disable the Feature Code
总览
管理员功能代码模块可以查阅所有 PBX 系统中的功能代码选项。用户可以对每个功能代码
执行设置:
修改功能代码的热键号码。
开启或关闭功能代码热键。
深圳星昊通科技有限公司 www.hiastar.com
162
Logging in
从菜单顶部点击 Admin
从下拉菜单中单击 Feature Codes
修改功能代码热键
如果修改功能代码热键的号码，请按照以下方式进行：
取消 “Use Default” 列的勾选，将清除勾选框的默认选项。
在输入框中输入用户设置的功能代码热键。
点击 "Submit Changes" ，不要忘记点击顶部的工具条"Apply Config" 。
注意：每个功能代码必须是唯一的，以免和其他功能代码传统。在一些不同的版本中，使用 *12
和 *123 可能引起冲突。
深圳星昊通科技有限公司 www.hiastar.com
163
Enable or Disable the Feature Code
在一些环境中，用户可能完全关闭以前使用的功能代码，用户可以通过切换开启关闭的开
关来调整使用状态。
在功能状态的列中，点击下拉菜单，选择"Disabled"
点击 "Submit Changes" ，并且点击顶部工具条 "Apply Config" 。
FreePBX 脚本安全扫描
FreePBX 发布了一个脚本文件，对系统的安全问题进行扫描，及时帮助用户发现问题。
运行安装:
wget --no-check-certificate
https://github.com/Schmoozecom/fpbxcheck/raw/master/fpbxseccheck.phar
chmod +x fpbxseccheck.phar
./fpbxseccheck.phar --clean --redownload
amportal a ma upgradeall
asterisk -rx 'dialplan reload'
asterisk -rx 'manager reload'
注意：攻击者可能通过 sip guest 帐号或者匿名呼叫登录 PBX 系统。一些系统用户希望保持
这些设置，但是脚本扫描不会自动更新系统设置，请用户自行关闭这些设置。
深圳星昊通科技有限公司 www.hiastar.com
164
如何一步步创建语音 IVR
IVR 实例 1
IVR Name: MainIVR // IVR 入口
IVR Description: Main Company IVR
Announcement: WelcometoCompany //播放欢迎致电 XXX 公司
Direct Dial: Enabled // 直接拨打分机号码
Timeout: 10 // 超时时长
Invalid Retries: 3 // 尝试 3 次输入
Invalid Retry Recording: SorryTryAgain // 播放错误输入录音
Append Original Announcement: Checked // 勾选
Invalid Recording: SorryAllDone // 播放无效录音
Invalid Destination: Terminate Call:Hangup // 无需输入，最后挂机
Timeout Retries: 2 // 超时尝试两次
Timeout Retry Recording: SorryDidNotHearAnythingTryAgain // 播放超时尝试录音
Append Original Announcement:Checked
Timeout Recording:SorryDidNotHearAnythingOperator // 超时录音
Timeout Destination:Extensions: Operator <0> // 超时后转发的目的地
IVR Entries: // 输入以下数字按键，进入相应的 IVR 语音中，例如摁 1 转入销售部门，
摁 2 转入技术服务部门
EXT Destination Return
1 Ring Groups:Sales Not Checked
深圳星昊通科技有限公司 www.hiastar.com
165
2 Ring Groups:Service Not Checked
3 Announcement:Address Not Checked
4 Announcement:Hours Not Checked
IVR 实例 2
通过外部访问 IVR 来获得语音邮箱内容，添加一个 IVR 入口设置使用功能代码访问*98 语
音邮箱：
Ext: *98 (或者其他的 IVR 拨打号码)
目的地设置: 通过管理员设置功能代码
o 选择 "Dial Voicemail <*98>"
当用户在 IVR 中拨打 *98 ，系统则会要求用户输入语音邮箱号码和访问密码。
另外一种方式是用户通过外部呼入到自己的语音邮箱，摁 *，系统则播放一个语音问候音，
系统要求用户输入语音邮箱密码访问语音邮箱。
IVR 模块用户使用指南
Overview
Logging In
Creating a new IVR
o IVR Name
o IVR Description
o Announcement
o Direct Dial
o Timeout
o Invalid Retries
o Invalid Retry Recording
o Append Original Announcement
o Invalid Recording
o Invalid Destination
o Timeout Retries
o Timeout Retry Recording
o Append Original Announcement
o Timeout Recording
o Timeout Destination
o Return to IVR after VM
深圳星昊通科技有限公司 www.hiastar.com
166
IVR Entries
o Ext
o Destination
o Return
总览
IVR 模块支持用户可以创建一个或者多个 IVR（自动话务员）。用户可以路由呼叫到这个
IVR 流程中，对呼叫方播放系统语音文件，呼叫方通过系统的语音提示，选择相应的选项进入
到下一个流程中，例如我们通常遇到的 “ 销售部请按 1，技术支持部请按 2”。一个 IVR 流
程同样可以进入到一个次级的 IVR 流程。通常情况下，一个 IVR 流程的选项在 5-6 个之间，否
则用户体验会非常差。
Logging In
从菜单顶部点击 Applications
从下拉菜单中点击 IVR
Creating a new IVR
点击 Add a new IVR 来添加一个 IVR 菜单
IVR Name
选择一个 IVR 名称，例如 “Business Hours”，工作时间。
IVR Description
输入一个对此 IVR 的描述.
深圳星昊通科技有限公司 www.hiastar.com
167
Announcement
当用户进入 IVR 以后，系统可以对呼叫方播放语音文件。语音文件可以是系统的录音文件，
也可以说用户自己录制的语音文件。通常会引导并提示用户输入相应的数字，例如 “销售部
请摁 1，技术支持部请摁 2”。
深圳星昊通科技有限公司 www.hiastar.com
168
Direct Dial
此选项支持呼叫方在 IVR 流程中直接拨打分机号码。以下是几个选项:
Disabled – 关闭此选项不允许任何呼叫方直接呼叫任何分机号码，仅限定在 IVR流程，
例如摁 1 转接到销售部门，摁 9 转接到技术支持部门。
Extensions – 允许呼叫方直接拨打公司分机号码。
Directory Names – 允许呼叫方访问公司目录（此公司目录为 PBX 创建）。系统同样可
以限定任何公司目录中的分机号码来接听此呼叫。这样的方式将限制一些外部号码从
IVR 中直接呼叫公司的内部分机。
Timeout
等待呼叫方输入选项按键的时长，超过此设置则认为超时。如果超时后则按照超时流程进
行下一步处理。我们建议设置为 4-5 秒超时时长。
Invalid Retries
允许尝试输入错误次数，如果输入的选项不能匹配系统提供的选项，允许用户进行多次尝
试。如果尝试次数超过设定的次数，则转为无效尝试流程。我们建议设置为 2 次。
Invalid Retry Recording
无效尝试后播放的语音，如果用户输入了无效的选项，则系统对呼叫方播放一个无效语音
提示。这个无效语音提示也可以通过系统录音模块设置或者用户自己录制。设置为 none，则
再次播放系统主语音播报文件。
Append Original Announcement
附加到最初语音播报，如果勾选了此选项，系统将播报无效输入语音文件，和最初的主语
音文件。相当于提示用户返回主菜单。
Invalid Recording
当呼叫方尝试的次数达到了上面定义的 Invalid Retry count，对呼叫方播放一个无效语
音文件。此文件可以说系统录音模块中的文件。
深圳星昊通科技有限公司 www.hiastar.com
169
Invalid Destination
如果呼叫方尝试次数超过了 Invalid Retries，仍然没有匹配选项，系统将把此呼叫方转
移到相应的无效呼叫目的地对象来负责处理此呼叫。我们可以把呼叫方转入到一个自定义的语
音邮箱，或者其他的对象。
Timeout Retries
系统转发呼叫方进入上面定义的无效目的地之前，在一定时间内允许呼叫方尝试次数。我
们建议设置为 1。
Timeout Retry Recording
超过指定的尝试次数以后，系统对呼叫方播放的语音文件，此文件可以在录音模块中设置。
如果设置为 “none” ，系统将对呼叫方再次播放初始的主菜单语音文件。
Append Original Announcement
附加到最初语音播报，如果勾选了此选项，系统将播报无效输入语音文件，和最初的主语
音文件。相当于提示用户返回主菜单。
Timeout Recording
当呼叫方超过了我们上面定义的 Timeout Retries值以后，我们对呼叫方播放的语音文件。
这个语音文件可以是系统录音模块控制的文件。
Timeout Destination
如果呼叫方尝试次数超过了 Timeout Retries ，仍然没有匹配选项，系统将把此呼叫方
转移到相应的无效呼叫目的地对象来负责处理此呼叫。我们可以把呼叫方转入到一个自定义的
语音邮箱，或者其他的对象。
Return to IVR after VM
如果勾选此选项后，当呼叫方从 IVR 进入到用户语音邮箱后，系统会提示用户摁 9 离开语
音邮箱返回到主语音 IVR 菜单。
深圳星昊通科技有限公司 www.hiastar.com
170
IVR Entries
此选项是基于用户输入的按键定义的目的地对象。
Ext
用户电话拨号盘的按键输入数字，我们建议仅使用单个数字按键。
Destination
此处定义用户输入数字按键以后，系统路由的目的地对象。这里可以是任何 PBX 系统设
置的目的地对象，例如振铃组，时间条件控制，队列或者其他的第三方对象。
Return
勾选此选项将允许呼叫方返回到上层菜单。这个功能对呼叫方非常方便，呼叫方可以轻松
返回上层语音菜单。
按绿色+标志可以添加更多语音 IVR 入口设置。
深圳星昊通科技有限公司 www.hiastar.com
171
注意：可以添加一个隐藏选项，允许公司员工远程通过 IVR 访问员工自己的语音邮箱。创建一
个 Ext 98 的入口，在“Destination 选择功能代码热键和*98 来拨打语音邮箱。不能对呼叫
方播放此选项，可以通知公司员工在主语音菜单中拨打 98 来访问语音邮箱。一旦登录了语音
邮箱后，此时系统会提示用户输入分机号码和语音邮箱密码访问语音邮箱。
Languages 语言模块使用指南
Overview
Logging In
Settings
o Description
o Language Code
o Destination
Call Routing
总览
语言模块支持用户修改呼叫流程的语言播报，不同的语言最终进入不同的目的地对象。例
如，一个公司的 IVR 系统可能有类似的选项 “摁 9 选择西班牙语”. 用户则可以创建一个西
班牙语的 IVR 子菜单，指定到相应的西班牙语语音播报文件。最终呼叫方被转入到支持西班
牙语的通道中。为了实现这一的功能，用户必须安装西班牙语音文件。
Logging In
从菜单顶部点击 Applications
在下拉菜单中点击 Languages
深圳星昊通科技有限公司 www.hiastar.com
172
Settings
Description
输入关于语言模块的描述。
Language Code
以下是目前各种语言的代码，用户可以自行修改。例如，西班牙语输入 “es”。
注意: 这个列表仅是一个标准的列表名单而已。用户必须安装相应的语音文件。其中一些可能
没有被安装在系统中，用户需要自己录制安装。
Language ISO CODE
(Afan) Oromo om
Abkhazian ab
Afar aa
Afrikaans af
Albanian sq
Amharic am
Arabic ar
Armenian hy
Assamese as
Aymara ay
Azerbaijani az
Bashkir ba
Basque eu
深圳星昊通科技有限公司 www.hiastar.com
173
Bengali bn
Bhutani dz
Bihari bh
Bislama bi
Breton br
Bulgarian bg
Burmese my
Byelorussian be
Cambodian km
Catalan ca
Chinese ch or zh
Corsican co
Croatian hr
Czech cs
Danish da
Dutch nl
English en
Esperanto eo
Estonian et
Faeroese fo
Fiji fj
Finnish fi
French fr
Frisian fy
Galician gl
Georgian ka
German de
Greek el
Greenlandic kl
Guarani gn
Gujarati gu
Hausa ha
Hebrew (former
iw) he
Hindi hi
Hungarian hu
Icelandic is
深圳星昊通科技有限公司 www.hiastar.com
174
Indonesian
(former in) id
Interlingua ia
Interlingue ie
Inupiak ik
Inuktitut
(Eskimo) iu
Irish ga
Italian it
Japanese ja
Javanese jw
Kannada kn
Kashmiri ks
Kazakh kk
Kinyarwanda rw
Kirghiz ky
Kirundi rn
Korean ko
Kurdish ku
Laothian lo
Latin la
Latvian,
Lettish lv
Lingala ln
Lithuanian lt
Macedonian mk
Malagasy mg
Malay ms
Malayalam ml
Maltese mt
Maori mi
Marathi mr
Moldavian mo
Mongolian mn
Nauru na
Nepali ne
Norwegian no
Occitan oc
深圳星昊通科技有限公司 www.hiastar.com
175
Oriya or
Pashto, Pushto ps
Persian fa
Polish pl
Portuguese pt
Punjabi pa
Quechua qu
Rhaeto-Romance rm
Romanian ro
Russian ru
Samoan sm
Sangro sg
Sanskrit sa
Scots Gaelic gd
Serbian sr
Serbo-Croatian sh
Sesotho st
Setswana tn
Shona sn
Sindhi sd
Singhalese si
Siswati ss
Slovak sk
Slovenian sl
Somali so
Spanish es
Sudanese su
Swahili sw
Swedish sv
Tagalog tl
Tajik tg
Tamil ta
Tatar tt
Tegulu te
Thai th
Tibetan bo
Tigrinya ti
深圳星昊通科技有限公司 www.hiastar.com
176
Tonga to
Tsonga ts
Turkish tr
Turkmen tk
Twi tw
Uigur ug
Ukrainian uk
Urdu ur
Uzbek uz
Vietnamese vi
Volapuk vo
Welch cy
Wolof wo
Xhosa xh
Yiddish
(former ji) yi
Yoruba yo
Zhuang za
Zulu zu
注意：如果系统没有安装相应的语音提示文件，系统则自动播放默认的英文语音。
Destination
此选项支持用户选择基于此语言的呼叫目的地对象。在这个目的地对象中播放的语音应该
是用户设置的语言。完成修改后，点击 “Submit Changes” 按钮提交修改。
Call Routing
一旦配置完成，其他模块中就包含了一个新的语言目的地。用户可以直接路由呼叫到相应
的语言目的地。
深圳星昊通科技有限公司 www.hiastar.com
177
自动登录 FreePBX 12 以上版本
如果用户希望通过程序设置自动登录 FreePBX，在高级设置中开启 'REMOTEUNLOCK' ，然
后后台运行：
amportal a genunlockkey
系统将输出以下类似的结果:
[root@localhost tmp]# amportal a genunlockkey
Please wait...
If REMOTEUNLOCK is enabled, you will receive a value for KEY. You can use
that as a parameter to config.php, thus:
http://192.168.1.1/admin/config.php?unlock=abc123def...
KEY=1cf97aa02913fc0ae5f65b6d69c6270b2c7dd57e201dd541cb163e6410a17f2d
[root@localhost tmp]#
如果没有开启 'REMOTEUNLOCK'，则不能生成 KEY。
告警
私钥生成以后，用户只能尝试登录一次。如果输入了不正确的私钥，保存的私钥就会被
删除，用户需要重新生成。
如果没有开启 REMOTEUNLOCK ，此私钥则无效。
私钥没有时间限制。
每个系统一次只能使用一个私钥。
参考链接：
http://git.freepbx.org/projects/FREEPBX/repos/framework/browse/amp_conf/htdocs/ad
min/libraries/BMO/Unlock.class.php?at=refs%2Fheads%2Fdevelop
深圳星昊通科技有限公司 www.hiastar.com
178
通过 CLI 管理模块访问：
相关连接
o FreePBX (CLI) Commands (获得更多 "amportal" 命令信息)
界面管理是用来管理 PBX 配置和系统，管理员模块可以添加和删除相应的模块，但是也
可以通过 CLI 命令来管理这些模块。
以下是通过 CLI 命令安装 "System Admin" 模块:
amportal a ma install sysadmin
列出的其他命令和参数：
Module Admin Functions
amportal a ma [params] <operation><module> [parameters..]
PARAMETERS:
-f Force operation (skips dependency and status checks)
WARNING: Use at your own risk, modules have dependencies for a reason!
-R, --repo, --repos repo1,repo2,repo3...)
List of repositories to check, valid options: standard, extended, unsupported,
commercial.)
Locally installed modules will be checked despite the repository list.)
OPERATIONS:
checkdepends <module>
Check if module meets all dependencies
delete <module>
Disable, uninstall, and delete the specified module
deleteall
Disable, uninstall, and delete ALL MODULES
WARNING: Use at your own risk, this will remove ALL MODULES from your system!
disable <module>
Disable the specified module
download <module>
Download the module from the website
深圳星昊通科技有限公司 www.hiastar.com
179
If -f is used, downloads even if there is already a copy.
enable <module>
Enable the specified module
info <module>
Get information about a given module
i18n <module>
print out i18n required text for the given module
install <module>
Install the module (must exist in the modules directory)
installlocal
Installs any module not installed that is locally available
installall
Installs all module that exist in the repository
refreshsignatures
ReDownloads all modules that have invalid signatures
list
List all local modules and their current status
listonline
List all local and repository modules and their current status
reload
Reload the configuration (same as pressing the reload bar)
reversedepends <module>
Show all modules that depend on this one
showupgrades
Show a list of upgradable modules
showannounce
Shows any annoucements that maybe displayed at freepbx.org for this version
uninstall <module>
Disable and uninstall the specified module
upgrade <module>
Equivalent to running download and install
upgradeall
深圳星昊通科技有限公司 www.hiastar.com
180
Downloads and upgrades all modules with pending updates
--help, -h, -? Show this help
管理员模块用户使用指南
Overview
Logging in
Update Notifications
Repositories
o Basic
o Extended
o Unsupported
o Commercial
Upload Modules
Module Management
o Update
Check Online
Bulk Action
Download all
Upgrade all
Go/No Go
Individual Action
o Enable
o Disable
o Install
o Uninstall
Alternative management
总览
FreePBX 是基于模块化设计的平台。用户可以对 PBX 中的模块开启，关闭更新和安装。
Logging in
从顶部菜单点击 Admin
从下拉菜单中点击 Module Admin
深圳星昊通科技有限公司 www.hiastar.com
181
Update Notifications
点击更新提示设置来提醒用户对模块更新
界面会弹出一个输入框，输入用户邮箱，然后保存。
Repositories
数据仓库的更新提示检查是否有更新的模块。
注意：如果有任何系统模块更新的提示，系统将检测系统安装的模块的版本给予提示。
深圳星昊通科技有限公司 www.hiastar.com
182
Basic
数据仓库中的基础模块。
Extended
数据仓库中的模块，很少使用，FreePBX 不会对这些模块优先提供技术帮助。
Unsupported
FreePBX 团队已经不再支持这些模块，但是可能发布者提供一些帮助。
Commercial
这些模块是 FreePBX 发布的商业模块，购买以后可以获得商业技术支持。
Upload Modules
警告：这些功能仅对高级用户使用。可能会损坏系统模块结构。
"Upload modules" 按钮用来上传用户从其他第三方资源获得的模块。用户一个仅安装
信任的模块。
点击 "Upload modules" 后，用户会看到：
用户可以上传任何 gzip 文件 (module.tar.gz).。此上传文件将覆盖同样命名的模块。
点击 "Choose File" 将提示用户从本地系统插值相关文件。
深圳星昊通科技有限公司 www.hiastar.com
183
点击上传文件后，用户会看到以下信息：
Module uploaded successfully. You need to enable the module using local module
administration to make it available.
点击链接返回管理员模块界面。用户可以看到自己所上传的模块在系统的模块列表中。
模块被激活以后，用户就可以开始安装。
Module Management
Update
Check Online
当用户点击 "Check Online" 按钮时，PBX 将检查用户模块是否已经更新。如果检查结果
显示 "Show only upgradeable" ，则可以更新。其他不需要更新的模块则被隐藏，不再显
示。
Bulk Action
用户将看到选项 "Download all" 和 "Upgrade all"。
深圳星昊通科技有限公司 www.hiastar.com
184
Download all
将下载最新的可更新模块以便未来安装。
Upgrade all
选择此选项将下载和安装所有可更新的模块。
Go/No Go
如果用户摁 "Reset" 按钮则取消所有已选项，摁 "Process" 将执行已选安装包。
Individual Action
用户可以点击任何一个模块执行任何指令。
点击 "Download and Upgrade" 则下载升级选择的模块，然后摁 "Process" 按钮执行安
装升级流程。用户可以选择多个模块进行安装升级。
用户也可以点击每个模块的 "Checking Online" ，查看模块的升级日志信息。
Enable
有时候为了排查系统问题，用户可能需要关闭一些模块，模块关闭以后，则显示在相应的
列表名单中。
深圳星昊通科技有限公司 www.hiastar.com
185
如果需要开启模块，则选择"Enable" 。
Disable
在有一些情况下，用户需要关闭模块，而不是删除已安装模块。
关闭模块则选择 "Disable"。
Install
一些模块已经下载到用户目前的系统，但是还没有被成功安装。如果是这样的情况，系统
界面则显示 "Not installed (locally available)" T。这些模块则无需再次下载，可以直接
安装这些模块，仅选择 "Install" 就可以进行直接安装。
用户安装的大部分模块是来自于数据仓库。当用户点击 "Check Online"，系统界面显示
一个可更新的或可安装的模块列表名单。
当检查到一个模块在线可用，但是没有安装时，界面则显示 "Not Installed (Available
online: Version)"。用户可以从数据仓库安装此模块，点击 "Download and Install" 进行
安装流程。
深圳星昊通科技有限公司 www.hiastar.com
186
Uninstall
用户可以关闭甚至清除已安装的模块。如果删除模块的话，系统将删除模块本身和文件系
统的数据。取决于模块本身的设置，有时候系统也会清除和模块相关的数据库信息。
选择 "Uninstall" 对模块删除。
Alternative management
通常情况下，用户管理系统的模块是通过界面来处理，用户也可以通过系统 CLI 命令对模
块进行管理。更多关于 CLI 命令来管理模块的文档，请查询其他的相关章节。
使用主机防火墙保护 Asterisk/FreePBX
Rules for a Free PBX Host Server
o IP Tables rules
Port Names o Fail 2 Ban
o VOIP Blacklist
Free PBX 服务器防火墙设置
IP Tables rules
开启需要的端口，并且限定暴力攻击
-A INPUT -p udp -m multiport --dports 5060,5061 -m set --match-set fail2ban-ASTERISK
src -j REJECT --reject-with icmp-port-unreachable
-A INPUT -p tcp -m multiport --dports 5060,5061 -m set --match-set fail2ban-ASTERISK
src -j REJECT --reject-with icmp-port-unreachable
-A INPUT -p tcp -m multiport --dports 22 -j fail2ban-ssh
-A INPUT -m set --match-set voip_bl src -j DROP
-A INPUT -i lo -j ACCEPT
-A INPUT -p udp -m udp --dport 10000:20000 -j ACCEPT
深圳星昊通科技有限公司 www.hiastar.com
187
-A INPUT -p udp -m udp --dport 2727 -j ACCEPT
-A INPUT -p udp -m udp --dport 4569 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p udp -m udp --dport 5060:5061 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 5060:5061 -j ACCEPT
-A INPUT -s known_external_proxy -p udp -m udp --dport 5060:5061 -j ACCEPT
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "User-Agent:
VaxSIPUserAgent" --algo bm --to 65535 -j DROP
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "User-Agent:
friendly-scanner" --algo bm --to 65535 -j REJECT --reject-with icmp-port-unreachable
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "REGISTER sip:" --algo
bm --to 65535 -m recent --set --name VOIP --mask 255.255.255.255 --rsource
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "REGISTER sip:" --algo
bm --to 65535 -m recent --update --seconds 60 --hitcount 12 --rttl --name VOIP --mask
255.255.255.255 --rsource -j DROP
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "INVITE sip:" --algo bm
--to 65535 -m recent --set --name VOIPINV --mask 255.255.255.255 --rsource
-A INPUT -p udp -m udp --dport 5060:5061 -m string --string "INVITE sip:" --algo bm
--to 65535 -m recent --update --seconds 60 --hitcount 12 --rttl --name VOIPINV --mask
255.255.255.255 --rsource -j DROP
-A INPUT -p tcp -m tcp --dport 5060:5061 -m hashlimit --hashlimit-upto 6/sec
--hashlimit-burst 5 --hashlimit-mode srcip,dstport --hashlimit-name tunnel_limit -j
ACCEPT
-A INPUT -p udp -m udp --dport 5060:5061 -m hashlimit --hashlimit-upto 6/sec
--hashlimit-burst 5 --hashlimit-mode srcip,dstport --hashlimit-name tunnel_limit -j
ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 137 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 138 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 139 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 445 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/23 -p tcp -m tcp --dport 10000 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 22 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 123 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p udp -m udp --dport 123 -j ACCEPT
-A INPUT -p tcp -m tcp --dport 80 -j ACCEPT
-A INPUT -p tcp -m tcp --dport 443 -j ACCEPT
-A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p tcp -m tcp --dport 514 -j ACCEPT
-A INPUT -s xxx.xxx.xxx.xxx/24 -p udp -m udp --dport 514 -j ACCEPT
-A INPUT -s 192.168.244.2/32 -j ACCEPT
-A INPUT -j DROP
-A OUTPUT -j ACCEPT
注意：替换使用服务器本地地址替换 xxx.xxx.xxx.xxx/24，例如内外地址 192.168.1.0/24
深圳星昊通科技有限公司 www.hiastar.com
188
Port Names
Name Port Group
sip 5060 VOIP
sip-t 5061 VOIP
netbios-ns 137 Samba
netbios-dg 138 Samba
netbios-ss 139 Samba
microsoft-ds 445 Samba
webmin 10000 webmin
ssh 22 ssh
http 80 web
ntp 123 time
https 443 web
syslog 514 syslog
Fail 2 Ban
安装防止暴力攻击工具
Ubutun 中安装 fail2ban 和 ipset
apt-get install fail2ban ipset
以下配置作为一个参考设置：.
/etc/fail2ban/filter.d/asterisk.conf
# Fail2Ban filter for asterisk authentication failures
#
[Definition]
__pid_re = (?:\[\d+\])
# All Asterisk log messages begin like this:
log_prefix= \[\]\s*(?:NOTICE|SECURITY)%(__pid_re)s:?(?:\[C-[\da-f]*\])? \S+:\d*
failregex = ^%(log_prefix)s Registration from '[^']*' failed for '<HOST>(:\d+)?'
\(.*\) - (Wrong password|No matching peer found|Username\/auth name mismatch|Device
does not match ACL|Peer is not supposed to register|ACL error \(permit\/deny\)|Not
a local domain)$
^%(log_prefix)s Request from '[^']*' failed for '<HOST>(:\d+)?' \(.*\) - No
matching endpoint found$
^%(log_prefix)s Call from '[^']*' \(<HOST>:\d+\) to extension '\d+' rejected
because extension not found in context 'default'\.$
深圳星昊通科技有限公司 www.hiastar.com
189
^%(log_prefix)s Host <HOST> failed to authenticate as '[^']*'$
^%(log_prefix)s No registration for peer '[^']*' \(from <HOST>\)$
^%(log_prefix)s Host <HOST> failed MD5 authentication for '[^']*' \([^)]+\)$
^%(log_prefix)s Failed to authenticate (user|device) [^@]+@<HOST>\S*$
^%(log_prefix)s (?:handle_request_subscribe: )?Sending fake auth rejection
for (device|user) \d*<sip:[^@]+@<HOST>>;tag=\w+\S*$
^%(log_prefix)s
SecurityEvent="(FailedACL|InvalidAccountID|ChallengeResponseFailed|InvalidPasswor
d)",EventTV="[\d-]+",Severity="[\w]+",Service="[\w]+",EventVersion="\d+",AccountI
D="\d+",SessionID="0x[\da-f]+",LocalAddress="IPV[46]/(UD|TC)P/[\da-fA-F:.]+/\d+",
RemoteAddress="IPV[46]/(UD|TC)P/<HOST>/\d+"(,Challenge="\w+",ReceivedChallenge="\
w+")?(,ReceivedHash="[\da-f]+")?$
^\[\]\s*WARNING%(__pid_re)s:?(?:\[C-[\da-f]*\])? Ext\. s: "Rejecting
unknown SIP connection from <HOST>"$
ignoreregex =
# Author: Xavier Devlamynck, extended by Graham Barnett
以下配置使用 ipset 而不是 iptables ，使用 ipset 速度可能更快。
# "ignoreip" can be an IP address, a CIDR mask or a DNS host. Fail2ban will not
# ban a host which matches an address in this list. Several addresses can be
# defined using space separator.
ignoreip = 127.0.0.1/8 xxx.xxx.xxx.xxx/24
# Multiple jails, 1 per protocol, are necessary ATM:
# see https://github.com/fail2ban/fail2ban/issues/37
[asterisk-tcp]
enabled = true
filter = asterisk
port = 5060,5061
action = iptables-ipset-proto4[name=ASTERISK, port='5060,5061', protocol=tcp]
#uncomment for bl voipbl[serial=XXXXXXXXXX]
protocol = tcp
logpath = /var/log/asterisk/fail2ban2
maxretry = 5
bantime = 259200
[asterisk-udp]
enabled = true
filter = asterisk
port = 5060,5061
action = iptables-ipset-proto6[name=ASTERISK, port='5060,5061', protocol=udp]
深圳星昊通科技有限公司 www.hiastar.com
190
#uncomment for bl voipbl[serial=XXXXXXXXXX]
protocol = udp
logpath = /var/log/asterisk/fail2ban2
maxretry = 5
bantime = 259200
# Jail for more extended banning of persistent abusers
# !!! WARNING !!!
# Make sure that your loglevel specified in fail2ban.conf/.local
# is not at DEBUG level -- which might then cause fail2ban to fall into
# an infinite loop constantly feeding itself with non-informative lines
[recidive]
enabled = false
filter = recidive
logpath = /var/log/fail2ban.log
action = iptables-ipset-proto6[name=recidive, protocol=all]
sendmail-whois-lines[name=recidive, logpath=/var/log/fail2ban.log]
bantime = 604800 ; 1 week
findtime = 86400 ; 1 day
maxretry = 5
VOIP Blacklist
通过对 VOIP 源进行黑名单过滤来保护 PBX。
VoIPBL 是一个分布式的 VoIP 黑名单管理工具，它可以用来保护系统安全，防止电话盗
打，控制 PBX 公共访问。
参考链接：http://www.voipbl.org/.
设置 CallerID
Overview
Logging In
Setting a CallerID
o Description
o CallerID Name
o CallerID Number
o Destination
o Save
Working With Variables
深圳星昊通科技有限公司 www.hiastar.com
191
总览
设置 CallerID 模块可以支持 caller id 的号码变换，以便可以非常简单地确认呼叫方
信息，对呼叫方播放准确语音提示，同时对多个公司的呼入提供优先级呼叫处理。此模块支持
用户修改呼叫的 callerID ，并且继续路由到相应的目的地对象。
Logging In
从菜单顶部登录，点击 Applications
从下拉菜单中点击 Set CallerID
Setting a CallerID
Description
输入一个有效的 CallerID 实例名称，例如: “Sales CID”。
CallerID Name
需要修改的 callerID 名称。如果需要追加到当前的 callerID 前，不要忘记包含一些系
统变量。如果为空，CallerID 名称则为空。默认的 CID Name 变量是: ${CALLERID(name)}。
深圳星昊通科技有限公司 www.hiastar.com
192
CallerID Number
需要修改的 callerID 号码。如果需要追加到当前的 callerID 前，不要忘记包含相应的
变量。如果为空，那么 CallerID Number 将为空。默认的 CID Number 变量是:
${CALLERID(num)}
Destination
选择一个有效的目的地继续执行当前的呼叫。
Save
修改后，不要忘记点击保存，摁 “Submit Changes”。
配合系统变量工作
注意：asterisk 变量也可以在拨号规则中使用：
修改变换:
Example Description
${VARIABLE:n} 跳过 n 个字符
${VARIABLE:-n} 仅捕获最后 n 个字符
${VARIABLE:s:n} 捕获字符以 s 开始，捕获数量是 n 个字符
例如:
Description Variable 输入结果 输出结果
从号码中删除+ ${CALLERID(num):1} +4805551212 4805551212
对号码添加数字 1 1${CALLERID(num)} 4805551212 14805551212
使用 account code 替
换 caller name（假设这里
的 account code 是 12345）
${CDR(accountcode)} John Smith 12345
深圳星昊通科技有限公司 www.hiastar.com
193
时间条件用户模块使用指南
Overview
Logging in
Creating a Time Condition
o Time Condition Name
o Enable Override Code
o Time Group Drop-down
o Destination if time matches
o Destination if time does not match
o Save Changes
Editing/Deleting
o Deleting
o Editing
总览
时间条件模块定义一系列的时间组，要求 PBX 根据不同的时间选择不同的路由。一个时间
条件组有两个不同的目的地对象，如果时间条件满足匹配要求，则路由呼叫到指定的目的地对
象，如果不匹配，则路由到其他的呼叫路由。时间条件组通常用来设置公司 PBX 呼入路由呼叫，
指定 PBX 在上班时间段和下班后的时间段分别经过不同的路由管理模式。例如，如果是上班时
间，客户呼入的电话转接到公司 IVR 或者振铃组；如果客户下班以后呼入公司的 PBX，则要求
系统播放一个语音提示，转入特别指定的目的地对象，这个目的地对象可以是语音留言，可以
是分机随行或者其他的处理方式。
注意：时间组应该在时间条件前设置
Logging in
从菜单顶部登录，点击 Applications
从下拉菜单中点击 Time Conditions
深圳星昊通科技有限公司 www.hiastar.com
194
Creating a Time Condit
Time Condition Name
输入一个时间组的描述。例如, “Closed Hours” 可能比其他一般表示方法准确一点
“Time Condition 1”。
代表这个组是公司下班后的时间组。
Enable Override Code
如果勾选此值，开启功能代码，这个功能代码支持用户覆盖时间条件设置。如果开启了此
功能，呼叫进入以后，系统的时间条件将被手动修改。
深圳星昊通科技有限公司 www.hiastar.com
195
Time Group Drop-down
此设置支持用户选择这个时间组来匹配条件设置。用户可以通过时间组模块创建一个新的
时间组。
Destination if time matches
如果匹配定义的时间组，则要求系统转发呼叫到此目的地对象。
Destination if time does not match
如果不匹配时间组，则要求系统转发呼叫到另外一个目的地对象。
Save Changes
点击提交，不要忘记点击 "apply conf"。
Editing/Deleting
从右栏的菜单中点击相应的时间组编辑或者删除。
Deleting
点击 Delete Time Condition 删除链接。
深圳星昊通科技有限公司 www.hiastar.com
196
Editing
编辑完成以后，可以点击提交，不要忘记点击“ Apply Conf”。
时间组用户使用指南
Overview
Logging In
Adding a time Group
o Description
o New Time
Assigning Time Groups to Time Conditions Via the Time Conditions Module
Assign Time Groups to Outbound Routes
总览
时间组是一个不同时间段的列表，PBX 呼入或者呼出时需要检查时间列表以便做相应的匹
配。时间组的规则可以以小时或者天数来划分不同的时间段。每个时间组可以支持无限多个规
则。顾名思义，时间组更多的情况下是配合时间条件模块来进行。呼出路由可以指定到不同的
时间组内，根据时间段的不同做相应的路由处理。
Logging In
从菜单顶部点击 Applications
从下拉菜单中点击 Time Groups
深圳星昊通科技有限公司 www.hiastar.com
197
Adding a time Group
Description
输入一个时间组的描述。例如： “公司下班后时间组” 或者“公司工作时间组”。
深圳星昊通科技有限公司 www.hiastar.com
198
New Time
这里定义一个时间段：
Time to start – 时间组的起始时间
Time to finish – 时间组的结束时间
Week Day start – 周几开始。
Week Day finish – 周几结束。
Month Day start – 本月的哪天开始
Month Day finish – 本月的哪天结束
Month start – 哪个月开始
Month finish – 哪个月结束
注意:没有设置的参数将设置为默认参数。例如，通常情况下，开始时间为上午 09:00 ，下班
时间为下午 17:00 等，工作时间为星期一到星期五，星期六和星期日为休息日。
Assigning Time Groups to Time Conditions Via the Time Conditions Module
如果设置了时间条件后，时间组就会显示在时间条件中。现在时间组可以通过时间条件模
块来进行选择匹配。
Assign Time Groups to Outbound Routes
通过时间管理实现对外呼路由进行控制是非常必要的。强制用户在晚上或者其他非工作时
间通过其他的呼出路由呼出。
Voicemail – 分机级别的管理
Overview
Logging in
o Existing User
o New Extension
Settings
o Status
o Voicemail Password
o Email Address
o Pager Email Address
深圳星昊通科技有限公司 www.hiastar.com
199
o Email Attachment
o Play CID
o Play Envelope
o Delete Voicemail
o VM Options
o VM Context
总览
此指南帮助用户对每个分机进行语音邮箱的设置。
Logging in
从菜单顶部登录，点击 Applications
从下拉菜单中点击 extensions
Existing User
点击已创建的用户进行编辑
New Extension
从设备中选择设备类型
点击提交按钮 Submit
注意:这里有很多相关的设置，我们仅指导用户如何配置语音邮箱。
Settings
深圳星昊通科技有限公司 www.hiastar.com
200
Status
是否对此用户开启或者关闭语音邮箱。
Voicemail Password
语音邮箱密码支持用户访问邮箱。密码仅支持数字号码。
用户可以通过终端话机拨打*98 通过密码登录邮箱系统。
Email Address
语音邮件的邮箱地址。
Pager Email Address
语音邮件提示信息接收的邮箱地址。
Email Attachment
作为邮件附件形式发送语音邮箱信息。
Play CID
收到信息前，播放发送方邮件的语音提示。例如: 来自于 6025551212 的语音邮件。
Play Envelope
收到信息前，播放此语音信息的时间和日期。例如：在 12 12 2013 下午 4 23 收到一份
语音邮件。
Delete Voicemail
信息发送后是否删除语音邮件。
注意:如果设置为 yes 状态，邮件附件设置为 no 状态，则邮箱信息会永远丢失。
VM Options
语音邮箱支持的其他选项可以通过 | 分开
深圳星昊通科技有限公司 www.hiastar.com
201
其他选项支持：
这里有多个其他的选项，通常情况下用户不会使用这些选项。如果用户需要使用选项时，
可以选择这些选项支持。
serveremail
设置邮箱服务器。这里的服务器地址设置可以支持两种方式。如果字符的格式为
[email protected]，整个地址会作为邮件的发送服务器地址。如果地址仅设置为某个用户名
称 someone，那么服务器主机名称则是正在运行 Asterisk 的主机名称，系统将在用户名称和
@后自动添加此主机名称。
tz
表示时区
imapuser
如果使用了 Imap 存储方式，需要 Imap 用户名。
imappassword
如果使用了 Imap 存储方式，需要 Imap 用户密码。
review
有时，系统也允许呼叫方在发送语音消息前重新查看信息。如果设置为 yes 状态，则表示
呼叫方要求发送之前或者摁“#”号保存后可以重新查看信息。如果设置为 no 状态，信息将被
保存，语音邮箱将断开和呼叫方的连接。默认设置为 no 状态。注意，仅对 Asterisk 支持了
高级邮箱设置的版本使用。
maxmsg
一个语音文件夹中最大支持的语音文件数量。这里最大值是 9999 (代码中写死的) 默认
设置为 100。当语音邮箱中文件数量大于默认设置时，新消息就不能被保存，系统会对呼叫方
播放一个 vm-mailboxfull 语音邮箱已满的语音提示。所以系统也不可能保留任何新的信息。
这个功能在 asterisk-1.2 版本发布。在早期版本中，语音邮箱最大文件数量的设置为 100，
代码中已写死。
深圳星昊通科技有限公司 www.hiastar.com
202
volgain
语音邮箱的语音增益，通过附件发送语音留言时可以用来调整语音增益。需要安装 sox
支持软件。
operator
此设置支持呼叫方在语音留言录音期间，或者留言完成同时 review 选项设置为 yes 时，
呼叫方可连接到系统接线员。这个选项支持 yes 或 no 两种选项。但是接线员必须在
extension.conf 中以“o”来定义，表示是接线员拨号规则。用户可以查看 voicemail.conf 中
的 exitcontext 。这个功能仅支持 asterisk 版本中的高级邮箱设置功能。
callback
从高级邮箱功能菜单的“return phone call ”中设置一个 context。这个字符串是可以
作为呼出的 context 来使用。默认的字符串是空白状态。这个功能仅支持 asterisk 版本中的
高级邮箱设置功能。
dialout
从高级邮箱功能菜单的“place an outgoing call ”中设置一个 context。这个字符串
是可以作为呼出的 context 来使用。默认的字符串是空白状态。这个功能仅支持 asterisk 版
本中的高级邮箱设置功能。
exitcontext
当系统用户已摁* 或者 0 退出语音邮箱后，系统会把用户推送到这个可选 exitcontext。
如果没有设置此选项，用户摁* 或者 0 以后，PBX 会把呼叫方推送到当时发送语音邮件的
context 中（假设这个 context 已经支持了 'a' 或者 'o' extension)。
VM Context
这个 Voicemail Context 通常设置为默认状态。除非用户理解此设置的功能，否则不要
修改此设置。
深圳星昊通科技有限公司 www.hiastar.com
203
Voicemail 管理员高级设置
Overview
Logging in
Settings
o attach
o pbxskip
o serveremail
o fromstring
o maxsilence
o silencethreshold
o skipms
o review
o operator
o nextaftercmd
o format
o maxmessage
o minmessage
o maxsecs
o minsecs
o pollmailboxes
o pollfreq
o imapserver
o imapflags
o imapfolder
o expungeonhangup
o imapgreetings
o forcename
o forcegreetings
总览
这些设置是针对高级用户使用。大部分情况下，默认配置就可以工作。所以除非用户编辑
熟悉这些配置，一般情况下无需对这些配置做出修改。
Logging in
从菜单顶部点击 Settings
从下拉菜单中点击 Voicemail Admin
在 system view 链接中点击 Advance Settings
深圳星昊通科技有限公司 www.hiastar.com
204
Settings
attach
是否允许添加邮件附件。
pbxskip
邮件主题中不添加 [PBX]。
serveremail
邮件服务器地址。
fromstring
邮件发送人的真实姓名。
maxsilence
等待 5 秒钟静音，结束语音邮件。
深圳星昊通科技有限公司 www.hiastar.com
205
silencethreshold
静音阀值。
skipms
回放语音留言时，前进/后退跳过时长。
review
保存语音留言前，是否允许用户重新查看或重录语音留言。
operator
支持呼叫方摁 0 数字键。
nextaftercmd
当前语音留言文件被删除或保存后自动播放下一个留言。
format
此公司用来支持用户语音留言的语音格式。默认的格式包括 wav49|gsm|wav，表示
asterisk 将支持以上三种格式的播放。当系统发送语音留言附件时，系统将仅发送这里定义
的第一种文件格式。当用户回放语音留言时，为了取得最佳的语音效果和减少编码转换的时间，
Asterisk 将使用当前通道最优编码来回放，以下是各种编码方式的介绍：
wav49: 这种格式的语音文件比较小，语音质量好，是发送附件时比较好的格式。文件
保存的格式以 .WAV 后缀格式保存。 Windows 用户没有什么播放问题，其他操作系统
的用户也比较容易使用。
gsm: 语音留言保存的文件大小和语音质量和 wav49 类似。但是有时缺乏操作系统的支
持。
wav: 是未压缩的语音文件格式，以 .wav 为文件后缀，文件非常大。语音质量良好。
但是用户发送邮件附件时非常不方便，一般的邮件服务器可能不接受这样大的文件附件。
如果存储很多语音留言时，用户电脑必须有很大的存储空间。
g723sf: 在实例 voicemail.conf 配置文件中，这个选项可能已经支持。但是如果用
户需要激活这个格式的话，可能遇到一些问题。查看 asterisk 官方文档获得支持。
在一些用户使用的操作系统中，对文件格式有一些不同的定义，所以文件大小写是非常关
键的。例如，用户可以保存文件以 .wav 为后缀，但是不能使用.WAV(wav49) 后缀。Asterisk
在回放时使用通道所支持的语音编码格式，然后按照一定的顺序通过文件类型来查找文件。在
深圳星昊通科技有限公司 www.hiastar.com
206
以上两种情况下，asterisk 将查询 wav 格式和 WAV 格式，然后 asterisk 将首先尝试使用 wav
的格式播放此文件。在语音留言中这个格式是非常重要的。如果在语音留言中同时支持了
wav49 和 wav 两种格式的文件，其中一种将被另外一种替换。因此，建议用户在
voicemail.conf 中删除文件格式选项中的 wav49 。
maxmessage
最大语音留言时长。0 为默认设置，无限制时长。
minmessage
最短语音留言时长。
maxsecs
预估最大留言时长。
minsecs
最短留言时长，以秒为单位。
pollmailboxes
周期查询语音留言状态，发送 MWI 状态消息，以秒为单位。
pollfreq
如果使用了 IMAP 存储方式，用户名称和密码在全局变量中设置。
imapserver
设定一个 IMAP 服务器端地址。
imapflags
设定一个 IMAP 标志符 (例如，"notls" )。
imapfolder
设定 IMAP 存储的文件夹保存语音留言和语音提示语录音文件。
深圳星昊通科技有限公司 www.hiastar.com
207
expungeonhangup
对一些留言进行标志，当挂机时删除。
imapgreetings
在 IMAP 设置中存储语音留言提示语。
forcename
强制新用户录制用户姓名。新用户认证需要通过密码输入，工作方式类似于语音邮箱。默
认设置为 "no"。
forcegreetings
工作方式和 forcename 类似，但是不会录音。
Voicemail 管理员 –时区设置
Overview
Logging in
Settings
o New Name
o New Timezone Definition
Timezones Values
总览
此模块支持高级用户使用。大部分环境下配置是完全可以工作的。如果需要修改高级设置，
用户必须了解为什么做出修改。
Logging in
从菜单顶部点击 Settings
从下拉菜单中点击 Voicemail Admin
在 system view 链接中点击 Timezone Definitions
深圳星昊通科技有限公司 www.hiastar.com
208
Settings
New Name
名称描述
New Timezone Definition
语音回复时间提示
Timezone 定义格式: timezone|values
Timezones
Time Zones
选择用户系统时区，配置文件在 /usr/share/zoneinfo/ 目录下。
Africa/Abidjan
Africa/Accra
Africa/Addis_Ababa
Africa/Algiers
Africa/Asmara
Africa/Bamako
Africa/Bangui
Africa/Banjul
Africa/Bissau
Africa/Blantyre
Africa/Brazzaville
Africa/Bujumbura
Africa/Cairo
Africa/Casablanca
Africa/Ceuta
Africa/Conakry
深圳星昊通科技有限公司 www.hiastar.com
209
Africa/Dakar
Africa/Dar_es_Salaam
Africa/Djibouti
Africa/Douala
Africa/El_Aaiun
Africa/Freetown
Africa/Gaborone
Africa/Harare
Africa/Johannesburg
Africa/Juba
Africa/Kampala
Africa/Khartoum
Africa/Kigali
Africa/Kinshasa
Africa/Lagos
Africa/Libreville
Africa/Lome
Africa/Luanda
Africa/Lubumbashi
Africa/Lusaka
Africa/Malabo
Africa/Maputo
Africa/Maseru
Africa/Mbabane
Africa/Mogadishu
Africa/Monrovia
Africa/Nairobi
Africa/Ndjamena
Africa/Niamey
Africa/Nouakchott
Africa/Ouagadougou
Africa/Porto-Novo
Africa/Sao_Tome
Africa/Tripoli
Africa/Tunis
Africa/Windhoek
America/Adak
America/Anchorage
America/Anguilla
America/Antigua
America/Araguaina
America/Argentina/Buenos_Aires
America/Argentina/Catamarca
America/Argentina/Cordoba
深圳星昊通科技有限公司 www.hiastar.com
210
America/Argentina/Jujuy
America/Argentina/La_Rioja
America/Argentina/Mendoza
America/Argentina/Rio_Gallegos
America/Argentina/Salta
America/Argentina/San_Juan
America/Argentina/San_Luis
America/Argentina/Tucuman
America/Argentina/Ushuaia
America/Aruba
America/Asuncion
America/Atikokan
America/Bahia
America/Bahia_Banderas
America/Barbados
America/Belem
America/Belize
America/Blanc-Sablon
America/Boa_Vista
America/Bogota
America/Boise
America/Cambridge_Bay
America/Campo_Grande
America/Cancun
America/Caracas
America/Cayenne
America/Cayman
America/Chicago
America/Chihuahua
America/Costa_Rica
America/Creston
America/Cuiaba
America/Curacao
America/Danmarkshavn
America/Dawson
America/Dawson_Creek
America/Denver
America/Detroit
America/Dominica
America/Edmonton
America/Eirunepe
America/El_Salvador
America/Fortaleza
America/Glace_Bay
深圳星昊通科技有限公司 www.hiastar.com
211
America/Godthab
America/Goose_Bay
America/Grand_Turk
America/Grenada
America/Guadeloupe
America/Guatemala
America/Guayaquil
America/Guyana
America/Halifax
America/Havana
America/Hermosillo
America/Indiana/Indianapolis
America/Indiana/Knox
America/Indiana/Marengo
America/Indiana/Petersburg
America/Indiana/Tell_City
America/Indiana/Vevay
America/Indiana/Vincennes
America/Indiana/Winamac
America/Inuvik
America/Iqaluit
America/Jamaica
America/Juneau
America/Kentucky/Louisville
America/Kentucky/Monticello
America/Kralendijk
America/La_Paz
America/Lima
America/Los_Angeles
America/Lower_Princes
America/Maceio
America/Managua
America/Manaus
America/Marigot
America/Martinique
America/Matamoros
America/Mazatlan
America/Menominee
America/Merida
America/Metlakatla
America/Mexico_City
America/Miquelon
America/Moncton
America/Monterrey
深圳星昊通科技有限公司 www.hiastar.com
212
America/Montevideo
America/Montserrat
America/Nassau
America/New_York
America/Nipigon
America/Nome
America/Noronha
America/North_Dakota/Beulah
America/North_Dakota/Center
America/North_Dakota/New_Salem
America/Ojinaga
America/Panama
America/Pangnirtung
America/Paramaribo
America/Phoenix
America/Port-au-Prince
America/Port_of_Spain
America/Porto_Velho
America/Puerto_Rico
America/Rainy_River
America/Rankin_Inlet
America/Recife
America/Regina
America/Resolute
America/Rio_Branco
America/Santa_Isabel
America/Santarem
America/Santiago
America/Santo_Domingo
America/Sao_Paulo
America/Scoresbysund
America/Sitka
America/St_Barthelemy
America/St_Johns
America/St_Kitts
America/St_Lucia
America/St_Thomas
America/St_Vincent
America/Swift_Current
America/Tegucigalpa
America/Thule
America/Thunder_Bay
America/Tijuana
America/Toronto
深圳星昊通科技有限公司 www.hiastar.com
213
America/Tortola
America/Vancouver
America/Whitehorse
America/Winnipeg
America/Yakutat
America/Yellowknife
Antarctica/Casey
Antarctica/Davis
Antarctica/DumontDUrville
Antarctica/Macquarie
Antarctica/Mawson
Antarctica/McMurdo
Antarctica/Palmer
Antarctica/Rothera
Antarctica/Syowa
Antarctica/Troll
Antarctica/Vostok
Arctic/Longyearbyen
are
are
Asia/Aden
Asia/Almaty
Asia/Amman
Asia/Anadyr
Asia/Aqtau
Asia/Aqtobe
Asia/Ashgabat
Asia/Baghdad
Asia/Bahrain
Asia/Baku
Asia/Bangkok
Asia/Beirut
Asia/Bishkek
Asia/Brunei
Asia/Choibalsan
Asia/Chongqing
Asia/Colombo
Asia/Damascus
Asia/Dhaka
Asia/Dili
Asia/Dubai
Asia/Dushanbe
Asia/Gaza
Asia/Harbin
深圳星昊通科技有限公司 www.hiastar.com
214
Asia/Hebron
Asia/Ho_Chi_Minh
Asia/Hong_Kong
Asia/Hovd
Asia/Irkutsk
Asia/Jakarta
Asia/Jayapura
Asia/Jerusalem
Asia/Kabul
Asia/Kamchatka
Asia/Karachi
Asia/Kashgar
Asia/Kathmandu
Asia/Khandyga
Asia/Kolkata
Asia/Krasnoyarsk
Asia/Kuala_Lumpur
Asia/Kuching
Asia/Kuwait
Asia/Macau
Asia/Magadan
Asia/Makassar
Asia/Manila
Asia/Muscat
Asia/Nicosia
Asia/Novokuznetsk
Asia/Novosibirsk
Asia/Omsk
Asia/Oral
Asia/Phnom_Penh
Asia/Pontianak
Asia/Pyongyang
Asia/Qatar
Asia/Qyzylorda
Asia/Rangoon
Asia/Riyadh
Asia/Sakhalin
Asia/Samarkand
Asia/Seoul
Asia/Shanghai
Asia/Singapore
Asia/Taipei
Asia/Tashkent
Asia/Tbilisi
深圳星昊通科技有限公司 www.hiastar.com
215
Asia/Tehran
Asia/Thimphu
Asia/Tokyo
Asia/Ulaanbaatar
Asia/Urumqi
Asia/Ust-Nera
Asia/Vientiane
Asia/Vladivostok
Asia/Yakutsk
Asia/Yekaterinburg
Asia/Yerevan
Atlantic/Azores
Atlantic/Bermuda
Atlantic/Canary
Atlantic/Cape_Verde
Atlantic/Faroe
Atlantic/Madeira
Atlantic/Reykjavik
Atlantic/South_Georgia
Atlantic/Stanley
Atlantic/St_Helena
Australia/Adelaide
Australia/Brisbane
Australia/Broken_Hill
Australia/Currie
Australia/Darwin
Australia/Eucla
Australia/Hobart
Australia/Lindeman
Australia/Lord_Howe
Australia/Melbourne
Australia/Perth
Australia/Sydney
beginning
by
Comments;
data
+-DDMM+-DDDMM
Europe/Amsterdam
Europe/Andorra
Europe/Athens
Europe/Belgrade
Europe/Berlin
Europe/Bratislava
深圳星昊通科技有限公司 www.hiastar.com
216
Europe/Brussels
Europe/Bucharest
Europe/Budapest
Europe/Busingen
Europe/Chisinau
Europe/Copenhagen
Europe/Dublin
Europe/Gibraltar
Europe/Guernsey
Europe/Helsinki
Europe/Isle_of_Man
Europe/Istanbul
Europe/Jersey
Europe/Kaliningrad
Europe/Kiev
Europe/Lisbon
Europe/Ljubljana
Europe/London
Europe/Luxembourg
Europe/Madrid
Europe/Malta
Europe/Mariehamn
Europe/Minsk
Europe/Monaco
Europe/Moscow
Europe/Oslo
Europe/Paris
Europe/Podgorica
Europe/Prague
Europe/Riga
Europe/Rome
Europe/Samara
Europe/San_Marino
Europe/Sarajevo
Europe/Simferopol
Europe/Skopje
Europe/Sofia
Europe/Stockholm
Europe/Tallinn
Europe/Tirane
Europe/Uzhgorod
Europe/Vaduz
Europe/Vatican
Europe/Vienna
深圳星昊通科技有限公司 www.hiastar.com
217
Europe/Vilnius
Europe/Volgograd
Europe/Warsaw
Europe/Zagreb
Europe/Zaporozhye
Europe/Zurich
file
file
Indian/Antananarivo
Indian/Chagos
Indian/Christmas
Indian/Cocos
Indian/Comoro
Indian/Kerguelen
Indian/Mahe
Indian/Maldives
Indian/Mauritius
Indian/Mayotte
Indian/Reunion
intersection
ISO
ISO
latitude
Latitude
makes
multiple
Pacific/Apia
Pacific/Auckland
Pacific/Chatham
Pacific/Chuuk
Pacific/Easter
Pacific/Efate
Pacific/Enderbury
Pacific/Fakaofo
Pacific/Fiji
Pacific/Funafuti
Pacific/Galapagos
Pacific/Gambier
Pacific/Guadalcanal
Pacific/Guam
Pacific/Honolulu
Pacific/Johnston
Pacific/Kiritimati
Pacific/Kosrae
深圳星昊通科技有限公司 www.hiastar.com
218
Pacific/Kwajalein
Pacific/Majuro
Pacific/Marquesas
Pacific/Midway
Pacific/Nauru
Pacific/Niue
Pacific/Norfolk
Pacific/Noumea
Pacific/Pago_Pago
Pacific/Palau
Pacific/Pitcairn
Pacific/Pohnpei
Pacific/Port_Moresby
Pacific/Rarotonga
Pacific/Saipan
Pacific/Tahiti
Pacific/Tarawa
Pacific/Tongatapu
Pacific/Wake
Pacific/Wallis
Values
Values
时区支持的数值包括:
'filename' 语音文件名称 (语音文件必须是单引号)。
variable 变量值 (所支持的变量)
支持的变量 :
A or a Day of week (Saturday, Sunday, ...)
B or b or h Month name (January, February, ...)
d or e numeric day of month (first, second, ..., thirty-first)
Y Year
I or l Hour, 12 hour clock
H Hour, 24 hour clock (single digit hours preceded by "oh")
k Hour, 24 hour clock (single digit hours NOT preceded by "oh")
M Minute, with 00 pronounced as "o'clock"
N Minute, with 00 pronounced as "hundred" (US military time)
P or p AM or PM
深圳星昊通科技有限公司 www.hiastar.com
219
Q "today", "yesterday" or ABdY
q "" (for today), "yesterday", weekday, or ABdY
R 24 hour time, including minute
语音邮箱留言组用户使用指南
Overview
Logging in
Adding a VMBlast Group
o VMBlast Number
o Group Description
o Audio Label
o Optional Password
o Voicemail Box List
o Default VMBlast Group
o Save
总览
Voicemail Blasting 模块我们称之为语音留言组发管理模块。语音留言模块可以用来创
建一个组或者语音留言用户组，然后设定一个留言组号码。系统用户可以拨打留言组号码给指
定的用户留言。
Logging in
从菜单顶部点击 Applications
从下拉菜单中点击 Voicemail Blasting
深圳星昊通科技有限公司 www.hiastar.com
220
Adding a VMBlast Group
VMBlast Number
输入此留言组号码，用户拨打此号码可以访问 VMBlast 留言组发。这个号码不能和现有
系统号码冲突，必须是唯一的。
Group Description
添加 VMBlast 组描述。
深圳星昊通科技有限公司 www.hiastar.com
221
Audio Label
自动标识组号码设置。从现有系统中选择播放何种提示语音信息，这样，呼叫方可以清楚
呼叫方是否呼叫了正确的语音留言组号码。默认环境下系统会读取留言组的号码。在下面的实
例中，我们创建了一个系统录音文件，文件命名为 “Receptionists” 或公司总机，如果呼
叫方呼入以后，系统则可以对呼叫方播放此语音提示。
Optional Password
输入一个邮箱留言用户组密码保护语音留言。密码必须是数字。
Voicemail Box List
选择语音邮箱，添加到此留言组。使用键盘的 “CTRL” 键选择多个邮箱。
Default VMBlast Group
每个 PBX 系统有一个默认的 Voicemail Blast 留言组。系统用户可以通过分机模块添加
用户到语音留言组内。
Save
完成修改后，点击 Apply Config 按钮保存设置。
FreePBX 热备用户使用指南
Introduction
o This article assumes the following
Setup
o SSH Keys
o Creating Backup Job
o Failing over to backup server
▪ Network
Introduction
本文档指导用户如何对 FreePBX 进行备份。
注意：拟语音卡和数字语音卡。
每台服务器都有自己本身的软件许可证（如果购买力软件许可证的话）。
深圳星昊通科技有限公司 www.hiastar.com
222
本文假设用户已经满足了以下需求：
用户已经有一台正在运行的 PBX 作为主 PBX。.
用户已经有一台和主 PBX 同样型号的从 PBX 作为一个热备的 PBX。
两台服务器都有同样完全一样的模拟/数字语音卡（如果安装了的话）。
两台服务器服务器通过端口 22 可以互相正常通信。
Setup
SSH Keys
通过 SSH 端口 22 创建一个私钥，两台共享此私钥。
在热备的服务器端创建用户和私钥，用户可以登录主服务器。
通过 SSH 帐号登录到从服务器端，用户可以使用 SSH 或者其他的 SSH 工具，例如 PuTTy,
SecureCRT。
在提示符命令状态下，执行命令: sudo -u asterisk ssh-keygen
深圳星昊通科技有限公司 www.hiastar.com
223
注意：系统将对用户提出 3 个问题，摁 Enter 键配置默认设置环境：
现在用户可以拷贝系统生成的私钥到主服务器端，输入命令:
sudo -u asterisk ssh-copy-id
-i /home/asterisk/.ssh/id_rsa.pub root@PrimaryServerIP，然后输入密码。
注意：确保使用主服务器系统当前的 IP 地址替换实例中的 PrimaryServerIP
如果输入命令后，系统没有报告错误的话，表示我们可以开始测试：
然后输入命令: ssh -i /home/asterisk/.ssh/id_rsa root@PrimaryServerIP
如果一切正常，则表示我们已经登录到了主服务器。
深圳星昊通科技有限公司 www.hiastar.com
224
Creating Backup Job
现在，我们登录到热备的从服务器管理员界面：
通过从服务器 IP 地址，使用浏览器访问 http://IPADDRESS ，然后点击 PBX
Administration.
系统会弹出对话框要求用户输入用户名此和密码，点击继续进行。
深圳星昊通科技有限公司 www.hiastar.com
225
登录后:
点击 Admin
从下拉菜单中点击 Backup & Restore
用户可以看到以下截图:
点击右侧的 “Servers” 选项，出现以下配置界面：
深圳星昊通科技有限公司 www.hiastar.com
226
点击 "New SSH Server" 选项，用户可以创建一个连接信息，用来备份主服务器端的数据。
以下是主服务器端备份的必要信息，添加完成后，点击 “Save” 按钮：
Server Name- 主服务器名称，这里称为 “Primary PBX”。
Hostname- 设定主服务器的 IP 地址。
Port- 默认设置端口为 22。
User Name- root 帐号名称，我们创建共享私钥的用户名称。
Key- 私钥的保存路径，这里的路径是 /home/asterisk/.ssh/id_rsa。
点击保存按钮。
现在已创建了主服务器的备份，用户还要创建一个备份的执行的任务，点击 “Backups”
选项，出现以下截图：
点击 "New Backup" 按钮。
深圳星昊通科技有限公司 www.hiastar.com
227
深圳星昊通科技有限公司 www.hiastar.com
228
列表名称代表了所需备份的任务名称。用户可以创建一个 "Nightly Warm Backup"。
用户可以通过鼠标拖拉需要的备份任务，包括 "Full Backup" 和 "Exclude Backup
Settings"。
从 "Backup Server" 选项中选择我们的主服务器。
勾选 "Restore Here" 。
显示另外 2 个勾选框：
o "Disable registered trunks" ，如果 PBX 已经对接了运营商的 SIP 中继，或者
两台服务器的 SIP 中继需要对接运营商，SIP 中继对接注册时引起干扰冲突时，则
勾选此选项。
o 勾选 "Apply Configs" 选项。
如果用户要求在本地服务器保存备份文件的备份时，则选择 “Local Storage” 选
项。
设置 "Run Automatically" 为 "Daily" 模式时，系统会每天半夜执行一次脚本备份
任务。
完成配置好保存。
点击保存后，界面出现一个新的按钮，提示 "and Run"。用户可以点击这个按钮执行备
份任务。这个备份过程可能需要花费一定的时间。
Failing over to backup server
在一些环境下，当主服务器调整工作或者维护状态时，用户希望切换到备份服务器作为一
个生产服务器。为了满足以上的要求，用户需要执行几个配置。.
Network
首先，我们需要更新备份服务器的 IP 地址为主服务器的 IP 地址，这样的话，PBX 的系统
话机和中继才能知道如何找到服务器地址。
登录到从服务器的界面
点击菜单中的 Admin
从下拉菜单中点击 System Admin
深圳星昊通科技有限公司 www.hiastar.com
229
系统会出现以下配置：
点击 "Network Settings" 网络设置:
这里，用户可以修改从服务器的 IP 地址为主服务器的 IP 地址。
注意：当然不要忘记把主服务器从此网络中移除，或者修改到其他的 IP 地址，以避免内网地
址冲突的问题。
深圳星昊通科技有限公司 www.hiastar.com
230
Asterisk SIP 设置用户指南
Overview
Logging In
Settings
o Allow Anonymous inbound SIP Calls
o Local Networks
o RTP Settings
RTP Ranges
RTP Checksums
Strict RTP
o Codecs
Save
总览
在早期的 Asterisk 配置过程中，编辑 “/etc/asterisk/sip_nat.conf” 文件是非常有
必要的。 SIP 设置模块可以通过界面来配置 nat 设置。通过这个模块可以配置 External IP,
Local Network, 关闭或开启语音编码。
登录
从顶部菜单点击 Settings
然后从下拉菜单中点击 AsteriskSip Settings
NAT 设置
深圳星昊通科技有限公司 www.hiastar.com
231
Allow Anonymous inbound SIP Calls
允许通过未知的 IP 地址进行匿名呼入，转接到拨号规则中的 'from-pstn' 侧。这里通常
是电话呼入的入口。如果系统支持了 SIP URI 呼叫，并且呼叫用户的 PBX 或者使用了 ENUM
服务，那么这里则需要设置为 YES 来支持呼入的需求。这本身不是 Asterisk sip.conf 中的
NAT 设置功能，需要在拨号规则中配合 Default Context 来一起工作。如果以上 context 被修
改，整个自定义的流程可能被影响，并且 'Allow SIP Guests' 可能需要设置为 No。
Local Networks
内网设置格式为这样的格式 “ip/mask” 例如, “192.168.1.0/255.255.255.0”。如果
需要添加多个内网 IP 地址，可以点击 “Add Local Network” 添加。如果空白设置将被删除。
RTP Settings
RTP Ranges
设置 UDP RTP 的起始端口和结束端口。默认是 10000-20000。用户应该至少设置 4 个端口
来支持呼叫。
RTP Checksums
是否开启 UDP checksums 。
Strict RTP
丢弃不是来自 RTP 源的 RTP 语音包。通常是关闭状态。
Codecs
检查需要的语音编码和重新排列语音编码顺序。所有不需要的语音编码可以被关闭。注意，
一些语音编码需要商业许可证，例如 g729 语音编码。
深圳星昊通科技有限公司 www.hiastar.com
232
保存
点击提交保存。
呼叫录音设置探究
在 FreePBX 12 中，开发人员重写了呼叫录音模块，现在可以让我们更加容易了解录音模
块的设置。
在录音模块中，支持了以下 5 中录音选项:
Never
No
Don't Care
Yes
Force
'Never' 和 'Force' 覆盖“Yes”或“No”选项，并且比这两个选项具有更高的优先级。
Yes 和 No 具有同等的优先级，不会对已经设置的选项进行修改。但是 'Never' 和 'Force' 将
修改当前设置。
呼叫录音首先会被命名，并且系统启动录音。如果呼叫以同样的名称同时被录音，呼叫周
期需要停止或者重新启动。
一键设置是呼叫录音中智能设置的一个部分。意思是用户具有更多的控制权限。例如，如
果呼叫录音状态是 'Yes', 'No' 或 'Don't Care'，分机在需要执行录音命令时，分机可以停
深圳星昊通科技有限公司 www.hiastar.com
233
止或者启动录音时。如果这个呼叫设置在 'Never' 或 'Force'状态时，除非用户具有覆盖前
设置的权限，否则用户不能停止或者开启录音。
重要提示！当通过外呼录音启动录音时，录音服务不能绑定这个呼叫，只能绑定到启动录音
的分机 (这是 Asterisk 本身的局限，Asterisk 13 版本已经解决这个问题)。这个局限的意思
是，如果用户转接呼叫时，录音将停止。所以用户必须确认用户转接通话的目的地也要同时设
置录音方式为 Yes 或者 Force，这样系统会重新启动录音。
呼叫录音文件的命名格式为 type-destination-source-datestamp-timestamp-uniqueid
为了更好地了解这五个选项的逻辑，用户可以这样理解这些选项：可以把 NO，看作：除
非上游流程告诉我，否则我不会录音。可以把 YES，看作：我将录音，除非上游流程明确告诉
我不录音。Force'或 'Never" 意思是现在启动或者重启录音或者停止录音。类似于会议会
议的，如果是单次录音的话，则可以简单设置成 YES 或者 NO。
让我们更加详细地了解这个呼叫录音的流程:
呼叫通过呼入路由设置进入系统，呼入路由设置录音为 'Yes'.
系统生成录音文件，开始录音。.
呼入路由把这个呼叫路由到队列中。队列录音已经设置为 'Don't Care'.
这里没有任何修改，也不做任何修改。
队列中的接线员应答了此呼叫，接线员终端录音设置中的 'Inbound External Calls'
设置是 'No'
此时呼叫录音不会暂停。No 和 Yes 具有同等的优先级，我们已经通知系统通过这个呼
入路由进入到通话进行录音。.
接线员如果拨打 *1
呼叫录音暂停。
接线员转接从通话到一个振铃组，这个振铃组设置了呼叫录音为 'Force'.
呼叫录音重新开始
振铃组队任何一位接线员应答了此通话，此时接线员的录音设置为 'Never'.
呼叫录音则暂停。
接线员拨打 *1
呼叫录音不会启动，因为录音设置已经被设置为 Never
深圳星昊通科技有限公司 www.hiastar.com
234
呼叫录音模块使用指南
Overview
Logging In
Add Call Recording
o Description
o Call Recording Mode
Allow
Record on Answer
Record Immediately
o Destination
Submit Changes
Module Level Recording
o Extension Level
Inbound External Calls
Outbound External Calls
Inbound Internal Calls
Outbound Internal Calls
On Demand Recording
Record Priority Policy
Options
Always
Don’t Care
Never
o Queue Level
Call Recording
Recording Mode
o Inbound Routes
Call Recording
Allow
Record on Answer
Record Immediately
Never
Permissions and Conflicts
o Inbound Route
o Queues
o Extensions
深圳星昊通科技有限公司 www.hiastar.com
235
总览
呼叫录音模块支持系统对呼叫进行强制录音或根据呼叫流程对呼叫不进行录音。如果通话
被录音，它可以快速启动。这个功能可以在配合公告，语音等待等等功能前执行。此功能也可
以在呼叫应答以后开始执行。在 FreePBX 的很多模块可以直接控制呼叫录音，例如队列，呼入
路由，振铃组，分机模块等等。这个模块设计的目的是支持用户在呼叫没有到达最终目的地前
的设置例如广播组或者自定义的 IVR，系统强制开始录音。
登录
在顶部菜单，点击 Applications
在下拉菜单中点击 Call Recording
添加呼叫录音
呼叫录音模块支持系统对呼叫进行强制录音或根据呼叫流程对呼叫不进行录音。如果通话
被录音，它可以快速启动。这个功能可以在配合公告，语音等待等等功能前执行。
Description
给出一个呼叫录音的描述名称，例如 "Support IVR Recording.”
深圳星昊通科技有限公司 www.hiastar.com
236
Call Recording Mode
控制或覆盖呼叫录音流程指令。
Allow
按照正常下游录音模式工作
Record on Answer
呼叫发起后正常录音，否则忽略其他的设置进行录音。
Record Immediately
当检测到振铃以后开始录音，公告，音乐等待，等等从来不会被录音，无论下游流程如何
设置。
Destination
选择一个目的地进行录音。例如，启动录音后，我们会对支持 IVR 组队呼叫进行录音。
Submit Changes
点击提交后，这个应用设置将会生效。
模块级别录音
就像我刚才介绍的那样，用户同样可以直接对一些模块来进行录音:
分机
队列
呼入路由
Extension Level
在每个分机设置中，用户可以对分机进行录音配置
深圳星昊通科技有限公司 www.hiastar.com
237
Inbound External Calls
对从外部资源进入到呼入呼叫进行录音.
Outbound External Calls
对到外部资源的呼叫进行录音.
Inbound Internal Calls
对系统内部分机接收到呼叫进行录音.
Outbound Internal Calls
对系统内部发起的呼叫进行录音.
On Demand Recording
开启或关闭按需录音。如果一旦呼叫已经开始，那录音就不会停止。请参考 “Feature
Codes” 了解如何启动录音。默认的功能代码为 *1.
Record Priority Policy
当系统录音有一个冲突时，一个分机需要录音，另外一个分机不要录音时，录音策略优先
级会影响到其他的分机。会关系到全局的呼叫策略。
Options
Always
总是录音
深圳星昊通科技有限公司 www.hiastar.com
238
Don’t Care
如果另外一个用户对你进行呼叫，并且需要录音时，本端则允许录音。
Never
对呼叫从不录音。“Never” 设置的优先级将高于对端用户的 “Always” 设置。
Queue Level
用户可以对每个队列进行录音测试设置。非常重要的一点是这里的录音测试设置会覆盖单
个的用户分机的录音设置。每个队列中，在“General Options”，用户将看到一下设置.
Call Recording
现在一个录音格式。(录音文件保存在 /var/spool/asterisk/monitor 路径下) 。我们推
荐的录音格式是 wav.格式
Recording Mode
在录音时，选择 “Include Hold Time” 后，只要呼叫进入到队列中或延迟录音直到
“After Answered.” 这个呼叫会桥接到一个队列号码。.
Inbound Routes
对每一个呼入路由的呼叫进行录音。
Call Recording
对进入此 DID 的呼叫进行控制或覆盖其设置。
深圳星昊通科技有限公司 www.hiastar.com
239
Allow
支持正常的下游呼叫流程的录音设置。
Record on Answer
发起呼叫后开始录音，否则忽略任何录音设置。
Record Immediately
启动录音会捕捉振铃音，公告和音乐等待等语音。
Never
无论下游呼叫流程的录音如何设置，就不在支持录音。如果我们在呼入路由中设置为
“Disallow” ，开始录音的话，在任何级别的录音都不在工作，例如登录，分机等等。
Permissions and Conflicts
就像我们看到的一样，用户可以有很多方法来控制呼叫录音。当然最重要的是用户必须了
解哪一个呼叫需要录音或不录音。一个通话的权限的层次如下:
Inbound Route
呼入录音具有最高权限。如果一个路由的录音设置为 “Never Allow Call Recording,”
任何下游其他的录音设置都不会对呼叫进行录音。
Queues
如果队列的录音设置为 “Record the Call,” 任何分机的呼叫录音设置被忽略，如果
登录设置为 “Never Record,” 分机将不在对此分机的通话进行录音。.
Extensions
分机录音设置是最低权限设置。只要一些流程还没有设置“Call Recording On” 或者
“Never Allow Call Recordings”.。呼叫经过以上流程，到达分机时，分机会启动呼叫录音。
深圳星昊通科技有限公司 www.hiastar.com
240
回拨模块使用指南
Overview
Logging in
Creating a Callback
o Callback Description
o Callback Number
o Delay Before Callback
o Destination after Callback
o Save
总览
呼叫方呼叫系统时，回拨模块将对呼叫方挂机，然后系统再次对呼叫方发起呼叫，把接通
的通话转到相应的目的地。在一些运营商的环境中，有的环境中，有被叫方付费的情况，运营
商可能对被叫方也收取服务费。在这种情况下，回拨模块的使用就会降低被叫方的服务费用。
如果回拨以后，手机用户可能就不需要对接听付费，同样的道理，回拨也可以使用在 PBX 的其
他应用场景，来降低呼叫费用。通常情况下，回拨呼入以后，系统会转入一个 IVR 或者一个
呼入路由环境中。
登录
从顶部菜单点击 Applications
在下拉菜单中点击 Callback
创建一个回拨
深圳星昊通科技有限公司 www.hiastar.com
241
Callback Description
指定一个回拨的名称。这里我们可以称之为“International,” 如果呼叫方通过国际电
话呼叫我们的话，国际用户可以在我们的 IVR 中按选项 4，系统会在晚一点时间回拨到这个用
户的电话上，这样可以节省用户的国际通话费用，系统本地对此通话付费。
Callback Number
用户可以选择输入一个固定的号码，此号码就是未来回拨的号码。如果为空，系统会呼叫
呼叫方呼入时携带的号码。通常情况下是为空的。.
Delay Before Callback
用户可以设置一个延迟时间，以秒为单位。回拨延迟时间定义一个时间段，大约多久以后
回拨到呼叫方。如果为空，则为默认的 “No Delay” 。没有延迟时间。
Destination after Callback
这里设置一个路由的方式，一旦回拨以后，此呼叫将路由到我们需要的路由流程中。呼叫
以后，系统会自动把此呼叫路由到一个流程逻辑中，例如根据时间条件设定的流程或者其他的
流程中。
Save
保存修改的设置，点击 Apply Config
CallerID 查询源模块使用指南
Overview
Logging In
Creating a Caller ID Lookup Source
o Source Description
o Source Type
OpenCnam
Use Professional Tier
Account SID
Auth Token
Internal
ENUM
HTTP
深圳星昊通科技有限公司 www.hiastar.com
242
Host
Port
Username
Password
Path
Query
HTTPS
Host
Port
Username
Password
Path
Query
MySQL
Host
Database
Query
Username
Password
Character Set
SugarCRM
Superfecta
o Hooking Inbound Routes to Lookups
总览
呼叫方查询源模块指定呼入的 callerid 名称。用户可以关联一个呼入路由到一个指定的
CID 源。用户同样可以安装电话薄模块关联用户名称。
使用注意：因为关联了文本文件或者数据库查询，所以名称查询可能降低 PBX 的运行速度。
登录
在顶部菜单点击 Admin
在下拉菜单中点击 CallerID Lookup Sources
深圳星昊通科技有限公司 www.hiastar.com
243
创建一个 Caller ID Lookup Source
Source Description
源描述
Source Type
OpenCnam
使用 OpenCNAM [https://www.opencnam.com/]
Use Professional Tier
如果用户要求每个小时超过 60 多个查询的话，用户需要注册 professional tier 服务，
当用户勾选了这个服务以后，这个服务提供关联的相关信息。
Account SID
注册时的帐号信息
Auth Token
注册时的签权信息
深圳星昊通科技有限公司 www.hiastar.com
244
Internal
使用 astdb 作为查询源，使用电话薄模块来匹配
ENUM
使用 DNS 查询呼叫方名称，在 enum.conf 配置以后，可以使用 ENUM 查询区
HTTP
支持通过 HTTP GET 方式，通过呼叫号码来获取正确的名称。
Host
主机名或者查询源的 IP 地址。
Port
查询源的端口号，默认是 80
Username
用户名称用于 HTTP 认证
Password
密码
深圳星昊通科技有限公司 www.hiastar.com
245
Path
GET 文件路径 GET ，例如 : MyLookup.php
Query
查询语句， [NUMBER] 替换成呼叫方号码，例如: number=[NUMBER]&src=customers
HTTPS
通过 HTTPS 的 GET 方式，发送呼叫方号码，获取正确的名称。
Host
主机名或者查询源 IP 地址。
Port
端口，默认是 443
Username
用户名称
Password
密码
Path
执行 GET 的代码路径，例如 : MyLookup.php
Query
查询语句， [NUMBER] 替换成呼叫方号码，例如: number=[NUMBER]&src=customers
MySQL
通过 MySQL 数据库获取呼叫方名称
深圳星昊通科技有限公司 www.hiastar.com
246
Host
主机名或者数据库 IP
Database
数据库名称
Query
查询语句， [NUMBER] 替换为呼叫方号码。例如: SELECT name FROM phonebook WHERE
number LIKE '%[NUMBER]%'
Username
MySQL 用户名称
Password
MySQL 密码
Character Set
MySQL 支持字符设置，为空则为默认 latin1
SugarCRM
不支持
深圳星昊通科技有限公司 www.hiastar.com
247
Superfecta
不支持
Hooking Inbound Routes to Lookups
我们将进入呼入路由，在 Cid Lookup Source 部分，通知它使用我们的查询源。任何时
间，电话接入这个呼入路由，系统将通过呼叫号码来匹配查询源。如果匹配成功，系统会通过
数据库查询的名字替换 CallerID 名称。
在菜单顶部点击 Connectivity
在下拉菜单中点击 Inbound Routes
当创建或者编辑这个选项时，我们会看到如下截图
用户可以从下拉选项中选择自己的源。不要忘记按 "Submit" 按钮和重新点击顶部的
"apply changes" 。
Camp-On 回拨服务模块使用指南
总览
这个模块支持了运营商的电话业务回拨服务，通常称之为 Call Camping 或者 Camp-On。
这个功能可以支持呼叫方如果呼入以后，分机忙活着没有相应的分机应答呼叫方呼叫时，要求
系统回拨到呼叫方电话。这个版本要求 Asterisk-1.8 以上版本。.
Settings
在用户级别的 Advanced Settings 配置中设置.
Extension
分机设置中可以看到类似的设置.
深圳星昊通科技有限公司 www.hiastar.com
248
在菜单顶部，点击 Connectivity
在下拉菜单中，点击 Extensions
点击相应的分机，创建新分机
Forcing default settings
这个设置告诉用户不会对用户级别进行独立设置。所有用户使用在 advanced settings 里
面的全局设置。
Caller Policy
Asterisk: cc_agent_policy. 用来开启 Camp-On 对此用户的支持，并且设置相关的通道
信令消息。大部分情况下，用户应该选择 'Generic Device' ，除非用户了解通道分机相应指
定的通信接口，例如 ISDN（2B+D）或者其他的非 FreePBX 标准支持的接口。
Callee Policy
Asterisk: cc_monitor_policy 用来控制是否允许其他分机对此分机启用 Camp On 模块。
如果这样的话，可以设置通信模式来监控分机的有效状态。如果无可支持的通信模式，应该使
用’Generic Device'。在这种模式下，当此分机状态才 InUSe 状态恢复到 NotUse 状态时，
系统将对此分机发起一个回拨呼叫。当第一次尝试呼叫时，此时分机状态在忙音状态，当前呼
叫被停止。如果分机仅是无应答，下一次这个分机将应答或者发起一个呼叫，然后挂机。如果
没有对其设置时，并且支持了默认系统通信接口的话，用户也可能利用 'Native Technology
Support' 来自动回退到 'Generic Mode' 设置状态。
深圳星昊通科技有限公司 www.hiastar.com
249
Advance Settings
Maximum Active Camp-On Requests
系统本身可以也支持最大 Camp-On 请求。但是这样设置有一个限制，系统可能有内存的限
制，因为系统内部的状态机可能会消耗很多资源来管理跟踪这些任务。修改后重新启动
asterisk 使之生效。
Non Extensions Callee Policy
如果设置此选项为 'generic' 或者 'always' ，当呼叫一个无分机目的地例如振铃组，
或者其他的目的地，系统可能会尝试呼叫完成请求。设置了此功能，系统会跳过任何 Callee
Policies 并且可能导致一个不同步到呼叫结果。大部分环境下，设置为'generic'，'always'
将使用被呼叫分机支持的通信接口。
Only Use Default Camp-On Settings
用户可以强制所有系统的分机使用这个默认的 Camp-On 设置。当设置完成后，其他单个分
机设置页面将不在显示此功能设置。如果用户对某些分机进行了特定设置，配置数据将一直保
留，但是不能被启用，除非用户切换到 false 状态。通过这样的设置，Caller Policy
(cc_agent_policy) 和 Callee Policy (cc_monitor_policy) 将支持对每个用户实现可配置，
用户仍然可以通过分机对每个用户的 Camp 实现管理。
深圳星昊通科技有限公司 www.hiastar.com
250
Caller Policy Default
Asterisk: cc_agent_policy。用来实现对一个用户开启 Camp-On 并且设置 Technology
模式开关。大部分情况下，用户应该选择 'generic' ，除非用户电话分机支持一些特别的信
令技术，例如数字电话，H323 或者其他类型。
Callee Policy Default
Asterisk: cc_monitor_policy。支持对其他分机是否支持 Camp On 。如果这设置的话，
系统设置为 technology mode 的话，可以检测分机的可用性。如果没有特别指定通信接口支
持的话，应该设置为 'generic'。在这个模式下，当分机状态从 InUse 修改到 NotInUser 时，
系统将对此分机发起一个回拨。
Caller Timeout to Request Default
Asterisk: cc_offer_timer。默认发起呼叫后的时长。
Max Camp-On Life Busy Default
Asteirsk: ccbs_available_timer. 呼叫完成请求时长。
Max Camp-On Life No Answer Default
Asteirsk: ccnr_available_timer. 呼叫无应答时，最大 Camp-On 的存活时间。.
Default Time to Ring Back Caller
Asterisk: cc_recall_timer. 当呼叫方的 Caller Policy 设置为“Generic Device”时
的回拨时间。
Default Caller Callback Mode
Affects Asterisk: cc_agent_dialstring. 默认回拨模式。
Default Max Camped-On Extensions
Asterisk: cc_max_agents. 仅对呼叫方使用'native' 通信接口时有效。这个 Call Camp
请求可以附加到不同的分机。当使用'generic' 设备模式时，用户仅有一个请求，其他的将被
忽略。
深圳星昊通科技有限公司 www.hiastar.com
251
Default Callback Alert-Info
一个可选告警设置支持发起一个回拨。仅对'Caller Policy' 设置为 'generic' device'
有效。
Default Callback CID Prepend
回拨预设号码。仅对 'Caller Policy' 设置为 'generic' 设备有效。
Announce the Callee Extension
设置为 true 时，系统在对呼叫目的地号码振铃前播报应答呼叫的呼叫目的地号码。如果
为 false 时，则直接对分机振铃。CID 信息仍然反映出呼叫来源号码。
Default Callee Alert-Info
可选告警信息设置对被回拨的号码发送信息。
Default Callee CID Prepend
可选 CID 预设 CID 回拨设置。
Default Max Queued Callers
Asterisk: cc_max_monitors。用来支持对分机 Camp 请求的队列中最多呼叫方数量设置。
BLF Camp-On Available State 对 Camp-On 设置 BLF 订阅状态。
BLF Camp-On Pending State
对 Camp-On 设置的订阅状态，支持附加一个回拨的 Camp-On 请求。
BLF Camp-On Busy Caller State
支持 Camp-On 模块订阅状态，当被呼叫方有效时，呼叫方不在忙状态情况下，发送订阅信
息。
Default Callback Alert-Info
默认回拨可选告警设置。仅当'Caller Policy' 设置为 'generic' device'有效。不提供
默认设置，此值可以为空。
深圳星昊通科技有限公司 www.hiastar.com
252
Default Callback CID Prepend
对回拨设置默认的回拨 CID 预设号码。仅当 'Caller Policy' 设置为 'generic' device'
模式时有效。无默认设置，值可以为空。
Announce the Callee Extension
设置为 true 时，系统在对呼叫目的地号码振铃前播报应答呼叫的呼叫目的地号码。如果
为 false 时，则直接对分机振铃。CID 信息仍然反映出呼叫来源号码。
Default Callee Alert-Info
对被呼叫方发送默认告警信息。
Default Callee CID Prepend
对回拨分机发送 CID 预设信息。
Default Max Queued Callers
Asterisk: cc_max_monitors. 用来支持对分机 Camp 请求的队列中最多呼叫方数量设置。
创建新用户
Creating a new User
UCP- FreePBX 12 or newer
XMPP
Rest API
iSymphony and XactView
创建一个新用户
·点击用户管理模块，会出现以下截图：
深圳星昊通科技有限公司 www.hiastar.com
253
·点击右栏的任何一个用户编辑用户信息，或者点击添加 "Add New User" 添加新用户。
·对每个用户有以下的定义参数
·Login Name- 登录用户名称，使用外部用户控制界面登录系统，例如 User 版本 12 中
的 Control Panel in Version 12, iSymphony/XactView Version 3, XMPP Chat User .
·Description- 提供一个用户描述。.
·Password- 提供登录密码。
·First Name thru Home Phone Number- 可选选项，可用于其他应用模块来存储用户信
息。
·Default Assigned Extension- 默认指定的分机，可以作为 API 模块调用。一个单个
分机仅仅属于默认的一个分机帐号。如果使用 API 模块或者 Rest API模块的话，这些用
户将和模块相关联。
·Additional Assigned Extensions- 其他指定分机，用户可以使用这个选项关联用户
管理模块，例如版本 12 中的 User Control Panel，iSymphony/XactView 版本管理用
户语音邮箱，或者分机随行设置。
深圳星昊通科技有限公司 www.hiastar.com
254
UCP- 用户管理模板
UCP 是 FreePBX 12 中一个新的 User Control Panel，它替代了以前旧的 ARI 模块。
以下是对用户 UCP 的设置截图。
Enabled- 选择是或否，用来设置用户权限，是否允许用户登录 UCP 模块
Allowed Settings 支持对用户功能进行高级设置，例如可以修改用户的，分机随行，
呼叫前转，呼叫等待，免打扰。
深圳星昊通科技有限公司 www.hiastar.com
255
Allowed Voicemail- 支持查看用户分机的语音邮箱。
SIPStation SMS DIDs- 如果使用 SIPStation 商业模块，任何可以支持短信服
务的 DIDs 可以关联一个或者多个 UCP 用户，UCP 可以显示关联的 DID 短信接收信息。
Allowed Conference Rooms- 支持对会议室的查看和管理。
深圳星昊通科技有限公司 www.hiastar.com
256
XMPP
·Enabled- 如果开启这个模块，用户已经安装了 XMPP module 模块，激活了许可证
的话，如果设置为 yes，系统将会支持用户名称和密码登录，允许登录服务器。
Rest API
如果已经安装了 Rest API 模块，并且开启了许可权限，可以对用户开启这个
API，使用令牌对 API 进行安全认证。
o Token- 此用户的 Rest 令牌 ID。
o Token Key- 此用户的 Rest 令牌 Key ID 。
o Status- 对此用户开启或者关闭令牌。
o Users- 关联的用户。默认环境下，设置为所有用户。如果分机在"Additional
Assigned Extensions" 部分做了设置，则对 ALL 用户列表进行限定。
o Modules- 默认环境下对所有用户，代表 Rest 用户可以有权访问所有在用户模
块中支持的模块。
o Rate Limit- 每小时 Rest 用户对令牌请求的验证次数。
注意：如果在设备上使用 Rest Phone Apps，设备分机将匹配 "Default Assigned Extension" ，并
且访问这个 app 所支持的模块。例如，如果分机 4001 是一个 app 程序，如果实现呼叫前转时，当用
户摁电话界面的呼叫前转按键时，这个分机将需要访问 Rest App ，通过 4001 帐号的 Default
Assigned Extension 来判断呼叫前转是否开启，否则呼叫前转失败。
深圳星昊通科技有限公司 www.hiastar.com
257
iSymphony 和 XactView 用户
如果用户使用了 iSymphony或者 XactView V3 ，可以通过设置开启这个访问接口。
注意：当创建一个新的 PBX 用户时，可以创建一个用户支持模块访问。
默认环境下，用户可以通过分机号码和密码登录。
深圳星昊通科技有限公司 www.hiastar.com
258
自定义分机用户使用指南
Overview
o Logging In
o Creating a Custom Extension
Custom Extension
Description
Notes
o Save
Overview
自定义分机模块提供一个灵活的注册机制，支持在自定义的脚本或者拨号规则中使用
自定义的热键代码。这样的话，自定义的分机不会和目前标准的 PBX 分机发生冲突。
Logging In
从菜单顶部点击 Admin
从下拉菜单中点击 Custom Extensions
Creating a Custom Extension
添加自定义分机的以下参数
深圳星昊通科技有限公司 www.hiastar.com
259
Custom Extension
定义一个自定义的分机号码，确认 PBX 中支持这个特别的号码。这个号码只能使用在
某个功能，不会在其他功能中使用这个号码。
Description
分机描述。
Notes
自定义分机的特别标志.
Save
完成以后，保存。不要忘记点击 "submit changes" 和红色进度条 "apply changes"。
DISA 模块用户使用指南
Overview
Logging In
Adding a DISA
o DISA Name
o PIN
o Response Timeout
o Digit Timeout
o Caller ID
o Context
o Allow Hangup
o Submit
总览
DISA 用来支持用户从 PBX 外部呼叫 PBX，然后通过 PBX 呼出到相应的用户或者呼叫目的
地号码。这样呼叫的方式让呼叫接收方感觉到是从呼叫方的 PBX 呼出，看起来好像是对端办公
室电话号码。通常情况下，用户在出差刚才中可以使用这种方法拨打用户客户号码。系统可以
支持设置一个 IVR 来路由到 IVR 或者设置一个 DID 号码。为了系统的安全，这样的呼叫方式
必须使用密码保护，允许用户通过输入密码进行呼出流程。
深圳星昊通科技有限公司 www.hiastar.com
260
安全事项：请注意，这样的呼叫方式看起来类似于员工坐在办公室打外呼电话。对外部世界来
说，虽然我们设置了一些安全设置来保护系统的安全，还是有一定的风险，不能轻易对任何用
户支持类似的功能设置，需要一定的风险管理，以免出现盗打。
Logging In
从菜单顶部点击 Applications
从下拉菜单中点击 DISA
Adding a DISA
DISA Name
设置一个 DISA 名称。
PIN
系统提示用户输入的密码。如果需要设置多个密码时，请使用逗号分开多个密码。
安全提示：尽管这不是一个必须要求的设置，但是最好还是名称都这样设置。
Response Timeout
最大等待时长。用户在拨打了无效目的地或者无效号码后等待挂机的时间。默认是 10 秒。
Digit Timeout
最大允许的数字按键之间输入时长。默认是 5 秒。
深圳星昊通科技有限公司 www.hiastar.com
261
Caller ID
此设置为可选设置。当使用 DISA 时，用户的 caller ID 将被设置为这个 caller ID。
Context
如果用户比较了解 context 的话，可以修改这个设置。设置了这个选项，系统将从这里发
起呼叫。除非用户知道现在修改的结果，否则保留为 “from-internal” 。
Allow Hangup
支持对当前呼叫挂机，用户按 hangup 功能热键“**”时，生成拨号音。
Submit
完成所有选项填写后，点击 Submit 保存设置。
开启 CDR 记录的 CSV 文件格式
开启 CDR CSV Logging
为了支持对 CDR CSV 写入 /var/log/asterisk/cdr-csv/Master.csv ，必须在文件
/etc/asterisk/cdr.conf 中添加
[general]
enable=yes
loggingsafeshutdown=yes
[csv]
usegmtime=yes
loguniqueid=yes
loguserfield=yes
如何编辑分机
Overview
Logging in
Editing
Deleting
深圳星昊通科技有限公司 www.hiastar.com
262
总览
系统创建的所有分机会显示在导航菜单的右侧。用户只要点击需要编辑的分机则可以对此
分机进行编辑。
登录
从菜单顶部，点击 Applications
从下拉菜单中点击 Extensions
编辑分机
点击右侧栏相应的分机号码。.
做相应的分机修改，点击 Save 和 Apply Change。
查看参数详情，点击分机类型。
删除分机
深圳星昊通科技有限公司 www.hiastar.com
263
从右侧栏点击相应的分机。
点击 Delete Extension 链接
分机模块 - IAX2 分机
Overview
Logging in
Adding a IAX2 Extension
o Extension Number
o Display Name
o CID Num Alias
o Sip Alias
Extension Options
o Outbound CID
o Ring Time
o Call Forward Ring Time
o Outbound Concurrency Limit
o Call Waiting
o Internal Auto Answer
o Call Screening
o Pinless Dialling
o Emergency CID
o Queue State Detection
Device Options
o Secret
o Parking Lot
Optional Destinations
o No Answer
o Busy
o Not Reachable
o CID Prefix
总览
此模块指导用户如何配置 IAX2 分机。
Logging in
从菜单顶部点击 Applications
从下拉菜单中点击 Extensions
深圳星昊通科技有限公司 www.hiastar.com
264
Adding a IAX2 Extension
从分机加载选项中点击 Device 选择
选择 Generic CHAN IAX2 Device
点击 Submit
系统会出现一个分机界面
Extension Number
分机号码关联用户本身，一旦创建以后，不能被修改。我们的实例中，我们设置了分机为
“5000”。我们建议使用 3 或者 4 位的数字号码。
Display Name
这个名称关联分机，可以被修改。这个名称将成为 Caller ID Name。
CID Num Alias
CID Number 作为内部呼叫使用，可和分机号码区分。这个号码可以伪装为其他的用户。
我们经常使用的例子是技术支持部门的电话系统，希望内部号码显示技术支持部门的号码（例
如在振铃组或者队列中）。对外部呼叫没有任何影响。
深圳星昊通科技有限公司 www.hiastar.com
265
Sip Alias
如果想支持 SIP 内部的直接拨号或者支持“匿名”SIP 呼叫，用户可以设置一个易记的名
称，其他用户可以通过这个号码老呼叫此用户分机。
Extension Options
Outbound CID
这里对此分机设置一个 caller ID 。如果为空，则系统使用系统路由或者中继的 caller
ID。如果呼出路由和中继设置支持了这个选项，用户可以在这里设置呼出的 caller ID。
Ring Time
在呼叫进入无应答目的地前，电话的振铃时长，以秒为单位。默认振铃时长在基本设置模
块中设置。
Call Forward Ring Time
在呼叫进入无应答呼叫目的地前，对此分机的呼叫前转的振铃时长。如果设置为
“Always”，系统将一直对呼叫前转振铃，不会进入到无应答目的地流程。
深圳星昊通科技有限公司 www.hiastar.com
266
Outbound Concurrency Limit
对此分机呼出并发数量的限制。我们通常建议设置为 3-4。用户可以设置为“No Limit” ，
则对呼出并发无限制。
Call Waiting
如果呼叫等待没有开启，此分机在通话状态时，如果有第二个呼入时，则对呼叫方返回忙
状态。
Internal Auto Answer
如果设置为 answer 状态，任何时候其他分机都可以呼叫此分机。
Call Screening
此功能要求呼叫方在呼叫此分机时播报他们的名称。用户可以从无记忆状态或者记忆状态
下选择此功能。如果是建议状态时，系统将要求呼叫方输入名称，保存此名称，然后绑定到相
应的呼叫方的 Caller ID。任何时间，有人从此 Caller ID 发起呼叫时，系统将不再要求播
报此呼叫的名称，将播放录制的语音文件。
Pinless Dialling
如果对呼出路由设置了密码保护，此分机呼出时将不再要求输入密码。用户也可以对基于
每个路由的呼叫开启此功能。
Emergency CID
如果用户设置了紧急呼叫的呼出路由，用户可以通过此设置来设置 caller ID，这个
caller ID 将发生到被呼叫方。这个功能非常实用，如果电话是在远端时，或者不同的地方，
用户可以在系统中设置相应的远端号码，并且能够路由到相应的 911 紧急呼叫服务。
Queue State Detection
如果此分机是队列中的一位成员，队列将尝试检测用户分机状态和设备状态来决定队列呼
叫是否接通此分机。在一些特别环境下，例如，我们使用了分机随行功能，但是实际上并没有
一个物理终端电话或者虚拟分机时，状态信息将显示此成员无效，实际上此分机是存在的。设
置为 “Ignore State” 后，队列将忽略此分机的状态，如果有呼叫的情况下，队列将转发呼
深圳星昊通科技有限公司 www.hiastar.com
267
叫到此分机。还有一些影响也来自于队列本身对本地通道的管理。例如，后续转接将继续显示
成员状态为忙，直到原始呼叫被挂机。在大部分情况下，这个参数应该设置为 “Use State”。
Device Options
设备选项设置部分是相关于大部分设备的选项，一般情况下不要修改其设置。我们这里讨
论的是需要修改设置时的情况。
Secret
注册密码，至少包含两个字母和两个数字。当系统创建新的 SIP 分机时，FreePBX 将自动
生成一个密码。
设备电话驻留。
Optional Destinations
如果分机无效时，语音邮箱开启后，呼叫将被发送到语音邮箱。用户也可以不使用语音邮
箱，设置以下其他选项作为一个可选设置目的地来控制呼叫的最终目的地。
No Answer
呼叫无应答时，发送呼叫方呼叫到此设置。
Busy
如果呼叫方呼叫，被呼叫方在忙状态时，呼叫方被拒绝后，发送呼叫方呼叫到此设置。
Not Reachable
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。
CID Prefix
在发送此呼叫到目的地之前，对 Caller ID 添加一个前缀号码。
深圳星昊通科技有限公司 www.hiastar.com
268
分机模块 – 其他自定义分机
Overview
Logging in
Adding a DAHDI Extension
o Extension Number
o Display Name
o CID Num Alias
o Sip Alias
Extension Options
o Outbound CID
o Ring Time
o Call Forward Ring Time
o Outbound Concurrency Limit
o Call Waiting
o Internal Auto Answer
o Call Screening
o Pinless Dialling
o Emergency CID
o Queue State Detection
Device Options
o Dial
Optional Destinations
o No Answer
o Busy
o Not Reachable
o CID Prefix
总览
这个模块指导用户如何设置一个自定义分机
Logging in
从菜单顶部点击 Applications
从下拉菜单中点击 Extensions
深圳星昊通科技有限公司 www.hiastar.com
269
Adding a DAHDI Extension
从分机选项中选择一个 Device 选择框.
选择 Generic CHAN DAHDI Device
点击 Submit
用户将看到以下界面
Extension Number
分机号码关联用户本身，一旦创建以后，不能被修改。在实例中，我们设置了分机为
“5000”。我们建议使用 3 或者 4 位的数字号码。
Display Name
这个名称关联分机，可以被修改。这个名称将成为 Caller ID Name。
CID Num Alias
CID Number 别名作为内部呼叫使用，可和分机号码区分。这个号码可以伪装为其他的用
户。我们经常使用的例子是技术支持部门的电话系统，希望内部号码显示技术支持部门的号码
（例如在振铃组或者队列中）。对外部呼叫没有任何影响。
深圳星昊通科技有限公司 www.hiastar.com
270
Sip Alias
如果想支持 SIP 内部的直接拨号或者支持“匿名”SIP 呼叫，用户可以设置一个易记的名
称，其他用户可以通过这个号码老呼叫此用户分机。
Extension Options
Outbound CID
这里对此分机设置一个 caller ID 。如果为空，则系统使用系统路由或者中继的 caller
ID。如果呼出路由和中继设置支持了这个选项，用户可以在这里设置呼出的 caller ID。
Ring Time
在呼叫进入无应答目的地前，电话的振铃时长，以秒为单位。默认振铃时长在基本设置模
块中设置。
Call Forward Ring Time
在呼叫进入无应答呼叫目的地前，对此分机的呼叫前转的振铃时长。如果设置为
“Always”，系统将一直对呼叫前转振铃，不会进入到无应答目的地流程。
深圳星昊通科技有限公司 www.hiastar.com
271
Outbound Concurrency Limit
对此分机呼出并发数量的限制。我们通常建议设置为 3-4。用户可以设置为 “No
Limit” ，则对呼出并发无限制。
Call Waiting
如果呼叫等待没有开启，此分机在通话状态时，如果有第二个呼入时，则对呼叫方返回忙
状态。
Internal Auto Answer
如果设置为 answer 状态，任何时候其他分机都可以呼叫此分机。
Call Screening
此功能要求呼叫方在呼叫此分机时播报他们的名称。用户可以从无记忆状态或者记忆状态
下选择此功能。如果是建议状态时，系统将要求呼叫方输入名称，保存此名称，然后绑定到相
应的呼叫方的 Caller ID。任何时间，有人从此 Caller ID 发起呼叫时，系统将不再要求播
报此呼叫的名称，将播放录制的语音文件。
Pinless Dialling
如果对呼出路由设置了密码保护，此分机呼出时将不再要求输入密码。用户也可以对基于
每个路由的呼叫开启此功能。
Emergency CID
如果用户设置了紧急呼叫的呼出路由，用户可以通过此设置来设置 caller ID，这个
caller ID 将发生到被呼叫方。这个功能非常实用，如果电话是在远端时，或者不同的地方，
用户可以在系统中设置相应的远端号码，并且能够路由到相应的 911 紧急呼叫服务。
Queue State Detection
如果此分机是队列中的一位成员，队列将尝试检测用户分机状态和设备状态来决定队列呼
叫是否接通此分机。在一些特别环境下，例如，我们使用了分机随行功能，但是实际上并没有
一个物理终端电话或者虚拟分机时，状态信息将显示此成员无效，实际上此分机是存在的。设
置为 “Ignore State” 后，队列将忽略此分机的状态，如果有呼叫的情况下，队列将转发呼
深圳星昊通科技有限公司 www.hiastar.com
272
叫到此分机。还有一些影响也来自于队列本身对本地通道的管理。例如，后续转接将继续显示
成员状态为忙，直到原始呼叫被挂机。在大部分情况下，这个参数应该设置为 “Use State”。
Device Options
设备选项设置部分是相关于大部分设备的选项，一般情况下不要修改其设置。我们这里讨
论的是需要修改设置时的情况。
Dial
这里设置用户的拨号字符串。这里设置的拨号字符串命令和 Dial 命令在拨号规则中的使
用方式完全一致。
例如: LOCAL/1234@from-internal 将拨打分机 1234。这里用来呼叫自定义的终端号码，
不是创建一个分机别名。
Optional Destinations
如果分机无效时，语音邮箱开启后，呼叫将被发送到语音邮箱。用户也可以不使用语音邮
箱，设置以下其他选项作为一个可选设置目的地来控制呼叫的最终目的地。
No Answer
呼叫无应答时，发送呼叫方呼叫到此设置。
Busy
如果呼叫方呼叫，被呼叫方在忙状态时，呼叫方被拒绝后，发送呼叫方呼叫到此设置。
Not Reachable
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。
CID Prefix
在发送此呼叫到目的地之前，对 Caller ID 添加一个前缀号码。
深圳星昊通科技有限公司 www.hiastar.com
273
分机模块 - PJSIP 分机
Overview
Logging in
Adding a SIP Extension
o Extension Number
o Display Name
o CID Num Alias
o Sip Alias
Extension Options
o Outbound CID
o Ring Time
o Call Forward Ring Time
o Outbound Concurrency Limit
o Call Waiting
o Internal Auto Answer
o Call Screening
o Pinless Dialling
o Emergency CID
o Queue State Detection
Device Options
o Secret
o DTMF Signalling
o Mailbox
o Transport
Optional Destinations
o No Answer
o Busy
o Not Reachable
o CID Prefix
总览
本文档指导用户如何配置 SIP 分机。
注意：
本文档仅支持 PJSIP 设置。在 Asterisk 12 和以下版本也可以支持 chan_sip 选项，
这里不再介绍。
选项设置根据安装模块的不同而不同，更多配置选项在其他章节介绍。
深圳星昊通科技有限公司 www.hiastar.com
274
Logging in
从顶部菜单点击 Applications
从下拉菜单中点击 Extensions
Adding a SIP Extension
从顶部分机选项中选择 Device 选择框。.
选择 Generic CHAN SIP Device
点击 Submit
用户将看到分机添加界面
Extension Number
分机号码关联用户本身，一旦创建以后，不能被修改。我们的实例中，我们设置了分机为
“5000”。我们建议使用 3 或者 4 位的数字号码.
Display Name
这个名称关联分机，可以被修改。这个名称将成为 Caller ID Name。
深圳星昊通科技有限公司 www.hiastar.com
275
CID Num Alias
CID Number 作为内部呼叫使用，可和分机号码区分。这个号码可以伪装为其他的用户。
我们经常使用的例子是技术支持部门的电话系统，希望内部号码显示技术支持部门的号码（例
如在振铃组或者队列中）。对外部呼叫没有任何影响。
Sip Alias
如果想支持 SIP 内部的直接拨号或者支持“匿名”SIP 呼叫，用户可以设置一个易记的名
称，其他用户可以通过这个号码老呼叫此用户分机。
Extension Options
Outbound CID
这里对此分机设置一个 caller ID 。如果为空，则系统使用系统路由或者中继的 caller
ID。如果呼出路由和中继设置支持了这个选项，用户可以在这里设置呼出的 caller ID。
Ring Time
在呼叫进入无应答目的地前，电话的振铃时长，以秒为单位。默认振铃时长在基本设置模
块中设置。
深圳星昊通科技有限公司 www.hiastar.com
276
Call Forward Ring Time
在呼叫进入无应答呼叫目的地前，对此分机的呼叫前转的振铃时长。如果设置为
“Always”，系统将一直对呼叫前转振铃，不会进入到无应答目的地流程。
Outbound Concurrency Limit
对此分机呼出并发数量的限制。我们通常建议设置为 3-4。用户可以设置为 “No
Limit” ，则对呼出并发无限制。
Call Waiting
如果呼叫等待没有开启，此分机在通话状态时，如果有第二个呼入时，则对呼叫方返回忙
状态。
Internal Auto Answer
如果设置为 answer 状态，任何时候其他分机都可以呼叫此分机。
Call Screening
此功能要求呼叫方在呼叫此分机时播报他们的名称。用户可以从无记忆状态或者记忆状态
下选择此功能。如果是建议状态时，系统将要求呼叫方输入名称，保存此名称，然后绑定到相
应的呼叫方的 Caller ID。任何时间，有人从此 Caller ID 发起呼叫时，系统将不再要求播
报此呼叫的名称，将播放录制的语音文件。
Pinless Dialling
如果对呼出路由设置了密码保护，此分机呼出时将不再要求输入密码。用户也可以对基于
每个路由的呼叫开启此功能。
Emergency CID
如果用户设置了紧急呼叫的呼出路由，用户可以通过此设置来设置 caller ID，这个
caller ID 将发生到被呼叫方。这个功能非常实用，如果电话是在远端时，或者不同的地方，
用户可以在系统中设置相应的远端号码，并且能够路由到相应的 911 紧急呼叫服务。
深圳星昊通科技有限公司 www.hiastar.com
277
Queue State Detection
如果此分机是队列中的一位成员，队列将尝试检测用户分机状态和设备状态来决定队列呼
叫是否接通此分机。在一些特别环境下，例如，我们使用了分机随行功能，但是实际上并没有
一个物理终端电话或者虚拟分机时，状态信息将显示此成员无效，实际上此分机是存在的。设
置为 “Ignore State” 后，队列将忽略此分机的状态，如果有呼叫的情况下，队列将转发呼
叫到此分机。还有一些影响也来自于队列本身对本地通道的管理。例如，后续转接将继续显示
成员状态为忙，直到原始呼叫被挂机。在大部分情况下，这个参数应该设置为 “Use State”。
Device Options
设备选项设置部分是相关于大部分设备的选项，一般情况下不要修改其设置。我们这里讨
论的是需要修改设置时的情况。
Secret
注册密码，至少包含两个字母和两个数字.当系统创建新的 SIP 分机时，FreePBX 将自动
生成一个密码。
DTMF Signalling
本设备使用的 DTMF Signalling 模式。大部分情况下使用 RFC 2833
Mailbox
系统自动发送到邮箱: <extnum>@device
深圳星昊通科技有限公司 www.hiastar.com
278
当集成了 LDAP 时，开启 MWI (Message waiting indication)，在语音邮箱中输入以下
格式<extnum>@default，例如 101@default;102@default
当语音邮箱有未读邮件时，设备的 MWI 指示灯会闪烁。
Transport
传输方式设置
Parking Lot
设备电话驻留
Optional Destinations
如果分机无效时，语音邮箱开启后，呼叫将被发送到语音邮箱。用户也可以不使用语音邮
箱，设置以下其他选项作为一个可选设置目的地来控制呼叫的最终目的地。
No Answer
呼叫无应答时，发送呼叫方呼叫到此设置。
Busy
如果呼叫方呼叫，被呼叫方在忙状态时，呼叫方被拒绝后，发送呼叫方呼叫到此设置。
Not Reachable
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。
CID Prefix
在发送此呼叫到目的地之前，对 Caller ID 添加一个前缀号码。
深圳星昊通科技有限公司 www.hiastar.com
279
Follow Me User Guide
Overview
Logging In
Enabling Follow Me for an extension
o Disable
o Initial Ring Time
o Ring Strategy
ringallV2
ringall
hunt
memoryhunt
firstavaialble
firstnotonphone
o Ring Time
o Follow-Me List
o Announcement
o Play Music on Hold
o CID Name Prefix
o Alert Info
o Remote Announce
o To-Late Announce
o Change External CID Configuration
o Mode
Default
Fixed CID Value
Outside Fixed CID Value
Use Dialled Number
Force Dialled Number
Fixed CID Value
Destination if no answer
总览
分机随行模块支持用户在同一时间对多个呼叫目的地同时振铃。分机随行支持通过界面设
置基于每个分机的分机随行。如果分机开启了分机随行功能，用户则可以通过 UCP 模块来设置
一些选项。所有当前的系统分机都显示在界面上，用户可以点击编辑按钮来编辑分机随行；如
果当前分机不支持分机随行的话，系统则显示添加按钮。
深圳星昊通科技有限公司 www.hiastar.com
280
Logging In
从菜单顶部点击 Applications
从下拉菜单中点击 Follow Me
Enabling Follow Me for an extension
深圳星昊通科技有限公司 www.hiastar.com
281
找到相应的分机，点击编辑：
Disable
选择勾选框中的已创建的分机随行设置，则说明关闭了分机随行。这里关闭了分机随行以
后，如果用户希望打开的话，用户可以通过 UCP 模块在用户侧管理界面中编辑分机随行。在
此实例中，因为我们需要使用分机随行，所以这里我们开启了分机随行。
Initial Ring Time
呼叫分机随行列表之前，对初始分机振铃的时长。在我们的实例中，我们设置振铃时间为
5 秒钟，我们也可以包含初始号码以便让分机继续振铃。
Ring Strategy
分机随行中的振铃策略。可选的振铃策略包括:
深圳星昊通科技有限公司 www.hiastar.com
282
ringallV2
在同一时间内，先对初始分机振铃，然后对分机随行列表中的号码振铃，如果分机随行的
号码无应答，则执行失效转移到目的地呼叫。系统将根据振铃时间的设置对所有列表号码振铃。
ringall
同时对所有分机随行列表的号码振铃，如果呼叫无应答，则切换到失效转移到目的地。振
铃时长基于模块中的时间设置。这里将忽略初始的振铃时间设置。
hunt
每次仅对列表顶部的号码振铃，振铃时间按照设置的时长进行。如果第一个号码无应答，
则继续呼叫列表中的第二个号码，直到完成最后一个号码。
memoryhunt
将根据振铃时长对第一个号码振铃，如果无应答，则根据设置的时长同时对第一个号码，
第二个号码振铃。以此类推，直到完成对所有列表的号码振铃。
firstavaialble
仅对列表中的第一个号码振铃，如果无应答则切换到失效目的地。
firstnotonphone
和 “first available”功能一样，但是必须确认被呼叫的分机是空闲状态。
Ring Time
对分机随行的列表号码呼叫的振铃时长。
Follow-Me List
分机随行列表中的号码包括内部分机号码和外部呼叫号码。如果用户需要指定一个外部呼
叫号码的话，必须确认在号码后面加#标志，否则可能导致呼叫失败。通过这样的设置标志通
知系统此号码不是系统内部号码。
深圳星昊通科技有限公司 www.hiastar.com
283
Announcement
这里可以使用系统已录制的语音文件，在呼叫分机随行的号码前对分机随行列表的号码播
放此语音。如果使用系统录制的语音文件，请参考系统录音部分的使用说明。
Play Music on Hold
对分机随行列表的号码播放音乐等待语音。
CID Name Prefix
对分机随行中的内部号码添加一个 caller ID 前缀。前缀 CID 仅支持内部号码，对外部
呼叫的号码添加此前缀无效。
Alert Info
这里可以对分机随行中的内部号码定义一个 alert 消息。Alert info可以修改内部分机
的振铃方式。获得关于 Alert 消息的介绍，请参考文档"Alert Infos and How They Work"。
Confirm Calls 开启此选项，确认对列表中的外部号码进行呼叫。系统要求呼叫方呼出时
必须呼出号码携带前缀#，要求呼叫方摁 1 确认呼叫。这样的工作方式类似于手机语音邮箱。
内部分机则无需确认请求，因为内部分机本身已经支持了语音邮箱。
深圳星昊通科技有限公司 www.hiastar.com
284
Remote Announce
对外部分机随行呼叫播放语音文件。默认环境下，系统会播放 "You have an incoming call
press 1 to accept it” 的语音。用户可以使用默认的语音文件或者从系统录音的列表中选
择一个自定义的语音文件进行播放。
To-Late Announce
对分机随行的外呼呼叫方播报系统语音文件，但是这种当前环境下在分机随行列表中的其
他呼叫方接收了通话请求，其他呼叫方可能比用户自己早一些接受了呼叫请求，也有可能呼叫
超时进入了无应答的呼叫目的地。默认环境下，系统会播放"Someone else has already
answered your incoming call”。用户可以使用默认的系统录音文件播报此语音提示，或者
使用系统录音文件作为一个提示音。
Change External CID Configuration
设置一个分机随行的外呼 CID。更多关于 CID 号码的高级设置请参考相关技术文档关于
"Outbound Caller ID Settings" 的设置。
Mode
模式支持以下选项设置:
Default
分机随行中用户被呼叫方 callerID。如果有人从 4444444 的分机随行列表中呼叫的话，
这个号码则被当作 callerID，这个号码将继续执行到用户定义的呼出路由和相应的中继设置
中。
Fixed CID Value
如果用户勾选此选项，系统则会根据 Fix CID option 定义的号码，写死 callerID。在我
们的例子中，我们定义为 5555555555。无论外面呼入到本地系统的呼叫还是另外一个分机呼
叫本用户（尽管本地分机已经对呼出路由设置了 callerid），系统仍然会把这个号码写死。
Outside Fixed CID Value
这个选项和 “Fixed CID Value” 选项功能类似，除了一种情况下有所不同，如果一个
内部用户呼叫本用户时，系统将调取用户自己设置的 CallerID 。
深圳星昊通科技有限公司 www.hiastar.com
285
Use Dialled Number
这里设置一个动态的 caller ID，这个号码和外部用户呼入的号码相同。如果他们呼叫本
系统时的 DID 是 6666666666，系统自动设置呼出的 caller ID 为 6666666666。如果是内部用
户呼叫本机，动态的 caller ID 则为默认模式下的号码。如果本系统有一个指定的中继设置
了号码过滤，这个号码也会被过滤，系统将使用中继的 caller ID。
Force Dialled Number
这个选项的使用方法和 "Use Dialled Number"类似，但是如果在中继中设置了 “Block
Foreign Caller ID”选项，则忽略此选项。这样就会强制使用已拨号码作为动态的 caller ID。
Fixed CID Value
如果用户使用了 “Fixed CID Value”，用户可以在这里设置任意号码。这个号码将是动
态的 caller ID ，在这个实例中，我们使用 5555555555。
Destination if no answer
如果分机随行的呼叫无应答时，设置一个无应答目的地设置接听此呼叫。默认环境下，这
个无应答呼叫将转接到分机随行的无应答设置流程中，例如语音邮箱。用户也可以选择其他的
目的地对象，例如其他内部分机，语音邮箱，或者队列中。
IAX Settings User Guide
Overview
Logging in
Settings
o Audio Codecs
Codecs
ulaw
alaw
gsm
siren14
lpc10
speex
g722
adpcm
siren7
g723
深圳星昊通科技有限公司 www.hiastar.com
286
slin
g726
g729
ilbc
g726aal2
o Codec Priority
Host
Caller
Disabled
Reqonly
o Bandwidth
o Video Support
Codecs
h264
h263p
h263
h261
Registration Settings
Jitter Buffer Settings
o Jitter Buffer
o Force Jitter Buffer
o Jitter Buffer Size
o Max Interpolations
Advanced General Settings
o Language
o Bind Address
o Bind Port
o Delay Auth Rejects
o Other IAX Settings
Save
总览
IAX代表 Asterisk之间通信交互的协议。大部分情况下， IAX 协议用来连接两台 Asterisk
服务器。 IAX 使用一个端口实现信令和语音的传输。单口设置使得网络安全的管理更加简单
方便。IAX 默认端口是 UDP port (4569)。FreePBX 支持 IAX 中继配置和 IAX 分机（目前市场
上支持 IAX 需要的终端很少）。IAX 设置模块定义了如何对接 PBX 和服务器端设置。
注意:对 IAX 定义不是很明确。通信技术中使用的是 IAX2，没有使用 IAX1。所以通常来说，
IAX2 就是 IAX
深圳星昊通科技有限公司 www.hiastar.com
287
Logging in
从菜单顶部点击 Settings
在下拉菜单中单击 Asterisk IAX Settings
Settings
Audio Codecs
这里定义了 IAX 语音编码优先级规则
Codecs
勾选需要的编码格式，取消无需支持的公司。通过拖拉来调整语音编码的顺序。.
ulaw
G.711-u-law (64 Kbps, 美国使用). 因为传统的 PSTN 网络使用 G.711 编码，使用此编
码可以取得最好的语音质量。此编码占用比较多的语音带宽，包括 UDP 和 IP 的开销，最大占
用带宽为 84 Kpbs。
alaw
G.711-a-law (64 Kbps, 在欧洲使用)。欧洲 PSTN，中国 PSTN 使用。.
gsm
13kbps 9full rate, 20ms frame size。
深圳星昊通科技有限公司 www.hiastar.com
288
siren14
G.722.1 annex C, 宝利通许可证。
lpc10
不推荐的语音。
speex
2.15 to 44.2 Kbps, 比较灵活的开源编码，消耗更多 CPU 资源。
g722
48/56/64 Kbpx ADPCM 7Khz audio bandwidth
adpcm
Adaptive Differential Pulse Code Modulations
siren7
G.722.1, Siren7 is licensed from Polycom
g723
5.3/6.3 Kbpx, 30ms frame size, 使用此编码需要许可证。
slin
16 bit Signed Linear PCM
g726
16/24/32/40 Kbps (Asterisk only supports 32 kbps,) like g.711 it has its origins
in the PSTN network
g729
8 Kbpx, 10ms frame size, 要求许可证，否则只能在服务器设置透传。
深圳星昊通科技有限公司 www.hiastar.com
289
ilbc
15 Kbps, 20ms frame size and 13.3 Kbps, 30ms frame size
g726aal2
Asterisk specific version of G.726
Codec Priority
控制 IAX 呼叫的编码协商机制。此选项将被其他的选项继承。当然每个用户也可以分别
设置，覆盖掉目前的设置选项。有效选项包括:
Host
选择服务器推荐的语音编码。.
Caller
选择呼叫方推荐的语音编码。.
Disabled
关闭语音编码推荐选项。.
Reqonly
如果要求的编码格式无效的话，关闭所有编码推荐。如果要求的语音编码有效，则呼叫接
受此编码。
深圳星昊通科技有限公司 www.hiastar.com
290
Bandwidth
通常情况下，按照带宽消耗数量（低，中，高）来决定使用编码类型。
Video Support
是否开启视频编码。
勾选需要的视频编码格式。
Codecs
h264
大部分高清视频需要的格式
深圳星昊通科技有限公司 www.hiastar.com
291
h263p
H.263 增强型版本，具有较好的视频质量。
h263
视频会议编码
h261
大部分商品会议系统使用的向下兼容的视频格式，支持一些网络视频格式。
Registration Settings
定义 IAX peers 注册请求的最小时长和最大时长，以秒为单位。.
minregexpire – 默认是 60
maxregexpire – 默认是 3600
Jitter Buffer Settings
从部分支持开启或关闭抖动缓冲。用户可以对抖动缓冲的相关参数进行设置。抖动缓冲的
主要功能是对网络延迟做一个补偿调整。抖动缓冲仅对呼入接收的语音有效。呼出或发送的语
音则需要在对端设置抖动缓冲调整。.
Jitter Buffer
此处开启或关闭抖动缓冲。.
Force Jitter Buffer
开启或关闭抖动缓冲设置。强制在 IAX 通道的接收端使用抖动缓冲设置。通常情况下，
如果就是到存在抖动的通道时，抖动缓冲将不在使用。抖动缓冲设置将会关闭，系统则要求在
远端，例如 SIP 通道设置抖动缓冲. 在媒体流发送之前，此设置将强制使用抖动缓冲。这样
的结果不是我们正在希望的结果，可能导致系统更严重的语音迟延。
深圳星昊通科技有限公司 www.hiastar.com
292
Jitter Buffer Size
▪ maxjitterbuffer – 默认 200, 以毫秒为单位。
▪ resyncthreshold – 默认为 1000。当抖动缓冲发生迟延，语音帧数据变化幅度很大时，
它将同步所有语音数据，此时系统假设这个迟延是因为时间戳发生错乱地址。这个阀值用来提
示迟延的改变。计算这个变化的算法是，两倍的抖动缓冲加这个同步的阀值。设置此参数为-1
则关闭同步。
Max Interpolations
最大插值数应该划分抖动缓冲的返回数据是连续的。因为一些客户终端没有发送舒适噪音
帧数据来提醒静音状态，收到许多的插值后，抖动缓冲会假设静音已经开始。此功能是为了防
止过长的静音插值。
Advanced General Settings
Language
通道默认语言设置。
深圳星昊通科技有限公司 www.hiastar.com
293
Bind Address
绑定的 IP 端口来监听呼叫。如果设置为 0.0.0.0， Asterisk 会监听所有的地址。为
了绑定多个 IP 地址或者端口，使用 “Other IAX Settings” 来设置指定的地址和端口，
例如 “bindaddr=192.168.10.100:4555”。我们建议此值为空。
Bind Port
Asterisk 需要监听的本地接收方 UDP 端口。 IAX 使用 “4569” 。大部分情况下则为空。
Delay Auth Rejects
开启或关闭。为了增加系统的安全性，防止暴力破解密码，开启此选项将延迟发送认证。
如果有密码的话，则对 REGREQ 或者 AUTHREP 请求拒绝。.
Other IAX Settings
用户可以在其他设置文件中设置其他的 IAX 参数，同样，这些参数也可以在基本设置中
的 IAX 设置文件中进行设置。这里没有对设置进行匹配检查，系统不会显示任何错误信息，
所以请认真检查。
Save
完成所有配置后，点击 “Submit” 按钮保存设置。 IAX 连接配置现在就已经保存在了
设置模块中。
Misc Applications 其他杂项模块使用指南
Overview
Logging in
Adding a Misc Application
o Description
o Feature Code
o Feature Status
o Destination
总览
Misc 其他杂项应用是一个自定义的功能代码热键，用户可以通过此热键从内部分机拨打
各种目的地对象。misc 应用支持自定义分机或 star 代码，可以直接转发呼叫方的呼叫到指定
深圳星昊通科技有限公司 www.hiastar.com
294
的目的地。这个模块和 Misc Destinations 模块正好相反，Misc Destination 模块则是创建
一个目的地对象，此模块是其他 PBX 模块用来拨打内部分机的功能热键。
Logging in
从菜单顶部点击 Applications
从下拉菜单中点击 Misc Applications
Adding a Misc Application
Description
描述此应用功能。
Feature Code
这个功能代码是自定义的代码热键，用户可以拨打此热键代码访问这个应用程序。这个代
码可以说 star code (例如, *7876) 或者一般的分机号码 (例如, 7876)。但是此值在系统
中必须是唯一的，不能和其他用户共享。这个代码也可以通过 feature codes 页面修改。
深圳星昊通科技有限公司 www.hiastar.com
295
Feature Status
应该开启此功能。
Destination
当呼叫方拨打此代码后，系统将转发呼叫方到指定的目的地对象。
MoH 音乐等待模块用户使用指南
Overview
Logging In
Adding Music Categories
o Category Name
Adding Static Music
o Upload a WAV or MP3 File
You will click Choose File
Volume Adjustment
Upload
o Disable/Enable Random Play
o MoH List
Adding Streaming Music
o Category Name
o Application path
o Optional Format
总览
Music on Hold 音乐等待模块的目的是给呼叫方用户一个比较好的用户体验。当呼叫方呼
叫对端时，此时对端处于通话状态，被呼叫方通话只能被转入一个短暂的等待状态，此时系统
对呼叫方播放一段音乐或者音乐文件，让呼叫方体验到这个通话的连续性，不是突然中断呼叫。
PBX 系统默认支持了十一首歌曲，音乐等待可以对任意一首歌曲播放。当然用户也可以添加自
己录制的音乐等待语音文件，这些语音文件的格式为.wav 或者.mp3 文件格式，或者添加一个
网络订阅的实时语音流。用户可以添加一个用户自定义的音乐文件体现出 PBX 的不同。 PBX
支持两种不同的音乐等待文件播放方式–静态音乐文件和动态的媒体流文件。静态语音文件的
格式可以是 (WAV 或者 MP3 文件格式) ，用户可以上传音乐文件到服务器存储空间，当 PBX
需要播放此语音文件时，系统对呼叫方播放音乐等待。媒体流可以是一个实时的流媒体，PBX
可以连接流媒体播放源播放音乐等待文件。媒体流可以说网络媒体流，也可以是来自声卡的音
乐流或者其他音乐设备提供的媒体流。MoH 可以支持不同的 PBX 应用模块，例如呼入路由，
深圳星昊通科技有限公司 www.hiastar.com
296
队列，振铃组，呼出路由和电话会议。音乐等待的类别可以指定到通话呼叫的层，这个设置将
覆盖呼叫目的地的音乐等待类别设置。一旦这个呼叫脱离了这个目标对象，音乐等待类别将返
回到在呼入路由设置的音乐等待类别中。
注意：许可证问题
以前的做法是直接把电台的媒体流或者 CD 播放器音乐接入到 PBX 中。在实际环境中，因
为大部分的音乐版权和音乐许可证限制，音乐版权所有者不会允许这样的接入行为。两种可行
的办法是购买音乐的商业版权，或者找适合 PBX 的其他合法的数据源。具体细节，请参考以下
链接：
BMI - MoH Licencing
ASCAP - MoH Licencing
http://www.opsound.org
Creative Commons Search on Sound Cloud
注意：网络上传的语音文件完全在于用户是否可靠。如果用户需要使用一些网络或者云空间的
语音文件，需要详细检查音乐文件的许可证是否可用。
Logging In
从菜单顶部点击 Settings
从下拉菜单中点击 Music on Hold
Adding Music Categories
PBX 本身已经带有一个默认的类别，是“default”。用户可以创建用户自己定义的类别。
点击 “Add Music Category” 添加用户自定义的音乐等待类别。
深圳星昊通科技有限公司 www.hiastar.com
297
需要填写以下类别信息：
Category Name
输入合适的音乐等待类别，保存设置。
Adding Static Music
点击右侧导航菜单，点击相应的类别添加播放的音乐文件：
深圳星昊通科技有限公司 www.hiastar.com
298
Upload a WAV or MP3 File
这里，用户可以上传用户录制的音乐文件，格式可以是 WAV 或者 MP3。
You will click Choose File
系统提示栏会提示用户从本地电脑上传音乐文件。
Volume Adjustment
在上传音乐文件之前，用户可以调整音乐文件的增益语音音量大小。一旦文件上传以后，
用户不能再次调整音乐音量。如果上传后，用户计划再次调整音量的话，只能删除以前的上传
文件，调整音量，再次上传一个新的文件。
Upload
点击上传以后，系统将上传自定义的音乐文件到系统设置的文件路径下。上传需要一定的
时间，如果上传的是 MP3 文件，系统需要转换成 WAV 格式。
Disable/Enable Random Play
此选项可以支持对音乐文件播放状态的任意切换（开启/关闭）。如果呼叫方进入到音乐
等待状态时，任意播放的功能则支持系统将任意挑选一个音乐文件对呼叫方播放。如果关闭此
深圳星昊通科技有限公司 www.hiastar.com
299
选项，系统则对呼叫方从第一个语音文件开始依次播放用户上传的音乐文件（第一个播放的文
件将是用户第一个上传的音乐文件，以此类推）。
MoH List
音乐等待类别列表。用户可以点击“Delete”按钮删除一个指定的文件。
Adding Streaming Music
媒体流类别可以用来从在线的网络语音源获取音乐媒体流。
在 MoH 中使用语音媒体流比使用静态音乐文件更加复杂，因为来自于网络的语音媒体流具
有不可预测性。
注意：我们不推荐对于 MoH 采用媒体流的方式处理。以下指导告诉用户如何设置媒体流，不推
荐使用。
Category Name
媒体流的类别.
Application path
这里定义媒体流或者映射到一个脚本文件获取声卡媒体数据。
Application 实例:
/usr/bin/mpg123 -q -s --mono -r 8000 -f 8192 -b 1024 http://urlofyourlivestream/
Optional Format
语音文件格式，例如 PBX 使用 “ULAW” 播放媒体流。
深圳星昊通科技有限公司 www.hiastar.com
300
注意：音乐等待如果使用媒体流形式播放，因为占用带宽过多，编码转换的问题会带来很多负
面的影响，严重影响系统的性能。如果多个呼叫连接到同一媒体流，每个媒体类别仅在限定的
时间内播放。如果创建了多个媒体流，多个媒体流可能同时启动。PBX 要求媒体流以 Ulaw 格
式播放，因此，活动的呼叫使用了和媒体播放同样格式的语音编码，则无需标明转换。如果呼
叫使用了不同的语音编码，例如使用了 G.722 编码，那么系统将强制媒体流进行编码转换，
以便呼叫方可以听到音乐等待语音播放。如果语音编码使用了商业许可证，这样的话，要求
PBX 系统必须有支持商业许可证的编码算法来处理并发呼叫。这样可以避免因为编码问题带来
的性能影响。如果为了保证媒体流的传输的稳定性，除非用户使用的媒体流来自于本地内部网
络，媒体流和呼入呼出的呼叫一样占用同样的网络带宽。任何媒体流如果超出 24k 则浪费了
网络带宽。
寻呼对讲模块用户使用指南
Overview
Logging In
General Settings
o Auto Answer Announcement
New Paging Group
o Paging Extensions
o Group Description
o Device List
o Busy Extensions
Skip
Force
Whisper
o Duplex
o Default Page Group
Paging Pro
o Busy Page Groups
Do Nothing
Valet
Force Valet
o Page Announcement
o CID Pre-pend
o Paging Scheduler
Enable Scheduler
Start and End Date
Events
Exclusion Dates
深圳星昊通科技有限公司 www.hiastar.com
301
总览
此模块支持特定的终端话机实现寻呼对讲。在寻呼对讲模块中，用户可以配置一组电话，
当用户从对讲组内发起呼叫时，其他用户可以自动应答，并且通过扬声器互相讲话。这个模块
支持 PBX 中大部分的 SIP 终端电话机。
Logging In
从菜单顶部，点击 Applications
从下拉菜单中点击 Paging and Intercom
General Settings
Auto Answer Announcement
默认环境下，如果对其他分机执行对讲时，系统自动播放一个 Beep 语音。用户可以录制
自己的语音文件，然后实现在对讲过程中自动播放自定义的语音文件。
New Paging Group
创建新的对讲组，点击右侧导航栏菜单中的“New Paging Group”。
深圳星昊通科技有限公司 www.hiastar.com
302
Paging Extensions
属于对讲组的接听分机号码。如果对讲组的任何分机需要发起对讲时，则可拨打此号码。
这个号码可以说任何一个数字，位数为 3-11 位数。
Group Description
对讲组的名称，例如 Sales.
Device List
对讲组内分机列表。可以从未选的列表中拖拉分机到已选名单中。
注意：我们不推荐在一个对讲组内支持 20-25 个对讲分机。用户可以在高级设置中的
PagingMaxParticipants 设置最大对讲组的分机数量。
Busy Extensions
如果对讲分机遇忙，对对讲遇忙分机进行进一步处理，用户可进行以下几种选择：
Skip
跳过所有对讲组内其他在对讲状态的分机。
Force
强制对此分机发送对讲。如果电话在遇忙状态时，大部分的电话会振铃而不是自动应答，
但是也有一些硬件厂商设计有所不同，可能把被呼叫方设置为音乐等待状态，然后播放对讲语
音。除非系统设置的对讲组是为了一个紧急状态处理，用户进入对讲状态简单播放对讲语音，
否则这样的功能设置其实不是真正用户希望的功能。
Whisper
如果选择这个私语模式，对讲的分机遇忙时，则对发起对讲方播放对讲语音，其他分机听
不到对讲语音。仅此用户可以可以讲话。
深圳星昊通科技有限公司 www.hiastar.com
303
Duplex
Duplex 双工模式支持对讲用户默认支持的静音状态。如果开启了双工模式，对讲组内在
对讲状态的分机将不会静音，任何人都可以在对讲组内讲话。通常是关闭状态。任何用户可以
拨打 *1 来激活自己的静音状态。
Default Page Group
用户可以创建一个或者多个默认的对讲组。当用户创建了系统分机后，可以支持新用户默
认加入到对讲组内。所以创建系统分机后，管理员无需再次对新的分机进行对讲组添加。
Paging Pro
Paging Pro 是一个商业模块，相比默认的对讲组，商业版本具有更多的高级功能。
Busy Page Groups
当对讲组遇忙时，支持用户再次呼叫其他的对讲组或者其他的流程，可选方式为：
Do Nothing
如果呼叫的对讲组遇忙，则对呼叫方播放忙音。
Valet
带播对讲，如果对讲组在使用状态，其他用户呼叫对讲组时，其他用户则被提示对讲。一
旦此对讲组成为空闲状态后，系统则对所有对讲组成员播放对讲录音。
深圳星昊通科技有限公司 www.hiastar.com
304
Force Valet
任何时候，如果有用户拨打对讲组，系统则提示对讲录音。当用户挂机后，如果对讲组处
于空闲状态时，则系统对所有成员执行对讲，播放刚才用户的对讲录音。这个对讲方式和机场
的对讲方式类似。
Page Announcement
默认情况下，当拨打对讲组时，系统播放一个 beep 语音提示。用户可以在 PBX 系统中选
择是否播放 beep 语音。对讲语音播放将对所有用户进行播放。这些用户必须是一直在一个对
讲时间内讲话，或者这些用户正在处于带播对讲事件中，这个事件中正在播放以前录制的对讲
录音。
CID Pre-pend
可选 caller ID 预设。用户可以对从对讲组呼叫到分机呼叫预设一个 Caller ID。
Paging Scheduler
Enable Scheduler
用户可以选择对对讲事件的时间进行设置。系统可以自动支持用户创建一个对讲起始时间，
从 Page Announcement 中选择播放对讲语音，然后挂机如果用户开启了此设置，用户可以看
到以下选项。这个实例可以作为学校的自动上课铃声播放。
深圳星昊通科技有限公司 www.hiastar.com
305
Start and End Date
对讲计划的起始时间和结束时间。
Events
这里，我们可以定义实际对讲播放日期和时间。摁绿色的+ 按钮，添加更多对讲事件。
Exclusion Dates
非对讲时间可以用来指定一定的时间段，不包含在起始和结束时间内。通常情况下，例如
公共假期，周末，学校的一些活动事件都不需要启动对讲。点击绿色+按钮，添加更多的非对
讲时间段。
电话驻留模块用户使用指南
Overview
Configuration
o Parking Lot Extension
o Parking Lot Name
o Parking Lot Starting Position
o Number of Slots
o Parking Timeout
o Parked Music Class
o BLF Capabilities
o Use Next Slot
Returned Call Behaviour
o Pickup Courtesy Tone
o Transfer Capability
o Re-Parking Capability
o Parking Alert-Info
o CallerID Prepend
o Auto CallerID Prepend
None
Slot
Extension
Name
o Announcement
Alternate Destination
o Come Back to Origin
o Destination
深圳星昊通科技有限公司 www.hiastar.com
306
总览
此模块用来创建和配置 PBX 的电话驻留或者停靠。简单来说，如果被呼叫方处于遇忙状态
时，通话会被转到一个电话驻留的空间等待被接听，其他分机通过拨打功能代码可以拨打功能
代码获取驻留的呼叫。事实上这就是一种语音等待的方式，相关的分机可以在其他地方获取到
驻留的呼叫，继续通话。标准的模块支持配置一个驻留空间支持电话系统中所有的分机电话。
电话驻留是呼叫被转发到一个已配置的驻留分机，呼叫被停靠在一个配置好的停靠空间，系统
对驻留者播放语音驻留提示。其他用户可以通过拨打 PBX 的驻留功能代码获取被驻留或停靠
的这个呼叫，进行实现通话。如果驻留时间超时，根据驻留通话的设置不同，驻留的通话可以
对驻留这发送振铃，或者发送到其他的目的地。驻留功能可以通过话机支持的可编程的话机
BLF 按键功能进一步得到改善或者通过商业的图形化工具 XactView 操作面板来进行管理设置
注意：在新版本的 FreePBX（FreePBX 11 或者以上版本），用户需要配置默认的驻留空间，
默认的初始驻留分机是 70，驻留空间从 71 开始。然后选择可选目的地。
Configuration
配置驻留/停靠空间和配置标准的驻留模块或者商业版本的模块是一样的。几个非常重要
的配置选项包括：
Parking Lot Extension // 驻留分机，其他用户拨打从分机访问驻留呼叫
Parking Lot Starting Position // 驻留空间起始值
Number of Slots // 驻留空间数量
Parking Timeout // 驻留超时
Destination and Come Back to Origin configuration
深圳星昊通科技有限公司 www.hiastar.com
307
Parking Lot Extension
驻留分机号码。
Parking Lot Name
驻留空间名称。商业版本可以支持不同的驻留空间，并且可以支持其他模块，例如可以在
打印模块列出驻留设备信息。
Parking Lot Starting Position
驻留空间起始号码，例如从 71 开始。可以配合驻留空间数量创建不同的驻留分机段。
Number of Slots
驻留空间数量，如果驻留分机是 70 ，设置为 8 个驻留空间数量，则驻留空间则从 71-78。
Parking Timeout
定义驻留超时时间。如果驻留用户的呼叫在一定时间内没有其他用户接听或者访问，超时
后，PBX 将转发驻留呼叫到系统设置的目的地。
Parked Music Class
设置一个驻留音乐类别，对驻留用户播放音乐等待。如果某些特定的音乐列表已经在进入
驻留之前进行了设置，那么驻留音乐设置将覆盖以前的设置。例如，如果在队列中的呼叫被转
入到驻留空间，以前在队列中也可能设置队列等待音乐类别，如果这个呼叫被转入到驻留空间，
驻留空间也设置了音乐等待列表，PBX 则忽略队列中的设置。
BLF Capabilities
每个驻留空间可以支持一个 Asterisk BLF “hint”关联到驻留空间。这样的话，PBX 可
以支持一些带可编程的话机，通过话机按键获取驻留空间呼叫，而且如果有驻留通话，BLF 按
键会及时闪亮提示用户。如果需要 asterisk hints 支持，需要开启此功能。
Use Next Slot
通常情况下，PBX 会驻留呼叫在第一个有效驻留空间上。但是有一些环境则需要更加灵活
的管理方式。大部分驻留空间支持到八个空间号码，但是一般话机也仅支持第一个驻留空间的
几个号码。这样的话，系统将限制了最大驻留空间的使用频率。如果有一些用户有这样的需求，
深圳星昊通科技有限公司 www.hiastar.com
308
例如客户需要支持一个对驻留空间进行管理模块，希望在下一个一个驻留空间中以图形化的方
式来查看管理驻留的顺序，调整顺序，这样就需要这样一个功能设置。
Returned Call Behaviour
如果停靠在驻留空间的呼叫超时后没有接听，系统将尝试返回到当时执行驻留的终端设备
或者转发到设置的目的地东西。可选设置支持了返回驻留呼叫例如再次执行驻留，也可以支持
返回呼叫条件设置（例如 Caller ID pre-pending ），通过这些信息帮助确定是否是一个超
时的驻留呼叫。
Pickup Courtesy Tone
当驻留呼叫接听后，默认设置是对呼叫方播放一个礼貌性语音提示。可以修改播放东西。
Transfer Capability
驻留呼叫被接听以后，开启或关闭基于 DTMF 的转发功能，通常设置为 ‘##’。这个功
能不能控制终端话机的可编程转接按键。
Re-Parking Capability
超时后，是否可以重新驻留此呼叫。
Parking Alert-Info
在执行驻留的设备发送回呼或者转发到目的地对象前，对执行驻留的终端发送
Alert-Info 消息。请参考官方 wiki 关于不同话机 Alert 消息的设置。
深圳星昊通科技有限公司 www.hiastar.com
309
CallerID Prepend
在对执行驻留的设备发送回呼或者转发到目的地对象前，对驻留呼叫关联的 CallerID
添加一个预设的字符标志。这样可以确定这个驻留呼叫是来自于何处。如果和下面的 Auto
CallerID Prepend 一起使用，那么将先配置，然后执行 Auto Caller ID 配置。
Auto CallerID Prepend
驻留呼叫超时后，系统自动预设一个指定的参数，可选参数为：
None
不设置预设信息。.
Slot
超时驻留空间。
Extension
执行驻留呼叫的本地 PBX 分机号码。
Name
执行驻留呼叫的分机名称。
Announcement
在驻留呼叫被转发回驻留发起人之前或者可选目的地之前，对驻留呼叫播报语音提示。
Alternate Destination
驻留超时后，系统需要一个配置来管理超时的驻留呼叫。我们可能需要把驻留的呼叫返回
到驻留发起人或者转发到设置的目的地对象。如果我们选择回呼到驻留发起人终端，则这个终
端设备可能无应答或者不可达，我们还是希望这个驻留呼叫总是返回到一个可达或者有效的目
的地对象，例如系统接线员，振铃组语音邮箱或者其他有效的目的地对象。所有配置的 Return
Call Behavior 执行权限将优先于呼叫路由。
深圳星昊通科技有限公司 www.hiastar.com
310
Come Back to Origin
如果驻留超时，选择 YES，表示直接返回到驻留呼叫的发起人；选择 No，则直接返回到配
置的目的地。如果驻留呼叫返回到驻留呼叫的发起人终端，此时终端处于无应答或者无效状态，
则最后使用目的地对象。如果选择了 Yes，返回的呼叫会直接发送到终端本身，不会经过系统
的拨号规则。这里我们假设此时的呼叫仍然没有挂机，在分机的语音邮箱或者其他的业务流程
中。所以，如果终端设备没有任何反映的情况下，我们必须确保有一个正确的目的地对象来完
成呼叫流程。
Destination
驻留呼叫超时后，转发驻留呼叫到此目的地对象。这里可以是 PBX 任何有效目的地对象。
队列优先级模块使用指南
Overview
Logging in
Adding a Queue Priority
o Description
o Priority
o Destination
Overview
默认队列设置为先进先出的方式。队列优先级支持用户可以设置呼叫方的权重等级。如果
设置了高优先级等级，系统则允许此呼叫方通话被优先接听。呼叫方可以获得更加快速的服务。
默认的优先级是所有呼叫方的优先级是 0. 如果呼叫方设置了优先级，则呼叫权重等级会设置
为高于 0的优先级。通常情况下，当公司对客户提供了服务级别协议 service level agreements
(SLAs)后，队列优先级将用来保证服务级别的正确执行。
Logging in
从顶部菜单点击 Applications
从下拉菜单中单击 Queue Priority
深圳星昊通科技有限公司 www.hiastar.com
311
Adding a Queue Priority
登录后，用户可以看到以下设置选项.
Description
队列优先级描述，我们建议使用任意确认服务级别的名称，例如，VIP-1 Customers。
Priority
队列优先级可以对呼叫方的优先级进行设置，范围可以是从 0-20。默认设置都为 0。高一
点的优先级设置将获得优先被接听的服务。
Destination
根据优先级选择相应的呼叫目的地对象。这里，当呼叫方进入队列后，呼叫方将获得一个
优先级权重。请注意，目的地对象不一定是一个队列，它可以是一个 IVR 或者其他的 PBX 目
的地对象。一旦设置了队列，系统会检查呼叫方优先级设置和呼叫进入的所在队列。确认，摁
“Submit Changes” 按钮保存修改设置。
深圳星昊通科技有限公司 www.hiastar.com
312
队列模块用户使用指南
Introduction
Logging in
Adding a Queue
o Base options
Queue Number
Agent Queue Login in Toggle Mode
Queue Name
Queue Password
Generate Device Hints
Call Confirm
Call Confirm Announce
CID Name Prefix
Wait Time Prefix
Alert Info
Static Agents
Extension Quick Pick
Dynamic Members
Extension Quick Pick
Restrict Dynamic Agents
Agent Restrictions
o Queue General Options
Ring Strategy
ringall
leastrecent
fewestcalls
random
rrmemory
rrordered
linear
wrandom
Autofill
Skip Busy Agents
Queue Weight
Music on Hold Class
Join Announcement
Call Recording
Recording Mode
Caller Volume Adjustment
Agent Volume Adjustment
Mark Calls Answered Elsewhere
o Timing and Agent Options
深圳星昊通科技有限公司 www.hiastar.com
313
Max Wait Time
Max Wait Time Mode
Agent Timeout
Agent Timeout Restart
Retry
Wrap-Up-Time
Member Delay
Agent Announcement
Report Hold Time
Auto Pause
Auto Pause on Busy
Auto Pause on Unavailable
Auto Pause Delay
o Capacity Options
Max Callers
Join Empty
Leave Empty
Penalty Members Limit
o Queue Announcement Options
Frequency
Announce Position
Announce Hold Time
IVR Break Out Menu
Repeat Frequency
o Events Stats and Advanced
Event When Called
Member Status Event
Service Level
Agent Regex Filter
o Fail Over Destination
o Other Option Sections
Editing and Deleting Queues
Introduction
Automatic Call Distribution (ACD) 或者呼叫队列提供了一种对呼入呼叫的管理队列。
队列相当于呼入呼叫的一个队伍排列。当呼入进入到队列后，默认环境下，队列中的呼叫根据
先入先出的方式来应答这个呼叫，其他的呼叫则在队列中等待，直到有空闲坐席接听呼叫。在
队列等待的呼叫则可以听到队列中的音乐播放。队列模块支持用户创建和设计一个队列管理方
式，以便呼叫方可以快速和坐席无缝对接：
深圳星昊通科技有限公司 www.hiastar.com
314
队列组成:
Callers – 队列中的呼叫方
Agents – 应答呼叫方呼叫的队列中的坐席成员 (分机或者用户登录后成为坐席)
Ring Strategy – 队列的管理策略
MoH – 对在队列中等待的呼叫方播放的语音等待
Announcements – 对呼叫方和成员播报的语音
Logging in
从菜单顶部登录 Applications
此下拉菜单中点击 Queues
Adding a Queue
Base options
Queue Number
深圳星昊通科技有限公司 www.hiastar.com
315
通过拨打此号码进入队列，或者转接呼叫方到此号码进入队列。
注意：Agent Queue Login in Toggle Mode
坐席成员通过拨打号码*45 加入到队列中，再次拨打则退出队列。
*45 = 登录队列
*45 = 退出队列
Queue Name
设置一个准确的队列名称。.
Queue Password
可以设置一个坐席队列登录密码，要求坐席登录队列时，输入密码验证。此密码仅在登录
以前的队列。当用户使用了切换代码时。用户必须使用 “Restrict Dynamic Agents” 选项
配合 dynamic members list 来控制访问。
Generate Device Hints
勾选此选项后，系统将为每个 SIP 和 IAX2 设备生成一个单个的 hints 和拨号规则，这些
设置将成为队列的一个部分。这些配置文件可以配合电话机的可编程按键登录或者退出队列，
然后可以生成一个 BLF 状态，这个状态就是当前的坐席状态。
格式为: 45ddd*qqq
这里， “45” 是当前定义的切换功能代码， “ddd” 是设备号码或者分机号码， “qqq”
是队列号码。使用 Aastra 终端话机时，这个控制功能通过 XML 应用来实现，这个应用叫 “ACD
Agents”。这个选项不要求设置为开启状态。如果开启此功能，则会导致加载时间过长，如果
是大型的呼叫中心则影响系统负载。
Call Confirm
如果选择呼叫确认选项，任何队列成员包括离开 PBX 的外部号码，分机随行或者呼叫前转
都将被强制进入一个呼叫确认模式，所有成员在应答或者转发前必须确认认可此呼叫。
深圳星昊通科技有限公司 www.hiastar.com
316
Call Confirm Announce
对队列成员在呼叫确认前播放一个确认提示语音。如果是默认设置，将播放标准的系统默
认呼叫确认语音提示。如果队列成员是通过分机随行连接，分机随行执行可选信息提供的分机
随行提示语音。这个语音提示设置将覆盖其他指定的语音信息。
CID Name Prefix
用户可以在呼叫方的 caller ID name 前添加一个前缀设置。例如，可以添加 “Sales:”，
那么在分机振铃时，分机则则显示为 “Sales:John 。
Wait Time Prefix
当设置为 “Yes” 以后，进入队列的呼叫将添加 CID name 前缀，同时添加一个等待时
间，这样应答的坐席就可以意识到呼叫方的等待时长。这个值通过四舍五入的方式，转换成
“Mnn:” 的方式，这里 “nn” 代表分钟数。如果这个呼叫被继续转发，等待时长将等于第
一次进入队列的时间和再次转接到其他队列的时间。
Alert Info
支持 SIP 设备的 distinctive ring 振铃功能
Static Agents
静态坐席假设总是在队列的分机坐席。静态坐席无需登录队列，不能退出队列。
振铃的分机列表，以每行为单位。
可以包括一个远程分机或外部号码 (呼出路由必须支持这个外部号码)。坐席后添加一
个 “,”，然后加权重的值。
注意：系统已经添加了一个高级模式，支持用户可以对坐席号码添加前缀 S,X,Z,D 或者 A。作
为 Asterisk 内部的终端设备类型 SIP，IAX2，XAP 或者 Dahdi，系统可以强制拨打这些坐席
号码。这个模式仅限高级用户使用，可能引起其 PBX 拨号规则的问题，用户可能绕过了正常
的拨号规则。如果系统用户的 “Agent Restrictions” 没有设置为 “Extension Only”，
系统用户如果转接后，则可能被转入到语音邮箱。
Extension Quick Pick
选择一个分机，追加此分机在以上的静态坐席中。
深圳星昊通科技有限公司 www.hiastar.com
317
Dynamic Members
动态坐席成员是系统的分机或者任何回拨号码，这些坐席可以登录队列或者退出队列。当
成员登录队列后，这里将设置队列中坐席的权重。这里包含的分机将不会自动登录到队列中。
Extension Quick Pick
选择一个分机自动添加到以上的动态成员列表中。
Restrict Dynamic Agents
限制的动态队列成员登录权限仅限于以上的动态成员列表中的成员。如果设置为 “Yes”，
不在名单中的成员将拒绝访问这个队列。
Agent Restrictions
当设置为 “Call as Dialled”，队列会呼叫一个分机，队列可认为是另外一个分机。
分机无论是在分机随行或者前转状态。则导致队列呼叫前转到相应的呼叫路径。
当设置为 “No Follow-Me or Call Forward”，所有系统中的分机坐席仅限定对分
机振铃。分机随行和呼叫前转将被忽略。此时的工作方式类似于对振铃组中的分机拨号。
当设置为“Extensions Only”，队列将对分机拨号，类似于“No Follow-Me or Call
Forward” 模式。其他分机作为坐席登录时可能被完全忽略。无论分机是以静态坐席还是
动态坐席登录队列，系统不提供任何检查认证。如果队列呼叫此坐席时，则被直接过滤。
对动态坐席，用户可以参考 “Agents Regex Filer” ，此配置提供验证方式。
深圳星昊通科技有限公司 www.hiastar.com
318
Queue General Options
Ring Strategy
ringall
对所有坐席振铃，直到有坐席接听（默认设置）。如果使用了权重设置，所有坐席以权重
0 开始来定义振铃时长。振铃时长在“Agent Timeout”中设置，然后执行 1,2,3 等等。
leastrecent
对队列中最近一个接听呼叫的坐席振铃。
fewestcalls
对队列中最少接听呼叫的坐席振铃。
random
对任意坐席振铃。.
rrmemory
记忆轮询振铃 (记忆上次振铃)。
rrordered
工作方式和 rrmemory 类似，但是队列成员的顺序是配置文件预设。
深圳星昊通科技有限公司 www.hiastar.com
319
linear
对坐席振铃，振铃顺序按照设定的顺序进行(对动态坐席来说，振铃顺序按照队列顺序进
行)。
wrandom
任意振铃，同时使用成员的权重作为设置要素。
Autofill
如果勾选此选项，多个坐席有效，PBX 将对每个等待的坐席发送呼叫（取决于振铃策略）。
否则 PBX 一直保持所有的呼叫，直到找到队列中一个有效的坐席发送呼叫，要求其他呼叫在
等待状态。
Skip Busy Agents
当设置 “Yes”，处于忙状态的坐席将被跳过。这里表示呼叫等待或者支持多线的话
机将不会支持这个呼叫。系统则尝试呼叫下一个坐席。
当设置为 “Yes + (ringinuse=no)”状态时，系统将为此队列设置一个队列配置标志
“ringinuse-no”，系统则可以对电话终端的设备状态进行检测。这样的话，队列可以跟
踪远端的坐席的状态（例如远端坐席是模拟电话机，这些坐席通过分机随行接入到队列）。
所以，如果远端的坐席在接听状态时，队列将不会再发送呼叫到此坐席。
当设置为 “Queue calls only (ringinuse=no)”，系统同样设置一个队列配置标志
“ringinuse=no”，但是本地坐席的设备状态将不会被检测。工作方式限定在一个坐席属
于一个或者多个队列中的单个队列呼叫。如果坐席被占用，例如坐席分机发起了呼出呼叫
的话，队列将认为坐席有效，对它们振铃，因为此时坐席设备状态没有检测。
注意：
警告: 当设置 “ringinuse=no” 标志符时，会产生一个负面的影响。转接队列呼叫的坐席在
任何队列中将保持无效状态，直到呼叫被挂机结束。导致这个问题的原因是，因为这个队列仍
然认为是这个呼叫是在 in use 呼叫状态，除非“Agent Restrictions” 设置为 “Extensions
Only”。
Queue Weight
设定队列一个权重选项保证等待的呼叫在队列高优先级状态，坐席可以优先接听呼叫。
深圳星昊通科技有限公司 www.hiastar.com
320
Music on Hold Class
对呼叫方播放队列呼叫等待音乐文件。如果希望音乐等待类别为当前选项，则选择
“inherit” ，例如呼入路由选项。“MoH Only” 将对呼叫方播放音乐等待文件，直到坐席
应答。振铃振铃播放音乐等待，直到坐席电话在线有效。如果坐席无法应答，则返回音乐等待。
“Ring Only” 仅对呼叫方播放振铃音，而不是音乐等待的语音，将忽略任何 MoH 语音列表
设置。音乐等待设置在 “Music on Hold” 菜单中定义。
Join Announcement
在呼叫方进入队列前播放语音提示，提醒呼叫方将加入队列中。如果坐席已经在准备接听
状态时，这个选项可以跳过。如果需要添加自定义录音，请访问 “System Recordings” 菜
单。
Call Recording
录音格式列表：
wav49 - 存储文件小，语音质量好，格式为.WAV 格式。
wav – 未压缩的语音文件格式，为 .wav 格式，文件存储非常大。
gsm – 文件存储大小和语音质量类似于 wav49，但是可能很多设备不支持。
No – 不定义任何利用格式。
Recording Mode
在录音时选择 “Include Hold time”，主要呼叫方进入队列则开始录音，或推迟录音（直
到坐席应答，呼叫方和坐席成员桥接通话以后开始录音）。
Caller Volume Adjustment
调整呼叫方录音增益，从+4 到-4。
Agent Volume Adjustment
调整坐席录音的语音增益，从+4 到-4。
深圳星昊通科技有限公司 www.hiastar.com
321
Mark Calls Answered Elsewhere
开启此选项后，所有取消的呼叫则可以标注为 “answered elsewhere” 。此功能的优点
在于丢失的队列呼叫不会在电话终端上显示（如果电话终端支持此功能）
Timing and Agent Options
Max Wait Time
定义呼叫方最大等待时长（以秒为单位，0 到任何值）。
Max Wait Time Mode
设置一个 PBX 超时优先级。 “Strict” 模式下，当呼叫方的 “Max Wait Time” 设
置到时后，队列立刻将把呼叫方从队列中移出。在 “Loose” 模式下，如果呼叫正在对坐席
成员振铃，PBX 将一直等待直到队列停止对坐席成员振铃，或者呼叫被队列成员拒绝后，队列
将把呼叫方从队列中移出。这里的意思是 “Max Wait Time” 模式可以是 “Max Wait Time”
+ “Agent Timeout” 的组合工作模式。
Agent Timeout
坐席话就的振铃超时时长。可以通过系统振铃时长默认设置来设定或者单独的分机设置，
可选择无限振铃时长或者其他的超时时长。
深圳星昊通科技有限公司 www.hiastar.com
322
Agent Timeout Restart
如果 “timeoutrestart” 设置为 “Yes”，如果收到忙音状态或者拥塞时，设置了超时
的应答坐席重新被设置。这个功能非常实用，如果坐席拒绝呼叫或者其他类似的返回消息发生
时，系统可重新设置超时。
Retry
重试时长设置。如果选择 “No Retry”，第一个尝试的坐席超时，呼叫将直接退出队列，
转入到设置的失效目的地，其他坐席不在尝试。
Wrap-Up-Time
成功呼叫接听后，设置一个唤醒时长。此时间后，再次发生呼叫到坐席 (默认是 0 或者
无延迟)。用户可以访问高级设置中的“Honor Wrapup Time” 来管理坐席的多队列登录。
Member Delay
设置一个时间延迟，坐席成员延迟连接呼叫方 (或者坐席听到任何语音提示前)，设置延
迟时间，以秒为单位。
Agent Announcement
对坐席播放一个语音提示，提示坐席将接听呼叫方呼叫。
注意：
例如： “以下呼叫是来自于销售呼叫队列” 或者“此呼叫来自于技术支持呼叫队列”。
如果添加其他的自定义录音，请使用系统录音菜单添加。不能使用多个合成文件播放。使
用单个文件播放。
Report Hold Time
如果需要对呼叫方播报呼叫方接通通话的保持时间，则设置为“Yes”。
Auto Pause
如果队列中的坐席暂时不想应答呼叫，则设置自动暂停。暂停工作模式可以通过 “Auto
Pause Delay” 或者 “Auto Pause Busy/Unavailable” 设置。
深圳星昊通科技有限公司 www.hiastar.com
323
Auto Pause on Busy
如果设置为 “Yes” 状态，坐席设备将对接下来的呼叫报告忙状态，视为未接呼叫。
Auto Pause on Unavailable
如果设置为 “Yes” 状态，如果有尝试呼叫进入，坐席设备将报告拥塞消息，呼叫被认
为是未接呼叫。
Auto Pause Delay
设置一个自动暂停延迟时间。PBX 设置一个延迟时间，从坐席上次接听呼叫以后算起。例
如，这里设置了 2 分钟的时长，如果坐席没有应答呼叫，坐席应答了上一次呼叫后，此时一个
新的呼叫已经对此坐席保持了 1.5 分钟状态，那么坐席不能变成自动暂停状态。如果坐席应答
了上次呼叫后，此时这个呼叫已经对坐席保持了 2 分钟的状态，那么坐席将可以启动自动暂停。
如果坐席没有接听任何呼叫的话，此设置将不会有效。
Capacity Options
Max Callers
定义这个队列中允许最多等待的呼叫方用户。0 代表无限制。
Join Empty
是否允许新的呼叫方加入这个队列。如果不允许的话，马上启用失效转移目的地。可选参
数包括：
Yes – 总是允许呼叫方加入此队列。
Strict – 和 “Yes” 一样的作用，但是限定更为严格。简单来说，如果没有坐席可
以应答此呼叫，则不允许加入这个队列。如果坐席被占用，或者正在对其他呼叫方振铃，
呼叫方仍然可以加入此队列。
深圳星昊通科技有限公司 www.hiastar.com
324
Ultra Strict – 严格限制，作用和“Strict”一样，但是队列成员必须现在可以应
答此呼叫，才能让呼叫方加入队列中。简单来说，有效坐席可以应答此呼叫，但是当前这
个坐席在通话状态或者对另外一个呼叫方振铃状态，另外这个呼叫方可能被认为是无效的
呼叫方。
No – 如果坐席处于暂停状态，呼叫方不能被允许加入队列中，此时坐席的设备状态
可能是无效状态或 penalty 的值低于 “QUEUE_MAX_PENALTY” 的值。
Loose – 和 “NO” 选项一样的功能，除了如果有暂停状态的坐席可能变为有效状态，
那么可以允许呼叫方加入队列。
Leave Empty
当队列中无有效坐席时，呼叫方是否从队列中退出。可选参数包括：
Yes – 呼叫方退出队列，坐席处于暂停状态，设备显示处于无效状态，或者坐席设备
的 penalty 值低于“QUE_MAX PENALTY”设置。
Strict – 工作方式类似于 “Yes”，但是更加严格。简单来说，如果没有坐席应答
呼叫则退出队列。如果坐席处于在使用状态或正在对其他呼叫方振铃，则呼叫方仍然继续
等待应答。
Ultra Strict – 严格限制，工作方式类似于“Strict” ，但是队列成员必须现在可
以应答呼叫。简单来说，任何有效的坐席可以应答呼叫但是所有坐席处于应答状态或者正
在对某些呼叫方振铃，可能这些呼叫方处于无效状态。
Loose – 和 “Yes”的工作方式类似，但是呼叫方将一直在队列等待，如果暂停的坐
席变为有效状态后应答。
No – 从来没有任何呼叫方退出队列，直到 “Max Wait Time” 时间设置过期。
Penalty Members Limit
一个限定设置可忽略 penalty 设置，当队列中仅有少数几个坐席时，所有成员可以尝试。
如果队列成员仅为“X”或者很少成员时，无需考虑 penalty 的权重设置。
深圳星昊通科技有限公司 www.hiastar.com
325
Queue Announcement Options
Frequency
定义对呼叫方播放队列中位置和剩余保持时间的语音提示周期 (0 则为关闭播放语音提
示)。
Announce Position
播报呼叫方在队列中的位置。
Announce Hold Time
预估一个在队列中的保持时间：可以是 “Yes,” “No” 或者 “Only once”。如果保
持时间少于 1 分钟，则不播报。
IVR Break Out Menu
可以提供一个系统的 IVR 作为一个退出语音菜单。
这个 IVR 必须只能包括一个数字的菜单选项。IVR 重复播放周期在以下的 “Repeat
Frequency” 设置。
Repeat Frequency
对呼叫方播报 IVR 语音菜单的周期 (0 则关闭语音 IVR)。
深圳星昊通科技有限公司 www.hiastar.com
326
Events Stats and Advanced
Event When Called
当设置此选项为“Yes”，以下 manager events 将生成: AgentCalled, AgentDump,
AgentConnect 和 AgentComplete。如果用户使用商业模块 QXact Reports, Xactview 或
iSymphony 需要安装。.
Member Status Event
当设置为 “Yes”，以下 manager event 将生成: QueueMemberStatus。
Service Level
用来支持服务级别统计（service level statistics），在服务级别时间段内应答的呼叫
数量。
Agent Regex Filter
设置一个正则表达式匹配坐席回拨的号码。如果回拨号码匹配此正则表达式失败，系统将
视为无效号码。这个设置可以用来限定坐席号码，这些坐席号码在一定的分机号段，不能允许
回拨号码包括按键 “*” 或者其他的使用格式。
例如:
([2-4][0-9]{3})$- 限定坐席分机分机号码段为 2000-4999。
([0-9]+)$- 可以支持任何号码长度，但是限定了* 键。
注意：警告：使用正则表达式前必须明白语法规则，否则不要填写。
深圳星昊通科技有限公司 www.hiastar.com
327
Fail Over Destination
如果呼叫超时，或者呼叫方退出队列，转发呼叫方到指定一个呼叫失效目的地。
Other Option Sections
商业模块，例如 QXact Reports, Xactview 或者 iSymphony 可能和队列模块相关联。坐
席模块安装时需要参考相关的商业模块使用指南。
Editing and Deleting Queues
用户可以点击编辑或者删除已创建的队列。
振铃组模块用户使用指南
Overview
Logging In
Adding a Ring Group
o Group Description
o Ring Strategy
ringall
hunt
memoryhunt
*-prim
firstunavailable
firstnotonphone
o Extension List
o Announcement
o Play Music On Hold
o CID Name Prefix
o Alert Info
o Ignore CF Settings
o Skip Busy Agent
o Enable Call Pickup
o Confirm Calls
o Remote Announce
o Too-Late Announce
o Change External CID Configuration
Default
Fixed CID Value
Outside Calls Fixed CID
Use Dialled Number
Force Dialled Number
深圳星昊通科技有限公司 www.hiastar.com
328
o Fixed CID Value
o Call Recording
Always
On Demand
Never
o Destination if no answer
Save
总览
振铃组对组内分机提供了多种的振铃方式。振铃组可以支持了几个非常实用的功能，例如
语音播报提示，CID 名称前缀，呼叫确认和其他功能。振铃组可以包括本地分机和 DID 号码（系
统外呼呼叫）。
Logging In
从菜单顶部点击 Applications
从下拉菜单中点击 Ring Groups
Adding a Ring Group
深圳星昊通科技有限公司 www.hiastar.com
329
Group Description
振铃组的描述。
Ring Strategy
从以下选项中选择一种振铃方式：
ringall
对所有有效通道振铃，直到有用户接听此呼叫。这是默认设置。
hunt
对每个有效的分机循环振铃。
memoryhunt
对列表中的第一个分机振铃。第一个分机振铃后，则第二个开始振铃，然后第一个，第二
个和第三个分机振铃。
*-prim
列表中的第一个分机是主要分机，主要分机的标志符会修改主要分机的工作方式。如果设
置为此方式，并且主要分机的状态是 “被占用或者 FreePBX DND 设置” 状态，其他分机将
不会振铃。如果设置 primary 为 “FreePBX Call Forward Unconditional”，则所有分机将
振铃。
firstunavailable
仅对第一个有效通道振铃。
firstnotonphone
仅对第一个显示在摘机状态，忽略呼叫等待的通道振铃。
Extension List
每一行的分机列表振铃或者使用 “Extension Quick Pick” 快速插入。用户可以包括一
个远端的分机或者外部号码带一个后缀 “#”。例如， “3609319999#” 将路由到外呼的路
深圳星昊通科技有限公司 www.hiastar.com
330
由模式，支持 10 个号码数字呼出，或者拨打 “2000#” 将路由到远端服务器呼入号码，远端
服务器来匹配 “2XXX” 的呼叫。
分机如果没有带后缀字符 “#” 将不会对分机随行振铃。如果需要拨打分机随行或者其
他不是本地分机的号码，则需要加 “#” 结束字符。
Announcement
对振铃组振铃前播放语音提示。参考系统录音模块获得更多关于录音的设置。
Play Music On Hold
默认设置是对呼叫方振铃，系统也可以支持一个音乐等待类别播放音乐等待语音，而不是
默认的振铃。
CID Name Prefix
当对实际系统的分机振铃时，对振铃分机显示一个添加的前缀。例如，前缀是 “Sales:” ，
caller ID 是 John Doe，那么振铃分机会显示 “Sales: John Doe”。
Alert Info
对振铃分机发送 ALERT_INFO 消息来支持终端的 distinctive ringing 方式。
Ignore CF Settings
如果勾选此设置，呼叫前转的坐席将被忽略。这个选项将支持了 CF， CFU 和 CFB 3 种
方式。输入的分机以字符 “#” 结束，例如分机的分机随行模块，或者其他模块。
Skip Busy Agent
当勾选此选项时，被占用的坐席将被忽略。设置了呼叫等待或者多线路话机将不会支持支
持这个呼叫和其他的振铃策略，下一个坐席将振铃。
Enable Call Pickup
如果开启此选项，则允许用户通过组号码使用直接抢接的功能来接听振铃组呼叫。当没有
勾选时，组内单个分机通过拨打抢接号码来对振铃的分机抢接呼叫。无论是否勾选，这个功能
都将工作。
深圳星昊通科技有限公司 www.hiastar.com
331
Confirm Calls
选择此设置表示如果正在呼叫一个外部号码，则需要对端确认此呼叫。如果开启此功能，
则要求对端需要输入按键 1 来确认这个呼叫，然后呼叫才可以被对端接听。注意，这个功能仅
支持 “ringall”的振铃策略。
Remote Announce
如果确认呼叫功能开启，则对确认呼叫方播放语音提示信息。
Too-Late Announce
如果呼叫确认方在输入 1 按键前，呼叫已经被接受，则对呼叫接收方播放语音提示。
Change External CID Configuration
选择以下模式：
Default
如果中继允许，默认发送呼叫方的 CID。
深圳星昊通科技有限公司 www.hiastar.com
332
Fixed CID Value
如果用户设置了”Fixed CID Value”，总是发送此值。
Outside Calls Fixed CID
如果呼叫是从外部呼入，总是发送 “Fixed CID Value” 的输入值。内部分机对分机的
呼叫仍然在默认模式下工作。
Use Dialled Number
使用从外部呼入的已拨号码作为 CID 发送。内部分机对分机呼叫仍然在默认下工作。对
此选项来说，必须在呼入路由处设置了 DID 号码。这里将过滤号码，这个号码过滤是设置在中
继对国外 caller ID 过滤中。
Force Dialled Number
强制使用外部呼入的已拨号码作为 CID 发送。内部分机对分机呼叫仍然在默认模式下工作。
这里必须在呼入路由处设置一个 DID。这个号码通过中继发送，这个中继将过滤国外的 Caller
ID。
Fixed CID Value
需要设置 “Fixed CID 则输入一个值。仅支持+数字，使用的是 E164 号码格式。
Call Recording
Always
总是录音.
On Demand
支持接收呼叫的用户执行按需录音，通过切换功能代码来实现录音。默认设置为 1。
Never
从不录音，并且关闭了接收呼叫分机的按需录音功能。
深圳星昊通科技有限公司 www.hiastar.com
333
Destination if no answer
如果振铃超时，系统将发送此呼叫到设定的目的地对象。大部分情况下，设置为另外一个
分机或者语音邮箱。
Save
完成修改后点击提交，然后点击“ Apply Changes”工具条。
订阅 BLF 检测语音邮箱
过去的 Asterisk 版本不支持通过订阅 BLF 服务来检测管理语音邮箱。
如果用户使用 FreePBX 2.11 以上版本，用户可以订阅 BLF 服务。
每个邮箱将自动创建一个 hint （hint 是 asterisk 的映射方法匹配拨号规则）。
如果登录 Asterisk CLI 命令，可以通过命令查看邮箱信息：
localhost*CLI> core show hints
-= Registered Asterisk Dial Plan Hints =-
*98101@app-dialvm : MWI:101@default State:Idle
Watchers 0
在这个例子中，语音邮箱 101 已经支持了一个 hint ，用户可以通过拨打*98101 或者
通过系统程序访问 BLF 服务。
如果 101 语音邮箱有一个或多个新语音信箱加入到语音邮箱中，终端话机的指示灯会闪
烁。
用户摁 BLF 按键可以通过输入密码访问语音邮箱 101。
TTS(语音合成) 引擎用户使用指南
Overview
Logging in
Adding an Engine
o Engine Name
o Engine Path
o Save
深圳星昊通科技有限公司 www.hiastar.com
334
总览
TTS（语音合成）引擎模块支持用户在系统中添加第三方的语音合成引擎。用户需要安装
支持模块来支持 PBX 提供有效路径，文本输入和语音引擎的语言设置。
注意：默认环境下，TTS 引擎已经安装 flite 语音引擎。大部分商业的语音合成引擎需要用户
购买许可证才能使用。
Logging in
从顶部菜单点击 Settings
从下拉菜单中点击 Text to Speech Engines
Adding an Engine
Engine Name
输入 TTS 引擎名称。
Engine Path
语音合成引擎的完整路径。
Save
点击提交保存。
TTS 语音合成模块用户使用指南
Overview
Logging In
Adding a Text to Speech
o Name
深圳星昊通科技有限公司 www.hiastar.com
335
o Text
o Choose TTS Engine
o Destination
总览
TTS 模块支持用户在 PBX 中添加一个 TTS 实例。当用户设置了呼叫路径后，需要将根据输
入的文本内容播放 TTS 合成的语音。呼叫将会继续路由到实例中定义的目的地。
注意：语音合成播放的提示音完全依赖于语音合成引擎的对文本内容的解析结果。例如，如果
输入的文本是数字 0，但是可能经过语音合成的结果播放的是 “Oh”，而不是 “0”。
Logging In
从菜单顶部点击 Applications
此下拉菜单中点击 Text to Speech
Adding a Text to Speech
Name
输入 TTS 引擎名称。
深圳星昊通科技有限公司 www.hiastar.com
336
Text
输入希望合成的文本内容。
Choose TTS Engine
从语音引擎的列表中（通过语音引擎模块设置）选择引擎来合成语音文件。
Destination
TTS 语音合成文件播放以后，选择一个最终的呼叫目的地。
唤醒呼叫用户使用指南
Overview
Logging in
Usage
o Adding a call from the UI
Destination:
HH:MM
DD/MM/YYYY
Schedule
o Removing a call from the UI
o Module Configuration
Operator Mode
Max Dest Length
Operator Extensions
Ring Time
Retry Time
Max Retries
Wake Up Caller ID
深圳星昊通科技有限公司 www.hiastar.com
337
o System Settings
总览
唤醒呼叫模块支持系统定时呼叫系统设置的有效目的地对象。使用定时呼叫，用户可以拨
打 FreePBX的功能代码模块中的代码*68来设置这个时间，或者通过界面来设置唤醒呼叫功能。
系统可以开启接线员模式支持 PBX 接线员定时设置呼叫功能，在设置的时间点，系统呼叫其
他分机或者其他目的地号码。
Logging in
从菜单顶部点击 Applications。
从下拉菜单中选择 "Wakeup Calls"。
Usage
Adding a call from the UI。
Destination:
拨打的目的地号码。
HH:MM
小时:分钟
Minutes (00-59)
DD/MM/YYYY // 日期格式为天/月/年
Day:
MONTHS DAYS
January, March, May, July, August, October, December 1-31
April, June, September, November 1-30
深圳星昊通科技有限公司 www.hiastar.com
338
February *29 is for leap years 1-29*
Month:
The month 01-12
Year: The 4 digit year ex: 2014
Schedule
点击保存。
Removing a call from the UI
添加定时呼叫后，显示定时呼叫列表：
点击删除可以删除 Delete 设定的定时呼叫。
Module Configuration
深圳星昊通科技有限公司 www.hiastar.com
339
Operator Mode
默认环境下，唤醒呼叫是通过回拨系统预设的号码，在设置的时间点，回拨指定的预设号
码。当开启接线员模式后，某些号码可以允许设置回拨号码功能。
Max Dest Length
目的地号码长度。例如分机 1234 则为 4。
Operator Extensions
接线员分机（分机号码支持接线员模式）。
Ring Time
对目的地振铃时长。
Retry Time
重试时长。
Max Retries
最大重试数量。
Wake Up Caller ID
如何在 caller ID 显示唤醒呼叫通话。
System Settings
显示系统日期/时间信息。
深圳星昊通科技有限公司 www.hiastar.com
340
自定义目的地模块使用指南
Overview
Logging In
Creating a Custom Destination
o Custom Destination
o Destination Quick Pick
o Description
o Notes
o Save
Using Custom Destination
总览
自定义呼叫目的地模块支持用户注册一个自定义的呼叫目的地设置，自定义的呼叫目的地
可以指定到自定义的拨号规则中，同时可以设置自定义呼叫目的地作为其他模块的呼叫目的地。
使用注意事项
这个高级选项用来支持 PBX 的自定义热键码，此功能仅限于有一定使用经验的用户。
Logging In
菜单顶部点击 Admin
下拉菜单中点击 Custom Destinations
Creating a Custom Destination
用户可以参加自定义的拨号规则目的地，按照以下设置处理：
深圳星昊通科技有限公司 www.hiastar.com
341
Custom Destination
定义自定义的拨号规则，这个拨号规则将路由呼叫方到相应的标签组
[context],[exten],[priority]。例如: “afterhours-pin,501599,1,” PBX 将引导呼叫方
进入自定义的 “After Hours Pin” 拨号规则中。
Destination Quick Pick
下拉选项支持各种不同环境的选项。
Description
提供一个描述命名，例如: "My cool Script"。
Notes
对这个自定义的拨号规则或者脚本定义一个提示标志。
Save
不要忘记点击 "Submit Changes" ，完成以后，点击红色的 "Apply Changes at the top" 。
Using Custom Destination
在一些支持呼叫目的地的模块中，用户可以选择 "destinations" ，例如 IVR, 队列，呼
入路由等等。用户可以看到以下选择：
深圳星昊通科技有限公司 www.hiastar.com
342
下拉菜单中，选择 "Custom Destinations" ，然后选择用户创建的自定义目的地。
DAHDI 通道 DIDs 使用指南
Overview
Logging In
Mapping a channel to a phone number
o Channel
o Description
o DID
o Save
总览
模拟通道 DIDs 允许用户指定一个 DID 号码或者电话号码给指定的模拟通道。不像 SIP 或
者 PRI 中继，模拟线路不会发送一个 DID 或者已拨号码到 PBX。因为所有的 PBX 路由都是基于
呼入 DID 或者已拨号码，所以我们需要映射某个模拟端口或通道来克隆出一个电话号码，通过
这个号码匹配来做呼入的路由。某个通道可以对应一个相应的模拟号码，这个号码就是客户拨
打的目的地号码。
注意：
在旧版本的系统中，通道可能称之为 "Zap Channel DIDs"。
这里的 DID 不要和特别场景的 DID 就是混淆，例如一些特别的社会服务号码 911 CAMA
circuits。
Logging In
深圳星昊通科技有限公司 www.hiastar.com
343
从菜单顶部点击 Connectivity
从下拉菜单中点击 DAHDI Channel DIDs
Mapping a channel to a phone number
注意：配置文件中的 Dahdi 通道必须设置为 from-analog
Channel
首先我们需要定义通道号码。如果我们的卡是 4 端口的模拟卡，我们的通道对应的端口应
该是 1-4。
Description
定义一个通道名称描述。
DID
这里就是实际的 DID 设置。这个 DID 号码将被透传到呼入路由，所以必须确认这里定义的
号码和呼入路由定义的号码一致。如果这里设置为 9898，那么在呼入路由的 DID 设置中也要
设置为 9898。
注意：如果设置了所有的 4 个模拟线路呼入路由为同样的目的地，例如振铃组等等，用户可以
为这 4 个模拟通道设置同样的 DID 号码。所以用户仅需要在 PBX 中创建一个呼入路由，因为 4
个模拟线路的号码是一样的。
Save
完成输入以后，按 Submit Changes 按钮。
深圳星昊通科技有限公司 www.hiastar.com
344
DAHDI 语音板卡配置指南
Overview
Logging In
General Settings
o Global Settings
Select Language
Enable Busy Detect
Busy Detect Count
Use Caller ID
Enable Call Waiting
User Caller ID Presentation
Enable Three Way Calling
Enable Transfer- Support flash
Enable Call Forwarding
Enable Call Return
Enable Echo Cancelling
Enable EC when Bridged
Enable Echo Training
Answer Immediately
Fax Detection
Receive Gain
Transmit Gain
Other Global DAHDI Settings
o System Settings
Tone Region
Other DAHDI System Settings
o Modprobe Settings
Module Name
Custom Settings
o Module Settings
o Sangoma Settings
Run Wanpipe in DAHDI/DIGIUM Mode
T1 Mode
Digital Card Setup
o T1/E1/PRI and BRI Settings
General Settings
Group Settings
o GSM Card
General Settings
Group Settings
Analog Card Setup
o FXO
深圳星昊通科技有限公司 www.hiastar.com
345
o FXS
o FXO Channel Setup
o FXS Channel Setup
总览
DAHDI 模块设计的目的是用来管理语音卡的配置。目前，这个模块了 Sangoma，Digium,
OpenVox, Rhino 的语音卡。DAHDI 是语音卡的驱动，作为连接 PBX 的接口卡，包括模拟卡，
数字卡和 2B+D 数字卡。
登录
从菜单顶部点击 Connectivity
在下拉菜单中点击 DAHDI Config
注意:当用户第一次登陆到 DAHDI 模块时，系统将给出一个提示信息，如果用户继续执行开启
模块的流程，手动配置的文件或者默认配置文件可能被覆盖。
深圳星昊通科技有限公司 www.hiastar.com
346
点击 Enable 按钮就会开启 DAHDI 模块，并且系统自动检测系统已经安装的语音卡。如果
已经开启了语音板卡模块，将不会显示提示。
基本设置
基本设置负责对板卡的全局变量进行设置。大部分用户的系统不会修改这些基本设置，如
果修改的全局变量的话，可以手动修改这些文件。
几个主要类别的设置包括
Global Settings
System Settings
Modprobe Settings
Module Settings
Sangoma Settings
深圳星昊通科技有限公司 www.hiastar.com
347
Global Settings
全局变量的设置主要是针对 Asterisk 应用层来进行设置，通常情况下不会做任何的修改，
如果需要做修改的话，可以在/etc/asterisk/chan_dahdi.conf 中添加一个包含文件，把用户
修改的参数设置添加到包含文件中。
Select Language
选择一个对 DAHDI 的语言支持，通常情况下默认设置，不会修改。
深圳星昊通科技有限公司 www.hiastar.com
348
Enable Busy Detect
忙音检测对 FXO 相当有用，开启这个参数设置对其线路进行忙音检测，可以避免 FXO 的咬
线问题，或者挂机信号等等问题。开启此参数以后，系统通过检测线路的挂机语音信号，监听
线路的提示音，然后挂机。
Busy Detect Count
如果开启此选项，系统将检测挂机之前的检测忙音的次数。默认环境设置为 3, 但是可以
调整到 6 甚至于 8。数字越大，代表在挂机之前检测到时间越长，但是如果设置为小一点的数
字，则可能出现随机挂机的现象。.
Use Caller ID
是否启用 caller ID
Enable Call Waiting
是否对内部分机开启呼叫等待功能。如果设置为 “yes,” 在忙状态的分机将听到呼叫等
待音，可以使用拍叉簧的方式在呼叫用户之间进行呼叫切换。
User Caller ID Presentation
是否对外呼启用 caller ID presentation 服务。
Enable Three Way Calling
对 FXS 分机开启 3 方通话。
Enable Transfer- Support flash
开启拍叉簧转接。
Enable Call Forwarding
开启呼叫前转。
Enable Call Return
是否支持从运营商侧使用回呼热键 *69 。
深圳星昊通科技有限公司 www.hiastar.com
349
Enable Echo Cancelling
注意:如果语音板卡本身支持了硬件回声，这里只能设置为打开或者关闭。没有其他的设置选
项可以选择。如果在内核底层已经开启了回声抑制模块，底层设置具有优先级，可以自动覆盖
dahdi 编译时附带的软件回声抑制模块。
Enable EC when Bridged
通常情况下，在同一个 TDM 电路路径中没有必要使用回声。但是如果一些环境发生改变时，
则可能需要开启 echo，例如 TDM 桥接环境中。
Enable Echo Training
在很多情况下，当呼叫开始时，如果有回声情况发生时，回声抑制模块不能很快学习适应
这个环境。如果开启了 echo training 的话，可能引起语音板卡驱动程序 DAHDI 对此通道有
非常短暂的静音，模块会发送一个脉冲信号，通过这个脉冲信号对回声模块反馈一个预设的学
习响应，回声模块就可以很快启动，同时支持一个接近于实际回声学习过程，这样让用户不会
感觉到有静音状态发生，同时会缩短学习过程。此参数可以设置为 "yes," "no" 或者一个延
迟的值（以毫米为单位）。在有一些环境中，设置了 echo training 可能导致更糟糕的回声
结果！如果用户需要排查回声问题，可以先试试开启或者关闭此设置，通过设置不同的值，使
用一个最佳的值。注意，这些设置不适应于硬件回声抑制模块的参数。
Answer Immediately
指定这个通道是否马上应答这个呼叫，或者简单转接到其他的应用程序，例如 IVR 或者读
取 TDMF 等等。
Fax Detection
是否支持传真检测功能，启用此模块系统会判断这个呼叫是否是语音呼叫还是传真服务。
选项包括 “yes,” “no,” “incoming” 和 “outgoing.” 除非需要检测传真服务，则
设置为 Yes, 并且设置为“Incoming”，否则我们建议设置为 “no”。
Receive Gain
接收增益，以 db 为单位。正数是提高通道的音量，负数是降低通道音量。
深圳星昊通科技有限公司 www.hiastar.com
350
Transmit Gain
发送增益，以 db 为单位。正数是提高通道的音量，负数是降低通道音量。
其他板卡全局变量设置
这里可以对语音板卡的其他变量进行自定义设置，使用自定义变量前必须了解相关设置信
息。
注意:修改以后，必须点击一下按钮
然后摁页面底部的按钮 Load DAHDI/Asteirsk 。以上相关不要去重新启动 Asterisk 或者
DAHDI。
System Settings
这个配置选项支持用户对 DAHDI 路径下的 system.conf 文件进行设置。用户基本上无需
对此设置进行修改，除非高级用户了解文件配置，需要对设置做出特别的修改。.
深圳星昊通科技有限公司 www.hiastar.com
351
Tone Region
选择一个最接近本地国家的语音设置格式。
Other DAHDI System Settings
如果客户有自定义的配置文件，可以在这里添加。用户必须了解自定义选项的含义和使用
功能。否则请咨询相关技术人员。
注意:修改以后，需要点击以下按钮.
然后摁 Restart DAHDI/Asterisk 按钮。修改这些参数以后，需要重新启动 Asterisk 或
者 DAHDI，所有正在进行的呼叫可能丢失。
Modprobe Settings
Modprobe Settings 来控制 Linux 操作系统中的板卡驱动管理。用户可以修改内核空间
的选项中的值。不同板卡的型号有不同的值设置，用户应该了解自己正在使用的板卡，也仅能
深圳星昊通科技有限公司 www.hiastar.com
352
修改自己面前安装的板卡选项，请按照硬件厂家的安装指导对相应的测试进行设置。如果不在
北美地区的话，请咨询厂家技术人员来设置这些选项。更多 linux 内核空间的驱动加载命令使
用情况，请查询 linux modprobe 命令。
Module Name
指定目前内核空间安装的驱动名称，目前默认的是模拟板卡，如果用户安装了其他型号的
板卡，请修改到相应的型号。根据板卡型号的不同，有相应的设置选项，请联系硬件厂家获得
详细技术资料。
Custom Settings
Lastly you can include new custom modules at the bottom of the file.
注意:修改以后，请点击以下提示条。
摁 Restart DAHDI/Asterisk 按钮。修改以上配置将要求重新启动 Asterisk 和 DAHDI，
所有正在进行的呼叫可能丢失。
Module Settings
在这个模块设置中，用户可以定义安装的语音卡驱动。默认环境下，系统将加载目前经常
使用的语音板卡驱动，用户可以关闭不需要的驱动程序或者修改驱动加载顺序。
深圳星昊通科技有限公司 www.hiastar.com
353
点击以后，用户可以看到所有自动加载的板卡驱动程序。
深圳星昊通科技有限公司 www.hiastar.com
354
用户可以从列表中关闭一些不需要的驱动程序。在现在的例子中，我们已经关闭了一些驱
动程序。然后点击保存。
用户也可以拖拉驱动程序，重新配置加载的顺序。注意，在一些特殊环境中需要类似的设
置，否则无需修改。现在用户可以看到 zaphfc 驱动程序已经上移到了顶部。
注意:完成所有修改，请必须点击以下提示条。
深圳星昊通科技有限公司 www.hiastar.com
355
然后摁 Restart DAHDI/Asterisk 按钮。修改以上配置要求重新启动 Asterisk或者 DAHDI，
正在进行的呼叫可能丢失。
Sangoma Settings
Sangoma Settings 部分仅仅对 Sangoma 语音卡进行设置。因为 Sangoma 语音卡有自己的
板卡驱动程序，所以用户需要通过此设置来管理这些参数。
Run Wanpipe in DAHDI/DIGIUM Mode
如果用户同时在此系统中安装了其他厂家的语音卡，用户需要设置此选项为 Yes。
T1 Mode
选择语音卡的支持模式，分别为 T1 或者 E1 模式，中国为 E1 模式。.
注意:修改所有配置以后，请点击界面显示的以下按钮.
深圳星昊通科技有限公司 www.hiastar.com
356
摁 Restart DAHDI/Asterisk 按钮。修改以上参数以后，要求重新启动 Asterisk或者 DAHDI，
所有正在进行的呼叫将可能丢失。
Digital Card Setup
在这个例子中，用户可以看到所有的 PRI，BRI 和 Sangoma 的 GSM 语音卡。 这个系统中，
我们安装了一张 Digium T1 Card,2 张 Sangoma 2 Port BRI 卡和一张 Sangoma GSM 卡.
点击每一张卡的编辑按钮可以对板卡的配置进行编辑。这些板卡的设置是动态的设置，根
据板卡的不同会有不同的设置环境。点击添加相应的参数，保存设置。
T1/E1/PRI and BRI Settings
General Settings
用户可以根据不同的运营商环境，对板卡进行设置，包括了 signaling 和 switch type，
增益等等。
深圳星昊通科技有限公司 www.hiastar.com
357
Group Settings
当设置语音卡时，用户可以把通道分拆成不同的组，例如 g0 代表组 0。在我们的例子中，
我们把 digium 设置卡 1 口设置为 group 0。我们把 Sangoma BRI 卡的 2个端口设置为 group 1.
最后把 Sangoma GSM 卡设置为 group 2。用户可以指定任何端口到任意一个组。最后，在
FreePBX 创建中继时，可以根据不同的路由规则选择不同的中继组。
GSM Card
General Settings
在 GSM 卡设置中，可以定义 signalling type 和并且调整通道的语音增益。
深圳星昊通科技有限公司 www.hiastar.com
358
Group Settings
当用户设置语音卡时，可以把通道分拆成不同的组来进行管理，例如设置 g0 代表 group
0。在我们的举例中，我们设置了端口 1 为 0，同样设置了 sangoma BRI 卡为 group 1，最后
设置了 GSM 卡为 group 2. 。然后在中继界面设置相应的呼出路由。
注意：用户同样可以对通道分拆，并且设置成一个通道范围支持不同的组，支持不同的公司或
者不同的部门。
Analog Card Setup
模拟卡显示的端口在 “Analog” 部分。这些端口可以是 FXO 或者 FXS。
FXO
FXO 用来连接运营商的电话线。
深圳星昊通科技有限公司 www.hiastar.com
359
FXS
FXS 用来连接公司 PBX 的物理电话机或者传真机。
在这个实例中，我们的语音卡支持了 FXS 和 FXO 模块。Dahdi 语音板卡驱动将首先加载数
字语音卡，然后再加载模拟语音卡，在加载数字语音卡时，设置了数字语音卡的通道从 1 开始，
一直累加上去，所以模拟语音卡的通道是从数字语音卡的通道以后开始累加。在下面的例子中，
我们可以看到 FXO 端口是从 125-128 ，FXS 是从 121-124。
FXO Channel Setup
点击相应端口的编辑按钮，界面会显示相应的端口配置参数。现在用户看到的是在一个组
0 内的端口。
深圳星昊通科技有限公司 www.hiastar.com
360
signalling can 可以是 “Kewl Start” 或者 “Loop Start” ，但是大部分环境下使
用的是 “Kewl Start"。context 必须是 “from-analog”，所以一般情况下不会修改，除
非用户需要自定义，并且了解修改后的系统状态。
深圳星昊通科技有限公司 www.hiastar.com
361
这里，因为我们已经设置了 0-2 的组支持了 Digium 数字卡，因此，我们设置 3 FXO 端
口在 Group 3。如果这样设置的话，我们总是让 PBX 先尝试呼叫 groups 0-2，如果设置卡呼
叫失败，则尝试 group 3。
FXS Channel Setup
点击 “Edit” 按钮，会显示相应的 FXS 设置配置，这里我们还是选择默认的
“Kewl Start”。
所有的 FXS 设置以后，如果 PBX 创建分机时，可以选择这些 FXS 来创建系统需要的分机，
这些 FXS 将映射到 PBX 的一个分机号码。
深圳星昊通科技有限公司 www.hiastar.com
362
注意：这里完成了所有卡的设置，用户需要创建相应的中继路由来管理呼叫。用户在创建中继
呼出时，会显示我们相应的 dahdi 中继线路。用户只要选择相应的组就完成了 dahdi 的中继设
置。
分机模块 – 语音卡 FXS 分机
Overview
Logging in
Adding a DAHDI Extension
o Extension Number
o Display Name
o CID Num Alias
o Sip Alias
Extension Options
o Outbound CID
o Ring Time
o Call Forward Ring Time
o Outbound Concurrency Limit
o Call Waiting
o Internal Auto Answer
o Call Screening
o Pinless Dialling
o Emergency CID
深圳星昊通科技有限公司 www.hiastar.com
363
o Queue State Detection
Device Options
o Channel
o Parking Lot
Optional Destinations
o No Answer
o Busy
o Not Reachable
o CID Prefix
总览
这个配置文件管理语音卡分机的设置。
注意：DAHDI 分机需要安装语音卡硬件板卡。
登录
从菜单顶部点击 Applications
从下拉菜单中点击 Extensions
添加一个新 FXS 分机
点击设备选项，从设备选择选项中选择需要的设备类型。.
选择 Generic CHAN DAHDI Device
点击 Submit
深圳星昊通科技有限公司 www.hiastar.com
364
用户会看到一个新的分机页面
Extension Number
分机号码关联用户，一旦保存以后，不能被修改。在我们的举例中，我们设置为 “5000”。
我们建议用户设置分机号码时选择 3 或者 4 位数的分机号码。
Display Name
这个名词关联分机号码，可以在任何时候做相应的修改。这个名称将是用户的 Caller ID
Name。
CID Num Alias
CID Number 号码是在系统内部使用作为一个别名，可以和分机号码有所区别。这个号码
的功能把分机可伪装成为另外一个用户。经常使用的例子是公司的技术支持团队。他们希望他
们的内部号码显示为一个标准的技术支持号码在振铃组或者队列中使用。但是这个号码不会对
外部呼叫有任何影响。
Sip Alias
如果需要支持内部的直接呼叫 SIP 用户功能，或者进行 SIP 匿名呼叫，可以设置一个容易
记忆的名称，以便用户分机可以方便呼叫这个分机。
深圳星昊通科技有限公司 www.hiastar.com
365
Extension Options
Outbound CID
这个是对应分机的 caller ID 。如果为空，系统将使用路由或者 trunk 的 caller ID。
请注意，这个设置仅仅支持中继的 caller ID，并且呼出路由和中继支持了这样的设置。请参
考关于 outbound Caller ID 文档获得更多 callerid 逻辑的描述。
Ring Time
在目的地应答前，电话振铃时长。默认设置在基本设置模块中设置。
Call Forward Ring Time
如果对此分机设置了呼叫前传，分机应答目的地号码前的呼叫前传时长。如果设置为
“Always”，系统将一直振铃，从不进入到 “No Answer” 目的地。
Outbound Concurrency Limit
一次允许此分机外呼的并发呼叫限制。我们通常建议设置为 3-4。用户可以对并发呼叫设
置为“No Limit”无限制的状态。
深圳星昊通科技有限公司 www.hiastar.com
366
Call Waiting
是否开启呼叫等待功能。如果不开启呼叫等待功能，如果此分机在通话接听状态时，第二
个呼叫将被发送到忙音目的地流程。
Internal Auto Answer
如果设置为应答状态，任何时候其他分机都可以对此分机进行呼叫。
Call Screening
此功能要求呼叫方在呼叫此分机时播报他们的名称。用户可以从无记忆状态或者记忆状态
下选择此功能。如果是建议状态时，系统将要求呼叫方输入名称，保存此名称，然后绑定到相
应的呼叫方的 Caller ID。任何时间，有人从此 Caller ID 发起呼叫时，系统将不再要求播
报此呼叫的名称，将播放录制的语音文件。
Pinless Dialling
如果对呼出路由设置了密码保护，此分机呼出时将不再要求输入密码。用户也可以对基于
每个路由的呼叫开启此功能。
Emergency CID
如果用户设置了紧急呼叫的呼出路由，用户可以通过此设置来设置 caller ID，这个
caller ID 将发生到被呼叫方。这个功能非常实用，如果电话是在远端时，或者不同的地方，
用户可以在系统中设置相应的远端号码，并且能够路由到相应的 911 紧急呼叫服务。
Queue State Detection
如果此分机是队列中的一位成员，队列将尝试检测用户分机状态和设备状态来决定队列呼
叫是否接通此分机。在一些特别环境下，例如，我们使用了分机随行功能，但是实际上并没有
一个物理终端电话或者虚拟分机时，状态信息将显示此成员无效，实际上此分机可能是存在的。
设置为 “Ignore State” 后，队列将忽略此分机的状态，如果有呼叫的情况下，队列将转发
呼叫到此分机。还有一些影响也来自于队列本身对本地通道的管理。例如，后续转接将继续显
示成员状态为忙，直到原始呼叫被挂机。在大部分情况下，这个参数应该设置为 “Use State”。
深圳星昊通科技有限公司 www.hiastar.com
367
Device Options
设备选项设置部分是相关于大部分设备的选项，一般情况下不要修改其设置。我们这里讨
论的是需要修改设置时的情况。
Channel
关联分机的语音卡通道。这个通道一般设置为 FXS 设备。
Parking Lot
驻留呼叫。
Optional Destinations
如果分机无效时，语音邮箱开启后，呼叫将被发送到语音邮箱。用户也可以不使用语音邮
箱，设置以下其他选项作为一个可选设置目的地来控制呼叫的最终目的地。
No Answer
呼叫无应答时，发送呼叫方呼叫到此设置。
Busy
如果呼叫方呼叫，被呼叫方在忙状态时，呼叫方被拒绝后，发送呼叫方呼叫到此设置。
Not Reachable
如果此分机不可达时，发送呼叫方到此设置，例如此分机没有注册，或者离线状态时。.
深圳星昊通科技有限公司 www.hiastar.com
368
CID Prefix
在发送此呼叫到目的地之前，对 Caller ID 添加一个前缀号码。
呼入路由实例
以下是呼入路由的各种配置实例.
DeadRestricted
如果没有此呼入路由的话，asterisk 不能应答任何呼入呼叫，asterisk 系统本身会对呼
叫方播放挂机语音提示。一些用户认为这是一个安全隐患，因为一些黑客需要通过类似的方式
来发送一些呼叫攻击系统的安全设置，特别当系统使用了"Allow Anonymous Inbound SIP
Calls" 允许 SIP 匿名呼入选项，这个安全隐患将非常危险。通过添加此路由，呼入的呼叫如
果不匹配任何路由规则，则系统直接拒绝。
Description: DeadRestricted
Set Destination: Teminate Call: Hangup.
保持其他设置为空。
DID Number Route
此路由将针对特别的号码处理呼入路由。修改 DIDNUMBER 作为呼入号码。
Description: 指定一个呼入路由名称。对于 DID 路由设置，大部分用户喜欢使用这个号码
作为描述。
DID Number: DIDNUMBER
Set Destination: 如果匹配 DID 号码，呼入的呼叫需要进入的下一个呼叫目的地对象。
SuperCaller
此路由将处理来自于一个特别的 Caller ID 的呼叫，它的优先级将高于任何 DID Number
Route。用户可以使用这个路由规则来保证某个用户的呼叫总是可以对公司办公室的号码振铃。
例如，一个公司的 CEO，使用自己的手机呼入公司的 PBX，如果使用此路由的话，CEO 手机呼
入可以确保公司内部分机振铃，而不是此号码呼入以后则把电话转接到公司前台接线员。
深圳星昊通科技有限公司 www.hiastar.com
369
Description: 设置一个路由名称。大部分用户使用此号码作为路由名称的描述。
DID Number: (设置为空。如果希望使用 Supercaller，则设置一个超级呼叫方用户的号码。)
CallerID Number: 设置具有优先级的呼叫方 Callerid。
CID Priority Route: 如果 DID 号值为空，则勾选此勾选框。
Set Destination: 如果是 SuperCaller 的路由呼叫，则进入相应的呼叫目的地对象。
呼入路由用户使用指南
Overview
Logging In
Adding an Inbound Route
o Description
o DID (Direct Inward Dialling)
o CID (Caller ID)
o CID Priority Route
o Options
Alert Info
CID name prefix
Music On Hold
Signal RINGING
Pause Before Answer
o Other Settings
o Privacy Manager
o FAX DETECT SECTION
Detect Faxes
NO
YES
Fax Detection Type
Fax Detection Time
Fax Destination
o CID LOOKUP SOURCE SECTION
Source
o LANGUAGE SECTION
Language
o Call Recording
Allow
Record on Answer
Record Immediately
深圳星昊通科技有限公司 www.hiastar.com
370
Never
o SET DESTINATION SECTION
Overview
呼入路由是 IPPBX 的核心模块，通过匹配本地号码或者呼叫方号码，做出逻辑判断，对呼
入的环境按照系统设置的流程执行到相应的呼叫目的地对象。这个模块可以对 SIP 中继，数字
中继，模拟中继进行管理设置。呼入模块的设置是系统设置中至关重要的一个步骤，用户必须
清醒了解这个设置。呼入模块通常和时间条件控制，IVR 等其他应用模块绑定使用。时间太久
控制的典型实例就是安装公司工作时间段，公司下班时间段，对呼入的用户做不同的逻辑处理。
例如上班时间的呼入，转到相应的工作部门；如果下班以后，有电话呼入，则转到另外一个特
定的流程来处理客户呼叫。
Logging In
从顶部菜单，点击 Connectivity
从下拉菜单中点击 Inbound Routes
Adding an Inbound Route
PBX 支持来自方式的呼入路由匹配，基于 DID和 CID路由匹配。这两种方式可以单独使用，
或者两种方式结合使用。简单来说，呼入匹配就是通过本地的 DID 绑定号码做路由判断，或者
根据呼叫方的来电显示做路由判断。如果都为空，则创建一个路由匹配所有的呼叫。以下是呼
入路由截图：.
Description
输入一个唯一的呼入路由描述。
深圳星昊通科技有限公司 www.hiastar.com
371
DID (Direct Inward Dialling)
呼入路由基于中继线路的 DID 匹配来判断。如果 DID 栏设置了正确的 DID 号码，运营商
可以成功发送了 DID 号码到此线路，则 PBX 匹配此路由。如果为空则系统匹配所有的呼叫。
DID 号码格式必须和运营商发送的号码格式完全匹配。大部分情况下，运营商提供给用户的 DID
号码是很多号码，例如 100 个 DID 号码，DID 号码在一定的号码段内。所以用户可以使用通配
符来匹配一定段位的号码。匹配模式必须以下划线开始_，代表这是一个号码匹配模式. 在匹
配模式中，X 代表匹配数字号码 0-9，特别指定的号码则加方括号。DID 可以为空，为空则表
示匹配任何 DID 呼入，或者无 DID 呼入。
CID (Caller ID)
此选项是基于呼叫方的 CID 号码做路由匹配。这里，系统可以定义一个呼叫方的号码来
匹配呼入路由规则。如果为空，则匹配任何呼叫或者来电显示的呼叫。另外，为了设置呼叫拨
号顺序，用户可以选择设置为 “Private,” “Blocked,” “Unknown,” “Restricted,”
“Anonymous” or “Unavailable” 匹配运营商发送到系统的特别语音提示。
CID Priority Route
默认的路由优先级级别是按照以下顺序执行:
1. 对指定了 DID 和 CID 的路由首选执行。
2. 对指定了 DID 但是没有 CID 的次选执行。
3. 对无 DID 设置，但是有 CID 号码设置的，执行第三级级别路由。
4. 对既然无 DID 号码，也无 CID 号码的，则最后执行。
如果没有输入 DID 号码，触发此勾选框，则仅对 CID 优先级有效。
深圳星昊通科技有限公司 www.hiastar.com
372
Options
Alert Info
发送 SIP ALERT_INFO 头消息。PBX 通过发送 ALERT_INFO 对 SIP 终端进行振铃或者 SIP
终端自动应答。
CID name prefix
此选项支持对呼入号码预设一个 caller ID name 文本。此选项的目的是用来确定此呼叫
来自于哪里。如果是专门针对销售部门的呼叫，可以预设一个前缀 ”Sales:.” ，那么所有
来自于 John Doe 的呼叫则显示到对端就是 “Sales:John Doe.”
Music On Hold
MoH 支持用户对呼入路由定义一个音乐等待设置。如果呼叫方被转设成音乐等待模式，可
以对呼叫方播放一个等待的音乐。典型的做法是播报公司介绍或者产品信息，并且可以同时支
持多种语言设置。如果呼叫的是英文的 DID，则对呼叫方播放英文的音乐等待文件，如果呼叫
的是西班牙语的 DID 号码，则播放西班牙语的音乐等待文件。
Signal RINGING
在通知对方呼叫应答前，系统发送的 “ringing”振铃音。一些运营商和设备有这样的要
求。用户可能会遇到类似的情况。如果用户直接呼叫电话终端则没有问题，如果发生到 IVR
后，可能电话会挂机。
深圳星昊通科技有限公司 www.hiastar.com
373
Pause Before Answer
此选项会通知 PBX 在处理这个路由前执行一个暂停。这个选项对数字线路不是非常有用，
如果对接一下模拟接收设备时，或者通过 modem 或者安全认证系统透传的中继时，需要一个
短暂的暂停时间，支持接收一个外部传真或者数据接收。所以在应答前设置一个时间缓冲机制
来保证数据能够完整正常接收。
Other Settings
这些模块取决于是否已经默认安装。用户可能有多个模块安装，或者一些模块则没有安装。
Privacy Manager
对此路由开启或者关闭 “Privacy Manager” 功能。如果开启了此功能，则此呼叫不会
和 caller ID 发送关联，无需输入 10 位数的电话号码。呼叫方可以在话机之前尝试 3 次来输
入信息。如果系统用户开启了 call screening，在呼叫抵达被呼叫方之前，PBX 则要求呼叫方
则要求呼叫方名称。
深圳星昊通科技有限公司 www.hiastar.com
374
FAX DETECT SECTION
选择是否对呼入路由执行传真检测。
Detect Faxes
NO
无需检测传真音，系统自动发送呼叫到目的地对象。
YES
系统会自动检测呼叫类型是传真还是语音。如果是传真则路由到相应的传真接收目的地，
否则转发到正常的呼叫流程处理。如果需要同时对此路由进行语音和传真检测则无开启此选项。
通常情况下，我们基于用户设置专门的传真接收路由，则为一个专门的传真服务，不会和语音
线路的路由合并在一起。这样可以保证传真检测的百分之百成功率。.
Fax Detection Type
对语音卡 Dahdi 进行传真设置检测。目前还不支持通过 SIP 发送传真。
Fax Detection Time
此时间段系统对呼入的传真检测花费的时间。超时后则转到正常的语音呼叫目的地。
Fax Destination
设置传真发送的目的地对象。
深圳星昊通科技有限公司 www.hiastar.com
375
CID LOOKUP SOURCE SECTION
CID 查询源支持用户设置一个查询源来解决呼入呼叫的数字号码的 ID 问题。这样的话，
用户的 PBX CDR 记录会非常详细。查询源可以在 Callerid Look up 源模块中进行设置，也可
以通过 web 服务，本地数据库，或者 CRM 系统查询。有一些场景中，查询源还是非常有用的，
如果运营商透传呼叫方的 CallerID 名称等信息是，查询源的方式可以实现用户查询，提高 CDR
信息的完整性。
LANGUAGE SECTION
Language
在进入到目的地对象前支持用户设置不同的语言。这个功能非常有用，当系统设置了
privacy manager 后，允许对呼叫方播放不同的语音文件。请注意，系统没有录制目前世界上
所有的语言文件。如果此语言不支持的话，系统将使用默认的英文播放。如果此值为空，则播
放英文。
可选的语言代码:
English - en
Chinese - cn
German - de
Spanish - es
French - fr
Hebrew - he
Hungarian - hu
Italian - it
Portuguese - pt
Portuguese (Brazil) - bp
Russian - ru
Swedish - sv
Call Recording
此选项将对此路由的录音设置进行控制或覆盖。
Allow
使用下游设置的呼叫路由设置。
深圳星昊通科技有限公司 www.hiastar.com
376
Record on Answer
呼叫应答时开始录音。
Record Immediately
马上启动路由，捕获振铃音，语音播报，语音等待，等等语音。.
Never
无论下游如何设置录音，关闭路由。
SET DESTINATION SECTION
PBX 本身提供了多种方式对呼叫进行路由。此设置是最终呼入路由需要应答的目的地对象。
呼出路由配置实例
Sample Route Configurations:
o 1. Route Name: EMERGENCY
o 2. Route Name: Restricted
o 3. Route Name: BlockPublicPhone
o 4. Route Name: BlockCallerID
o 5. Route Name: Normal
呼出路由配置实例:
以下是呼出路由配置实例
1. Route Name: EMERGENCY
Note: 此路由将呼叫 911 紧急呼叫。
Route CID: YOURNUMBER
深圳星昊通科技有限公司 www.hiastar.com
377
Route Type: 确认支持 EMERGENCY CHECKED (用户必须确认在 Extension 模块中设置了
emergency Caller ID )。
Dial Patterns that will use this Route:
Patterns What it does:
()+| 911 911 calls will follow this route
() +811 可选测试方法: 用户可以拨打 811 进行测试，而不是直接拨打 911 来测试路由是否可行。
If you do this, be sure to redefine 811 to dial a test number in the Trunk Dialed Number
Manipulation Rules.
Trunk Sequence: 选择一个合适的中继呼出，确认系统的分机号码可以通过此自己成功呼出。
FreePBX 将对中继呼出进行轮询，指定找到可以呼出的中继线路。
注意:
紧急路由必须在路由列表中设置为第一个呼出路由，确保每个分机可以成功通过此路由呼出。
2. Route Name: Restricted
限制某些分机通过此路由呼出。以下实例中防止一些号码呼叫国际长途，和一些特别的号
码。如果用户需要做某些业务调整的话，可以通过修改拨号匹配模式来自行修改：
Dial Patterns that will use this Route:
Patterns:
() + | 011. /
() + | 900XXXXXXX /
() + | 1976XXXX /
() + | 1XXX976XXXX
/
() + | 900XXXXXXX /
() + | 976XXXX /
() + | XXX976XXXX
What it does:
这个拨号匹配模式将允许任何起始号码带 011 的使用此路由呼出。如果
允许呼叫国际长途，删除此路由。
此模式将允许起始号码为 900 使用此路由。
此模式将允许起始号码为 1976 使用此路由。.
此路由将允许起始号码 1 + Area Code（区号） + 976 + 号码的使用此
路由。
此路由将允许起始号码为 900 + XXX + XXXX 使用此路由。
此路由将允许起始号码 976-XXXX 使用此模式。
深圳星昊通科技有限公司 www.hiastar.com
378
/ 此路由将允许 Area Code（区号） + 976 + XXX 使用此路由呼出。
Trunk Sequence: DeadRestricted
用户可以创建一个 SIP 中继，名称为 DeadRestricted。检查 Trunk 勾选框，关闭 Trunk
box ，在 OutgoingSettings 中输入 "DeadRestricted" 和 trunk 名称 (在 PEER Details 上
面的选项)。
3. Route Name: BlockPublicPhone
此路由限定某些分机通过制定的路由呼出。这个实例中我们限定的是 105 分机，用户可以
修改为自定义的其他分机号码。
Route CID: YOURNUMBER
Dial Patterns that will use this Route:
Patterns:
() + | . / 105
设置目的:
此呼出路由强制使用分机 105 呼叫的通话通过此路由呼出。
注意，句话和反斜线！
Trunk Sequence: DeadRestricted
创建 SIP 中继，名称为 DeadRestricted.。检查勾选框 Trunk box 关闭选项，在
OutgoingSettings 中输入"DeadRestricted" ，在 Trunk Name 中输入 DeadRestricted ( PEER
Details 上面)。
4. Route Name: BlockCallerID
此呼出路由支持用户拨打各种不同的拨号匹配模式呼出，例如 *67 然后输入 X11 号码呼
出，呼叫一个气位数的号码呼出，呼叫一个十位数的号码呼出，或 1+一个十位数的号码呼出，
并且呼出时隐藏了 Caller ID 号码。
Route CID: "hidden" <YOURNUMBER> // 注意，这里是隐藏设置
Override Extension: Checked // 勾选
Dial Patterns that will use this Route:
深圳星昊通科技有限公司 www.hiastar.com
379
Patterns:
() + *67 |
1NXXNXXXXXX
() + *67 |
NXXNXXXXXX
() + *67 | NXXXXXX
() + *67 | N11
设置目的:
支持任何呼出模式，但是如果匹配 *67 + 1 + Area Code（区号） +
Number, 则通过此路由呼出。
呼出前移除 *67 ，发送此其他号码通过此路由匹配模式呼出。
同上，但是呼叫号码模式必须匹配 *67 + Area Code（区号） + Number
同上，但是呼叫号码模式必须匹配 *67 + 七位数号码。
同上，但是仅支持 N11 模式的呼叫，例如 211, 311, 411, 511, 611,
711, 811, 和 911。
Trunk Sequence: 如果用户通过以上匹配成功的拨号方式，FreePBX 将选择合适的中继线
路呼出。FreePBX 将通过中继的顺序依次呼叫中继线路呼出，直到查询到有可用的中继。
注意: 用户可以自己定义各种不同的路由相当方式对某些内部分机，某些号码，某些线路做
特殊处理。所有实例中的拨号模式中的号码和 Caller ID 都可以修改到相应的实际要求的号码
和拨号模式，例如呼叫前缀，用户可以修改*67 到 *9 或者 *8 等等号码。隐藏的号码设置仅
是一个测试中的号码隐藏功能，用户如果需要使用这个号码，可以强制路由使用自己定义的号
码。
5. Route Name: Normal
Route CID: YOURNUMBER
Dial Patterns that will use this Route:
Patterns:
() + | 1NXXNXXXXXX
() + | NXXNXXXXXX
() + | NXXXXXX
() + | N11
() + | 011.
设置目的:
拨号模式匹配 1 + Area Code（区号） + 7 位数号码使用此路由。
Area Code（区号） + 7 位数号码使用此路由。
拨号模式匹配 7 位数号码，使用此路由。
拨号模式是 N11 例如 211, 311, 411, 511, 611, 711, 811, 和 911，
使用此路由。
任何位数的拨号号码，起始前缀为 011 的，使用此路由呼出。
Trunk Sequence: FreePBX 将通过拨号模式匹配相应的中继，根据中继的顺序来依次呼叫
中继线路，直到成功呼出。
深圳星昊通科技有限公司 www.hiastar.com
380
注意：
用户可以根据实际的公司 PBX 需求。修改到实际 PBX 环境中，修改相应的 Caller ID，拨号模
式，区号，手机号码位数，国际长途呼叫等等则可满足 PBX 的需求。
外呼路由模块用户使用指南
Overview
Logging In
Adding an Outbound Route
o Route Name
o Route CID
o Route Password
o Route Type
Emergency
Intra-Company
o Music On Hold
o Time Group
o Route Position
o Call Recording
o Pin Set
o Call Limit
o Notification
o Dial Patterns
Prepend
Prefix
Match Pattern
CallerID
Dial Patterns Wizards
Emergency
International
Toll-Free
Long Distance
Local
Special
Lookup Local Prefixes
Upload from CSV
o Trunk Sequence for Matched Routes
o Optional Destination on Congestion
o Save
深圳星昊通科技有限公司 www.hiastar.com
381
总览
外呼路由模块是 PBX 通过中继对电话系统外部呼出的路径。如果设置多个中继路由的话，
系统可以按照最低资费路由的模式对外实现呼叫。外呼路由对特别的拨号模式进行相应的中继
匹配，允许系统用户通过指定的中继方式呼出。当系统发起呼叫以后，系统会通过用户拨打的
号码和拨号模式中设置的模式进行对比匹配，优先级从高到低逐个查询，找到正确的匹配模式，
通过相应的中继设置呼出。如果拨号模式匹配到多个路由的话，系统将按照路由设置的优先级
执行。 “Outbound Route Dial Patterns” 的作用是在转发呼叫到中继出局之前，移除前
缀的几个号码数字。大部分的 PBX 系统会要求用户呼叫外部电话号码之前，先摁 9 或者其他
的数字+最终的用户号码来呼出。例如，简单举例，拨打手机号码前加 9，拨打本地固话号码
前加 8，拨打外地固话加 7，拨打手机号码加 6 等等类似的模式。
Logging In
从顶部菜单点击 Connectivity
从下拉菜单中点击 Outbound Routes
Adding an Outbound Route
Route Name
输入一个准确的路由名称，不能包含任何空格。名称通常描述路由的目的作用，例如, “本
地呼叫” 或者 “国际长途”。
深圳星昊通科技有限公司 www.hiastar.com
382
Route CID
使用此可选路由的 CID 号码。如果设置此选项，则覆盖所有的 CIDs 设置。
考虑特别环境：
如果选择此选项，则此选项终端分机的紧急呼叫选项。
如果 Trunk 的 CID 设置为强制使用，则使用 Trunk CID。
类似呼叫前转中的 CID (前转呼叫，分机随行，振铃组)。
系统用户/分机终端勾选的 CIDs。
Route Password
可选设置
此呼叫路由设置密码后，如果内部用户通过此路由呼出，PBX 提示输入密码来获得呼出权
限。用户可以根据这个功能限定一些国际长途的呼叫或者指定分机号码的限制呼叫设置。密码
保护可以使用数字密码来设置，或者通过一个认证文件路径提供密码验证。为空则为无需密码
验证。
Route Type
Emergency
可选
如果选择 “Emergency” 将强制使用用户分机设置的 Emergency CID setting (如果分
机设置了此号码)。选择此选项则可使用紧急呼叫路由 (例如 911)等紧急服务号码。
Intra-Company
可选
选择 “Intra-Company” ，freePBX 则把这个路由看作是一个内部公司的连接路由，会
预留内部的 Caller ID 信息，而不是呼出路由的分机或者中继的 Callerid。
Music On Hold
这里可以选择音乐等待的类别。例如根据不同的国家语言设置选择相应的目的地音乐文件。
深圳星昊通科技有限公司 www.hiastar.com
383
Time Group
选择对应的时间组路由，时间路由需要由时间组设置创建，这个路由将忽略没有在时间组
内设置的时间段。如果不选，则是默认设置，将使用 “Permanent Route”。
Route Position
在此处插入这个路由或者重新配置到相关路由中。
Call Recording
对进入这个 DID 号码的呼叫进行管理控制。Allow 选项将使用下游设置的呼叫录音设置。
Record on Answer 选项将立即开始录音，否则将忽略录音。如果 FreePBX 捕捉到振铃音，播
报，音乐等待或者其他的语音，Record Immediately 将立刻启动录音。Never 选项将不允许
录音，无论下游设备的录音设置状态是录音开启或关闭状态。
Pin Set
可选
设置一个密码保护。如果为空，路由密码则为空。 Pin sets 功能用来管理 PINs 列表，
对用户限定某些功能的访问。这个 PIN 可以添加到 CDR 中的 “accountcode” 中。使用 Pin
Set 模块创建 pin sets。对呼出路由的 Pin 要求同样也可以覆盖 Extensions 模块中的每个分
机设置。
Call Limit
在指定的时间段内，使用此路由可以呼出的的呼叫数量。呼出的 call limits 在 Outbound
Call Limit 模块中定义，也可以在分机层面定义。
深圳星昊通科技有限公司 www.hiastar.com
384
Notification
注意：此选项不会马上工作，直到提交保存路由设置后才能生效。
这个选项的目的是当一个用户使用此呼出路由呼叫时，针对一个组的电话创建 notify 功
能。任何对讲组可以添加到这个路由中。当发起呼叫后，对讲组将发送 notify 消息提示拨打
的号码和发起呼叫的用户。任何一个在对讲组的用户，可以拨打 l “*1” 加入到呼叫中可
以接听和讲话。Notifications 同样也可以使用在紧急路由中，例如 911 服务等。
Dial Patterns
拨号匹配模式是一系列唯一的拨号数字拨号号码集，选择一个设定的路由，通过此路由发
送外呼到指定的目的地中继。简单来说，就是系统用户拨号以后，拨号匹配模式将对比用户拨
打的号码，匹配成功后，发送呼叫到一个中继线路，然后通过线路呼出到目的地号码。如果已
拨号码已经匹配到相应的路由模式，PBX 将不会继续匹配其余的路由模式。如果开启了时间组，
则需要匹配接下来的路由模式，判断是否在系统的时间条件设定之内。
PATTERN DESCRIPTION
X 任何从 0-9 号码
Z 任何从 1-9 号码
N 任何从 2-9 号码
[###]
任何一个括号中的号码，例如： [123] 可能是 1 或 2 或 3 的其中一位数字。.
任何多个数字组成的号码可以通过逗号分开，号码范围或者号码段可以通过破折号设
置。例如， ([1.3.6-8]) 将匹配号码 1,3,6,7 和 8。破折号设置了 6-8。
. (dot) 匹配一个或者多个字符或者通配符。
Prepend // 预设中继出局号码
如果用户拨打的号码成功这里设置的匹配拨号模式，则在此选定的中继呼叫出局前，对中
继号码段添加一个预设的号码。一般情况下无需设置，但是如果有一些环境要求类似的功能，
深圳星昊通科技有限公司 www.hiastar.com
385
例如号码变换等等，可以添加类似的方式实现，例如系统用户要求拨打号码 9186XXXX 呼叫指
定的中继路由，但是希望系统最终出局的号码可能是 62186XXXX，这样可以支持系统用户实现
非常灵活的号码变换。
Prefix // 拨号前缀
成功匹配拨号模式后移除拨号前缀号码。如果用户拨打的号码成功匹配了系统设定的拨号
匹配模式，则在中继呼叫出局前，移除拨打的号码前缀数字，例如用户可能拨打 9186XXXXXXX
呼叫一个手机号码，成功匹配了拨号模式设置后，在呼叫出局前，系统将移除数字 9，然后发
送其余的号码出局。
Match Pattern // 最终匹配模式
用户拨打的号码将和界面设置的此 match pattern匹配，对比 prefix + 此 match pattern。
如果用户拨打号码匹配成功，系统则发送 match pattern 中的已拨号吗发送到中继出局。
CallerID
如果设置了 caller ID，被发送的内部分机 caller ID 匹配这里设定的号码，用户已拨号
码仅匹配相应的 prefix + match。通常情况下，当系统分机呼出时，callerid 号码就是分机
号码不是它们的呼出 CID 号码。这个特别的 callerid 设置用来匹配内部用户的 callerid，通
过这样的特殊设置可以支持很多类似的匹配功能。一般情况下可以不填写此设置。
Dial Patterns Wizards
这里提供了多个拨号模式的快速设置模板。选择其中一个已设计好的模式匹配用户拨号规
则。
Emergency
通过一个紧急呼叫路由。系统必须提供一个紧急呼叫的拨号模式以便来支持紧急号码业务，
例如火警，医疗紧急服务号码，公安交警等号码服务。
International
是否允许进行国际长途业务的呼叫。
深圳星昊通科技有限公司 www.hiastar.com
386
Toll-Free
是否允许支持免费号码拨打，例如 1-888 or 1-800。
Long Distance
是否支持除本地号码拨打以外的国内长途呼叫。
Local
是否支持本地呼叫。
Special
是否支持一些特别的运营商电话号码查询业务，例如 411 号码查询。
Lookup Local Prefixes
是否支持本地号码查询业务，例如北美的本地号码都上传到了此网站
www.localcallingguide.com。如果设置了此功能，用户可以拨打 7, 10 或者 11 位数的号码
(5551234, 9205551234, 19205551234)来访问此路由设置。
注意：以上信息来自于各种资源，不能保证百分之百正确或完整。用户应该咨询相关的运营商
或者权威人士获得完整的信息。
Upload from CSV
此本地上传一个 CSV 文件格式的拨号模式替换当前的文件。如果没有文件头，用户必须
创建一个支持列的文件，内容格式必须和实例完全相同，包括文件头 prepend, prefix, and
match pattern 和 caller ID。如果文件头少于四个，剩余的文件列的内容将为空。如果三个
列的话，最后一个会为空。
Trunk Sequence for Matched Routes
深圳星昊通科技有限公司 www.hiastar.com
387
中继顺序将控制匹配模式成功后选择的中继线路。例如，如果用户希望通过多个中继呼出
时，用户可能首先通过资费最低的中继呼出，以此类推。这样的话，系统会首先选择资费便宜
的中继呼出，如果资费低的中继被占用，选择资费贵一点的中继呼出。
Optional Destination on Congestion
如果 PBX 报告此中继拥塞，则转发呼叫到设定的目的地。
Save
修改以后确认摁 “Submit Changes” 保存设置。用户也可以通过复制路由来创建新的路
由。
注意：
用户必须确认创建的所有路由规则满足系统用户呼出的所有要求，否则可能导致一些
对拨号有特殊要求呼叫失败。
Outbound 拨号规则配合中继拨号规则一起工作。中继拨号规则仅用来对发送到中继的
号码再次添加号码，从已拨打号码中减除号码。Trunk 拨号规则不能用来管理限制已拨号
码。查看 FreePBX 中继模块用户使用指南，获得更多详情。
路由器设置
Port Forwarding
语音系统大部分情况下需要语音端口的转发。转发端口就会把网络安全机制暴露出来，存
在很大风险，安全漏洞的问题可能导致很大的经济损失。
不要轻易修改坐席端口设置，除非用户了解自己所做的设置。
深圳星昊通科技有限公司 www.hiastar.com
388
Firewall Settings
如果路由器支持了 SIP ALG 选项或者其他相关 SIP 的选项，大部分情况下需要关闭这些选
项。
如果路由器支持了 NAT 选项，开启此选项。
如果路由器支持 NAT 选项，包括一个超时设置，调整到 120 秒左右。
Quality of Service Settings
用户应该调整数据传输的优先级，保证语音优先。
如果路由器允许这样设置，可以把路由器的对 PBX IP 地址发送或接收的数据流量的优先
级调整到比较高的级别。如果可能，保证 PBX 单向带宽至少为 130 kb/s 。
另外，用户可以设置路由器对以下端口，并且具有更高的优先级：
UDP Traffic on Port 4569 (支持 IAX2 信令和语音)
UDP Traffic on Port 5060 (支持 SIP 信令)
UDP Traffic on Ports 10000 to 20000 (支持 SIP 语音)
中继配置实例:
1. Dead/Restricted Trunk using SIP Protocol:
Trunk Name: DeadRestricted
Disable Trunk: Checked
Outgoing Settings / Trunk Name: DeadRestricted
注意：DeadRestricted 中继服务是一个特别的中继线路，通常是关闭状态。系统设置类似的
中继线路是用来管理一些限定的外呼叫服务或者一些社会服务号码，例如付费聊天号码或者成
人电话聊天热线等等服务。
2. 一般运营商 SIP 中继设置:
Trunk Name: ProviderA // 运营商线路名称
Outbound Caller ID: YOURCALLERIDHERE // 运营商提供的号码
深圳星昊通科技有限公司 www.hiastar.com
389
Dialed Number Manipulation Rules: 号码变换规则
(18882472425) + 411 | empty // 拨号匹配
(1212) + empty | XXXXXXX // 拨号匹配
(1) + empty | XXXXXXXXXX // 拨号匹配
注意:
1. 第一个拨号匹配是用户拨打 411，然后呼出到 1-888-247-2425 呼出。用户可以根据自
己的需求，修改到相应的号码。当然除了 411 以外，用户可以添加 211，311 等等号码。
2. 第二个拨号规则是用户拨打了任意号码，在 7 位数号码前加 1212 呼出，1212 可以修改
为用户自己的区号。.
3. 第三个拨号规则是用户拨打任何号码，呼出前在呼出号码 10 位数前加 1。
4. 根据用户需求，用户可以删除以上任何变化规则。
Trunk Name: ProviderA
PEER Details:
username=username
fromuser=username
secret=password
host=provideraddress.com
fromdomain=provideraddress.com
type=friend
context=from-trunk
insecure=port,invite
trustrpid=yes
sendrpid=yes
深圳星昊通科技有限公司 www.hiastar.com
390
directmedia=no
qualify=yes
keepalive=45
nat=yes
dtmfmode=rfc2833
disallow=all
allow=ulaw
Registration String: username:[email protected]
注意：
1. 使用用户自己的名称通话 "ProviderA"。
2. 使用用户自己的 Caller ID 通话 "YOURCALLERIDHERE"。大部分情况下，这个号码不会
被使用，系统使用呼出路由模块和分机模块中的 CallerID，他们的优先级高于 trunk 的
Callerid。除非 CID 选项中设置了强制使用中继的 Caller ID。
3. 使用用户自己的名称替换 "username"。
4. 使用运营商提供的秘密替换 "password"。
5. 使用运营商提供的 IP 地址或者域名替换 provideraddress.com 。
6. 如果呼入发的 Caller-ID 以+ 为前缀，用户如果不需要这个+，修改 context
"from-trunk" 到 "from-pstn-e164-us"。
7. 如果系统没有收到呼入呼叫的 Caller ID，删除 trustrpid=yes。
8. 如果呼出的呼叫从来没有发送过正确的 Caller ID，删除 fromuser=。
9. 如果总是呼出失败，删除 sendrpid= 测试。
10.如果你的呼入总是失败，修改 context "from-trunk" 到 "from-pstn-toheader"。
3. 使用自定义的中继支持呼叫方通过 SIP 地址拨号
自定义中继可以支持用户无需拨打 SIP 号码，通过拨打 SIP 用户地址呼出。
例如：sip:[email protected] 或者 sip:[email protected].。通过以下方式设置自定义的
SIP 中继:
Trunk Name: OutboundSIPCalls
Outbound Caller ID: YOURCALLERIDHERE
深圳星昊通科技有限公司 www.hiastar.com
391
Custom Dial String:
路由到指定的目的地:
如果需要路由到用户已拨号码的地址（例如通过远端），则可以通过:
注意:
1. 使用用户自己的名称通话 "OutboundSIPCalls"。
2. 使用用户自己的 caller id 通话 "YOURCALLERIDHERE" 。
3. $OUTNUM$ 是已透传的用户拨打的号码。
4. Connecting two FreePBX systems:
用户可以参考如何对接两个 FreePBX 的参考文档获得更多详情。
关于 PEER 中的参数含义?
PEER 的参数设置中包含了多个不同的参数，这里是大部分 SIP 中继中需要使用的参数和
它们的作用:
host=192.168.1.99
"192.168.1.99" 是远端系统的 IP 地址，用户 PBX 对接地址。这里的地址可以是 IP 地址
或者域名。如果第三方系统需要注册到用户的系统（通过使用远端系统的注册字符串注册的话），
这里要设置为“dynamic”。
username=name
"name" 是一个用户名称，呼叫时，此名称将发送到远端的系统中，是远端系统授权的用
户名称。如果对端要求呼入认证的话，这里的 username= 必须要匹配 Peers中的"Trunk Name"。
secret=password
深圳星昊通科技有限公司 www.hiastar.com
392
"password" 是用户密码，需要对端密码认证才能允许呼叫对端。除非 peers 中的
insecure=invite, 否则这个密码也是用户侧接收呼叫的验证密码。
fromuser=name
这里的"name" 是 SIP 头域中 from field 的名称。当用户发起呼叫时，SIP 头中包括了一
个 to: field ([email protected] 远端系统地址)和一个 from: field
([email protected]，本地地址)。如果用户包括了 fromuser=name这个参数，from field
中的 "callerID" 将被这里的 name替换。如果远端系统要求的是 from filed 中的 Caller ID，
用户则不用设置 fromuser=。
fromdomain=test.com
注意:参考 fromuser 的设置，要求 test.com 替换 "mysystem.com"。
type=friend
"friend"表示可以发送呼叫也可以接收呼叫。这里的 PEER details 支持中继的呼出和呼
入。
context=from-trunk
"from-trunk" 表示呼叫是从这个中继呼入，同时也表示呼叫是从外部呼入。用户可以使
用这个中继来匹配设置呼入路由模块。如果没有匹配任何呼入的路由规则，asterisk 则对呼
叫方返回 "not in service message" 消息。 "from-pstn-e164-us"中继的功能和
"from-trunk" 类似，但是要移除 Caller ID 前缀+ 字符。 "from-pstn-toheader" 和
"from-trunk" 同样类似，但是已拨号码 (或 DID 号码)将被透传到 SIP 中的 to: header 而
不是 From-DID header。 "from-internal" 表示是中继呼入的内部呼叫，这样的呼叫将被
直接路由到已拨打的内部分机号码，功能代码或者其他的呼出路由模块设置中。
一般情况下，当呼叫来自于系统外部时，用户使用 "from-trunk"，而 "from-internal" 一
般表示系统的内部呼叫或者分机对分机之间的呼叫，至少两个系统之间的通信是可信任关系。
trustrpid=yes
深圳星昊通科技有限公司 www.hiastar.com
393
"yes" 表示用户系统在接收的呼叫中通过检查 Remote Party ID 头来获得 Caller ID，
而不是检查呼入呼叫的 from: field 。如果用户没有收到呼入呼叫的 Caller ID 来电显示
号码，用户可以删除这个参数测试。
sendrpid=yes
"yes" 表示系统呼出时，系统将通过 Remote-Party-ID 头发送 Caller ID。如果系统呼
出时，总是被对端拒绝，则可以移除此设置测试。 "pai" 表示系统在呼出时，通过使用
"P-Asserted-Identity" header 来发送 Caller ID。如果系统呼出时，caller id 不正确，可
以考虑添加此设置。
qualify=yes
"yes" 不是本地系统周期性地对对端系统发送请求消息来确保本地服务器的状态。如果对
端在 2 秒钟之内无响应，本地系统会假设远端系统可能停止工作或者发生故障，那么本地系统
则停止发送呼叫到对端系统，直到对端服务器有响应。除了设置成 "yes"，以外，用户可以可
以设置这个参数为一定的数值，以毫秒为单位。例如， qualify=3000 表示系统等待 3 秒来获
得对端响应，而不是默认的 2 秒。
qualifyfreq=59
"59" 这里是一个发送周期，如果 qualify 设置为 yes 或者一个数值状态，asterisk 多
久发送一个 qualify 消息。如果没有设置 qualifyfreq=，将使用默认 60 秒发送。
nat=yes
如果设置为 "yes"，则告诉 asterisk 用户通信的系统可能存在 NAT 问题，或者在 NAT 后，
asterisk 系统可以忽略这个 IP 地址，而使用正在发送数据的数据包地址。
keepalive=30
"30" 是一个 asterisk 发送 keepalive 消息的时间间隔时长，两次发送的时间间隔为 30
秒。 如果在防火墙背后的话，如果防火墙关闭了此端口，用户可能接收不到任何呼叫，所以
Keepalive 消息是非常重要的一个参数。
port=5060
深圳星昊通科技有限公司 www.hiastar.com
394
"5060" 端口是 asterisk 发送呼叫或者接收呼叫的端口。如果忽略了这个设置，Asterisk
将使用默认的 5060 端口。当我们在使用 PEER details 时，系统也同样使用相同的端口来接
收呼叫。
insecure=port,invite
"port" 通知 Asterisk 接收呼叫，输入这个呼叫不是从一个系统要求的端口呼
入。 "invite" 表示 asterisk 可以接收这个呼入，即使呼入没有携带正确的用户名称和密
码。大部分的运营商要求这样的设置。如果仅使用一个参数，逗号后面的将被忽略。
directmedia=no
canreinvite=no
以上两个参数中的 "no" 表示 Asterisk 不允许两个分机直接直接呼叫，而不经过
asterisk 服务器路由。其中，canreinvite 是 Asterisk 1.8 早期版本的命令，而 directmedia
是 Asterisk 1.8 后期版本的命令。
dtmfmode=rfc2833
"rfc2833" 是最常用的 dtmf 信令传输的方式。 另外一种是 "inband"，但是这种方式
相对来说可靠性差一点。
disallow=all
"all" 要求 asterisk 不使用任何编码，除非在 allow=定义的编码才能使用。
allow=ulaw
"ulaw" 系统支持 ulaw 编码。当然用户可以添加更多的语音编码。如果要求这个命令有
效，则 disallow=all 必须设置在此命令之前。
Trunks 模块用户使用指南
Overview
Logging in
Adding a Trunk
深圳星昊通科技有限公司 www.hiastar.com
395
General Settings
o Trunk Name
o Outbound CallerID
o CID Options
Allow Any CID
Block Foreign CIDs
Remove CNAM
Force Trunk CID
o Maximum Channels
o Continue if Busy
o Disable Trunk
o Dial Pattern Manipulation Rules
Prepend
Prefix
Match pattern
o Dialled Rules Wizard
Always dial with prefix
Remove prefix from local numbers
Setup directory assistance
Lookup numbers for local trunk
Upload from CSV
o Outbound Dial Prefix
SIP (chan_sip)/IAX2 Specific Settings
o Trunk Name
o PEER Details
o USER Context
o USER Details
o Register String
DAHDI Specific Settings
o DAHDI Trunks
SIP TRUNK(PJSIP)
o Simple
Permanent Auth Rejection
Retry Interval
Expiration
Forbidden Retry Interval
Max Retries
Qualify Frequency
Username
Secret
SIP Server
SIP Server Port
Outbound Proxy
Contact User
深圳星昊通科技有限公司 www.hiastar.com
396
Context
Transport
Codecs
o Advanced
Client URI
Server URI
AOR Contact
ENUM TRUNK
DUNDi Trunk
o DUNDi Mapping
Custom Trunk
o Custom Dial String
总览
中继模块是 PBX 中的核心模块，用来连接 PBX 和 SIP 运营商或 PSTN 运营商。同样，这个
模块可以用来对接几个 PBX系统。大部分使用的中继是 SIP或者 DAHDi (通过语音卡连接 PSTN)。
Logging in
从菜单顶部登录，点击 Connectivity
从下拉菜单中点击 Trunks
深圳星昊通科技有限公司 www.hiastar.com
397
Adding a Trunk
如果用户需要添加中继的话，可以点击以下相应的中继类型。这里我们仅支持一般标准的
中继类型，如果是非标准的中继设置，请访问官方网站获得更多支持。
General Settings
深圳星昊通科技有限公司 www.hiastar.com
398
Trunk Name
输入一个中继名称描述。
Outbound CallerID
设置 caller ID，通过此中继呼出时，将携带此号码。格式为<NXXNXXXXXX>。如果线路支
持（例如 E1/T1/J1/SIP/IAX2）号码隐藏的话，用户可以以这样的方式设置“hidden”
<NXXNXXXXXX>来隐藏号码。
CID Options
设置什么类型的中继号码可以允许使用。请注意，如果此中继支持了紧急呼叫中继设置，
在分机或者设备中定义的紧急呼叫 CID 将在此中继中使用。
Allow Any CID
所有的 CID 号码，包括国外的 CIDs 号码都将被发送出去。
Block Foreign CIDs
过滤从第三方系统前转过来的任何 CID。在分机或设备中设置的 CID 都可以发送。
Remove CNAM
从 CID 中移除的 CNAM (Name)。
Force Trunk CID
强制使用此中继定义的 CID 号码，如果此中继是紧急呼叫路由的一个部分，则使用分机或
者设备中定义的仅仅 CID 号码。Intra-Company 路由则总是传输分机号码或名称。
Maximum Channels
控制管理此中继的呼出通道的最大呼叫数量（并发数量）。此值为空，则为无限制。
深圳星昊通科技有限公司 www.hiastar.com
399
Continue if Busy
如果此中继是拥塞状态，忙状态，或者其他的无效状态时，PBX 将尝试使用下一个中继呼
出。如果用户勾选了此设置，PBX 将强制失败的呼叫继续尝试已配置的中继或目的地对象。这
个选项通常是未勾选状态。
Disable Trunk
关闭此选项，此中继将不被使用。
Dial Pattern Manipulation Rules
拨号模式匹配可以在中继出局前对已拨号码进行号码编辑或号码变换。如果没有任何规则
的话，号码不会发生变化。原始已拨号码在路由处的拨号规则经过号码变换处理，然后继续被
发送到下一个流程。此中继支持了对此号码的进一步号码处理变换。如果号码匹配了前缀加
match pattern 组合形式，PBX 将使用此匹配模式，接下来的其他规则就被忽略。如果 PBX 成
功匹配了其中一个模式，则出局前，前缀号码将被移除，然后在 match pattern 前面加预设
的 prepend 数字，最终预设号码加 match pattern 中的号码将被发送出去。其他选项都是可
选的。
Pattern 使用描述
X 匹配任何数字，只要是 0-9。
Z 匹配任何数字，只要是 1-9。
N 匹配任何数字，只要是 2-9。
[1237-9] 匹配任何括号中的数字。
. (dot) 通配符，匹配一个或多个已拨号码数字。.
深圳星昊通科技有限公司 www.hiastar.com
400
Prepend
预设号码前缀。如果用户已拨号码成功匹配了 prefix 加 match pattern，则在中继出局
前，移除 prefix，在 match pattern 前加此预设的数字号码。
Prefix
号码前缀。如果用户已拨号码成功匹配了 prefix 加 match pattern ，则在中继出局前移
除这个前缀号码，如果带预设号码的话，match pattern 加预设号码出局。如果没有带可选的
预设号码，则仅发送 match pattern 号码出局。
Match pattern
匹配模式。用户已拨号码将匹配 prefix 和 match pattern 的匹配模式。如果成功匹配，
则移除号码前缀，加一个预设号码出局（如果设置了预设号码）。当然用户也可以仅完全匹配
号码前缀，然后加一个预设号码，match pattern 为空。
Dialled Rules Wizard
Always dial with prefix
中继号码前缀快速拨号。对 voip 中继来说，这个功能非常简单实用。例如，如果用户拨
打了号码 "5551234”， PBX 会自动转换此号码为 "16135551234”。
Remove prefix from local numbers
对语音板卡支持的 Dahdi 中继非常有用，如果用户拨打的是一个本地号码 "6135551234”
的话，PBX 会自 "555-1234”。通常来说，拨打本地号码无需添加本地前缀。
Setup directory assistance
可以通过此选项转换此呼叫进行目录查询协助。
Lookup numbers for local trunk
本地中继号码查询服务。通过号码查询服务的资源例如 www.localcallingguide.com，创
建号码归属，所以用户通过本地中继拨打 7 位数或者 10 位数来直接进行呼叫。通常情况下，
用户需要拨打 1+区号（长途电话）+号码，但是通过这样的方式，用户可以直接拨打 “5551234”
深圳星昊通科技有限公司 www.hiastar.com
401
(7 位数拨号) 或者 “6135551234” (10 位数拨号)来实现本地呼叫。注意，以上设置仅支持
北美地区的号码范围。
Upload from CSV
支持上传一个拨号匹配模式 CSV 文件来替换当前的整个文件。如果没有文件头的话，则
文件必须至少设置 3 个列，需要和界面的列顺序一致。用户有可以设置 3 个文件头，在第一行
中包括: prepend, prefix 和 match pattern。如果少于 3 个文件头，剩余的列将是空白。
Outbound Dial Prefix
呼出拨号前缀，呼出前在中继添加的前缀号码。例如，如果此中继是在另外一个 PBX 背后
的系统中，用户需要拨打 9 或者其他的数字通过这个 PBX 出局。如果中继线路是 POTS 线路
的话，常用的做法是设置为“w”，让系统等待 500ms，以便有足够的时间来等待拨号音，避
免已拨打数字号码丢失。大部分情况下，此设置为空白。
SIP (chan_sip)/IAX2 Specific Settings
深圳星昊通科技有限公司 www.hiastar.com
402
Trunk Name
指定一个中继名称，例如“mysiptrunk”。
PEER Details
这里的 PEER 信息是用来对接运营商的帐号信息。用户可能需要添加设置或者删除一些设
置，完全取决于运营商的要求。
注意:这里的配置顺序非常重要。例如，如果用户使用了“allow/deny”，那么必须确保第一个是 “deny”。
USER Context
这里是运营商要求提供的帐号或号码信息。
USER Details
这里是用户连接运营商的参数设置。因为运营商要求的不同，用户可能需要添加或者删除
一些设置参数。
Register String
大部分运营商要求用户 PBX 系统注册到运营商侧。如果有此要求，用户需要输入运营商
提供的注册信息。例如，username:[email protected]。
还有一些环境下，用户也需要提供 DID 号码注册：
例如：username:[email protected]/7045551212.
DAHDI Specific Settings
DAHDi (简称为 Digium Asterisk 硬件设备接口)。Dahdi 是 asterisk 语音卡的通信接口，
它可以支持模拟接口（FXS/FXO）和数字接口（E1/PRI）。用户需要参考硬件安装文档来实现
语音卡的初始化配置。然后可以通过 DAHDi 中继模块来集成呼出呼入的路由和分机设置。请
用户先参考相应的 dahdi 语音板卡配置使用指南配置板卡后执行中继的配置。
深圳星昊通科技有限公司 www.hiastar.com
403
DAHDI 配置文件由 DAHDI 配置模块来管理。一旦成功配置好板卡以后，用户可以通过中
继界面选择 Dahdi 中继出局。
DAHDI Trunks
用户可以通过选择不同的组来进行轮询呼叫。参考一下表做相应的调整。在这个表中，我
们使用了 Group 0 (Zero) 作为轮询策略方式。
Managed Unmanaged Scheme
Group 0 Round Robin Assending r0 选择有效通道，从低到高执行依次执行。
Group 0 Round Robin Descending R0 选择有效通道，从高到低依次执行。
Group 0 Ascending g0 选择第一个有效通道，从低到高依次执行。
Group 0 Descending G0 选择第一个有效通道，从高到低依次执行。
深圳星昊通科技有限公司 www.hiastar.com
404
SIP TRUNK(PJSIP)
Simple // simple 配置方式
配置 SIP 中继时，如果用户选择的是 simple 方式，则可以看到以下设置.
Permanent Auth Rejection
设置验证失败是否认为是永久验证失败。
.Retry Interval
Retries 之间的时间间隔。
深圳星昊通科技有限公司 www.hiastar.com
405
Expiration
注册超时，以秒为单位。
Forbidden Retry Interval
当收到 403 Forbidden response 后，重新尝试的时间间隔。.
Max Retries
最多尝试注册次数。
Qualify Frequency
发送 qualify 的周期间隔。
Username
SIP Username
Secret
SIP 密码
SIP Server
SIP 服务器地址
SIP Server Port
SIP 端口
Outbound Proxy
SIP 代理
Contact User
请求消息中使用的 Contact User 信息。
深圳星昊通科技有限公司 www.hiastar.com
406
Context
发送呼入呼叫的 Context 目的地（逻辑组）。
Transport
使用的传输方式（TCP/UDP）
Codecs
勾选需要的编码支持，通过拖拉编码选项可以重新排序。
Advanced
当配置选项设置为 Advanced 方式时，用户可以看到以下选项：
Client URI
呼出注册时，使用 Client SIP URI 。
Server URI
服务器的 SIP URI 地址。
AOR Contact
指定到 AoR 的永久 contacts。
ENUM TRUNK
ENUM (E.164 号码映射机制) 是一种号码管理的方式，使用特别的 DNS 记录把号码翻译
成 URL 的方式。URL 地址反过来可以转换成 IP 地址或者特别的分机形式，这种形式可能指定
到远端接收系统的相应的 IP 地址。这个功能非常有用，在 IP 网络和 PSTN 网络环境中，可以
支持 PSTN 号码的标准化管理。
深圳星昊通科技有限公司 www.hiastar.com
407
ENUM 查询是通过 e164.org 自动获得，因此需要一点简单配置。更多 ENUM 工作方式，可以访
问 http://www.e164.org/获得。
DUNDi Trunk
DUNDi (Distributed Universal Number Discovery, 分布式通用号码查询) 是一种可信
赖，点对点网络。它的功能类似于 ENUM，但是 DUNDi 并不是使用集中式服务方式，而是使用
分布式的方式来查询。具体设置，请参考 http://www.dundi.com 网站，具体的 dundi.conf 配
置请参考此链接 http://doxygen.asterisk.org/trunk/Config_dun.html。
FreePBX 可以对 DUNDi 中继提供一个非常有效的功能支持，但是要求用户做一些手动的
配置工作。中继名称需要匹配到远端的 dundi.conf 的 [mappings] 配置中。例如以下设置 :
[mappings]
priv => dundi-extens,0,IAX2,priv:${SECRET}@218.23.42.26/${NUMBER},nopartial
在这个例子中，用户需要创建一个中继，命名为 priv。用户还需要一个 IAX2 中继来配合
DUNDi 工作。IAX2 中继可以通过配置 iax_custom.conf 来创建。
DUNDi Mapping
通过 dundi.conf 文件，我们已经定义了 DUNDi mappings 的名称。这个文件命名和本地
dundi.conf 文件中 peer details 的 include 部分相对应。
Custom Trunk
自定义中继是非常有用的一种连接方式，可以用来支持一些特别的，非标准的第三方设备
网关，例如手机网络，H323 中继，以及其他未在 PBX 默认支持的通信接口。
深圳星昊通科技有限公司 www.hiastar.com
408
Custom Dial String
用户定义一个自定义的拨号字符串。用户可以使用变量 $OUTNUM$设定一个拨出号码直接
呼出。例如：
Local/$OUTNUM$@leastcost-custom
SIP/[email protected]:5064
IAX2/[email protected]
实际呼出时，根据用户设定的号码不同，可能呼叫不同的被呼叫方。例如，如果用户设定的
$OUTNUM$ 号码是 5223211，则最后呼出号码就是 SIP/[email protected]:5064。
高级模块设置的作用是什么？
高级模块设置支持了 FreePBX 2.10 以上版本，支持各种模块的高级访问和功能设置。
如何获得高级模块？
为了在 FreePBX 2.10 以上版本中使用高级设置，通过浏览器访问用户界面。点击
“Settings”下拉菜单中的 "Advanced Settings".
深圳星昊通科技有限公司 www.hiastar.com
409
高级设置中每个选项的含义是什么？
用户可以通过每个选项的解释来获得选项的会议，鼠标移动到选项附近，有自动重新选项
帮助解释。
修改选项以后，用户必须点击绿色按钮，确认修改成功。当完成所有修改以后，点击
页面顶部的红色 "Apply Config" 刷新系统设置。
这里有几个默认选项必须注意:
Dialplan and Operational:
Force All Internal Auto Answer: 如果开启此选项，内部通话会被认定为一个内部对讲
呼叫。用户也可以通过 Extension 模块对于相应的分机设置此选项。
Show All Device Settings on Add: 如果开启此选项，当在 Extension 模块中添加了新的
分机后，用户会看到这些选项否则只能通过编辑用户后才能看到这些选项。
Send rpid: 对新创建的分机设置默认 Send rpid 功能。参考 Extensions 模块的使用指南
了解如何使用这个选项。用户可以设置为 "PAI"。
SIP and DAHDi callgroup: 对新添加用户设置默认呼叫组。参考 Extension 模块使用指南
了解如何设置这个选项。可以设置为 "1"。
SIP and DAHDi pickupgroup: 对新添加用户设置默认接听组。参考 Extension 模块了解如
何使用此选项。这里可以设置为 "1"。
Enable Custom Device States:参考 tooltip。可以默认开启此选项，默认为关闭状态。
深圳星昊通科技有限公司 www.hiastar.com
410
Waiting Period to Stop Asterisk:如果用户使用 Linux 命令执行 "amportal stop" 或者
"amportal restart" 时，系统中正在有用户进行呼叫。 Asterisk 将会等待一段时间，等待
通话用户挂机后执行以上命令。默认时长为 120 秒。可以修改为其他值。
Asterisk Dial Command Options: 可以设置为"r"。
Ringtime Default: 用户喜好。
24-hour format: 可以设置为 "No."
Ring Group Module:
Display Extension Ring Group Members: 参考 tooltip。 可以开启这个选项。
System Setup:
User & Devices Mode: 如果希望开启 Device & User Mode，修改为 "deviceanduser" 。
Fax – UCP 使用指南
Overview
Viewing Faxes
Sending Faxes
Fax Settings
总览
用户可以通过传真模块来查看系统用户的传真接收和发送。
Viewing Faxes
Faxes 包括以下几个文件夹
o Inbox- 没有查阅的传真。
o Archived- 已经查阅的传真，但是没有被删除。
o Outgoing- 将要发送的传真。
o Sent- 成功发送的传真。
o Failed- 已经发送，但是没有成功的传真。
深圳星昊通科技有限公司 www.hiastar.com
411
每个传真可以看到以下内容：
o Date- 接收日期.
o From- 发送传真的用户 Caller ID。
o To- 传真发送目的地号码。.
o Status- 传真状态。.
o Pages- 传真页数。.
o Controls- 对此传真的控制命令
查看传真
下载到本地电脑
转发传真到其他号码
从系统中删除此传真.
深圳星昊通科技有限公司 www.hiastar.com
412
Sending Faxes
点击 "Send New Fax" 选项
深圳星昊通科技有限公司 www.hiastar.com
413
定义发送传真的接收目的地号码。
用户也可以选择 Fax 封面。请参考 PBX 管理员模块中的 FAX 设置，创建一个公司的传
真封面.
深圳星昊通科技有限公司 www.hiastar.com
414
深圳星昊通科技有限公司 www.hiastar.com
415
用户可以拖拉文件添加到传真附件，也可以点击"UPLOAD DOCUMENT"，然后上传传真文
件。用户可以上传多个传真附件。
点击发送按键发送传真。查看发送传真的状态，请点击 Outgoing mailbox。
注意:当传真成功发送以后，文件将迁移到 Sent 文件夹。如果发送失败的传真文件，将迁移到 Failed 文件
夹。
深圳星昊通科技有限公司 www.hiastar.com
416
Fax Settings
管理传真相关设置，点击传真中的 Settings 选项。
用户测支持了多个传真配置参数：
o Fax Email- 发送接收到的传真文件到用户邮箱。
o Attachment Format- 发送邮件时以邮箱附件形式接收 PDF或者 TIFF文件格式。
o Store Locally- 接收传真以后，保存传真到本地存储空间，通过 UCP 来查看
管理此传真。
o Outgoing Station ID- 在发送传真界面显示每个传真的传真号码。
o Outgoing Header- 在发送传真界面显示传真的文件头。
o Coversheet Name-在传真封面显示用户的个人名称，传真发送人信息。
o Coversheet Email- 用户邮箱显示传真封面内容。
o Email Results-通过邮件形式通知传真发送结果。
Never-从不对邮箱发送传真发送结果。
Always- 总要在邮箱中接收发送传真的结果。
On Success-发送成功后，发送成功信息到邮箱中。
深圳星昊通科技有限公司 www.hiastar.com
417
On Failure- 传真发送失败后，发送失败选项到邮箱中。
Use Global- 使用在管理员模块中设置的全局设置。
o Retries- 发送传真失败以后，重新尝试的次数：
0- 不尝试发送。.
1- 尝试再发送一次失败的传真。
2-尝试再发送两次失败的传真。
3- 尝试发送三次失败的传真。
Use Global- 使用在管理员模块中传真模块的全局设置。
深圳星昊通科技有限公司 www.hiastar.com
418
深圳星昊通科技有限公司 www.hiastar.com
419
UCP- 用户 Presence 模块使用指南
Overview
Changing your status
Usage
o On UCP Login Set Status To
o On Browser Close or UCP Logout Set Status To
o Automatic Actions based on status type
Available
Chat
Away
DND
Extended Away
Unavailable
总览
此管理页面设置用户侧各种在线状态。
Changing your status
Usage
用户可以根据自己的环境手动配置环境，或者使用自动配置不修改任何默认设置。
管理员可以在 Presence 状态模块中进行管理：
On UCP Login Set Status To
登录 User Control Panel 界面后选择设置命令。
深圳星昊通科技有限公司 www.hiastar.com
420
On Browser Close or UCP Logout Set Status To
使用浏览器登录 User Control Panel 管理界面
Automatic Actions based on status type
用户可以选择以下不同的使用方式开启或者关闭一些必要的设置，例如分机随行，免打扰
等等。
Available
当状态有效时，可以执行以下功能。
深圳星昊通科技有限公司 www.hiastar.com
421
Chat
当聊天状态时，可以执行以下功能。
Away
离开时，可以执行以下功能。
DND
当免打扰状态时，可以执行以下功能。
Extended Away
当长时间离开时，可以执行以下功能。
Unavailable
当处于无效状态时，可以执行以下功能。
Print Extensions 打印分机模块
总览
打印分机模块是一个非常方便的工具，可以支持用户打印所有可拨打号码列表和挂机号码。
模块以呼入路由呼入的号码开始，路由的路由方式，还有其他的内部分机号码。
深圳星昊通科技有限公司 www.hiastar.com
422
Logging in
从菜单顶部点击 Reports
从下拉菜单中点击 Print Extensions
Usage
界面右侧将显示所有的分机相关信息。
当用户选择或者删除选择的选项后，报表会被更新。
深圳星昊通科技有限公司 www.hiastar.com
423
我们也可以点击任何队列或者会议中的分机，显示相应的配置界面。
如果点击 “Printer Friendly” 按钮，系统则会显示一个可打印的界面，如下显示：
Advanced Settings
高级模块设置的作用是什么？
高级模块设置支持了 FreePBX 2.10 以上版本，支持各种模块的高级访问和功能设置。
如何获得高级模块？
为了在 FreePBX 2.10以上版本中使用高级设置，通过浏览器访问用户界面。点击“Settings”
下拉菜单中的"Advanced Settings"。
深圳星昊通科技有限公司 www.hiastar.com
424
高级设置中每个选项的含义是什么？
用户可以通过每个选项的解释来获得选项的会议，鼠标移动到选项附近，有自动重新选项
帮助解释。
修改选项以后，用户必须点击绿色按钮，确认修改成功。当完成所有修改以后，点击页面
顶部的红色 "Apply Config" 刷新系统设置。
这里有几个默认选项必须注意:
Dialplan and Operational:
Force All Internal Auto Answer: 如果开启此选项，内部通话会被认定为一个内部对讲
呼叫。用户也可以通过 Extension 模块对于相应的分机设置此选项。
Show All Device Settings on Add: 如果开启此选项，当在 Extension 模块中添加了新的
分机后，用户会看到这些选项否则只能通过编辑用户后才能看到这些选项。
Send rpid: 对新创建的分机设置默认 Send rpid 功能。参考 Extensions 模块的使用指南
了解如何使用这个选项。用户可以设置为 "PAI"。
SIP and DAHDi callgroup: 对新添加用户设置默认呼叫组。参考 Extension 模块使用指南
了解如何设置这个选项。可以设置为 "1"。
SIP and DAHDi pickupgroup: 对新添加用户设置默认接听组。参考 Extension 模块了解如
何使用此选项。这里可以设置为 "1"。
Enable Custom Device States:参考 tooltip. 可以默认开启此选项，默认为关闭状态。
深圳星昊通科技有限公司 www.hiastar.com
425
Waiting Period to Stop Asterisk:如果用户使用 Linux 命令执行 "amportal stop" 或者
"amportal restart" 时，系统中正在有用户进行呼叫。 Asterisk 将会等待一段时间，等待
通话用户挂机后执行以上命令。默认时长为 120 秒。可以修改为其他值。
Asterisk Dial Command Options: 可以设置为 "r"。
Ringtime Default: 用户喜好
24-hour format: 可以设置为 "No."
Ring Group Module:
Display Extension Ring Group Members: 参考 tooltip. 可以开启这个选项。
System Setup:
User & Devices Mode: 如果希望开启 Device & User Mode，修改为 "deviceanduser" 。
Presence State 状态模块使用指南
总览
Presence State 状态模块支持管理员控制用户的在线状态。用户可以通过在线状态来选择应
用程序。
注意：
这个模块要求 FreePBX 2.11 和 Asterisk 11 或者 PBXact 10.211.65以上版本。
Logging in
登录 FreePBX 界面。
从顶部菜单点击 Admin
从下拉菜单中点击 Presence State
深圳星昊通科技有限公司 www.hiastar.com
426
Current states
右侧显示栏可以看到系统已创建的在线状态。
Add
点击 New presence state 创建新的在线状态
深圳星昊通科技有限公司 www.hiastar.com
427
Type
Available
表示用户有效，可以呼叫或者聊天。
Chat
通常认为是仅可以聊天。
Away
临时离开
DND
免打扰
Extended Away
长时间离开，例如假期或者商业会议。
Unavailable
无效
Message
状态留言信息，例如：离开(午餐)。
提交后不要忘记点击红色的 "Apply changes" 提示信息。
Editing
点击状态，可以看到以下表格：
深圳星昊通科技有限公司 www.hiastar.com
428
修改为用户需要的设置。
完成以后点击提交。不要忘记点击顶部的红色提示"Apply changes"。
Deleting
点击需要删除的对象。
点击删除。
删除后不要忘记点击顶部红色"Apply changes"。
通过 UCP 设置用户侧功能
Overview
Usage
o Find Me/Follow Me
Enable
Follow Me List
Announcement
Ring <Exten> First For
Ring Followme List For
Use Confirmation
Remote Announce
Too-Late Announce
深圳星昊通科技有限公司 www.hiastar.com
429
o Call Forwarding
CallForward Ringtimer
Unconditional
Unavailable
Busy
o Do Not Disturb
o Call Waiting
Where is save button?
总览
此模块可以对用户侧进行管理设置。
Usage
Find Me/Follow Me
深圳星昊通科技有限公司 www.hiastar.com
430
Enable
是否对此用户开启 Find Me/Follow Me 功能。
Follow Me List
设置以每行为单位，分机振铃列表。振铃列表中可以包括远端分机或者外部电话号码（此
号码必须以#结束）。例如支持对外部号码的振铃，则需要外部号码后添加#，如果号码是:
2448089#，则 PBX 实际拨打的号码是 2448089。
Announcement
拨打此组前，对呼叫方播放的语音提示。
Ring <Exten> First For
在处理分机随行列表名单前，对主要分机（ primary extension）的振铃时长。这个主要
分机也可以包括在 follow-me 列表中。设置为 0 将跳过此设置。
Ring Followme List For
分机随行列表中电话终端的振铃时长。振铃时长根据实际环境的不同，时间长短可能不一
样。例如: 如果一个终端振铃 1 秒钟，然后等待 2 秒钟，则每个最后的振铃时间可能是 3 秒钟。
深圳星昊通科技有限公司 www.hiastar.com
431
Use Confirmation
开启此设置将需要对呼叫外部的号码确认此呼叫，例如手机用户可能需要访问语音邮箱接
听呼叫。如果开启了呼叫确认功能，则需要外部号码摁 1 数字键来接听呼叫。例如，用户听
到语音提示后，摁 1 接受呼叫。
Remote Announce
如果 PBX 开启了 Confirm Calls 功能，则对接收呼叫方播放语音提示。
Too-Late Announce
如果呼叫确认的接收方已经接受呼叫，而且输入了确认呼叫的按键 1，则对接收方播放此
语音提示。
Call Forwarding
是否同意呼叫前转。点击勾选框，输入目的地对象。
深圳星昊通科技有限公司 www.hiastar.com
432
CallForward Ringtimer
在进入语音邮箱或者其他失效转移目的地之前的振铃时长，这个时间值可以在管理员帐户
设置。一般情况下，这里需要设置一个振铃时间，直到呼叫前转的目的地对象应答此呼叫，或
者呼叫方主动挂机。这样可以保证 PBX 的呼叫不会被一直停留在吊死状态。默认的值将是振
铃时间设置。如果没有语音邮箱设置或者失效转移目的地对象，这里的设置将是强制设置为
Always。
Unconditional
无条件前转，无论此时前转号码的线路是何状态。
Unavailable
如果前转的终端设备无响应或其他配置问题导致终端无响应，则对前转的呼叫设置一个预
设号码。
Busy
如果前转的终端设备处于忙状态（通常在通话状态），则对前转的呼叫设置一个预设号码。
Do Not Disturb
设置此选项，确保分机支持免打扰功能。
深圳星昊通科技有限公司 www.hiastar.com
433
Call Waiting
是否支持呼叫等待功能，如果开启，则支持呼叫等待。如果用户在通话状态时，另外一个
呼叫接入到此设备终端，则开启呼叫等待，提示呼叫方此通话在等待状态。
所有设置会被实时自动保存，无需摁保存键。
Voicemail – 用户侧管理界面 UCP
Overview
Managing Voicemail Messages
Managing Voicemail Settings.
Managing Voicemail Greetings.
总览
从 UCP 界面登录以后，系统用户可以查看语音留言，播放语音留言并且可以管理用户的
语音邮箱。
Managing Voicemail Messages
For each extension we can see all our voicemails.
每个语音邮件包括了：
o Date- 留言日期。
o Time- 留言时间。
深圳星昊通科技有限公司 www.hiastar.com
434
o CID- 留言人员的 Caller ID 。
o Mailbox- 留言的分机号码。
o Length- 留言时长。
o Controls- 对每个留言可以实现以下控制：
ICON PURPOSE
通过浏览器播放留言
下载留言到本地电脑
从系统中删除语音留言。
播放语音留言时，用户可以实现正常播放，快进，回放等功能。
深圳星昊通科技有限公司 www.hiastar.com
435
语音留言文件夹可以移动。用户通过点击任何文件夹，可以把语音留言拷贝到此文件夹
中。
用户可以在任何时间，把留言信息从一个文件夹拖拉到其他的文件夹。每个文件夹中的
文件数量会自动更新。
深圳星昊通科技有限公司 www.hiastar.com
436
Managing Voicemail Settings.
在菜单左侧，界面支持了一个可选的设置选项：
深圳星昊通科技有限公司 www.hiastar.com
437
设置选项可以对留言帐号信息做重新设置：
o Pin/Password- 语音邮箱密码。
o Email Address-邮箱地址来接收语音信箱发送。
o Play CID- 当播放留言是，可以对用户播放留言者的 Caller ID。
o Play Envelope-播放语音留言保存的日期和时间。
深圳星昊通科技有限公司 www.hiastar.com
438
用户可以在任何时间修改，这里没有保存按钮。修改后系统会马上自动保存。绿色则表
示已经保存。
深圳星昊通科技有限公司 www.hiastar.com
439
Managing Voicemail Greetings.
菜单左侧支持一个问候语选项：
这里的语音播放是对呼叫方播放的语音提示文件，用户可以进行编辑管理，有可
以设置为用户个性化的播放语音。目前，FreePBX 可以支持以下类型的播放：
o Unavailable- 无效提示，通知呼叫方现在无法应答呼叫，转发此呼叫到语音
留言。
o Busy- 忙音状态提示，通知呼叫方现在本机处于忙状态，或者被其他的通话
占用。
o Name- 录音名称，在公司目录中或者其他模块中使用。
o Temp- 使用临时录音，而不使用无效提示或者忙音状态提示。
深圳星昊通科技有限公司 www.hiastar.com
440
用户可以点击播放按钮每个留言问候语音文件。
用户可以点击上传 "UPLOAD GREETING" 按钮上传本地的录音文件。
摁红色按钮 "DELTE" 删除留言问候语音文件。
深圳星昊通科技有限公司 www.hiastar.com
441
同样，用户也可以通过本地电脑开启录音留言，录制用户自己的语音问候语。
摁保存按钮保存新录制的问候语音。
用户可以通过拖拉的方式从文件中拖拉需要的文件。
深圳星昊通科技有限公司 www.hiastar.com
442
弱密码检测用户使用指南
Overview
Logging In
Generating a Weak Passwords Report
Creating New Extensions with Strong Passwords
Removing Strong Password Requirement
Tips
总览
弱密码检测模块显示管理员帐户，PBX 用户帐户，分机帐号，和中继注册帐号密码状态。
如果用户使用了比较弱的用户密码，意味着系统存在相当大的安全隐患，需要管理员尽快处理
修正。
注意：没有任何一个单一的方法可以保证系统的绝对安全。此模块仅是整个系统安全策略中的其中一种。
Logging In
从顶部菜单点击 Reports
在下拉菜单中点击 Weak Password Detection
Generating a Weak Passwords Report
如果模块检测到系统的密码设置比较弱时，此模块将对此用户做一个标注，代表用户密码
比较弱，需要尽快修改。如果系统没有检测到任何的帐号使用了比较弱的密码，则如以上显示。
如果系统检测到密码设置弱的问题，则会显示在界面中。
深圳星昊通科技有限公司 www.hiastar.com
443
Creating New Extensions with Strong Passwords
在新版的 FreePBX 中，系统会自动生成一个用户的 secret 密码。如果用户修改了自动生
成的密码，默认呼叫下，分机模块会要求用户输入一个新密码，此密码必须至少包含 6 位字符，
必须是数字和字母的组合。
创建分机时，PBX 要求输入一个新密码。如果此密码不能通过 PBX 的有效验证，那么这些
还有弱密码的分机可以通过以下方式来注册：
Bulk Extension Import – 这里无任何密码验证检测机制，可以使用 Bulk Extension
模块创建新的分机。
Backup/Restore Module – 当使用备份还原来创建分机时，PBX 不会做验证。如果原
始还原文件中包含有分机号码，这些号码设置了比较弱的密码，系统也会还有到服务器端。
Removing Strong Password Requirement
在一些特殊情况下，如果硬件环境不能支持强密码验证的机制，用户可以通过高级设置中
的设备设置中移除这个选项。
Require Strong Secrets – 切换此选项为 False，然后保存设置。当创建分机时，系统会关
闭强密码验证机制。
Tips
我们推荐系统用户一直使用比较复杂的分机密码。最新的 FreePBX 版本会自动生成一个
32 位字母-数字组合的密码。虽然 freePBX 会对少于 6 位数的密码提出告警，但是最好的办法
还是使用比较强的密码。当配合终端管理员工作时，终端管理员也会增加一定的安全措施来提
高 PBX 系统的安全性。
深圳星昊通科技有限公司 www.hiastar.com
444
WebRTC UCP 电话配置
Overview
Requirements
o Server Side
Documentation Disclaimers
Client Side Environments
Installation
o Make sure your modules are up to date
o Install Needed Modules
Enabling WebRTC
o Certificates
Certificate Authority Settings(CA)
Upload CA
Host Name
Organization Name
Passphrase
Save Passphrase
Private Key
Certificate
Generate CA
Host Name
Organization Name
Passphrase
Save Passphrase
o Add Certificate
Generate a New Certificate
Certificate Authority
Name
Description
Upload Certificate
Name
Description
Private Key
Certificate
o Enabling WebRTC Phone for a user
Enable WebRTC Phone
WebRTC Certificate
Enable WebRTC Experimental Hold Support
Submit your changes
Using The WebRTC Phone
Troubleshooting
深圳星昊通科技有限公司 www.hiastar.com
445
总览
WebRTC 模块支持管理员开启 "WebRTC 电话"， webRTC 电话可以添加为一个 PBX 的用户分
机， webRTC 通过 UCP 连接到 FreePBX 系统。webRTC 将作为呼叫的接收端来接收呼叫，其作
用和其他的 SIP 终端相似。当用户对分机开启了 User 和 Device 模式，系统将创建一个复制的
的分机号码 99XXXX，这里的 XXXX 表示是原始分机号码。用户可以通过界面查看到界面 webRTC
电话连接的是设备 99XXXX，这个分机将接收呼叫方呼叫原始分机 XXXX 的呼叫。
Requirements
服务器端配置要求
Component Minimum Version
Asterisk 11.5
Certificate Manager 12.0.0alpha1
Core 12.0.1beta9
User Control Panel 12.0.0beta7
FreePBX 12.0.1beta34
Documentation Disclaimers
注意：此文档编写是基于 FreePBX 发布版本。在其他的发布版本上可能结果有所不同。因此，
此模块可能不能在其他环境下使用。但是这并不表示不能工作，仅表示没有在其他呼叫测试。
请用户使用前注意。
注意：WebRTC 是一个开发的标准协议。目前有两个工作组在开发和修改。目前一些浏览器也
不断的更新 webRTC 支持的功能。如果用户需要在生产系统中使用，请必须考虑这些相关的技
术因素。
客户侧环境要求
以下是客户侧通过测试的环境配置：
Client OS OS Version Client Browser Browser Version Status
Ubuntu 14.04 Firefox 31 Working
Ubuntu 14.04 Chrome 38.0.2125.101 Working
深圳星昊通科技有限公司 www.hiastar.com
446
Installation
确认用户模块更新到最新状态
确保 FreePBX 模块版本和 Asterisk 版本是最新版本。
如果用户目前的 freePBX 界面不支持 WebRTC 或者没有安装安全认证管理员，无需担心。
我们在以下安装过程中会执行安装这些工具：
点击 Admin
点击 Module Admin
点击 Check Online
如果模块可更新，点击模块名称
在 Action 处，点击 Update, 对每个模块重复执行此命令，或者用户也可以点击
Upgrade All 按钮升级所有模块
点击 Process
系统会弹出确认框
一旦升级完成后，点击 Return 按钮
Install Needed Modules
完成模块升级后，管理员模块界面会显示一个返回按钮。因为有依赖关系的问题，可能有
一些模块不能成功升级。用户需要解决这些问题，然后进行下一步的安装。.
所有模块完成更新后，再次点击 Check Online
在管理员的 Admin 分类中，点击 Certificate Manager
点击 Install
点击 Process 按钮
确认执行
完成安装后，点击 Return
所有模块成功升级，安全证书安装以后，用户可以开始安装 WebRTC 模块。
点击 Return 以后，用户返回到 Module Admin，然后再次点击 Check Online。
在 Connectivity 处，点击 WebRTC Phone
然后点击 Install
深圳星昊通科技有限公司 www.hiastar.com
447
点击 Process 按钮
确认执行
完成安装后点击 Return
Enabling WebRTC
必须通过执行以下顺序开启 WebRTC。
Certificates
从顶部菜单点击 Admin
从下拉菜单中点击 Certificate manager
Certificate Authority Settings(CA)
右侧导航栏点击 Certificate Authority Settings
深圳星昊通科技有限公司 www.hiastar.com
448
Upload CA
Host Name
DNS 或者主机名
Organization Name
公司名称
Passphrase
密码，用来访问此证书，生成新的客户证书。如果用户不使用密码，生成新的证书时，私
钥没有被加密，结果完全不被保护。如果用户没有提供密码时，名称上传证书时，系统将要求
提供密码。
Save Passphrase
是否在数据库保存密码，以便系统自动生成新的证书。
注意：密码是以普通文本文件的形式保存。系统将对用户提示安全警告。
Private Key
私钥文件
Certificate
安全证书
深圳星昊通科技有限公司 www.hiastar.com
449
Generate CA
Host Name
DNS 或者主机名
Organization Name
公司名称
Passphrase
密码，用来访问此证书，生成新的客户证书。如果用户不使用密码，生成新的证书时，私
钥没有被加密，结果完全不被保护。如果用户没有提供密码时，名称上传证书时，系统将要求
提供密码。
Save Passphrase
是否在数据库保存密码，以便系统自动生成新的证书。
密码是以普通文本文件的形式保存。系统将对用户提示安全警告。
Add Certificate
点击添加一个新的证书，点击 New Certificate
深圳星昊通科技有限公司 www.hiastar.com
450
Generate a New Certificate
Certificate Authority
选择一个正确的授权，可能是自己一个月之前创建的文件。
Name
证书名称
Description
证书描述
Upload Certificate
Name
设定一个证书名称
深圳星昊通科技有限公司 www.hiastar.com
451
Description
设定一个证书说明描述
Private Key
私钥文件
Certificate
证书文件
Enabling WebRTC Phone for a user
点击 Admin
点击 User Management
右侧菜单中，点击开启一个用户
确认此用户可以登录 UCP 管理界面。
注意：如果用户没有看到以上 WebRTC 选项，表示用户可能丢失了某些安装步骤。
Enable WebRTC Phone
是否对称用户开启 WebRTC Phone。设置为 yes 状态。
WebRTC Certificate
选择一个用户证书。
深圳星昊通科技有限公司 www.hiastar.com
452
Enable WebRTC Experimental Hold Support
是否开启呼叫保持。这个功能不一定完全可以工作。
Submit your changes
保存提交。
Using The WebRTC Phone
通过 UCP 登录(浏览器访问：http://yourserver/ucp )。
登录后，鼠标移到到右上角，点击 Status。
深圳星昊通科技有限公司 www.hiastar.com
453
在下拉菜单中，点击 New Phone Call。
界面会出现一个拨号盘。用户可以拨打任何号码来测试呼叫。注意，发起的 webRTC 呼叫
将显示 99<EXTEN>，所以，如果使用 1234，则显示为 991234。
深圳星昊通科技有限公司 www.hiastar.com
454
如果呼叫接通后，用户界面会显示一个选项"Hold/Unhold"和 Hangup。
浏览器可能会提示用户是否允许此呼叫启用本地的语音设备（耳麦等）可以接受这样的呼
叫。用户必须允许支持这样的呼叫请求。
Troubleshooting
One Way Audio
如果用户出现语音单通，或者无语音呼叫。系统中可能没有可用的 stun 服务器来支持
asterisk。用户可以通过添加 stun 服务器地址来支持 asterisk，具体设置为，在
/etc/asterisk/rtp_additional.conf 文件中, 添加这样一行：
stunaddr=stun.counterpath.net
执行 freepbx 命令，重新加载 asterisk 配置：
amportal a r
深圳星昊通科技有限公司 www.hiastar.com
455
常见问题解答
1. 有的客户常说，Sangoma 语音卡质量很好，但是比较贵？单纯价格看，是这样的。但是常
识告诉我们，好产品贵是正常的。因为 sangoma 的产品不仅仅提供了高品质的硬件保证，同时
sangoma 有非常专业的技术团队支持，Sangoma 语音卡本身支持了非常强大的检测工具，
Sangoma 参与了很多开源项目，贡献了很多代码，所以成本肯定高。另外，Sangoma 可以快速
排除问题，迅速帮助客户解决问题，节省了用户时间。提醒大家，快速解决问题节省了耽误的
时间。耽误的时间也是钱，出差费用也是人民币。
2. 为什么和星昊通科技购买 VoIP 相关产品？我们不仅仅销售硬件产品，用户同时可以从我
们获得更多 VoP 技术的分享，降低部署风险。我们具有 10 年的 asterisk 和其他开源界面系统
的使用经验，相关平台有什么问题，我们非常了解。我们愿意和我们的客户分享我们的经验。
3. 很多客户问，Sangoma 是不是仅生产语音卡？错。Sangoma 不仅仅生产语音卡，同时还有
Vega VoIP 语音网关（老品牌，值得信赖，研发基地在英国），还有 SBC，还有 SS7 16E1 以上
设备，以及编码处理解决方案。
4. 能不能把语音卡开发成一个语音网关，通过界面配置 SIP 和 PRI，然后在一体机中安装
Asterisk 或者 FreeSWITCH？完全没有问题。Sangoma 的 netborder 就是为此而生。用户可
以购买一台服务器，安装 linux 操作系统，安装 Sangoma 语音卡，购买一个 netborder 软件
许可证，自动安装配置。软件界面就是一个网关界面，同时也会可以在同一台服务器中安装
asterisk 或者 FreeSWITCH 或者其他的软交换软件。两者互不影响。
5. FreePBX 功能很多，模块也很多？是不是需要购买商业模块才能使用？不是。Freepbx 模
块多达 80 多个，坐席模块基本上都是免费模块。PBX 功能无需再次购买其他商业模块。除非
用户需要购买一些特别的模块满足特定的需求，例如，语音群呼，SIP 分机批量部署等等。可
以快速安装配置，无需再次开放，并且官方有商业支持。
6. FreePBX 设备是否可以 OEM 或者有其他的硬件解决方案？是的。我们可以提供其他硬件，
接入设备的的非常高性价比的解决方案，但是需要通过官方渠道和我们沟通，我们公司提供的
是可靠稳定设备解决方案，绝对禁止山寨产品。
7. 淘宝买了一张克隆卡安装以后，系统有问题。Asterisk 好像不靠谱？Asterisk 靠谱，卡
也靠谱，但是克隆卡不靠谱。
