查看“分机-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;'''Whether to delete the voicemail message from the mailbox after it is e-mailed to the user. If set to&nbsp;'''Yes''', this would provide functionality that allows users to receive their voicemail via e-mail alone, rather than needing to retrieve it from the web interface or a telephone.

If '''Delete Voicemail = Yes''', then you MUST set an e-mail address for the user above, and also set '''Email Attachment = Yes'''. Otherwise, the voicemail message would be lost forever, because it would not be e-mailed, and would be deleted from the system.

'''VM Settings'''

''Optional:&nbsp;''Advanced settings. Enter voicemail options, separated by the pipe symbol (|). For example, "review=yes | maxmessage=60" May be left blank.

'''VM Context'''

This is the Voicemail Context, which is normally set to "default." Do not change unless you understand the implications.

'''VMX Locater™'''

VMX Locater is designed to help a caller reach an operator and/or find you when you are not at your main phone. If enabled, the user will want to consider recording voicemail greetings that instruct a caller on which options to press (0, 1, and/or 2).

Whenever you enter information into the 0, 1, and/or 2 options below, you should run a test to make sure the number is functional, because otherwise the caller might become stranded or receive messages about a number being invalid.

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

'''Enabled&nbsp;'''

'''Yes/No:'''&nbsp;Whether to enable the VMX Locater feature. Set to&nbsp;'''Yes'''&nbsp;if you would like to enable this feature and edit the options below.

'''Use When'''

Select one or more of the buttons to enable VMX Locater for these types of greetings:&nbsp;'''Unavailable, Busy,'''&nbsp;and/or'''&nbsp;Temporary.'''

'''Voicemail Instructions'''

'''Yes/No:'''&nbsp;Whether to play instructions after playing your greeting. If set to&nbsp;'''No''', only a beep will be played after your personal voicemail greeting.

'''Press 0'''

Check the&nbsp;'''Go to Operator&nbsp;'''box to send the caller to the operator when they press 0. Uncheck the&nbsp;'''Go to Operator&nbsp;'''box and enter an alternative destination if you want the caller to be sent to a different destination when they press 0. This feature is still accessible to callers even when VMX Locater is disabled for the user.

'''Press 1'''

''Optional''&nbsp;- Enter a destination to send the caller to when they press 1.&nbsp;This can be an internal extension, ring group, queue, or external number such as a cell phone number.

'''Press 2'''

''Optional''&nbsp;- Enter a destination to send the caller to when they press 2.&nbsp;This can be an internal extension, ring group, queue, or external number such as a cell phone number.

'''Find Me / Follow Me'''

* Click on the&nbsp;'''Find Me / Follow Me'''&nbsp;tab.
* Find Me / Follow Me is enabled by default here so that you may edit the settings. After entering settings, you can disable it if desired.

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

'''General Settings'''

'''Enabled'''

'''''''''Yes/No:&nbsp;'''Whether to enable Find Me / Follow Me. Must be set to&nbsp;'''Yes'''&nbsp;(at least temporarily) in order to edit other settings on this page. If you leave it set to&nbsp;'''Yes''', Find Me / Follow Me will be active for this extension when you save the extension and apply config. You can set to&nbsp;'''No'''&nbsp;to disable Find Me / Follow Me for an extension until the user activates it.

'''Initial Ring Time'''

Use the drop-down menu to select initial ring time, in seconds. This is the number of seconds to ring the primary extension prior to proceeding to the follow-me list. If "0," the primary extension will not be rung before proceeding to the follow-me list. The extension can also be included in the follow-me list.

'''Ring Strategy'''

* 
** '''ringallv2:'''&nbsp;ring Extension for duration set in Initial Ring Time, and then, while continuing call to extension, ring Follow-Me List for duration set in Ring Time.
** '''ringall:'''&nbsp;ring Extension for duration set in Initial Ring Time, and then terminate call to Extension and ring Follow-Me List for duration set in Ring Time.
** '''hunt:'''&nbsp;take turns ringing each available extension
** '''memoryhunt:'''&nbsp;ring first extension in the list, then ring the 1st and 2nd extension, then ring 1st 2nd and 3rd extension in the list.... etc.
** '''<nowiki>*-prim:</nowiki>'''&nbsp;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 in do-not-disturb&nbsp;(DND) mode, it won't be rung. If the primary is in call forward (CF) unconditional mode, then all will be rung.
** '''firstavailable:'''&nbsp;ring only the first available channel
** '''firstnotonphone:'''&nbsp;ring only the first channel which is not off hook - ignore CW

'''Ring Time'''

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.

'''Follow-Me List'''

Enter a list of extensions to ring, one per line, or use the Extension Quick Pick menu below.&nbsp;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&nbsp;[file:///E:/display/FPG/Outbound+Routes+Module Outbound Routing]).

'''Extension Quick Pick'''

This drop-down menu gives you the option to select existing extensions to add to the Follow-Me List above.

'''Announcement'''

Select the message to be played to the caller before dialing the find me / follow me list. Default = none. The drop-down menu shows available system recordings.&nbsp;To add additional recordings, please use the&nbsp;[file:///E:/display/FPG/System+Recordings+Module System Recordings]&nbsp;module.

'''Play Music On Hold'''

If you select a Music on Hold class to play, instead of the default "Ring," the caller will hear that MoH instead of ringing while they are waiting for someone to pick up.

'''CID Name Prefix'''

''Optional''&nbsp;- You can optionally prefix the Caller ID name when ringing extensions in this group. For example, if you prefix with "Sales:", a call from John Doe would display as "Sales:John Doe" on the find me / follow me list extensions that ring.

'''Alert Info'''

''Optional -&nbsp;''You can optionally include an Alert Info, which can create distinctive rings on SIP phones.

'''Call Confirmation Configuration'''

'''Confirm Calls'''

'''Yes/No:&nbsp;'''Whether to confirm external calls. Call confirmation requires the remote party to press 1 to accept the call. This can help prevent an unanswered find me / follow me call from reaching an external voicemail box. This feature only works with the ringall or ringall-prim ring strategies.

'''Remote Announce'''

Message to be played to the person receiving the call if&nbsp;'''Confirm Calls = Yes'''. You can use the default message or select one of your&nbsp;[file:///E:/display/FPG/System+Recordings+Module System Recordings].

'''Too-Late Announce'''

Message to be played to the person receiving the call if&nbsp;'''Confirm Calls = Yes'''&nbsp;and the call has already been accepted elsewhere.

'''Change External CID Configuration'''

'''Mode'''

* 
** '''Default''': Transmits the caller's CID if allowed by the trunk.
** '''Fixed CID Value''': Always transmit the Fixed CID Value below.
** '''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