如何在 XSwitch 中管理用户及分机

用户和分机是 XSwitch 系统中两个非常重要的概念，它们相互独立但又互相依赖。本文旨在阐述两者的概念、关系及使用。

• 用户指一个人，属性有用户名、密码、类型（坐席或普通）等，可以登录Web系统。
• 用户名只可以是字母与数字的组合，区分大小写，除-_.外不能有特殊符号。
• 用户名称可以是中文或英文。
• 当用户类型设置为坐席时，可以在呼叫中心中作为坐席使用。
• 系统默认有两个特殊用户：
  • ID 为0的system用户，没有任何权限，不能登录系统，不能被删除。当对应不到真人的时候可以使用它，如不属于任何人的分机号，可以关联到该用户。
  • ID 为1的admin用户，该用户是最高级的管理员，在简单的场景中可以使用，在复杂的权限管理下，每个管理员都应该使用自己的账号登录。
• 用户密码长度为8-20位，必须同时包含大小写字母、数字、特殊字符!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~。
• 无法使用未创建的用户登录Web系统。

• 分机指进行音视频呼叫的真实载体，有以下一些基本属性：
  • ID：分机唯一标志，系统自动生成。
  • 名称：该分机的名称，支持中文和空格。
  • 号码：分机号，是一个“标志符字符串”，即只能是数字和字母的组合，区分大小写，除-._外不支持其它字符，如不能有空格或中文等。
  • 密码：分机的密码，在注册和呼叫时会用到。分机密码长度为8-20位，格式需为大小写字母+数字（可以包含特殊字符!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~）。
  • 呼叫源：如果该分机发起呼叫，XSwitch 就会认为它来自该呼叫源，进而通过呼叫源查找路由。
  • 所属用户：选择一个已有的用户。
  • 主叫名称：若为空，则以名称字段作为主叫名称，若设置为PASS，则透传 SIP INVITE 中的主叫名称。
  • 主叫号码：若为空，则使用号码字段作为主叫号码，若设为PASS，则透传 SIP INVITE 中的主叫号码。
  • 域：该号码所属的域。
  • 分机类型：见分机类型。
• 无法使用未创建的分机注册到XSwitch。

• 网关：将分机作为网关使用，比如可以使用 FXO 口的网关使用该账号注册到 XSwitch 上，多用于 FSO 口的网关在 NAT 后面的情况。
• SIP：SIP 协议的 SIP分机，包括 SIP over WebRTC。
• WebRTC：Verto 协议的 WebRTC 分机。
• H.323：支持 H.323 协议的分机。
• 海康摄像头：支持 GB28181 协议的海康摄像头注册。

点击分机详情页面的【显示分机高级配置】按钮可以设置如下主叫属性：

• 可以呼出
• 禁止呼出

• 紧急呼叫：只能拨打 110、119 等特殊号码。
• 本局呼叫：仅在 XSwitch 内部呼叫。
• 本地呼叫：仅呼叫本地网（无区号）的号码。
• 国内呼叫：仅呼叫国内号码。
• 国际呼叫：可以呼叫国际号码。

权限是递增的，高级的权限自动具有低级的呼叫权限，即开通了国际呼叫的分机可以呼叫所有号码。

开启可以代答其他通话的权限。

• 无权限：不可以代答任意通话。
• 分组代答：当同组中有振铃分机时，拨打*63可以代答该分机。
• 代答组名：选择组名，仅可以代答此组里的通话。
• 全局代答：拨打*75可以代答正在振铃的分机。

如果开启强插权限，如果某分机正在通话，拨打*62+分机号可以强行插入当前通话形成三方通话。

如果开启强拆权限，如果某分机正在通话，拨打*63+分机号可以强行插入当前通话并强制原来与该分机通话的一方挂机。

如果开启监听权限，拨打*78+分机号可以监听指定号码的通话。

点击分机详情页面的显示分机高级配置按钮可以设置以下属性：

• 可以呼叫此号码。
• 禁止呼叫此号码。

• 启用/禁用
• 语音邮箱密码：仅支持纯数字和*，以便从话机上读取语音邮件时能正确输入。

这是一个被叫业务。分机开启了语音信箱后，如果做被叫时无法接通，则可以将来话转到语音邮箱提示主叫进行留言。

• 呼叫转移号码：转移到的目的号码。
• 呼叫转移类型：有以下几种：
  • 与以下号码同振
  • 无应答转到以下号码
  • 呼叫失败转到以下号码
  • 无条件转到以下号码

