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

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

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


'''总览介绍'''

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


'''Logging in'''

* 从顶部菜单点击 '''&nbsp;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&nbsp;''' 按钮。

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''&nbsp;- 发送语音留言的邮箱地址。用户可以选择是否设置语音留言为附件发送。

'''Pager Email Address'''

''Optional -&nbsp;''广播邮箱或手机邮箱提示地址。

'''Email Attachment'''

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

'''Play CID'''

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

'''Play Envelope'''

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

'''Delete Voicemail'''

'''''''''Yes/No:&nbsp;'''发送邮箱以后是否删除此语音留言。如果设置为'''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:'''&nbsp;是否开启VMX Locater 功能。如果设置为'''Yes'''，用户就可以修改或编辑以下选项。

'''Use When'''

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

'''Voicemail Instructions'''

'''Yes/No:'''&nbsp;是否对呼叫方播放语音提示。如果设置为'''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'''

''Optional''&nbsp;-用户可以前置一个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''': Transmit the Fixed CID Value below on calls that come in from outside only. Internal extension-to-extension calls will continue to operate in default mode.
** '''Use Dialed Number''': Transmit the number that was dialed as the CID for calls coming from outside. Internal extension-to-extension calls will continue to operate in default mode. There must be a DID on the inbound route for this. This will be BLOCKED on trunks that block foreign CallerID.
** '''Force Dialed Number''': Transmit the number that was dialed as the CID for calls coming from outside. Internal extension-to-extension calls will continue to operate in default mode. There must be a DID on the inbound route for this. This WILL be transmitted on trunks that block foreign CallerID.

'''''''''Fixed CID Value'''

Fixed value to replace the CID used with some of the modes above. Should be in a format of digits only with an option of E164 format using a leading "+".

'''Destinations'''

'''No Answer'''

Optional destination call is routed to when the call is not answered on an otherwise idle phone. If the phone is in use and the call is simply ignored, then the busy destination will be used.

Remember to set '''Enabled = No''' at the top of the page after you're done changing settings if you do ''not'' want find me / follow me to be active. Otherwise, it will be ''active'' for the extension after you save settings and apply config.

'''Advanced'''

* Click on the&nbsp;'''Advanced&nbsp;'''tab.
* There are many settings in this tab. See below for explanations of the options.

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'''

A description for this DID, such as "Fax"

'''''''''Add Inbound DID'''

A DID that is directly associated with this extension. The DID should be in the same format as provided by the provider (e.g. full number, 4 digits for 10x4, etc).&nbsp;Format should be: XXXXXXXXXX

'''Add Inbound CID'''

Add a CID for more specific DID + CID routing. A DID must be specified in the above&nbsp;'''Add Inbound DID'''&nbsp;field. In addition to standard dial sequences, you can also enter Private, Blocked, Unknown, Restricted, Anonymous, Withheld, and Unavailable in order to catch these special cases if the Telco transmits them.

'''Call Camp-On Services'''

'''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'''&nbsp;Generic Device'''&nbsp;should be chosen unless your phones are designed to work with channel-specific capabilities.

'''Callee Policy'''

Asterisk: cc_monitor_policy. Used to control whether 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 it should be set to a&nbsp;'''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&nbsp;'''Native Technology Support'''&nbsp;if available and automatically fall back to the&nbsp;'''Generic Mode'''&nbsp;if not.

'''Add Extension'''

'''channel'''

The DAHDi channel number for this port.

'''context'''

Asterisk context this device will send calls to. Only change this is you know what you are doing.

'''immediate'''

DAHDi immediate mode setting, see DAHDi documentation for details.

'''signalling'''

DAHDi signalling, usually fxo_ks when connected to an analog phone. Some special applications or channel bank connections may require fxs_ks or other valid settings. See DAHDi and card documentation for details.

'''''''''echocancel'''

DAHDi echocancel setting, see DAHDi documentation for details.

'''echocancelwhenbridged'''

Whether to turn on echo cancellation when bridging between DAHDi channels. See DAHDi documentation for details.

'''echotraining'''

Echo training requirements of this card. See DAHDi documentation for details.

'''busydetect'''

Experimental and un-reliable setting to try and detect a busy signal. See DAHDi documentation for details.

