顶顶通呼叫中心中间件(mod_cti基于FreeSWITCH)-排队（ACD 话务分配）接口

进入排队

cti_acd acdname maxwaittime[s] priority

<action application="cti_acd" data="acdnaem 180 1"/>
  • acdname ACD 名称
  • maxwaittime 最大等待时间，单位秒，超过这个时间，没有接通坐席，会强制离开排队。
    • 如果需要没空闲坐席不等待，可以把最大等待时间设置为 nowait 。
    • 如果需要一直等待永不超时设置为0。
  • priority 优先级， 默认3个优先级 0低优先级 1中（默认） 2高优先级别。

排队配置

cti_acd@domain [哈希表]

  1. key 名称

  2. value 配置

    {
        "announce": "acd/欢迎.wav",
        "moh": "acd/等待音乐.wav",
        "timeout": {
            "wait_timeout": 10,
            "timeout_key": "1",
            "timeout_time": 5,
            "timeout_sound": "acd/等待超时.wav"
        },
        "wrapup": {
            "wrapup_sound": "acd/满意度调查.wav",
            "wrapup_bad_sound": "acd/无效按键.wav",
            "wrapup_exit_sound": "acd/结束语.wav",
            "wrapup_time": 3,
            "wrapup_key": "[1,2]",
            "wrapup_result": ""
        },
        "beep_time": 0.3,
        "play_employee_id": {
            "after_sound": "acd/工号之后.wav",
            "mode": 0
        },
        "linegroup": "默认组"
    }

acd_template.png

  • announce 进入队列先播放的欢迎语
    • 通道变量 cti_acd_announce 可以替换这个声音，如果有的通话不需要播放这个声音，可以设置通道变量cti_acd_announce 为”none” 。
  • moh 等待时候的背景音乐
  • strategy 分配策略，目前只实现了一个，根据线路组空闲时间分配坐席。
  • line_redial_interval 重拨间隔 坐席呼叫失败后的重拨间隔，单位毫秒，如果线路设置的休息时间(rest)比这个值更大，则使用线路休息时间设置。
  • line_wrapup_time 话后时间 坐席接完一个电话后的休息时间，单位毫秒。如果线路设置的休息时间(rest)比这个值更大，则使用线路休息时间设置。
  • linegroup 线路组，就是坐席组，这个队列接听电话的坐席。
  • timeout 等待超时， 原理，超时时间到了播放一个提示音提示音，可通过按键继续等待。
    • wait_timeout 超时时间，单位秒。0：不使用这个功能。
    • timeout_key 继续等待确定按键，如果不配置，按任意键都继续等待。
    • timeout_time 播放超时提示音之后，等待按键的时间。
    • timeout_sound 超时时播放的提示音，单位秒。
  • wrapup 坐席挂机后的处理
    • wrapup_sound 坐席挂机后播放的提示音
    • wrapup_bad_sound 按键不符合要求时候的提示音
    • wrapup_exit_sound 离开队列时播放的声音，比如按键完成之后就会播放。
    • wrapup_time 等待按键的时间，单位秒。
    • wrapup_key 有效的按键，正则表达式，如果不配做可以接受任意按键。
    • wrapup_result 按键结果写入的通道变量名，可以和CDR配合，收集用户按键。
      • beep_time 接通电话后可以和来电对话时，坐席听到的嘟声长度，单位秒，可以是小数。比如100毫秒就设置0.1。
      • play_employee_id 播放工号
      • before_sound 播放工号之前的声音（可选）
      • after_sound 播放工号之后的声音（可选）
      • mode 模式
        • 0 通话开始时播报(双方听到)
        • 1 通话开始时播报(只呼入听到)
        • 2 通话结束时播报(只呼入听到)
      • hidden_callerid 隐藏主叫,坐席来电显示隐藏后4位号码,如果需要隐藏指定位置的号码，hidden_callerid改成number类型，比如4就是第4位开始隐藏，-4就是倒数第4位开始隐藏，默认隐藏4位，如果要隐藏5位，添加一个配置hidden_callerid_length（number类型）隐藏长度设置为5。
      • remember_employee 记忆坐席,记录接听来电的坐席，方便下次优先转接给同一个坐席，配置是记忆时间单位天