配合呼叫转移号码以及超时时长使用，以分机 1001 为例，无条件转移，如果呼叫 1001，那么则直接转接到呼叫转移号码对应的号码。如果设置了同振，则两个号码同时振铃。如果设置无应答转，则 1001 在指定时间内响铃未应答情况下，通话转移到呼叫转移号码对应的号码。默认超时时长为 50 秒，如果设置了超时时长为 15，则表示 1001 分机 15 秒后没有应答则直接转接到其他号码。

呼叫该分机的超时时长。

• 启用/禁用
• 铃音：铃音或音乐文件。当该分机做被叫时该彩铃会播放给主叫方

• 不允许被代答
• 允许同组代答：当该分机振铃时，允许其他同组的分机通过拨打*63代答该通话
• 代答组名：输入一个组名
• 允许全局代答：允许其他拥有全局代答权限的分机通过拨打*75代答正在振铃的该分机

允许其他分机拨打*62+分机号可以强行插入该分机的当前通话。

允许其他分机拨打*63+分机号可以强行插入当前通话并强制该分机通话挂机。

允许其他分机拨打*78+分机号监听该号码的通话。

呼叫该分机时的编码。这可以在 A 与 B 没有共同编码时强制使用相应的编码。分机编码设置优先级高于路由界面中的媒体编码，即当分机设置了编码 PCMA，路由界面设置了媒体编码 PCMU，则选择 PCMA 去呼叫此分机。

开启后则自动录音，此自动录音和路由上的自动录音区别在于路由时针对所有。分机的录音是只针对此分机（前提路由不开启录音）。

• 用户用于登录Web系统，管理分机，分机用于接打电话。
• 一个用户可以有0个或多个分机。也可以一一对应。
• 分机必须归属于某个用户。

创建新用户账号有三种方法：

• 进入【用户】⇨【用户】界面，点击【新建】，选择【单个创建】，输入用户名、名称、登录密码、类型等红色必填项，然后点击【提交】即可。默认创建用户同时创建分机，分机号码和密码如果不填写则默认和用户号码及密码相同。如不需创建分机，则关闭【同时创建分机】选项，如下图所示：

• 进入【用户】⇨【用户】界面，点击【新建】，选择【批量创建】，输入起始号码、结束号码、登录密码、类型等必填项。默认创建用户同时创建分机，分机号码和密码如果不填写则默认和用户号码及密码相同。如不需创建分机，则关闭【同时创建分机】选项。批量创建时用户账号仅支持纯数字输入。如下图所示：

• 进入【用户】⇨ 用户】界面，点击【导入】（适用于创建大批量用户）可以批量导入用户和分机。导入仅支持 Excel 格式的文档，可以通过【导出】获取文件模版。

注意：在只导入用户或分机时，最好给每个不同的账号分配不同的密码，可以参见在 Excel 中生成随机密码。

新建分机有三种方法：

• 在分机列表页面点击【新建】⇨【单个创建】或【批量创建】，单个创建或批量创建。
• 在分机列表页面点击【导入】，导入一批分机（可根据导出的表格作为模版）。
• 在用户详情界面可以新建属于该用户的分机。

进入【用户】⇨【用户】界面，点击需要修改的用户名，进入【用户详情】页面。点击右上角【编辑】按钮即可进行信息修改。目前只可修改“名称”和“类型”。如下图所示：

进入【用户】⇨【用户】界面，点击【批量设置用户】按钮。添加需要修改的用户，成功后下拉选择类型即可。如下图所示：

进入【用户】⇨【用户】界面，点击需要修改的用户名，进入【用户详情】页面。点击右上角【修改密码】按钮即可进行密码修改。可使用“随机密码”功能生成新密码。如下图所示：

暂不支持批量修改用户密码。

进入【用户】⇨【分机】界面，点击需要修改的分机号码，进入【分机详情】页面。即可进行分机名称、分机密码等信息修改。如下图所示：

进入【用户】⇨【分机】界面，点击【批量设置分机】按钮。添加需要修改的分机，随后修改对应信息即可。如下图所示：

暂不支持批量修改分机密码。

进入【用户】⇨【用户】界面，点击需要删除的用户最右侧的【删除】按钮。如下图所示：

也可开启快速删除模式，快速删除模式将直接删除所选用户，不再有确认删除的提示框。如下图所示：

进入【用户】⇨【分机】界面，点击需要删除的分机最右侧的【删除】按钮。如下图所示：

也可开启快速删除模式，快速删除模式将直接删除所选分机，不再有确认删除的提示框。如下图所示：