HowTo文档

如何在 XSwitch 中配置路由?

路由是 XSwitch 呼叫调度的核心核心模块,决定呼叫的来源匹配、号码转发与业务落地规则,是实现分机互打、呼入呼出、IVR语音导航等业务的基础。下文将从核心概念、前置准备、基础操作及常用场景,完整讲解 XSwitch 路由的标准配置流程。

配置路由前需明确以下核心概念,避免操作失误:

  • 呼叫源:呼叫的发起方,主要包括分机context-1、外部context-2等,路由需明确指定呼叫来源。

  • 目的地类型:呼叫的接收方,可设置为本地分机、IVR语音导航、会议室、网关或IP地址等配置。

  • 字冠:被叫号码的前缀,用于匹配路由规则(如手机前缀13/14/15,固话前缀0),是路由匹配的关键。

  • 网关:对接运营商的外线线路,分为注册式和非注册式,是分机呼叫外网、外网呼入的核心载体。

  • Application:路由匹配成功后,系统自动执行的呼叫动作,常用动作包括应答、录音、桥接等,实现复杂呼叫功能。

完成以下准备工作,确保路由配置顺利进行:

  1. 使用admin超级账号登录XSwitch,拥有全部路由配置权限。

  2. 确认分机已通过SIP软电话或硬件话机注册成功,可拨打9196进行回声测试,验证分机通信正常。

  3. 若需实现分机呼叫外网功能,需提前配置并启动对应网关,确保网关与运营商线路正常连接;若使用特殊路由动作,需提前加载对应的功能模块,否则会导致呼叫失败。

  1. 新建路由:单个路由直接点击【路由】→【新建】,填写呼叫源、字冠、目的地等必填项,提交即可;批量创建路由点击页面右上方【导入】,先导出系统模板,按模板规范填写批量路由信息后上传,注意核对必填项格式,避免导入失败。

  2. 修改路由:点击路由列表中对应路由的名称,进入详情页面,点击【编辑】,调整所需参数(如字冠、目的地),保存后立即生效。

  3. 删除与启用:在路由列表右侧,点击【删除】可删除无用路由(删除前确认无正在使用的呼叫,避免影响通信);点击【启用】可切换路由状态,关闭后的路由将不再参与呼叫匹配。

分机互打

呼叫源选择“分机context-1”,输入分机对应的字冠(如分机号为1000~1029,字冠填10)和号码最大位长(如4位分机填4),目的地类型选择“本地分机”,配置完成后点击【保存】,立即生效。

分机呼外网

分机呼叫外网需通过网关转发,配置步骤如下:

呼叫源选择“分机context-1”,被叫字冠填写外网号码前缀(如国内手机填13/14/15,固话填0),设置对应号码最大位长(手机11位、固话7~11位),目的地类型选择已配置的网关;若分机拨外网需先拨0,设置“被叫号码变换”为删除前缀0,确保运营商接收正确号码。

若无需网关,可直接将目的地类型设为“IP地址”,填写运营商SIP服务器IP+端口即可。

如何在 XSwitch 中添加分机?