'''busycount'''

Experimental and un-reliable setting to try and detect a busy signal, number of iterations to conclude busy. See DAHDi documentation for details.

'''callprogress'''

Experimental and un-reliable setting to try and detect call progress tones. See DAHDi documentation for details.

'''dial'''

How to dial this device. This should not be changed unless you know what you are doing.

'''accountcode'''

Account code for this device.

'''callgroup'''

Callgroup(s) that this device is part of. Can be one or more callgroups, e.g. "1,3-5" would be in groups 1,3,4,5.

'''pickupgroup'''

Pickupgroups(s) that this device can pickup calls from. Can be one or more groups, e.g. '1,3-5' would be in groups 1,3,4,5. Device does not have to be in a group to be able to pick up calls from that group.

'''mailbox'''

Mailbox for this device. This should not be changed unless you know what you are doing.&nbsp;This will be automatically set to:&nbsp;&lt;extnum&gt;@device

With an LDAP backend, to enable MWI (Message waiting indication), enter a semi-colon list of mailboxes in the form &lt;extnum&gt;@'''''default'''''

e.g. 101@default;102@default &nbsp;...where the message lamp will light if any of the specified mailboxes has unread mail&nbsp;

'''CID Num Alias'''

The CID Number to use for internal calls, if different from the extension number. This is used to masquerade as a different user. A common example is a team of support people who would like their internal CallerID to display the general support number (a ringgroup or queue). There will be no effect on external calls.

'''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 users extension to call them.

'''Extension Options'''

'''Asterisk Dial Options'''

Cryptic Asterisk Dial Options. Check the&nbsp;'''override'''&nbsp;box to customize for this extension, or un-check to use system defaults set in Advanced Options. These will not apply to trunk options, which are configured with the trunk.

'''Ring Time'''

Number of seconds to ring prior to going to the "no answer" destination. Default will use the global default value set in Advanced Settings. If no voicemail is configured this will be ignored.

'''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&nbsp;'''Always'''&nbsp;will cause the phone to just continue to ring without going to the "no answer" destination.&nbsp;'''Default'''&nbsp;will use the current Ring Time. If voicemail is disabled and a destination is not specified, it will be forced into&nbsp;'''Always'''&nbsp;mode.

'''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.

'''Call Waiting'''

'''''''''Enable/Disable:&nbsp;'''Set the initial/current Call Waiting state for this user's extension.&nbsp;If disabled, a second concurrent incoming call would be sent to this extension's "busy" destination.

'''Internal Auto Answer'''

'''Disable/Intercom:&nbsp;'''When set to&nbsp;'''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 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&nbsp;'''Disabled''', the phone rings as a normal phone.

'''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 CallerID 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 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.

'''Pinless Dialing'''

Enabling Pinless Dialing will allow this extension to bypass any PIN codes normally required on outbound calls.

'''Emergency CID'''

This CallerID will always be set when dialing out an outbound route designated as an Emergency route. The Emergency CID overrides all other CallerID settings.

'''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 state information will indicate that this member is not available even when it is available. Setting this to&nbsp;'''Ignore State'''&nbsp;will make the queue ignore all state information, thus always trying to contact this member. Certain side effects can occur when this route is taken due to the nature of how queues handle local channels. For example, subsequent transfers will continue to show the member as busy until the original call is terminated. In most cases, this should be set to&nbsp;'''Use State'''.

'''Recording Options'''

'''Inbound External Calls'''

'''Force/Yes/Don't Care/No/Never:'''&nbsp;Recording of inbound calls from external sources.

'''Outbound External Calls'''

'''''''''Force/Yes/Don't Care/No/Never:&nbsp;'''Recording of outbound calls to external sources.

'''Inbound Internal Calls'''

'''Force/Yes/Don't Care/No/Never:'''&nbsp;Recording of calls received from other extensions on the system.

'''Outbound Internal Calls'''

Recording of calls made to other extensions on the system.

'''On Demand Recording'''

'''Disable/Enable/Override:'''&nbsp;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 by "Force" or "Never," the cannot be paused unless "Override" is selected.

'''Record Priority Policy'''