内部变量

  • acd_bridge_line 最后接通的坐席线路

  • acd_bridge_time 最后接通坐席的时间，微妙的时间戳

  • cti_acd_cause 排队结束原因

    • 0 未知
    • 1 排队名字不存在
    • 2 排队模块未初始化
    • 3 没空闲坐席不等待
    • 4 播放进入提示音的时候挂机了
    • 5 授权无效
    • 6 并发超过授权限制
    • 7 提示是否继续等待，没选择继续等待
    • 8 等待时间超过了最大等待时间
    • 9 呼叫坐席的时候挂机了
    • 10 等待的时候挂机了
    • 11 转接坐席成功

配置改变通知

config@domain [通道]

PUBLISH 通知到 config@domain。

{
	"type":"config_change",
	"table":"cti_acd",
	"key":"abc"
}
  • type,config_change：配置改变
  • table,那个表修改了，只需要@前面的。
  • key cti_acd的key

呼叫进度通知

排队中的呼叫转接给座席时，可以配置启用呼叫和应答通知。用于实现来电弹屏等业务。

配置说明

cti.json中配置

{
	"acd": {
		"state_write_redis":true,
		"notify": {
			"variables": ["caller_id_name", "destination_number"],
			"redis": {
				"channel": "acd",
				"list": "acd"
			},
			"http": {
				"url": "http://127.0.0.1/popup"
			},
			"log": false
		}
	}
}
  • state_write_redis 排队的状态信息是否写入redis的 cti_acd_state 哈希表。
  • variable 自定义变量,主叫通道获取变量对应的值。
  • redis
    • channel 通知到redis的channel
    • list 通知写入redis的list
  • http
    • url 通知到http接口的URL地址
  • log 是否打开调试日志

通知数据

注意：呼叫坐席失败会根据配置重呼，这样就可能有多次通知。

通知顺序

  • 进入排队enter，播放完欢迎提示音(announce)之后通知。
  • 转接坐席
    • 正常接通 dialer -> answer -> hangup
    • 呼叫失败 dialer->failure。
  • 离开排队leave。

参数说明

  • type 通知类型(enter:进入排队 ,dialer:开始呼叫,answer:已经接通,hangup:通话结束，failure:呼叫失败，leave:离开排队)
  • caller_uuid 来电UUID
  • caller_num 来电号码
  • caller_wait_time 来电排队时间,（单位毫秒）。就是开始排队到座席接听的等待时间。
  • called_uuid 被叫UUID
  • line_number 被叫线路号码
  • line_group 被叫线路组
  • 自定义表里acd.variable里面配置
redis通知格式

json格式

{
	"type": "dialer",
	"caller_uuid": "bbbd3492-d866-462c-8591-dbb3b0d78c76",
	"caller_num": "121",
	"caller_wait_time": "69",
	"called_uuid": "e7f36dca-d80d-4308-87c3-812c82a24949",
	"line_number": "121",
	"line_group": "2001",
	"caller_id_name": "121",
	"destination_number": "8000"
}
http通知格式

url编码

http://127.0.0.1/popup?type=failed&caller_uuid=91b2611d-1692-4af3-b8ee-88faf0db6723&caller_num=123&caller_wait_time=5120&called_uuid=61e22c49-6e14-4bbd-9b61-7a7ce473f10b&line_number=121&line_group=2001&caller_id_name=123&destination_number=8000

状态数据写入redis

cti.josn中acd.state_write_redis配置为true,会把排队状态信息入redis的 cti_acd_state@主机名 哈希表。

{
	"wait_priority": [0, 0, 0],
	"wait_count": 0,
	"assign_count": 0,
	"wrapup_count": 0
}
  • wait_priority 3个优先级分别等待中的电话数量。
  • wait_count 全部优先级等待中的电话总数。
  • assign_count 已经分配的电话数量（包含等待坐席接听和坐席已经接通的）。
  • wrapup_count 话后处理（满意度调查）电话数量。

查看fs内存中排队信息

有时候为了诊断问题需要查看 内存中排队模块的信息，可以执行fs控制台命令 cti show acd 排队名 或者shell执行 fs_cli -x "cti show acd 排队名"可以输出排队的配置信息和分配信息。

  • customer 3个优先级中等待分配的通话
  • assign 已经和坐席通话的通话
  • wrapup 话后处理的通话（满意度调查）
  • disable 已经删除的排队，不会从内存删除，会把disable设置为true

image-20220903100502642