查看“分机-Dahdi分机”的源代码

'''分机模块-如何创建FXS分机用户使用指南'''

''注意'' 此模块仅支持FreePBX-13以上版本。


'''总览介绍'''

此指南的配置信息和Dahdi语音板卡配置信息相关。


'''Logging in'''

* 从顶部菜单点击 '''Applications'''
* 从下拉菜单中点击'''Extensions'''

'''Adding a DAHDI Extension'''

* 此页面中选择点击'''&nbsp;Add New DAHDi Extension'''按钮。

http://wiki.freepbx.org/download/attachments/28182083/new-dahdi.png

'''General'''

http://wiki.freepbx.org/download/attachments/28182083/new-dahdi-ext.png

'''Add Extension'''

'''User Extension'''

分机号码关联用户本身，一旦创建以后，不能被修改。我们建议使用3或者4位的数字号码。

'''Display Name'''

这个名称关联分机，可以被修改。这个名称将成为Caller ID Name。

'''Outbound CID'''
这里对此分机设置一个 caller ID 。如果为空，则系统使用系统路由或者中继的caller ID。如果呼出路由和中继设置支持了这个选项，用户可以在这里设置呼出的 caller ID。


'''User Manager Settings'''

'''Link to a Default User'''

选择一个用户和中国分机关联，具体设置看用户管理模块。Default=是创建新用户。一个分机可以关联一个用户，一个用户仅过滤一个分机。

* '''Create New User''': 在用户管理员创建新用户，关联此分机。
* '''None:'''&nbsp;这个分机没有关联任何用户。
* '''Existing User''': 如果用户管理模块中有任何用户没有关联分机，可以选择此用户关联绑定。

'''Username'''

如果选择了创建新用户，新用户名就是登录用户名称。如果为空，则显示灰色。用户名和分机号码相同。 重新编辑用户名称，点击 '''Use Custom Username'''编辑用户名。

'''Password for New User'''

如果选择了创建新用户，系统会自动创建新的用户密码。 当然也会也可以重新编辑修改用户密码。

'''Groups'''

用户可以选择不同的用户组。用户组在用户管理模块中设置。如果用户组没有在用户管理模块中添加，这里菜单中不会显示。

http://wiki.freepbx.org/download/attachments/28182079/select-sales.png

http://wiki.freepbx.org/download/attachments/28182079/entered-sales.png

'''Voicemail'''

* 点击 '''Voicemail'''标签。
* 如果用户需要开启 voicemail，点击'''Yes'''按钮。

http://wiki.freepbx.org/download/attachments/28182079/voicemail-settings.png

'''Voicemail'''

'''Enabled'''

'''Yes/No''' 是否开启或关闭语音邮箱。

'''Voicemail Password'''

输入语音邮箱密码。如果为空，语音邮箱密码则是分机号码。用户可以通过热键*98访问语音邮箱系统修改密码。

'''Require From Same Extension'''

'''Yes/No:'''&nbsp;是否允许用户通过相同分机号码拨打*97来访问语音邮箱系统。这个选项不支持*98 呼叫，*98 则可以要求输入密码。建议设置为'''Yes'''。

'''Disable ( *&nbsp;) in Voicemail Menu'''

'''Yes/No:'''&nbsp;是否关闭语音邮箱菜单。 默认环境是 Default = Yes。 如果设置为'''Yes'''，用户按* 不会访问语音邮箱。。如果用户不愿意开启远程访问分机邮箱，则设置为'''Yes'''。 如果用户需要支持通过远程分机或者其他分机来访问此用户语音邮箱，则设置为'''No'''，那么用户可以拨打分机加*来访问语音邮箱。

'''Email Address'''

''Optional'' 发送语音留言的邮箱地址。用户可以选择是否设置语音留言为附件发送。

'''Pager Email Address'''

''Optional''广播邮箱或手机邮箱提示地址。

'''Email Attachment'''

'''Yes/No'''是否支持邮箱附件发送。

'''Play CID'''

'''Yes/No'''播放语音邮件前是否播放呼叫方电话号码，仅播放留言日期和时间。

'''Play Envelope'''

'''Yes/No'''是否播放录音其他信息，例如日期和留言时间。这个设置不会影响高级设置中的语音邮箱设置。

'''Delete Voicemail'''

'''Yes/No'''发送邮箱以后是否删除此语音留言。如果设置为'''Yes'''，用户收到语音留言邮件后，这个文件就被系统删除。

如果设置'''Delete Voicemail = Yes'''，用户必须输入语音邮箱地址，而且还要设置 '''Email Attachment = Yes'''。否则留言将完全丢失。

