1、座席功能通知消息
云通讯平台向应用服务器侧发送的请求通知，包括座席状态通知、座席操作结果通知、用户进入排队成功通知、用户退出排队通知、座席与用户通话结束通知、用户与座席通话结束后的录音完成通知、座席外呼用户应答通知、队列排队人数溢出通知、班长监听结束通知、座席外呼用户振铃通知、用户输入数据通知、获取用户信息通知等。
1.1 座席状态通知
当座席的状态发生变化后，云平台会向应用服务器侧发送此请求消息，其中“agentstate”相对url地址段是固定内容不可变。
请求地址
POST /agentstate?appid={appid}&callid={callid}&agentid={agentid}&agentstate={agentstate}&number={number}&time={time}&queuetype={queuetype}&alertingtime={alertingtime}&isqueue={isqueue} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| agentid |
整数 |
座席ID，4位正整数，由应用侧管理。 |
| agentstate |
整数 |
座席状态：0坐席准备中不能接电话 ；1坐席准备就绪可以接听来电； 2坐席锁定中，锁定中是云通讯平台在转接到坐席的时候先对坐席进行锁定操作，以避免其他用户呼入后分配到同一个坐席； 3坐席通话中不能接听其他来电；4座席线路忙，如果用云通讯的网络坐席可能是坐席不在线或者占线中，如果用落地电话则是在占线中(占线中不是通过云通讯平台的坐席进行呼叫)。默认值为0。</span> |
| callid |
字符串 |
用户呼叫id，当座席状态agentstate为2、3、由3变为0时，此值不为空。默认值为空。 |
| time |
字符串 |
状态切换时间，yyyymmddHHmiss。 |
| queuetype | 整数 | 用户排队类型，当agentstate变为2、3时此值有效。只有呼入进入排队制定队列时为有效值，坐席外呼和进入排队制定坐席时无效为默认值0。 |
| number | 整数 | 与座席通话的用户号码，当状态为2、3时值有效。 |
| appid | 字符串 | 应用id。 |
| alertingtime | 日期串 | 座席振铃时间，格式yyyymmddHHmiss，agentstate值为3时此参数有效 |
| isqueue |
0、1 |
是否有排队，agentstate值为2时此参数有效；0表示未排队、1表示有排队 |
请求回复
可回复空指令。当座席状态为“准备中”时，AS侧可根据实际设置座席状态自动切换为“准备就绪”，此时可复座席准备就绪命令，让座席立刻进入准备接电话的状态中。
1.2 座席操作结果通知
云平台会向应用服务器侧发送此请求消息，包括班长监听、呼叫转接、准备就绪、座席结束通话等操作通知。
请求地址
POST /<customurl>?appid={appid}&agentid={agentid}&type={type}&reason={reason}&time={time} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| agentid |
整数 |
座席ID，4位正整数。 |
| type |
整数 |
操作类型1班长监听、2呼叫转接、3准备就绪、4座席咨询、5呼叫转移、6咨询反回、7三方通话、8用户静音操作、9取消静音操作、10 座席主动外呼、11座席内呼、12|强插、13强拆、14 获取用户数据。 |
| result | 整数 |
0表示成功，其它值则失败。 |
| callid | 十六进制串 | 用户的callid。 |
| appid |
字符串 |
应用id。 |
| time | 字符串 | 操作时间；type值为1、2、4、5、6、7、8、9、10、11、12、13时有效。 |
请求回复
回复空指令。
1.3 用户进入排队成功通知
座席呼叫转接时用户进入排队队列的通知请求。URL中“<customurl>”可通过<Transfer>命令中的enterurl属性自定义
请求地址
POST /<customurl>?appid={appid}&callid={callid}&queuetype={queuetype}&count={count}&entertime={entertime} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| queuetype |
整数 |
用户进入的队列类型。 |
| count |
整数 |
进入后当前队列的排队人数。 |
| entertime |
字符串 |
进入队列的时间,yyyymmddHHmiss。 |
| appid |
必须 |
应用id |
请求回复
回复空指令。
1.4 用户退出排队通知
座席呼叫转接当排队超时用户选择退出队列时发送此请求消息。URL中“<customurl>”可通过<Transfer>命令中的quiturl属性自定义
请求地址
POST /<quitccs>?appid={appid}&callid={callid}&type={type}&queuetype={queuetype}&count={count}&quittime={quittime} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| type |
整数 |
退出排队类型：0超时主动退出 1达到最大排队次数强制退出 2用户挂机退出 3用户转接坐席正常退出 |
| queuetype |
整数 |
退出队列的类型。 |
| count |
整数 |
退出后队列当前的排队人数。 |
| quittime |
字符串 |
退出队列的时间，yyyymmddHHmiss |
| appid |
必须 |
应用id |
请求回复
可回复其它IVR命令，进入相关的业务逻辑。
1.5 座席与用户通话结束通知
当调用座席结束通话命令或座席或用户挂机，云平台会向应用侧发送此通知请求，成功结束，应用侧可以回复其它IVR命令。当非用户挂机时，进入后续的业务逻辑，座席结束通话命令失败则用户与座席的通话将继续，URL中“<customurl>”可通过用户进入排队命令中的agenthangupurl属性自定义。
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&duration={duration}&recordurl={recordurl}&endtype={endtype} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| endtime | 字符串 | 用户与座席通话结束时间,格式：yyyymmddHHmiss。 |
| endtype | 整数 |
通话结束类型：0座席结束通话、1座席挂机、2强拆结束、3用户挂机、4咨询反回结束通话、5座席咨询后转移呼叫、6座席转接呼叫、7咨询过程中咨询侧主动挂机、8咨询过程中用户挂机。 |
| recordurl | 字符串 | 录音下载地址。 |
| appid | 字符串 | 应用id。 |
请求回复
可回复其它IVR命令，进入相关的业务逻辑。
1.6 用户与座席通话结束后的录音完成通知
用户进入排队或座席呼叫转接命令中座席与用户通话结束后，云通讯平台向应用侧发送此通知。URL中“<customurl>”可通过<EnterCCS>或<Transfer>命令中的recordurl属性自定义
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&duration={duration}&recordurl={recordurl} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| duration |
整数 |
用户与座席通话时长。 |
| recordurl |
字符串 |
录音文件下载地址。 |
| appid |
必须 |
应用id |
请求回复
回复空指令。
1.7 座席外呼用户应答通知
座席主动外呼用户，当用户接听后云平台会向AS侧发送此通知。
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&number={number} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| appid |
必须 |
应用id |
| number |
用户号码 | 手机号码，座机号码或者通讯账号 |
请求回复
回复空指令。
1.8 队列排队人数溢出通知
用户进入排队时，若队列已经达到最大等待人数，且设置了后会发出此通知。URL中“<customurl>”可通过<EnterCCS>命令中的overflowurl属性自定义
请求地址
POST /<customurl>?appid={appid}&callid={callid}&queuetype={queuetype} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| queuetype | 整数 |
队列类型。 |
| appid |
必须 |
应用id。 |
请求回复
回复空指令。
1.9 班长监听结束通知
座席班长监听时班长挂机后会收到此通知请求。URL中“<customurl>”可通过<Monitor>命令中的notifyurl属性自定义
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| appid |
必须 |
应用id |
请求回复
回复其它IVR命令，让用户执行后续业务流程。
1.10 座席外呼用户振铃通知
座席外呼用户或座席后，当被叫有回音铃音时发送此通知，URL中“<customurl>”可通过坐席外呼中的action属性设置
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={answertime}&answertime={answertime} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| appid |
必须 |
应用id |
| answertime |
字符串 |
应答时间。 |
请求回复
回复空指令。
1.11 用户输入数据通知
座席调用命令获取用户输入数据<GetUserData＞命令后发送此通知。
请求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={answertime}&data={data}&type={type}&downloadurl={downloadurl}&result={result} HTTP/1.1
请求参数
| 参数名 |
类型 |
说明 |
|---|---|---|
| callid |
字符串 |
一个由32位数字、字符组成的唯一呼叫标识符。 |
| agentid |
整数 |
与其通话的座席id。 |
| appid |
必须 |
应用id |
| data |
字符串 |
用户按键内容。 |
| type |
整数 |
0按键内容。 |
| result |
字符串 |
0正常；1 按键超时。 |
请求回复
回复IVR空命令。