This is the call recording policy priority relative to other extensions when there is a conflict (i.e. one extension wants to record and the other extension does not). The higher of the two priorities determines the policy. If the two priorities are equal, the global policy (caller or callee) determines the policy.

'''Dictation Services'''

'''Dictation Service'''

'''Disabled/Enabled:'''&nbsp;Whether Dictation service is available for this extension.

'''Dictation Format'''

Audio format to use for dictation ('''Ogg Vorbis''',&nbsp;'''GSM''', or&nbsp;'''WAV''').

'''Email Address'''

The email address that completed dictations are sent to.

'''From Address'''

The email address that completed dictations are sent from. Format is "A Persons Name &lt;email@[http://address.com/ address.com]&gt;", without quotes, or just a plain email address.

'''DTLS'''

(Datagram Transport Layer Security)

'''Enable DTLS'''

'''No/Yes:'''&nbsp;Enable or disable DTLS-SRTP support.

'''''''''Use Certificate'''

The Certificate to use from&nbsp;[file:///E:/display/FPG/Certificate+Management+Module Certificate Manager]

'''DTLS Verify'''

Verify that provided peer certificate and fingerprint are valid.

* 
** '''Yes:&nbsp;'''Perform both certificate and fingerprint verification
** '''No:'''&nbsp;Perform no certificate or fingerprint verification
** '''Fingerprint:'''&nbsp;Perform ONLY fingerprint verification
** '''Certificate:&nbsp;'''Perform ONLY certificate verification

'''DTLS Setup'''

Whether we are willing to accept connections, connect to the other party, or both. This value will be used in the outgoing SDP when offering and for incoming SDP offers when the remote party sends actpass

* 
** '''Active:&nbsp;'''we want to connect to the other party
** '''Passive:&nbsp;'''we want to accept connections only
** '''Act/Pass''': we will do both

'''DTLS Rekey Interval'''

Interval at which to renegotiate the TLS session and rekey the SRTP session. If this is not set or the value provided is 0 rekeying will be disabled.

'''Optional Destinations'''

'''No Answer'''

Optional destination call is routed to when the call is not answered on an otherwise idle phone. If the phone is in use and the call is simply ignored, then the busy destination will be used instead.

'''CID Prefix'''

Optional CID Prefix to add before sending to this no answer destination.

'''Busy'''

Optional destination the call is routed to when the phone is busy or the call is rejected by the user. This destination is also used on an unanswered call if the phone is in use and the user chooses not to pick up the second call.

'''CID Prefix'''

Optional CID Prefix to add before sending to this busy destination.

'''''''''Not Reachable'''

Optional destination the call is routed to when the phone is offline, such as a softphone currently off or a phone unplugged.

'''CID Prefix'''

Optional CID Prefix to add before sending to this not reachable destination.

'''Other'''

'''Endpoint'''

'''Brand'''

Brand of device to be provisioned

'''MAC'''

MAC Address of device to be provisioned

'''Template'''

Template to use for device

'''Model'''

Model of device to be provisioned

'''Account'''

Account number to be assigned

'''iSymphony Settings'''

'''Add to iSymphony'''

'''yes/no:&nbsp;'''Whether to&nbsp;Makes this extension available in iSymphony

'''Auto Answer'''

'''yes/no:&nbsp;'''Whether to make this extension automatically answer the initial call received from the system when performing an origination within iSymphony. Only works with Aastra, Grandstream, Linksys, Polycom, and Snom phones.

'''Device Options'''

'''''''''Channel'''

Choose the FXS channel for this extension

'''Parkinglot'''

Choose a default Parking Lot for this extension.

'''Language'''

'''Language Code'''

This will cause all messages and voice prompts to use the selected language if installed. Languages can be added or removed in the Sound Languages module.

'''Default Group Inclusion'''

'''Default Page Group'''

'''Exclude/Include:&nbsp;'''Whether this extension/device will be part of the default page group.

'''Default VMblast Group'''

'''Exclude/Include:&nbsp;'''Whether this extension/device will be part of the default voicemail blast group.&nbsp;'''Include'''&nbsp;will be ignored if the user does not have a voicemail box.

'''Saving the Extension'''

* Click the&nbsp;'''Submit'''&nbsp;button
* Click the&nbsp;'''Apply Config&nbsp;'''button