'''VM Settings'''

''Optional:&nbsp;''高级设置。输入语音邮箱选项，通过分隔号分开(|)。例如 "review=yes | maxmessage=60" 。

'''VM Context'''

这是Voicemail Context 逻辑标签，通常设置为"default"。 不要修改设置，除非你了解拨号规则流程，否则可能访问不了语音邮箱。

'''VMX Locater™'''

VMX 存储器。当呼叫方呼叫到达系统接线员或者不在公司的主呼叫线路时，用来帮助呼叫方处理一个呼叫流程。 如果开启此设置，用户将认为进行一个留言提示音播放，这个功能将引导呼叫方通过拨打0，1，或者2来进行操作.

如果用户输入了以下0，1或 2选项，用户必须确认号码是可以工作的，否则用户则认为系统设备提示，或者输入了无效选项。

http://wiki.freepbx.org/download/attachments/28182079/vmx-locater.png

'''Enabled&nbsp;'''

'''Yes/No'''是否开启VMX Locater 功能。如果设置为'''Yes'''，用户就可以修改或编辑以下选项。

'''Use When'''

选择使用环境，例如：&nbsp;'''Unavailable, Busy,'''&nbsp;和/或'''&nbsp;Temporary.'''

'''Voicemail Instructions'''

'''Yes/No'''是否对呼叫方播放语音提示。如果设置为'''No'''，则仅播放一个beep 音。

'''Press 0'''

检查'''Go to Operator&nbsp;'''勾选框，用户按0以后就转发呼叫到接线员。如果不勾选'''Go to Operator&nbsp;'''框，则呼叫方被转发到其他的目的地流程。

'''Press 1'''

''Optional''&nbsp;- 当用户按1后，进入的一个目的地号码。 这个号码可以说内部号码，振铃组号码，队列，或者一个系统外部号码。

'''Press 2'''

''Optional''&nbsp;-当用户按2后，进入的一个目的地号码。 这个号码可以说内部号码，振铃组号码，队列，或者一个系统外部号码。

'''Find Me / Follow Me'''

* 点击'''Find Me / Follow Me'''标签。
* Find Me / Follow Me 在默认环境下是开启状态。这里可以编辑修改。设置一个分机随行号码。

http://wiki.freepbx.org/download/attachments/28182079/fmfm-settings.png

'''General Settings'''

'''Enabled'''

'''Yes/No:&nbsp;'''是否开启分机随行。 这里必须设置为'''Yes'''状态，或者临时设置为Yes, 这样可以编辑其他的设置文件选项。设置为No， 则关闭此分机分机随行功能。

'''Initial Ring Time'''

在分机随行之前系统对分机的振铃时间，以秒为单位。 如果为"0"， 分机在进入分机随行前不会振铃。

'''Ring Strategy''' 振铃策略

* '''ringallv2:''' 在初始振铃时间内对分机振铃，然后继续对分机随行列表的分机振铃。
* '''ringall:'''在初始振铃时间内对分机振铃，结束对此分机振铃，然后对分机随行列表振铃。
* '''hunt:'''对每一个有效分机振铃。
* '''memoryhunt:'''对分机随行列表中的分机依次振铃，例如第一个，第二个。。。
* '''<nowiki>*-prim:</nowiki>'''这个模式和上一个策略基本相同。但是如果第一个分机被占用的话，其他分机将不会振铃。如果第一个分机设置为免打扰模式，不会再次振铃。如果第一个分机设置为无条件呼叫前转模式，那么所有分机则会振铃。
* '''firstavailable:'''&nbsp;仅对第一个有效分机振铃。
* '''firstnotonphone:'''&nbsp;仅对第一个不是摘机状态的分机振铃-忽略呼叫等待。

'''Ring Time'''

电话振铃时间。对于所有振铃策略来说，这个时间就是每个电话循环振铃时间。

'''Follow-Me List'''

