查看“电话驻留模块”的源代码

'''电话驻留模块用户使用指南'''


'''总览'''

此模块用来创建和配置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


http://wiki.freepbx.org/download/attachments/5538550/parking-landing-page.png

'''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 会驻留呼叫在第一个有效驻留空间上。但是有一些环境则需要更加灵活的管理方式。大部分驻留空间支持到八个空间号码，但是一般话机也仅支持第一个驻留空间的几个号码。这样的话，系统将限制了最大驻留空间的使用频率。如果有一些用户有这样的需求，例如客户需要支持一个对驻留空间进行管理模块，希望在下一个一个驻留空间中以图形化的方式来查看管理驻留的顺序，调整顺序，这样就需要这样一个功能设置。

'''Returned Call Behaviour'''

如果停靠在驻留空间的呼叫超时后没有接听，系统将尝试返回到当时执行驻留的终端设备或者转发到设置的目的地东西。可选设置支持了返回驻留呼叫例如再次执行驻留，也可以支持返回呼叫条件设置（例如 Caller ID pre-pending ），通过这些信息帮助确定是否是一个超时的驻留呼叫。


'''Pickup Courtesy Tone'''

当驻留呼叫接听后，默认设置是对呼叫方播放一个礼貌性语音提示。可以修改播放东西。

'''Transfer Capability'''

驻留呼叫被接听以后，开启或关闭基于 DTMF 的转发功能，通常设置为 ‘##’。 这个功能不能控制终端话机的可编程转接按键。

'''Re-Parking Capability'''

超时后，是否可以重新驻留此呼叫。

'''Parking Alert-Info'''

在执行驻留的设备发送回呼或者转发到目的地对象前，对执行驻留的终端发送 Alert-Info  消息。 请参考官方wiki 关于不同话机Alert 消息的设置。

'''CallerID Prepend'''

在对执行驻留的设备发送回呼或者转发到目的地对象前，对驻留呼叫关联的CallerID  添加一个预设的字符标志。 这样可以确定这个驻留呼叫是来自于何处。如果和下面的 Auto CallerID Prepend  一起使用，那么将先配置，然后执行 Auto Caller ID 配置。

'''Auto CallerID Prepend'''

驻留呼叫超时后，系统自动预设一个指定的参数，可选参数为：

'''None'''

不设置预设信息。

'''Slot'''

超时驻留空间

'''Extension'''

执行驻留呼叫的本地PBX 分机号码。

'''Name'''

执行驻留呼叫的分机名称。

'''Announcement'''

在驻留呼叫被转发回驻留发起人之前或者可选目的地之前，对驻留呼叫播报语音提示。

'''Alternate Destination'''

驻留超时后，系统需要一个配置来管理超时的驻留呼叫。我们可能需要把驻留的呼叫返回到驻留发起人或者转发到设置的目的地对象。如果我们选择回呼到驻留发起人终端，则这个终端设备可能无应答或者不可达，我们还是希望这个驻留呼叫总是返回到一个可达或者有效的目的地对象，例如系统接线员，振铃组语音邮箱或者其他有效的目的地对象。所有配置的 Return Call Behavior  执行权限将优先于呼叫路由。



'''Come Back to Origin'''

如果驻留超时，选择YES，表示直接返回到驻留呼叫的发起人； 选择No， 则直接返回到配置的目的地。如果驻留呼叫返回到驻留呼叫的发起人终端，此时终端处于无应答或者无效状态，则最后使用目的地对象。如果选择了Yes， 返回的呼叫会直接发送到终端本身，不会经过系统的拨号规则。这里我们假设此时的呼叫仍然没有挂机，在分机的语音邮箱或者其他的业务流程中。所以，如果终端设备没有任何反映的情况下，我们必须确保有一个正确的目的地对象来完成呼叫流程。

'''Destination'''

驻留呼叫超时后，转发驻留呼叫到此目的地对象。这里可以是PBX 任何有效目的地对象。