输入振铃分机列表，一行一个分机。振铃分机也可以包含一个远程电话号码或者外部号码，注意，外部号码要加后缀(#)。例如: 2448089# ，系统则实际拨打的出局号码是2448089。

'''Extension Quick Pick'''

下拉菜单提供了多个当前有效分机，用户可以添加到分机随行列表。

'''Announcement'''

选择一个语音提示文件，在呼叫分机随行前播放。 默认是 Default = none。 这些语音提示文件可以从系统录音模块中提取或者添加。

'''Play Music On Hold'''

用户可以选择语音等待提示音，不使用默认的振铃方式。在被呼叫方接听之前，呼叫方将听到音乐等待提示。 用户可以从提示音类别中添加语音提示。

'''CID Name Prefix'''

用户可以前置一个Caller ID 名。 例如，前置一个"Sales:"，在分机随行列表中振铃的就是"Sales:John Doe"。

'''Alert Info'''

''Optional -&nbsp;''创建一个支持SIP终端的 distinctive rings。

'''Call Confirmation Configuration'''

'''Confirm Calls'''

'''Yes/No:&nbsp;'''是否是外部呼叫。呼叫确认要求远端用户接听时按1来接受呼叫。 这样可以防止未应答外部呼叫进入到语音邮箱。这个功能仅支持 ringall 或 ringall-prim 振铃策略。

'''Remote Announce'''

对远端被呼叫方播放语音提示，必须设置为'''Confirm Calls = Yes'''。用户可以使用默认的语音提示或从以下选项选择。

'''Too-Late Announce'''

如果远端在其他地方接受了呼叫，并且设置'''Confirm Calls = Yes'''，则对对端播放此语音提示。

'''Change External CID Configuration'''

'''Mode'''

* '''Default''': 如果中继支持发送caller's CID。
* '''Fixed CID Value''': 总是发送以下Fixed CID Value。
* '''Outside Calls Fixed CID Value''': 发送此外部呼入的以下Fixed CID Value 内部的分机对分机呼叫继续使用默认模式。
* '''Use Dialed Number''': 发送外部呼叫拨打的号码。 内部对内部呼叫继续使用默认模式。系统必须有一个呼入路由的DID号码。如果中继过滤国外号码，这个号码可能被过滤。
* '''Force Dialed Number''': 外部呼入呼叫拨打的号码。内部对内部呼叫仍然使用默认模式。系统必须有一个呼入路由的DID号码。如果发送的中继支持过滤国外Callerid，则强制使用此拨打的号码。

'''Fixed CID Value'''

使用固定值替换 以上模式使用的CID。应该都是数字格式，只有E164格式带前缀"+"。

'''Destinations'''

'''No Answer'''

当此呼叫无应答时可选目的地。 如果此终端正在被使用，或者简单忽略了呼叫，则使用忙目的地设置。

''注意'', 如果用户不想激活分机随行，设置顶部的'''Enabled = No'''。否则，用户需要保存设置，点击''apply config''按钮激活。

'''Advanced'''

* 点击'''Advanced'''标签
* 查看不同的选项

http://wiki.freepbx.org/download/attachments/28182083/dahdi-adv-1.png

http://wiki.freepbx.org/download/attachments/28182083/dahdi-adv-2.png

http://wiki.freepbx.org/download/attachments/28182083/dahdi-adv-3.png

'''Assigned DID/CID'''

'''DID Description'''

DID描述，例如 "Fax"

'''Add Inbound DID'''

一个DID直接关联这个分机。DID格式应该和运营商提供的格式相同。

'''Add Inbound CID'''

对DID + CID 路由添加一个CID 号码。DID 号码需要在上面的'''Add Inbound DID'''设置。另外，为了支持标准的拨号顺序，如果运营商发送了以下数据，用户可以输入Private, Blocked, Unknown, Restricted, Anonymous, Withheld,和 Unavailable 设置来匹配一些特殊的环境。

'''Call Camp-On Services'''

'''Caller Policy'''

Asterisk: cc_agent_policy。用来对此用户开启technology mode Camp-On功能。大部分情况下，'''&nbsp;Generic Device'''将作为标准的终端设备通道，除非用户电话设备专门支持了特别的通信接口。

'''Callee Policy'''

Asterisk: cc_monitor_policy。用来控制是否允许其他电话对此分机来执行Camp On 功能。如果允许，系统则设置technology mode来检测分机的有效性。 如果没有特殊的通信接口支持，此分机需要设置为'''Generic Device'''。 在这种模式下，如果分机状态从被使用状态修改为空闲状态时，回拨将从此分机发起。 如果第一次尝试，如果此分机处于忙状态时，将结束当前呼叫。 如果这是简单无应答时，系统会在下一次呼叫时，使用此分机应答或者发起呼叫。如果系统支持'''Native Technology Support'''，系统可以利用其优势来支持Camp-on 服务。如果不支持的话，可以自动切换到'''Generic Mode'''模式。

'''Add Extension'''

'''channel'''

DAHDi 通道号码

'''context'''

此终端将发生呼叫到 Asterisk 的逻辑 context。 一般为默认设置，除非用户非常了解此设置的意义。

'''immediate'''

DAHDi immediate 模式设置，查看 DAHDi文档。

'''signalling'''

DAHDi 信令，通常情况下，如果连接模拟话机，使用fxo_ks。 一些特殊应用或者 channel bank要求fxs_ks 或者其他设置，请查看asterisk 语音卡设置。

'''echocancel'''

语音卡回声设置，参考Dahdi 语音卡文档。

'''echocancelwhenbridged'''

当在Dahdi 通道之间桥接时，是否开启回声抑制。更多细节，请参考DAHDi文档。

'''echotraining'''

是否需要开启回声训练来获得最佳语音效果，查看Dahdi文档。

'''busydetect'''

忙音检测设置，检测挂机，忙音状态来判断话机是否挂机。

'''busycount'''

功能同上，周期检测忙音信号，参考语音卡文档。

'''callprogress'''

检测call progress tones。

'''dial'''

如何拨打此设备

'''accountcode'''

Account code 支持计费。

'''callgroup'''

呼叫组成员，可以是多个呼叫组成员，例如 "1,3-5" 表示在呼叫组1,3,4,5 中。

'''pickupgroup'''

接听组成员。可以支持多个接听组，例如‘1,3-5' 将在1,3,4,5接听组内。

'''mailbox'''

语音邮箱，系统自动生成设置为:&nbsp;&lt;extnum&gt;@device

配合LDAP集成使用，开启MWI (Message waiting indication)，输入，例如101@default;102@default。

'''CID Num Alias'''

CID 号码别名支持内部呼叫。它和分机号码不同。这里用来支持同一用户的不同称谓来支持不同的业务群体，例如所有技术支持部门的成员电话号码希望显示为标准的技术支持号码。这里的设置不会影响外部呼叫号码。

'''SIP Alias'''

SIP 别名。

'''Extension Options'''

'''Asterisk Dial Options'''

Asterisk Dial 选项。 检查'''override'''勾选此选项支持此分机，或者不勾选此选项使用默认的设置。

'''Ring Time'''

呼叫抵达 "no answer" 目的地之前的振铃时长。默认设置在高级选项菜单中设置。

'''Call Forward Ring Time'''

呼叫前转，呼叫前转忙，或呼叫前转无效的振铃时长。 设置为'''Always'''会导致电话继续振铃，不会进入到"no answer" 目的地。 '''Default'''将使用当前振铃时间。如果语音邮箱关闭，并且没有设置目的地，系统会强制进入'''Always'''模式。

'''Outbound Concurrency Limit'''

此分机最大外呼次数。 对系统安全有非常大的作用，保证系统安全。

'''Call Waiting'''

'''Enable/Disable:&nbsp;'''是否支持呼叫等待。如果关闭呼叫等待，第二个呼叫会进入到分机忙状态目的地。

'''Internal Auto Answer'''

'''Disable/Intercom:&nbsp;'''当设置为'''Intercom'''，内部分机对此分机呼叫时，分机可以自动应答，可以作为一个内部广播。如果关闭此设置，电话机作为正常分机振铃。

'''Call Screening'''

Call Screening 功能要求外部呼叫方显示呼叫方名称，此名称将会对分机显示，支持用户接收或者拒绝此呼叫。 Screening内存保存方式，所以只能对显示一次呼叫方名称。 Screening无内存支持方式则总是要求呼叫方播报名称。 两种方式都会根据最后一次保存的CallerID 版本名称。 如果任何系统中使用内存方式选项的用户被呼叫，呼叫方要求重新介绍呼叫方自己，所有系统用户将保存一个新的名称和呼叫方CallerID 关联。

'''Pinless Dialing'''

开启无密码拨打，则呼出时无需输入密码。

'''Emergency CID'''

紧急呼叫路由使用的CallerID支持紧急呼叫路由。 此紧急呼叫路由将覆盖所有的CallerID设置。

'''Queue State Detection'''

如果分机是队列成员，队列会使用用户分机状态或者设备状态信息来决定队列成员是否接听呼叫。在一些特定的环境中，例如 分机随行中，如果没有物理设备，或虚拟分机中，当分机在线后，状态信息将显示成员的状态有效性。设置为 '''Ignore State'''，则队列忽略分机状态消息，因此可能总是呼叫此分机。 实际环境中，因为中继处理本地通道的自然流程，呼叫接听后，中继可能被占用，那么接下来的转接呼叫会一直显示这个成员处于忙状态，直到以前的呼叫结束。大部分情况下，设置为'''Use State'''。

'''Recording Options'''

'''Inbound External Calls'''

'''Force/Yes/Don't Care/No/Never:'''对外部来的呼入录音。

'''Outbound External Calls'''

'''Force/Yes/Don't Care/No/Never:&nbsp;'''呼出的外部环境录音。

'''Inbound Internal Calls'''

'''Force/Yes/Don't Care/No/Never:'''系统中从其他分机接收的呼叫录音。

'''Outbound Internal Calls'''

系统内，其他分机呼叫录音。

'''On Demand Recording'''

'''Disable/Enable/Override:'''开启或者关闭按需录音。 这里全局录音策略仍然有效，如果呼叫已经设置为 "Force" 或者 "Never"  路由不能停止，除非选择"Override"。

'''Record Priority Policy'''

如果有录音冲突时，录音优先级是关联其他分机设置(例如，一个分机设置了录音，但是另外一个分机没有设置录音)。 高优先级的分机决定录音策略。如果两个分机的录音优先级相同，则全局策略来决定录音策略。

'''Dictation Services'''

'''Dictation Service'''

'''Disabled/Enabled:'''是否开启听读录音服务。

'''Dictation Format'''

语音格式为 ('''Ogg Vorbis''',&nbsp;'''GSM''', or&nbsp;'''WAV''').

'''Email Address'''

发送听读服务的邮件地址。

'''From Address'''

发送邮件的源地址。 格式为 "A Persons Name &lt;email@[http://address.com/ address.com]&gt;"。

'''DTLS'''

(Datagram Transport Layer Security)

'''Enable DTLS'''

'''No/Yes:'''是否开启或者关闭DTLS-SRTP支持。

'''Use Certificate'''

使用安全证书，查看安全证书模块。

'''DTLS Verify'''

验证peer 安全证书是否有效。

* '''Yes:&nbsp;'''执行证书和fingerprint验证更新。
* '''No:'''&nbsp;仅执行无证书或者fingerprint认证。
* '''Fingerprint:'''仅执行fingerprint验证。
* '''Certificate:&nbsp;'''仅执行证书认证。

'''DTLS Setup'''

是否接受双方DTLS创建方式。远端发送actpass 时，提供SDP。

* '''Active:&nbsp;'''我们想连接远端。
* '''Passive:&nbsp;'''我们仅接受连接。
* '''Act/Pass''': 我们提供以上两种方式。

'''DTLS Rekey Interval'''

TLS会话和重输入SRTP 会话的协商周期。 如果这里没有设置或者设置为0，重输入密钥关闭。

'''Optional Destinations'''

'''No Answer'''

如果呼叫未被应答，录音到此目的地。如果此话机在占用状态，呼叫被忽略，那么忙目的地路由将被调用。

'''CID Prefix'''

是否支持路由到无应答目的地前加前缀号码。

'''Busy'''

当电话参与忙状态，或者呼叫被拒绝后所路由的目的地。这个目的地也可以使用在无应答呼叫或者终端在使用状态的环境中。

'''CID Prefix'''

在发送此呼叫到忙目的地路由前添加的号码前缀。

'''Not Reachable'''

当此终端不可达时选择的路由目的地，例如SIP终端可能是离线状态。

'''CID Prefix'''

在发送此呼叫到离线不可达路由目的地前加号码前缀。

'''Other'''

'''Endpoint'''

'''Brand'''

SIP话机根据品牌部署

'''MAC'''

通过设备的MAC地址自动部署

'''Template'''

设备使用的模板

'''Model'''

自动部署的型号

'''Account'''

指定的Account 帐号

'''iSymphony Settings'''

'''Add to iSymphony'''

'''yes/no:&nbsp;'''是否支持iSymphony。

'''Auto Answer'''

'''yes/no:&nbsp;'''是否支持自动应答，仅支持Aastra, Grandstream, Linksys, Polycom, 和 Snom 话机。

'''Device Options'''

'''Channel'''

此分机的FXS通道

'''Parkinglot'''

此分机默认的振铃空间。

'''Language'''

'''Language Code'''

播报语言代码，系统所支持的语言可以通过语音语言模块添加或者删除。

'''Default Group Inclusion'''

'''Default Page Group'''

'''Exclude/Include:&nbsp;'''此分机是否是默认广播组成员。

'''Default VMblast Group'''

'''Exclude/Include:&nbsp;'''此分机是否是默认的voicemail 广播组成员。如果用户没有语音邮箱，则忽略'''Include'''。

'''Saving the Extension'''

* 点击'''Submit'''按钮，然后点击'''Apply Config'''按钮。