差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
cs:400systemintegration:api-open-platform [2019/09/10 09:38] wumaochang [获取历史会话列表] 修改per_page默认值 |
cs:400systemintegration:api-open-platform [2025/06/26 04:19] (当前版本) 丁艺杰 [查询技能组成员] |
||
|---|---|---|---|
| 行 4: | 行 4: | ||
| ===== 概述 ===== | ===== 概述 ===== | ||
| - | 环信客服云API开放平台以REST API的方式向第三方系统提供服务端调用的接口，用于业务系统对接和流程自动化等场景。目前，我们提供了坐席管理和历史会话相关的API，后续会根据客户需求逐步提供更丰富的接口，方便您的使用。 | + | 环信客服云API开放平台以REST API的方式向第三方系统提供服务端调用的接口，用于业务系统对接和流程自动化等场景。目前我们提供了坐席管理、历史会话、通话、工单等相关API接口，后续会根据客户需求逐步提供更丰富的接口，方便您的使用，如果上述api接口仍无法满足您的业务需求，您可以随时联系我们做进一步的沟通。 |
| - | API开放平台为旗舰版功能。 | + | API开放平台为旗舰版功能，如需使用，请联系商务或技术支持人员。 |
| ===== 获取clientID和secretID ===== | ===== 获取clientID和secretID ===== | ||
| 行 12: | 行 12: | ||
| 开通了API开放平台的每个租户，环信会提供用于认证的clientID和secretID。在调用平台的接口前，需要根据clientID和secretID生成accessToken，并将accessToken放在调用接口的请求头中使用。 | 开通了API开放平台的每个租户，环信会提供用于认证的clientID和secretID。在调用平台的接口前，需要根据clientID和secretID生成accessToken，并将accessToken放在调用接口的请求头中使用。 | ||
| - | 注：请联系环信获取租户对应的clientID和secretID。 | + | 注：如果您已开通了API开放平台功能，您可以直接在客服系统“管理员模式>设置>扩展集成>在线事件推送”里，获取到clientID和secretID，如果您未开通此功能，或开通后修改过此参数，您可请联系我们商务或技术支持获取您的租户对应的clientID和secretID。 |
| + | |||
| + | {{:cs:400systemintegration:环信客服云-api接口调用.png|}} | ||
| + | |||
| + | <WRAP center round important 100%> | ||
| + | 特殊注意：clientID和secretID为客户方需要绝对严格保密的数据，切勿对外泄露，否则极易造成企业业务数据泄露等严重问题，请务必严格管理！！ | ||
| + | </WRAP> | ||
| ===== 获取accessToken ===== | ===== 获取accessToken ===== | ||
| 行 22: | 行 29: | ||
| </WRAP> | </WRAP> | ||
| - | * Path：http://kefu.easemob.com/api/platform/tenants/{tenantId}/accessToken | + | * Path：http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/accessToken |
| * HTTP Method：POST | * HTTP Method：POST | ||
| * Request Headers: Content-Type=application/json | * Request Headers: Content-Type=application/json | ||
| 行 40: | 行 47: | ||
| <code php> | <code php> | ||
| curl -X POST \ | curl -X POST \ | ||
| - | http://kefu.easemob.com/api/tenant/1/accessToken \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/租户id/accessToken \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -d '{ | -d '{ | ||
| 行 72: | 行 79: | ||
| |accessToken| String |token| | |accessToken| String |token| | ||
| |expireTime|integer|过期时间（单位：秒）| | |expireTime|integer|过期时间（单位：秒）| | ||
| + | |||
| + | |||
| + | **调用示例截图：** | ||
| + | |||
| + | {{:cs:400systemintegration:环信客服云-api开放平台接口调用-获取token-1.png?nolink|}} | ||
| + | ===== 创建APP关联 ===== | ||
| + | |||
| + | 可调用接口创建APP关联，关联即im消息通道。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/autoCreateImAssociation | ||
| + | * HTTP Method: POST | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request POST \ | ||
| + | --url http://租户ID.sh.absoloop.com/api/platform/tenants/租户ID/autoCreateImAssociation \ | ||
| + | --header 'Accept: */*' \ | ||
| + | --header 'Accept-Encoding: gzip, deflate, br' \ | ||
| + | --header 'Connection: keep-alive' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --header 'Cookie: tgw_l7_route=ac6e8cfb38f79314f1d1a723829201ce' \ | ||
| + | --header 'Kefu-Token: 50a09b1ba2eee852172b8c8f724d75fc' \ | ||
| + | --header 'User-Agent: PostmanRuntime-ApipostRuntime/1.1.0' \ | ||
| + | --data '{ | ||
| + | "associationName":"app关联名字" | ||
| + | }' | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |associationName|String|N|关联名称| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "id": 23597, | ||
| + | "tenantId": 29748, | ||
| + | "name": "6666", | ||
| + | "description": null, | ||
| + | "orgName": "1428201012025562", | ||
| + | "appName": "kefuchannelapp29748", | ||
| + | "clientId": "YXA6W8LnQAxXEeuh8wWPzpsadg", | ||
| + | "clientSecret": "YXA6wc3HKZZvXVlSl2M5arIpqLqqV_A", | ||
| + | "serviceEaseMobIMNumber": "kefuchannelimid_600643", | ||
| + | "serviceEaseMobIMPassword": null, | ||
| + | "createDateTime": 1607959692553, | ||
| + | "ispass": true, | ||
| + | "isrun": true, | ||
| + | "dutyType": "None", | ||
| + | "agentQueueId": null, | ||
| + | "secondQueueId": null, | ||
| + | "robotId": null, | ||
| + | "secondRobotId": null, | ||
| + | "timeScheduleId": 0, | ||
| + | "usermail": "d938ebd9-86cb-4b89-8c12-54121b491c36@easemob.com", | ||
| + | "password": null, | ||
| + | "token": null, | ||
| + | "techChannelInfo": null, | ||
| + | "experience": false, | ||
| + | "appKey": "1428201012025562#kefuchannelapp29748" | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | | status | String | 接口响应状态 | | ||
| + | |id | int | 关联ID | | ||
| + | |tenantId | int | 租户ID | | ||
| + | |name | String | 关联名称 | | ||
| + | | description | String | 描述 | | ||
| + | | orgName | String | | | ||
| + | | appName | String | 应用名称 | | ||
| + | | clientId | String | | | ||
| + | | clientSecret | String | 秘钥 | | ||
| + | | serviceEaseMobIMNumber | String | 环信IM账号 | | ||
| + | | ServiceEaseMobIMpassword | String | 环信IM密码 | | ||
| + | | createDateTime | Data | 创建时间 | | ||
| + | | ispass | boolean | | | ||
| + | | isrun | boolean | | | ||
| + | | dutyType | DutyType | 绑定是全天还是分上下班（枚举：Allday(全天)、Onoff(上班时段和下班时段)、None(空)、NonWorkHours(下班时间)、WorkHours(上班时间)） | | ||
| + | | agentQueueId | long | 上班时间或全天绑定的技能组id | | ||
| + | | secondQueueId | long | 下班时间绑定的技能组id | | ||
| + | | robotId | long | 上班时间或全天绑定的机器人id | | ||
| + | | secondRobotId | long | 下班时间绑定的机器人id | | ||
| + | | timeScheduleId | int | 时间计划 | | ||
| + | | usermail | String | 邮箱（随机生成） | | ||
| + | | password | String | 密码（随机生成） | | ||
| + | | token | String | | | ||
| + | | techChannelInfo | String | | | ||
| + | | experience | | | ||
| + | | appKey | | | ||
| + | |||
| ===== 管理坐席 ===== | ===== 管理坐席 ===== | ||
| 行 79: | 行 187: | ||
| 可根据坐席的邮箱、真实姓名、手机号码、工号，对坐席进行模糊查询。 | 可根据坐席的邮箱、真实姓名、手机号码、工号，对坐席进行模糊查询。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agents | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agents |
| * HTTP Method: GET | * HTTP Method: GET | ||
| * Request Headers: Kefu-Token=${accessToken} | * Request Headers: Kefu-Token=${accessToken} | ||
| * 可能的错误码：详见：[[#错误码说明|错误码说明]] | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| - | **Curl示例：** | + | **Curl示例-查询多个坐席：** |
| <code php> | <code php> | ||
| curl -X GET \ | curl -X GET \ | ||
| - | 'http://kefu.easemob.com/api/tenants/1/agents?page=0&size=10&keyValue=32273591@qq.com' \ | + | 'http://kefu.sh.absoloop.com/api/platform/tenants/1/agents?&agentType=Message' \ |
| + | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | </code> | ||
| + | |||
| + | **Curl示例-查询单个：** | ||
| + | |||
| + | <code php> | ||
| + | curl -X GET \ | ||
| + | 'http://kefu.sh.absoloop.com/api/platform/tenants/1/agents?&agentType=Message&keyValue=zhangsan@qq.com' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| </code> | </code> | ||
| 行 98: | 行 214: | ||
| |page|int|Y|第几页，从0开始| | |page|int|Y|第几页，从0开始| | ||
| |size|int|Y|每页显示的数据| | |size|int|Y|每页显示的数据| | ||
| - | |keyValue|String|Y|模糊查询，username（邮箱）,trueName（真实姓名）,mobilePhone（手机号码）,agentNumber（工号）| | + | |keyValue|String|Y|模糊查询，username（邮箱）,trueName（真实姓名）| |
| + | |agentType|String|N|坐席类型：All 全渠道座席,Message 在线座席，Ticket 工单座席，CallCenter 呼叫中心座席， MVCombine 视频客服（VEC独立视频），默认为全部| | ||
| **Response示例：** | **Response示例：** | ||
| 行 111: | 行 228: | ||
| "userType": "Agent", | "userType": "Agent", | ||
| "userScope": "Tenant", | "userScope": "Tenant", | ||
| + | "nicename": "张三老师", | ||
| "password": "", | "password": "", | ||
| "username": "32273591@qq.com", | "username": "32273591@qq.com", | ||
| 行 128: | 行 246: | ||
| } | } | ||
| ], | ], | ||
| - | "avatar": "//sandbox.kefu.easemob.com/v1/tenants/28811/mediafiles/25763dd6-3b84-43ac-9471-869ec33bc91e5aS05YOPLnBuZw==/cutout?arg=0_0_1024_1024_300_300 | + | "avatar": "//kefu.sh.absoloop.com/v1/tenants/28811/mediafiles/25763dd6-3b84-43ac-9471-869ec33bc91e5aS05YOPLnBuZw==/cutout?arg=0_0_1024_1024_300_300 |
| \t", | \t", | ||
| 行 154: | 行 272: | ||
| | userType | String | 坐席类型 | | | userType | String | 坐席类型 | | ||
| | userScope | String | 所属范围 | | | userScope | String | 所属范围 | | ||
| + | | nicename| String | 坐席昵称| | ||
| | password | String | 密码 | | | password | String | 密码 | | ||
| | username | String | 账号(邮箱) | | | username | String | 账号(邮箱) | | ||
| 行 160: | 行 279: | ||
| | lastUpdateDateTime | String | 更新时间 | | | lastUpdateDateTime | String | 更新时间 | | ||
| | status | String | 启用状态 | | | status | String | 启用状态 | | ||
| - | | state | String | 在线状态 | | + | | state | String | 在线与离线状态，在线状态Online包含有：Online与Idle(空闲)、Busy(忙碌)、Hidden(隐身)、Leave(离开) ，离线状态Offline包含有：Offline(离线)、Logout（登出）注： Online与Idle均为空闲状态，后者主要用于单点登录，未做单点可忽略，Logout为瞬时操作状态，建议都是用离线标识| |
| | maxServiceSessionCount | int |接待人数| | | maxServiceSessionCount | int |接待人数| | ||
| | trueName | String |真实姓名| | | trueName | String |真实姓名| | ||
| 行 170: | 行 289: | ||
| | scope | String | 所属范围 | | | scope | String | 所属范围 | | ||
| | bizId | String | 所属业务ID | | | bizId | String | 所属业务ID | | ||
| - | | onLineState | String | 在线状态 | | + | | onLineState | String | 在线状态,同State字段 | |
| - | | currentOnLineState | String | 在线状态 | | + | | currentOnLineState | String | 在线状态,同State字段 | |
| | first | Boolean | 是否为第一页 是：true 否：false | | | first | Boolean | 是否为第一页 是：true 否：false | | ||
| | last | Boolean | 是否为最后一页 是：true 否：false | | | last | Boolean | 是否为最后一页 是：true 否：false | | ||
| 行 184: | 行 303: | ||
| 添加坐席，并设置坐席的昵称、登录邮箱、密码、真实姓名等信息。 | 添加坐席，并设置坐席的昵称、登录邮箱、密码、真实姓名等信息。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent |
| * HTTP Method: POST | * HTTP Method: POST | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 197: | 行 316: | ||
| "password":"qwe12345", | "password":"qwe12345", | ||
| "trueName":"321", | "trueName":"321", | ||
| + | "agentType":"All", | ||
| "mobilePhone":"", | "mobilePhone":"", | ||
| "agentNumber":"", | "agentNumber":"", | ||
| 行 208: | 行 328: | ||
| <code php> | <code php> | ||
| curl -X POST \ | curl -X POST \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 216: | 行 336: | ||
| "password":"qwe12345", | "password":"qwe12345", | ||
| "trueName":"321", | "trueName":"321", | ||
| + | "agentType":"All", | ||
| "mobilePhone":"", | "mobilePhone":"", | ||
| "agentNumber":"", | "agentNumber":"", | ||
| 行 231: | 行 352: | ||
| |password| String |Y|密码| | |password| String |Y|密码| | ||
| |trueName| String |Y|真实姓名| | |trueName| String |Y|真实姓名| | ||
| + | |agentType| String |N|坐席类型：All 全渠道座席,Message 在线座席，Ticket 工单座席，CallCenter 呼叫中心座席，， MVCombine 视频客服（VEC独立视频），默认为在线坐席| | ||
| |mobilePhone|int|Y|电话号码| | |mobilePhone|int|Y|电话号码| | ||
| |agentNumber|int|Y|工号| | |agentNumber|int|Y|工号| | ||
| 行 273: | 行 395: | ||
| | tenantId | int | 租户ID | | | tenantId | int | 租户ID | | ||
| | userId | String | 坐席ID | | | userId | String | 坐席ID | | ||
| - | | userType | String | 坐席类型 | | + | | userType | String | 坐席类型：坐席/管理员 | |
| | userScope | String | 所属范围 | | | userScope | String | 所属范围 | | ||
| | nicename | String | 坐席的昵称 | | | nicename | String | 坐席的昵称 | | ||
| 行 300: | 行 422: | ||
| 注：需正确填写坐席的登录邮箱地址（username字段）。 | 注：需正确填写坐席的登录邮箱地址（username字段）。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent |
| * HTTP Method: PUT | * HTTP Method: PUT | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 312: | 行 434: | ||
| "username":"32273591@qq.com", | "username":"32273591@qq.com", | ||
| "trueName":"小环", | "trueName":"小环", | ||
| + | "agentType":"All", | ||
| "mobilePhone":"", | "mobilePhone":"", | ||
| "agentNumber":"", | "agentNumber":"", | ||
| 行 323: | 行 446: | ||
| <code php> | <code php> | ||
| curl -X PUT \ | curl -X PUT \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 330: | 行 453: | ||
| "username":"32273591@qq.com", | "username":"32273591@qq.com", | ||
| "trueName":"小环", | "trueName":"小环", | ||
| + | "agentType":"All", | ||
| "mobilePhone":"", | "mobilePhone":"", | ||
| "agentNumber":"", | "agentNumber":"", | ||
| 行 344: | 行 468: | ||
| |username| String |Y|账号(邮箱)| | |username| String |Y|账号(邮箱)| | ||
| |trueName| String |N|真实姓名| | |trueName| String |N|真实姓名| | ||
| + | |agentType| String |N|坐席类型：All 全渠道座席,Message 在线座席，Ticket 工单座席，CallCenter 呼叫中心座席， MVCombine 视频客服（VEC独立视频），默认为在线坐席| | ||
| |mobilePhone|int|N|电话号码| | |mobilePhone|int|N|电话号码| | ||
| |agentNumber|int|N|工号| | |agentNumber|int|N|工号| | ||
| 行 365: | 行 490: | ||
| 获取租户的所有角色，包括管理员、坐席、自定义角色。 | 获取租户的所有角色，包括管理员、坐席、自定义角色。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/roles | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/roles |
| * HTTP Method: GET | * HTTP Method: GET | ||
| * Request Headers: Kefu-Token=${accessToken} | * Request Headers: Kefu-Token=${accessToken} | ||
| 行 374: | 行 499: | ||
| <code php> | <code php> | ||
| curl --request GET \ | curl --request GET \ | ||
| - | --url http://kefu.easemob.com/api/tenants/1/roles \ | + | --url http://kefu.sh.absoloop.com/api/platform/tenants/1/roles \ |
| --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| </code> | </code> | ||
| 行 445: | 行 570: | ||
| 修改坐席的登录密码。 | 修改坐席的登录密码。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent/password | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent/password |
| * HTTP Method: PUT | * HTTP Method: PUT | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 463: | 行 588: | ||
| <code php> | <code php> | ||
| curl -X PUT \ | curl -X PUT \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent/password \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent/password \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 495: | 行 620: | ||
| 删除指定的坐席。 | 删除指定的坐席。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent |
| * HTTP Method: DELETE | * HTTP Method: DELETE | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 512: | 行 637: | ||
| <code php> | <code php> | ||
| curl -X DELETE \ | curl -X DELETE \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 541: | 行 666: | ||
| 禁用指定的坐席。处于禁用状态的坐席无法登录环信客服云。 | 禁用指定的坐席。处于禁用状态的坐席无法登录环信客服云。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent/disable | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent/disable |
| * HTTP Method: PUT | * HTTP Method: PUT | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 558: | 行 683: | ||
| <code php> | <code php> | ||
| curl -X PUT \ | curl -X PUT \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent/disable \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent/disable \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 588: | 行 713: | ||
| 启用指定的坐席。处于启用状态的坐席可以登录环信客服云。 | 启用指定的坐席。处于启用状态的坐席可以登录环信客服云。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/agent/enable | + | * Path: http://kefu.sh.absoloop.com/api/platform/platform/tenants/{tenantId}/agent/enable |
| * HTTP Method: PUT | * HTTP Method: PUT | ||
| * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| 行 605: | 行 730: | ||
| <code php> | <code php> | ||
| curl -X PUT \ | curl -X PUT \ | ||
| - | http://kefu.easemob.com/api/tenants/1/agent/enable \ | + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent/enable \ |
| -H 'Content-Type: application/json' \ | -H 'Content-Type: application/json' \ | ||
| -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| 行 632: | 行 757: | ||
| + | |||
| + | |||
| + | ==== 修改坐席在线状态 ==== | ||
| + | |||
| + | 可修改坐席在线状态，状态列表：空闲、忙碌、离开、隐身、离线。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/agent/state | ||
| + | * HTTP Method: PUT | ||
| + | * Request Headers: Content-Type=application/json和Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | Request body: | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "username":"32273591@qq.com", | ||
| + | "state":"Busy" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl -X PUT \ | ||
| + | http://kefu.sh.absoloop.com/api/platform/tenants/1/agent/state \ | ||
| + | -H 'Content-Type: application/json' \ | ||
| + | -H 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | -d '{ | ||
| + | "username":"32273591@qq.com", | ||
| + | "state":"Busy" | ||
| + | }' | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |username| String |Y|账号(邮箱)| | ||
| + | |state| String |Y|在线状态：空闲(Online),忙碌(Busy),离开(Leave),隐身(Hidden),离线(Offline)，祝：设置坐席为离线状态并不会强制登出此坐席| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status| String |接口响应状态| | ||
| + | |||
| + | ===== 管理技能组 ===== | ||
| + | |||
| + | ==== 获取在线技能组列表接口 ==== | ||
| + | |||
| + | **获取token** | ||
| + | |||
| + | *开放平台需要使用token进行身份验证 | ||
| + | *Kefu-Token有效期2小时，到期需重新获取。 | ||
| + | |||
| + | **登录地址** | ||
| + | |||
| + | ^名称^说明^ | ||
| + | |操作| 获取在线技能组列表的接口 | | ||
| + | |协议| HTTPS | | ||
| + | |方式| GET | | ||
| + | |URL| /api/platform/tenants/{tenantId}/skillgroups | | ||
| + | |||
| + | ^名称^说明^ | ||
| + | |操作| 获取指定技能组下坐席信息的接口| | ||
| + | |协议| HTTPS| | ||
| + | |方式| GET| | ||
| + | |URL| /api/platform/tenants/{tenantId}/skillgroups/{queueId}| | ||
| + | |||
| + | **请求参数** | ||
| + | |||
| + | 1./api/platform/tenants/{tenantId}/skillgroups | ||
| + | ^参数^是否必传^描述^参数类型^数据类型^ | ||
| + | |tenantId| 是| 租户Id| Path| integer| | ||
| + | |RequestParam|否|请求参数| Path| String| | ||
| + | |||
| + | RequestParam包括以下几个参数: | ||
| + | ^参数^是否必传^描述^参数类型^数据类型^ | ||
| + | |page| 否| 当前页,默认0| String | ||
| + | size| 否| 当前页长，默认50|String | ||
| + | |||
| + | 2./api/platform/tenants/{tenantId}/skillgroups/{queueId} | ||
| + | ^参数^是否必传^描述^参数类型^数据类型^ | ||
| + | |tenantId| 是| 租户Id| Path| integer | ||
| + | |queueId| 是| 技能组Id| Path| Long | ||
| + | |||
| + | **返回数据** | ||
| + | |||
| + | ^HTTP状态Code^含义^ | ||
| + | |200| OK| | ||
| + | |400| 参数不正确| | ||
| + | |||
| + | ^成功返回数据^含义^ | ||
| + | |Status| OK| | ||
| + | |entities| List<from>| | ||
| + | |||
| + | **Entities包含返回数据** | ||
| + | ^返回数据^含义^ | ||
| + | |tenantId| 租户Id| | ||
| + | |queueId| 技能组Id| | ||
| + | |queueName| 技能组名称| | ||
| + | |queueType| 普通队列，还是临时队列| | ||
| + | |createDateTime| 创建时间| | ||
| + | |lastUpdateDateTime| 上次修改时间| | ||
| + | |queueGroupType| 技能组是默认组还是用户自定义组| | ||
| + | |agentUsers| 坐席数据信息| | ||
| + | |||
| + | **AgentUsers数据信息** | ||
| + | ^返回数据^含义^ | ||
| + | |tenantId| 租户Id| | ||
| + | |userId| 用户Id| | ||
| + | |userType| 用户类型| | ||
| + | |userScope| 用户所属范围| | ||
| + | |nicename| 昵称| | ||
| + | |username| 用户名| | ||
| + | |roles| 坐席拥有的角色| | ||
| + | |createDateTime| 坐席创建时间| | ||
| + | |lastUpdateDateTime| 上一次修改时间| | ||
| + | |statu| 坐席是否启用| | ||
| + | |state| 坐席状态：在线，忙碌，离线等| | ||
| + | |maxServiceSessionCount| 坐席最大接待数| | ||
| + | |agentType| 坐席类型| | ||
| + | |scope| 所属范围| | ||
| + | |bizId| 所属的业务Id| | ||
| + | |onLineState| 在线状态| | ||
| + | |||
| + | **请求示例** | ||
| + | |||
| + | 请求数据格式都应该是application/json，编码形式为UTF-8 | ||
| + | |||
| + | 1.获取技能组列表数据信息请求方式 | ||
| + | /api/platform/tenants/29762/skillgroups?page=0&size=10或 | ||
| + | /api/platform/tenants/29762/skillgroups | ||
| + | |||
| + | 2.获取技能组下坐席信息请求方式 | ||
| + | /api/platform/tenants/29762/skillgroups/6160 | ||
| + | |||
| + | **成功返回示例** | ||
| + | |||
| + | 1.获取技能组列表数据信息 | ||
| + | http://localhost:8016/api/platform/tenants/29762/skillgroups?page=0&size=10 | ||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "tenantId": 29762, | ||
| + | "queueId": 6158, | ||
| + | "queueName": "售后", | ||
| + | "queueType": "QueueNormal", | ||
| + | "priority": 0, | ||
| + | "createDateTime": 1635846909000, | ||
| + | "lastUpdateDateTime": 1635846911000, | ||
| + | "queueGroupType": "UserDefined", | ||
| + | "agentUsers": null | ||
| + | }, | ||
| + | { | ||
| + | "tenantId": 29762, | ||
| + | "queueId": 6159, | ||
| + | "queueName": "未分配", | ||
| + | "queueType": "QueueNormal", | ||
| + | "priority": 0, | ||
| + | "createDateTime": 1635846957000, | ||
| + | "lastUpdateDateTime": 1635846958000, | ||
| + | "queueGroupType": "SystemDefault", | ||
| + | "agentUsers": null | ||
| + | }, | ||
| + | { | ||
| + | "tenantId": 29762, | ||
| + | "queueId": 6160, | ||
| + | "queueName": "产品", | ||
| + | "queueType": "QueueNormal", | ||
| + | "priority": 0, | ||
| + | "createDateTime": 1635847007000, | ||
| + | "lastUpdateDateTime": 1635847008000, | ||
| + | "queueGroupType": "UserDefined", | ||
| + | "agentUsers": null | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "size": 10, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 3, | ||
| + | "totalPages": 1, | ||
| + | "totalElements": 3 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 2.获取技能组下坐席信息 | ||
| + | http://localhost:8016/api/platform/tenants/29762/skillgroups/6160 | ||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "tenantId": 29762, | ||
| + | "queueId": 6160, | ||
| + | "queueName": "产品", | ||
| + | "queueType": "QueueNormal", | ||
| + | "priority": 0, | ||
| + | "createDateTime": 1635847007000, | ||
| + | "lastUpdateDateTime": 1635847008000, | ||
| + | "queueGroupType": "UserDefined", | ||
| + | "agentUsers": [ | ||
| + | { | ||
| + | "tenantId": 77278, | ||
| + | "userId": "f3d51aa9-16cb-4b18-bcf7-e9365765e02f", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "Admin", | ||
| + | "password": "", | ||
| + | "username": "735017618@qq.com", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2016-10-13 15:51:14", | ||
| + | "lastUpdateDateTime": "2016-10-13 15:52:08", | ||
| + | "status": "Enable", | ||
| + | "state": "Online", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "Admin", | ||
| + | "agentType": "Ticket", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "77278", | ||
| + | "onLineState": "Online", | ||
| + | "currentOnLineState": "Online" | ||
| + | }, | ||
| + | { | ||
| + | "tenantId": 29762, | ||
| + | "userId": "f3d51aa9-16cb-4b18-bcf7-e9365765e02d", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "Admin", | ||
| + | "password": "", | ||
| + | "username": "29762@qq.com", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2021-11-03 10:52:05", | ||
| + | "lastUpdateDateTime": "2021-11-03 10:52:07", | ||
| + | "status": "Enable", | ||
| + | "state": "Online", | ||
| + | "maxServiceSessionCount": 15, | ||
| + | "agentType": "Message", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "29762", | ||
| + | "onLineState": "Online", | ||
| + | "currentOnLineState": "Online" | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 添加技能组 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求 ：POST /api/platform/tenants/{tenantId}/queues | ||
| + | |||
| + | 入参： | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | | tenantId |Integer| Y | 租户id | | ||
| + | |queueType|String | Y |云呼：CallCenter，在线：Message| | ||
| + | | name|String | Y|技能组名称 （不能超过20）| | ||
| + | |||
| + | 出参： | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |queueId|String | Y |技能组id| | ||
| + | |queueName|String | Y |技能组名称| | ||
| + | |queueGroupType|String | Y |技能组类型，在线用，UserDefined自定义 SystemDefault默认组| | ||
| + | | userCount|Integer| Y | 技能组内坐席数量| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queues?queueType=Message' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '{ | ||
| + | "name": "zaixian8" | ||
| + | }' | ||
| + | |||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "queueId": "9", | ||
| + | "queueName": "zaixian8", | ||
| + | "queueGroupType": "UserDefined", | ||
| + | "userCount": 0 | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queues?queueType=CallCenter' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '{ | ||
| + | "name": "yunhu8" | ||
| + | }' | ||
| + | |||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "queueId": "1343b9c0-9572-11ee-8fbc-f7237c60157d", | ||
| + | "queueName": "yunhu8", | ||
| + | "queueGroupType": null, | ||
| + | "userCount": 0 | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 查询技能组 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | GET /api/platform/tenants/{tenantId}/queues | ||
| + | |||
| + | 入参 | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |tenantId|Integer | Y|租户id| | ||
| + | |queueType|String | Y|云呼：CallCenter，在线：Message| | ||
| + | | queueName|String|N |技能组名称，非必传| | ||
| + | | page|Integer| Y|页码| | ||
| + | | size|Integer|Y |条数| | ||
| + | |||
| + | 出参 | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | | queueId|String|Y |技能组id| | ||
| + | |queueName|String |Y |技能组名称| | ||
| + | |queueGroupType|String |Y |技能组类型，在线用，UserDefined自定义 SystemDefault默认组| | ||
| + | |userCount|Integer|Y |技能组内坐席数量| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queues?queueType=Message&queueName=2&page=0&size=2' | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "queueId": "5", | ||
| + | "queueName": "在线技能组1207-1", | ||
| + | "queueGroupType": "UserDefined", | ||
| + | "userCount": 0 | ||
| + | } | ||
| + | ], | ||
| + | "first": false, | ||
| + | "last": true, | ||
| + | "size": 2, | ||
| + | "number": 1, | ||
| + | "numberOfElements": 1, | ||
| + | "totalPages": 2, | ||
| + | "totalElements": 3 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queues?queueType=CallCenter&queueName=yunhu&page=0&size=2' | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "queueId": "96c24d60-94e2-11ee-a3a1-67aeafb58a22", | ||
| + | "queueName": "yunhu5", | ||
| + | "queueGroupType": null, | ||
| + | "userCount": 0 | ||
| + | }, | ||
| + | { | ||
| + | "queueId": "ba41de30-94e3-11ee-9f77-539178b4fcc1", | ||
| + | "queueName": "yunhu6", | ||
| + | "queueGroupType": null, | ||
| + | "userCount": 0 | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": false, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 2, | ||
| + | "totalPages": 3, | ||
| + | "totalElements": 5 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 修改技能组 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求：PUT /api/platform/tenants/{tenantId}/queue/{queueId} | ||
| + | |||
| + | 入参 | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |tenantId|Integer |Y|租户id| | ||
| + | |queueType|String|Y |云呼：CallCenter，在线：Message| | ||
| + | |queueId|String | Y|技能组id| | ||
| + | |name|String | Y|技能组名称（不能超过20）| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location --request PUT 'localhost:8016/api/platform/tenants/77877/queue/5?queueType=Message' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '{ | ||
| + | "name":"在线2222" | ||
| + | }' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location --request PUT 'localhost:8016/api/platform/tenants/77877/queue/96c24d60-94e2-11ee-a3a1-67aeafb58a22?queueType=CallCenter' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '{ | ||
| + | "name":"云呼5555" | ||
| + | }' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 删除技能组 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求：DELETE /api/platform/tenants/{tenantId}/queue/{queueId} | ||
| + | |||
| + | 入参 | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |tenantId|Integer | Y|租户id| | ||
| + | |queueType|String | Y|云呼：CallCenter，在线：Message| | ||
| + | |queueId|String |Y |技能组id| | ||
| + | |userId|String | Y|坐席id（是指记录操作坐席）| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location --request DELETE 'localhost:8016/api/platform/tenants/77877/queue/9?queueType=Message&userId=5e0de11f-dfa5-43f4-acc1-38ad878d6a08' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location --request DELETE 'localhost:8016/api/platform/tenants/77877/queue/96c24d60-94e2-11ee-a3a1-67aeafb58a22?queueType=CallCenter&userId=5e0de11f-dfa5-43f4-acc1-38ad878d6a08' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 添加技能组成员 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求：POST /api/platform/tenants/{tenantId}/queue/{queueId}/agent | ||
| + | |||
| + | 入参 | ||
| + | |||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |tenantId|Integer |Y |租户id| | ||
| + | |queueType|String | Y|云呼：CallCenter，在线：Message| | ||
| + | |queueId|String |Y |技能组id| | ||
| + | | userIds|String| Y|坐席id| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queue/3/agent?queueType=Message' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '[ | ||
| + | "5e0de11f-dfa5-43f4-acc1-38ad878d6a08" | ||
| + | ]' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'localhost:8016/api/platform/tenants/77877/queue/e78a3de0-94cc-11ee-b500-2ba045a0f55e/agent?queueType=CallCenter' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '[ | ||
| + | "5e0de11f-dfa5-43f4-acc1-38ad878d6a08" | ||
| + | ]' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 删除技能组成员 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求：DELETE /api/platform/tenants/{tenantId}/queue/{queueId}/agent | ||
| + | |||
| + | 入参： | ||
| + | |名称|类型|是否非空(Y:是;N:否)|说明| | ||
| + | |tenantId|Integer |Y |租户id| | ||
| + | |queueType|String | Y|云呼：CallCenter，在线：Message| | ||
| + | |queueId|String |Y|技能组id| | ||
| + | |userIds|String|Y |坐席id| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location --request DELETE 'localhost:8016/api/platform/tenants/77877/queue/8/agent?queueType=Message' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '[ | ||
| + | "5e0de11f-dfa5-43f4-acc1-38ad878d6a08" | ||
| + | ]' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | |||
| + | curl --location --request DELETE 'localhost:8016/api/platform/tenants/77877/queue/1343b9c0-9572-11ee-8fbc-f7237c60157d/agent?queueType=CallCenter' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '[ | ||
| + | "5e0de11f-dfa5-43f4-acc1-38ad878d6a08" | ||
| + | ]' | ||
| + | { | ||
| + | "status": "OK" | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== 查询技能组成员 ==== | ||
| + | |||
| + | 入参Kefu-Token和之前一样，示例中省略Kefu-Token | ||
| + | |||
| + | 请求：GET /api/platform/tenants/{tenantId}/queue/{queueId}/agent | ||
| + | |||
| + | 入参 | ||
| + | |名称|类型|是否非空(Y:是;N:否)|说明| | ||
| + | |tenantId|Integer |Y |租户id| | ||
| + | |queueType|String | Y |在线客服：Message，视频客服：MVCombine，云呼客服：CallCenter，| | ||
| + | |queueId|String |Y |技能组id| | ||
| + | |page|Integer |Y |页码| | ||
| + | | size|Integer|Y |条数| | ||
| + | |||
| + | 出参 | ||
| + | |名称|类型|是否非空(Y:是;N:否)|说明| | ||
| + | |agentUser|Agentuser | Y|坐席信息| | ||
| + | | level|String| Y|等级值，云呼技能组用| | ||
| + | |||
| + | **在线示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'http://kefu.sh.absoloop.com/api/platform/tenants/{租户ID}/queue/{技能组ID}/agent?queueType=Message' | ||
| + | |||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "agentUser": { | ||
| + | "tenantId": 77877, | ||
| + | "userId": "5e0de11f-dfa5-43f4-acc1-38ad878d6a08", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "123", | ||
| + | "password": "", | ||
| + | "username": "qu120711", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2023-12-07 14:39:32", | ||
| + | "lastUpdateDateTime": "2023-12-07 14:39:32", | ||
| + | "status": "Enable", | ||
| + | "state": "Offline", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "321", | ||
| + | "mobilePhone": "", | ||
| + | "agentNumber": 120711, | ||
| + | "agentType": "All", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "77877", | ||
| + | "currentOnLineState": "Offline", | ||
| + | "onLineState": "Offline" | ||
| + | }, | ||
| + | "level": null | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "size": 10, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 1, | ||
| + | "totalPages": 1, | ||
| + | "totalElements": 1 | ||
| + | } | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "size": 10, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 0, | ||
| + | "totalPages": 0, | ||
| + | "totalElements": 0 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **视频客服示例** | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/{租户ID}/queue/{技能组ID}/agent?queueType=MVCombine' \ | ||
| + | --header 'Accept: */*' \ | ||
| + | --header 'Accept-Encoding: gzip, deflate, br' \ | ||
| + | --header 'Connection: keep-alive' \ | ||
| + | --header 'Cookie: tgw_l7_route=87d6235dd77d99ece2ddb5afcaacee4c' \ | ||
| + | --header 'Kefu-Token: d98351d2c8c89f6f87ab60edf4f5a378' \ | ||
| + | --header 'User-Agent: PostmanRuntime-ApipostRuntime/1.1.0' | ||
| + | | ||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "tenantId": 108773, | ||
| + | "userId": "5847ce50-0f3c-11ef-aeca-b5bc30bdd7a3", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "dyj@108773.com-昵称", | ||
| + | "password": "", | ||
| + | "username": "dyj@108773.com", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2024-05-11 10:15:33", | ||
| + | "lastUpdateDateTime": "2025-06-26 11:49:37", | ||
| + | "passwordUpdateDateTime": "2024-08-29 10:31:30", | ||
| + | "firstLoginTimeOfRecentDay": "2025-06-26 01:11:18", | ||
| + | "status": "Enable", | ||
| + | "state": "Online", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "dyj@108773.com-姓名", | ||
| + | "mobilePhone": "", | ||
| + | "agentNumber": 2345655, | ||
| + | "agentType": "MVCombine", | ||
| + | "avatar": "https://front-mf-webapp.sh.absoloop.com/static/img/geren.82dca2de.png", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "108773", | ||
| + | "onLineState": "Online", | ||
| + | "currentOnLineState": "Online" | ||
| + | }, | ||
| + | { | ||
| + | "tenantId": 108773, | ||
| + | "userId": "8d91fda0-5ddf-11ef-8da7-bbf7e3b159c5", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "ldb@108773.com", | ||
| + | "password": "", | ||
| + | "username": "ldb@108773.com", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2024-08-19 12:00:21", | ||
| + | "lastUpdateDateTime": "2025-06-25 09:54:54", | ||
| + | "passwordUpdateDateTime": "2024-08-20 15:38:34", | ||
| + | "firstLoginTimeOfRecentDay": "2025-06-25 09:54:54", | ||
| + | "status": "Enable", | ||
| + | "state": "Online", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "ldb@108773.com", | ||
| + | "mobilePhone": "", | ||
| + | "agentNumber": 2354335, | ||
| + | "agentType": "MVCombine", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "108773", | ||
| + | "onLineState": "Online", | ||
| + | "currentOnLineState": "Online" | ||
| + | }, | ||
| + | { | ||
| + | "tenantId": 108773, | ||
| + | "userId": "6c039430-87bc-11ef-97b2-bb37dcf6b9c6", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "李成", | ||
| + | "password": "", | ||
| + | "username": "licheng@108773.com", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2024-10-11 18:34:41", | ||
| + | "lastUpdateDateTime": "2025-05-30 11:30:30", | ||
| + | "firstLoginTimeOfRecentDay": "2025-05-30 11:30:30", | ||
| + | "status": "Enable", | ||
| + | "state": "Offline", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "李成", | ||
| + | "mobilePhone": "", | ||
| + | "agentNumber": 7881777, | ||
| + | "agentType": "MVCombine", | ||
| + | "avatar": "https://front-mf-webapp.sh.absoloop.com/static/img/geren.82dca2de.png", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "108773", | ||
| + | "onLineState": "Offline", | ||
| + | "currentOnLineState": "Offline" | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "size": 10, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 3, | ||
| + | "totalPages": 1, | ||
| + | "totalElements": 3 | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | |||
| + | **云呼示例** | ||
| + | |||
| + | <code json> | ||
| + | curl --location 'http://kefu.sh.absoloop.com/api/platform/tenants/{租户ID}/queue/{技能组ID}/agent?queueType=CallCenter' | ||
| + | |||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "agentUser": { | ||
| + | "tenantId": 77877, | ||
| + | "userId": "5e0de11f-dfa5-43f4-acc1-38ad878d6a08", | ||
| + | "userType": "Agent", | ||
| + | "userScope": "Tenant", | ||
| + | "nicename": "123", | ||
| + | "password": "", | ||
| + | "username": "qu120711", | ||
| + | "roles": "admin,agent", | ||
| + | "createDateTime": "2023-12-07 14:39:32", | ||
| + | "lastUpdateDateTime": "2023-12-07 14:39:32", | ||
| + | "status": "Enable", | ||
| + | "state": "Offline", | ||
| + | "maxServiceSessionCount": 10, | ||
| + | "trueName": "321", | ||
| + | "mobilePhone": "", | ||
| + | "agentNumber": 120711, | ||
| + | "agentType": "All", | ||
| + | "scope": "Tenant", | ||
| + | "bizId": "77877", | ||
| + | "currentOnLineState": "Offline", | ||
| + | "onLineState": "Offline" | ||
| + | }, | ||
| + | "level": "5" | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 1, | ||
| + | "totalPages": 1, | ||
| + | "totalElements": 1 | ||
| + | } | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 0, | ||
| + | "totalPages": 0, | ||
| + | "totalElements": 0 | ||
| + | } | ||
| + | </code> | ||
| + | ===== 批量查询客户信息接口 ===== | ||
| + | |||
| + | **Request body:：** | ||
| + | |||
| + | <code json> | ||
| + | |||
| + | { | ||
| + | "page": 0, | ||
| + | "size": 9, | ||
| + | "conditions": [ | ||
| + | { | ||
| + | "field_name": "createDateTime", | ||
| + | "value": "time1,time2", | ||
| + | "operation": "RANGE" | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |page | int | 页数 | | ||
| + | |size | int | 每页条数| | ||
| + | |conditions| | 查询条件| | ||
| + | |field_name| |查询字段名称，访客创建时间，固定无需修改| | ||
| + | |value String tim1||开始时间戳，time2结束时间戳| | ||
| + | |operation ||操作类型，排序，固定无需修改| | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --location 'http://kefu.sh.absoloop.com/api/platform/tenants/29676/customer/search' \ | ||
| + | --header 'Kefu-Token: 739170a565e79d97e6fd25d0aa522d4f' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data '{ | ||
| + | "page": 0, | ||
| + | "size": 9, | ||
| + | "conditions": [ | ||
| + | { | ||
| + | "field_name": "createDateTime", | ||
| + | "value": "1677340800000,1677945599000", | ||
| + | "operation": "RANGE" | ||
| + | } | ||
| + | ] | ||
| + | }' | ||
| + | </code> | ||
| + | |||
| + | <code php> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "content": [ | ||
| + | { | ||
| + | "customer_id": "3ece3c0f-0c98-40b2-bf66-b7f6d0a5ed14", | ||
| + | "bind_visitors": [ | ||
| + | "52dbf2dd-0129-403a-af4f-253f2a0ab27a" | ||
| + | ], | ||
| + | "created_at": 1677726847333, | ||
| + | "updated_at": 1680159446359, | ||
| + | "visitor_id": "52dbf2dd-0129-403a-af4f-253f2a0ab27a", | ||
| + | "vip": null, | ||
| + | "type": null, | ||
| + | "level": null, | ||
| + | "email": [ | ||
| + | "1@1.com" | ||
| + | ], | ||
| + | "nickname": "12", | ||
| + | "phone": [ | ||
| + | "15011111111" | ||
| + | ], | ||
| + | "username": [ | ||
| + | "1@1.com" | ||
| + | ] | ||
| + | } | ||
| + | ], | ||
| + | "totalElements": 3, | ||
| + | "last": false, | ||
| + | "totalPages": 3, | ||
| + | "sort": null, | ||
| + | "first": true, | ||
| + | "numberOfElements": 1, | ||
| + | "size": 1, | ||
| + | "number": 0 | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |customer_id |String |crm客户id| | ||
| + | |bind_visitors| List |绑定的访客visitor_id| | ||
| + | |visitor_id |string | 访客visitor_id| | ||
| + | |vip |boolean| 是否vip，敦煌定制| | ||
| + | |type |String| 访客类型，敦煌定制| | ||
| + | |level |String |访客级别，敦煌定制| | ||
| + | |email| list| 访客邮箱，为空则不返回| | ||
| + | |nickname |list| 访客邮箱，为空则不返回| | ||
| + | |username |list| 访客ID，为空则不返回| | ||
| ===== 查询历史会话 ===== | ===== 查询历史会话 ===== | ||
| 行 638: | 行 1638: | ||
| 根据渠道、客户昵称、技能组、坐席、会话接起时间、会话结束时间等条件查询历史会话列表。 | 根据渠道、客户昵称、技能组、坐席、会话接起时间、会话结束时间等条件查询历史会话列表。 | ||
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/serviceSessionHistorys | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/serviceSessionHistorys |
| * HTTP Method: GET | * HTTP Method: GET | ||
| * Request Headers: Kefu-Token=${accessToken} | * Request Headers: Kefu-Token=${accessToken} | ||
| 行 647: | 行 1647: | ||
| <code php> | <code php> | ||
| curl --request GET \ | curl --request GET \ | ||
| - | --url 'http://kefu.easemob.com/api/tenants/1/serviceSessionHistorys?page=1&per_page=1&state=Terminal%2CAbort& | + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/1/serviceSessionHistorys?stopDateFrom=2021-05-10T00%3A00%3A00.000Z&stopDateTo=2021-05-20T23%3A59%3A00.000Z' \ |
| - | isAgent=false&originType=&techChannelId=&techChannelType=&customerName=&agentIds=& | + | |
| - | enquiryTagIds=&orderType=&summaryIds=&enquirySummary= | + | |
| - | &sortOrder=desc&transfered=&queueIds=&stopDateFrom=2018-04-16T00%3A00%3A00.000Z | + | |
| - | &stopDateTo=2018-04-20T23%3A59%3A00.000Z&sortField=stopDateTime | + | |
| - | &fromAgentCallback=&queueId=0&agentUserId=425b496b-d96d-4931-be1c-f095ecdc09ef' \ | + | |
| --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| </code> | </code> | ||
| 行 667: | 行 1662: | ||
| |fromAgentCallback|boolean|N|会话类型 回呼：true 呼入：false| | |fromAgentCallback|boolean|N|会话类型 回呼：true 呼入：false| | ||
| |enquirySummary|int|N|评价 值为：0，1，2，3，4，5不填默认查询全部评价| | |enquirySummary|int|N|评价 值为：0，1，2，3，4，5不填默认查询全部评价| | ||
| + | |enquiryDegree|int|N|"3 (一般)" 满意度评价（用于数字评价）| | ||
| + | |resolutionScore|int|N| "1" 解决率评价分数 1 已解决 2 未解决（用于数字评价）| | ||
| + | |resolutionScore2|int|N| "1" 解决率评价分数 1 已解决 2 未解决（用于数字评价）| | ||
| + | |consultResult|int|N| "1" 咨询结果: 有效会话 - 1 ; 无效会话 = 0| | ||
| |queueIds|int|N|多个技能组ID数组| | |queueIds|int|N|多个技能组ID数组| | ||
| |beginDate| String |N|会话接起时间(开始范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | |beginDate| String |N|会话接起时间(开始范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | ||
| 行 675: | 行 1674: | ||
| |createDateTo| String |N|会话创建时间(结束范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | |createDateTo| String |N|会话创建时间(结束范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | ||
| |agentIds|list|N|多个坐席的ID数组| | |agentIds|list|N|多个坐席的ID数组| | ||
| + | |serviceSessionId|String|N|某个会话id，可用于查看某通会话信息，此参数与其他参数不可一同请求| | ||
| |sortField| String |N|排序字段 stopDateTime startDateTime createDatetime| | |sortField| String |N|排序字段 stopDateTime startDateTime createDatetime| | ||
| |sortOrder| String |N|升降序asc desc| | |sortOrder| String |N|升降序asc desc| | ||
| - | **Response示例：** | + | **Response示例01：** |
| <code json> | <code json> | ||
| 行 684: | 行 1684: | ||
| "status": "OK", | "status": "OK", | ||
| "entity": { | "entity": { | ||
| - | "total_entries": 10178, | + | "total_entries": 3, |
| "items": [ | "items": [ | ||
| { | { | ||
| - | "serviceSessionId": "29b04e8e-4e79-4eeb-a24a-bad04b9669d4", | + | "serviceSessionId": "45bd1110-69a3-49d0-b9e2-55e9399e3633", |
| - | "tenantId": 1, | + | "tenantId": 29676, |
| - | "techChannelId": 1, | + | "techChannelId": 1434, |
| - | "queueId": null, | + | "queueId": 161557, |
| - | "state": "Abort", | + | "state": "Terminal", |
| - | "chatGroupId": 1493629159358939434, | + | "chatGroupId": 4611895, |
| - | "messageSeqId": 1, | + | "messageSeqId": 4, |
| - | "agentUserId": null, | + | "agentUserId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", |
| - | "agentUserNiceName": null, | + | "agentUserNiceName": "Admin昵称1", |
| - | "agentUserTrueName": null, | + | |
| "agentUserType": 1, | "agentUserType": 1, | ||
| - | "createDatetime": "2018-04-19 15:00:59", | + | "createDatetime": "2021-05-10 18:46:44", |
| - | "startDateTime": null, | + | "startDateTime": "2021-05-10 18:46:48", |
| - | "agentLastMessageDate": null, | + | "stopDateTime": "2021-05-10 18:56:59", |
| - | "stopDateTime": "2018-04-19 15:00:59", | + | "techChannelType": "wechat", |
| - | "techChannelType": "easemob", | + | "enquirySummary": "4", |
| - | "summarys": [ | + | "enquiryDegree": "4 (满意)", |
| - | [ | + | "resolutionScore": "0", |
| - | { | + | "resolutionScore2": "0", |
| - | "id": 123, | + | "consultResult": "0", |
| - | "name": "test summary name", | + | "evaluateWay": "agent", |
| - | "color": 1, | + | "invited": true, |
| - | "parentId": 0 | + | "techChannelName": "环信本地测试", |
| - | } | + | "originType": [ |
| - | ] | + | "weixin" |
| ], | ], | ||
| - | "enquirySummary": "1", | + | "comment": "不活跃会话超时结束备注", |
| - | "enquiryDetail": "enquiry detail", | + | "visitorUser": { |
| - | "techChannelName": "优信测试", | + | "userId": "479032e4-1d94-4f65-a59b-43515b67d7dc", |
| + | "nicename": "环信本地测试：o6B_c4p_OKwcGLWqoFCXcXqKExS4", | ||
| + | "username": "o6B_c4p_OKwcGLWqoFCXcXqKExS4" | ||
| + | }, | ||
| + | "customer": { | ||
| + | "customerId": "c7e44d7d-8378-44b3-8b30-d4b46d97b62d", | ||
| + | "customerNiceName": "环信本地测试：o6B_c4p_OKwcGLWqoFCXcXqKExS4", | ||
| + | "customerTrueName": null | ||
| + | }, | ||
| + | "fromAgentCallback": false, | ||
| + | "transfered": false, | ||
| + | "agentUserSet": [ | ||
| + | { | ||
| + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserList": [ | ||
| + | { | ||
| + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueSet": [ | ||
| + | { | ||
| + | "queueId": "161557", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueList": [ | ||
| + | { | ||
| + | "queueId": "161557", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "serviceSessionAttribute": {} | ||
| + | }, | ||
| + | { | ||
| + | "serviceSessionId": "e4bd2cb2-d95d-4db6-85c7-5bf83b559d58", | ||
| + | "tenantId": 29676, | ||
| + | "techChannelId": 1434, | ||
| + | "queueId": 161557, | ||
| + | "state": "Terminal", | ||
| + | "chatGroupId": 4611895, | ||
| + | "messageSeqId": 5, | ||
| + | "agentUserId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "agentUserNiceName": "Admin昵称1", | ||
| + | "agentUserType": 1, | ||
| + | "createDatetime": "2021-05-10 18:19:53", | ||
| + | "startDateTime": "2021-05-10 18:20:08", | ||
| + | "agentLastMessageDate": "2021-05-10 18:20:12", | ||
| + | "stopDateTime": "2021-05-10 18:24:29", | ||
| + | "techChannelType": "wechat", | ||
| + | "enquirySummary": "5", | ||
| + | "enquiryDegree": "5 (非常满意,好)", | ||
| + | "resolutionScore": "0", | ||
| + | "resolutionScore2": "0", | ||
| + | "consultResult": "1", | ||
| + | "evaluateWay": "agent", | ||
| + | "invited": true, | ||
| + | "techChannelName": "环信本地测试", | ||
| "originType": [ | "originType": [ | ||
| - | "webim" | + | "weixin" |
| ], | ], | ||
| - | "comment": "comment", | ||
| "visitorUser": { | "visitorUser": { | ||
| - | "userId": "e11668c4-8821-4da0-bd42-ca067e338b1d", | + | "userId": "479032e4-1d94-4f65-a59b-43515b67d7dc", |
| - | "nicename": "customerNiceName", | + | "nicename": "环信本地测试：o6B_c4p_OKwcGLWqoFCXcXqKExS4", |
| - | "username": "visitor_username" | + | "username": "o6B_c4p_OKwcGLWqoFCXcXqKExS4" |
| }, | }, | ||
| "customer": { | "customer": { | ||
| - | "customerId": "a56a735c-a8ea-4043-b161-5235587b85e6", | + | "customerId": "c7e44d7d-8378-44b3-8b30-d4b46d97b62d", |
| - | "customerNiceName": "customerNiceName", | + | "customerNiceName": "环信本地测试：o6B_c4p_OKwcGLWqoFCXcXqKExS4", |
| "customerTrueName": null | "customerTrueName": null | ||
| }, | }, | ||
| - | "messageDetail": null, | ||
| - | "recordFileUrl": null, | ||
| "fromAgentCallback": false, | "fromAgentCallback": false, | ||
| "transfered": false, | "transfered": false, | ||
| - | "visitorUserTags": null, | + | "enquiryTags": [ |
| - | "enquiryTags": null, | + | { |
| - | "chatMessages": null, | + | "appraiseTagId": 274741, |
| - | "lastChatMessage": null, | + | "name": "服务态度好" |
| + | }, | ||
| + | { | ||
| + | "appraiseTagId": 274742, | ||
| + | "name": "解决速度快" | ||
| + | } | ||
| + | ], | ||
| "agentUserSet": [ | "agentUserSet": [ | ||
| { | { | ||
| - | "userId": "425b496b-d96d-4931-be1c-f095ecdc09ef", | + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", |
| - | "username": null, | + | "username": "15010965776@163.com", |
| - | "nicename": "testAgentNicename", | + | "nicename": "Admin昵称1", |
| - | "trueName": "testAgentTrueName", | + | "trueName": "Admin姓名", |
| - | "tenantId": "1" | + | "tenantId": "29676" |
| } | } | ||
| ], | ], | ||
| - | "agentQueueSet": null, | + | "agentUserList": [ |
| - | "enquiryTagNames": null, | + | { |
| - | "summarysDetail": "test summary name" | + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", |
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueSet": [ | ||
| + | { | ||
| + | "queueId": "161557", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueList": [ | ||
| + | { | ||
| + | "queueId": "161557", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "serviceSessionEventHistoryList": [ | ||
| + | { | ||
| + | "eventId": "82c0ab6d-0291-4376-b838-c7cb177c8e1f", | ||
| + | "serviceSessionId": "e4bd2cb2-d95d-4db6-85c7-5bf83b559d58", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": null, | ||
| + | "actorName": null, | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": null, | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Created", | ||
| + | "serviceSessionExt": "{\"fromAgentCallback\":false,\"sessionCreateType\":\"fromRoutingPolicy\",\"routingToRobot\":false,\"queueName\":\"未分组\"}", | ||
| + | "createDateTime": "2021-05-10 18:19:53", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "0e2dedcb-8f2b-400e-b1f2-8f489f041bdb", | ||
| + | "serviceSessionId": "e4bd2cb2-d95d-4db6-85c7-5bf83b559d58", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 18:20:08", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "e6e3c589-d6b4-498a-9dd0-caf5104fc47a", | ||
| + | "serviceSessionId": "e4bd2cb2-d95d-4db6-85c7-5bf83b559d58", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "FirstReplyTime", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 18:20:11", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "836e7ff4-921f-4a79-b494-d5ffeeeb869e", | ||
| + | "serviceSessionId": "e4bd2cb2-d95d-4db6-85c7-5bf83b559d58", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Closed", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 18:24:29", | ||
| + | "timeStamp": null | ||
| + | } | ||
| + | ], | ||
| + | "enquiryTagNames": "未解决", | ||
| + | "serviceSessionAttribute": {} | ||
| + | }, | ||
| + | { | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "techChannelId": 23293, | ||
| + | "queueId": 161557, | ||
| + | "state": "Terminal", | ||
| + | "chatGroupId": 4611717, | ||
| + | "messageSeqId": 15, | ||
| + | "agentUserId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "agentUserNiceName": "Admin昵称1", | ||
| + | "agentUserType": 1, | ||
| + | "createDatetime": "2021-05-10 11:17:16", | ||
| + | "startDateTime": "2021-05-10 11:17:26", | ||
| + | "agentLastMessageDate": "2021-05-10 11:20:03", | ||
| + | "stopDateTime": "2021-05-10 11:20:09", | ||
| + | "techChannelType": "easemob", | ||
| + | "enquirySummary": "0", | ||
| + | "enquiryDegree": "0", | ||
| + | "resolutionScore": "0", | ||
| + | "resolutionScore2": "0", | ||
| + | "consultResult": "1", | ||
| + | "invited": false, | ||
| + | "visitorLeaveTime": "2021-05-10 11:20:18", | ||
| + | "techChannelName": "体验关联", | ||
| + | "originType": [ | ||
| + | "webim" | ||
| + | ], | ||
| + | "visitorUser": { | ||
| + | "userId": "49440425-ac26-45df-9bf1-11bf39ca74af", | ||
| + | "nicename": "webim-visitor-CKFR3YEGFB2Q672V8W4P", | ||
| + | "username": "webim-visitor-CKFR3YEGFB2Q672V8W4P" | ||
| + | }, | ||
| + | "customer": { | ||
| + | "customerId": "5d513e47-0628-4c25-85f3-76627b26ceea", | ||
| + | "customerNiceName": "webim-visitor-CKFR3YEGFB2Q672V8W4P", | ||
| + | "customerTrueName": null | ||
| + | }, | ||
| + | "fromAgentCallback": false, | ||
| + | "transfered": true, | ||
| + | "agentUserSet": [ | ||
| + | { | ||
| + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "18c8af0f-5891-4a36-ad49-90fb612d3b8b", | ||
| + | "username": "qu1@1.com", | ||
| + | "nicename": "qu1@1.com昵称", | ||
| + | "trueName": "qu1@1.com姓名", | ||
| + | "tenantId": "29676" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserList": [ | ||
| + | { | ||
| + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "18c8af0f-5891-4a36-ad49-90fb612d3b8b", | ||
| + | "username": "qu1@1.com", | ||
| + | "nicename": "qu1@1.com昵称", | ||
| + | "trueName": "qu1@1.com姓名", | ||
| + | "tenantId": "29676" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "username": "15010965776@163.com", | ||
| + | "nicename": "Admin昵称1", | ||
| + | "trueName": "Admin姓名", | ||
| + | "tenantId": "29676" | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueSet": [ | ||
| + | { | ||
| + | "queueId": "164924", | ||
| + | "queueName": "第一技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueList": [ | ||
| + | { | ||
| + | "queueId": "164924", | ||
| + | "queueName": "第一技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 29676 | ||
| + | } | ||
| + | ], | ||
| + | "serviceSessionEventHistoryList": [ | ||
| + | { | ||
| + | "eventId": "06fed1c4-fbe2-4ac8-87d6-2d07c340db13", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": null, | ||
| + | "actorName": null, | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": null, | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Created", | ||
| + | "serviceSessionExt": "{\"fromAgentCallback\":false,\"routingPolicyType\":\"Channel\",\"sessionCreateType\":\"fromRoutingPolicy\",\"routingToRobot\":false,\"queueName\":\"第一技能组\"}", | ||
| + | "createDateTime": "2021-05-10 11:17:16", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "d34d7ddf-b1e9-4630-a9bb-5b34eae38e17", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 11:17:26", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "55c7cabe-9ef9-4572-923f-69c48788866f", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "FirstReplyTime", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 11:17:27", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "eb7ab5ba-64a9-4aad-a516-16e2d6acbfa1", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "fromName": "Admin姓名", | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": "Processing", | ||
| + | "toId": "18c8af0f-5891-4a36-ad49-90fb612d3b8b", | ||
| + | "toName": "qu1@1.com姓名", | ||
| + | "toState": "Processing", | ||
| + | "type": "TransferAA", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 11:17:45", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "fb8478a5-2506-4759-b70b-2cfd2fe4a105", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "18c8af0f-5891-4a36-ad49-90fb612d3b8b", | ||
| + | "actorName": "qu1@1.com昵称", | ||
| + | "fromId": "18c8af0f-5891-4a36-ad49-90fb612d3b8b", | ||
| + | "fromName": "qu1@1.com姓名", | ||
| + | "actorTrueName": "qu1@1.com姓名", | ||
| + | "fromState": "Processing", | ||
| + | "toId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "toName": "Admin姓名", | ||
| + | "toState": "Processing", | ||
| + | "type": "TransferAA", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 11:19:29", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "6d1f1823-ca5d-48bc-8c04-42abd02fa0ea", | ||
| + | "serviceSessionId": "55e34279-8a1c-4863-aa66-896fdd80b2ee", | ||
| + | "tenantId": 29676, | ||
| + | "actorId": "5dade28d-77e8-43a4-84e8-1eefa0c63748", | ||
| + | "actorName": "Admin昵称1", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "Admin姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Closed", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2021-05-10 11:20:09", | ||
| + | "timeStamp": null | ||
| + | } | ||
| + | ], | ||
| + | "serviceSessionAttribute": { | ||
| + | "referer": "https://029676.kefu.sh.absoloop.com/mo/admin/webapp/channels/web", | ||
| + | "searchType": "直接访问", | ||
| + | "ip": "211.157.146.18", | ||
| + | "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.182 Safari/537.36", | ||
| + | "region": "中国,北京,北京" | ||
| + | } | ||
| } | } | ||
| ] | ] | ||
| } | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **Response示例02：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "total_entries": 2, | ||
| + | "items": [{ | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "techChannelId": 157861, | ||
| + | "queueId": 276601, | ||
| + | "chatGroupId": 602362464, | ||
| + | "messageSeqId": 22, | ||
| + | "agentUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "agentUserNiceName": "dyj@99501.com-昵称", | ||
| + | "agentUserType": 1, | ||
| + | "createDatetime": "2024-09-02 10:05:46", | ||
| + | "startDateTime": "2024-09-02 10:05:46", | ||
| + | "agentLastMessageDate": "2024-09-02 10:09:02", | ||
| + | "stopDateTime": "2024-09-02 10:09:09", | ||
| + | "techChannelType": "easemob", | ||
| + | "summarys": [ | ||
| + | [{ | ||
| + | "id": 1239133, | ||
| + | "name": "问题咨询", | ||
| + | "color": 1532742911, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1239134, | ||
| + | "name": "咨询01", | ||
| + | "color": 255, | ||
| + | "parentId": 1239133 | ||
| + | } | ||
| + | ], | ||
| + | [{ | ||
| + | "id": 1239133, | ||
| + | "name": "问题咨询", | ||
| + | "color": 1532742911, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1239135, | ||
| + | "name": "咨询02", | ||
| + | "color": 255, | ||
| + | "parentId": 1239133 | ||
| + | } | ||
| + | ], | ||
| + | [{ | ||
| + | "id": 1239137, | ||
| + | "name": "投诉建议", | ||
| + | "color": 464055807, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1239139, | ||
| + | "name": "Hardware failure11", | ||
| + | "color": 255, | ||
| + | "parentId": 1239137 | ||
| + | } | ||
| + | ], | ||
| + | [{ | ||
| + | "id": 1239137, | ||
| + | "name": "投诉建议", | ||
| + | "color": 464055807, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1360026, | ||
| + | "name": "Network fault", | ||
| + | "color": 0, | ||
| + | "parentId": 1239137 | ||
| + | } | ||
| + | ], | ||
| + | [{ | ||
| + | "id": 1239137, | ||
| + | "name": "投诉建议", | ||
| + | "color": 464055807, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1360027, | ||
| + | "name": "Other", | ||
| + | "color": 0, | ||
| + | "parentId": 1239137 | ||
| + | } | ||
| + | ], | ||
| + | [{ | ||
| + | "id": 1391876, | ||
| + | "name": "请求", | ||
| + | "color": 2709962495, | ||
| + | "parentId": 0 | ||
| + | }], | ||
| + | [{ | ||
| + | "id": 1239137, | ||
| + | "name": "投诉建议", | ||
| + | "color": 464055807, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 600400011, | ||
| + | "name": "System failure", | ||
| + | "color": 0, | ||
| + | "parentId": 1239137 | ||
| + | } | ||
| + | ] | ||
| + | ], | ||
| + | "enquirySummary": "0", | ||
| + | "enquiryDegree": "0", | ||
| + | "consultResult": "1", | ||
| + | "techChannelName": "dyj-测试专用", | ||
| + | "originType": [ | ||
| + | "webim" | ||
| + | ], | ||
| + | "visitorUser": { | ||
| + | "userId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "nicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "username": "webim-visitor-R9C96M7JGRK7FX3X9TJ7" | ||
| + | }, | ||
| + | "customer": { | ||
| + | "customerId": "e4d69130-6662-11ef-95fb-efc368d9d654", | ||
| + | "customerNiceName": "河南省郑州市电信客户2024.08.30", | ||
| + | "customerTrueName": null, | ||
| + | "userDefineColumn": [] | ||
| + | }, | ||
| + | "fromAgentCallback": false, | ||
| + | "visitorUserTags": [], | ||
| + | "chatMessages": [{ | ||
| + | "msgId": "52c73d1a-68d0-11ef-999f-c34169df9000", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-09-02 10:09:02", | ||
| + | "message": "23432432" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "51efefe0-68d0-11ef-8f84-4f936cb681ec", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-09-02 10:09:00", | ||
| + | "message": "12341242342" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "4f78fc70-68d0-11ef-8e21-51ef1deb8483", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-09-02 10:08:56", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "49042770-68d0-11ef-8568-e3f5036f0817", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:08:45", | ||
| + | "message": "我想人工接待" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "48ff9390-68d0-11ef-a8db-83ee66c2be2f", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-09-02 10:08:45", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "4879e8da-68d0-11ef-813f-115f43b66793", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:08:44", | ||
| + | "message": "hgj指令消息第一项转人工" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "35e91a10-68d0-11ef-a15f-139f1435bd55", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:08:13", | ||
| + | "message": "" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "3514b324-68d0-11ef-86dc-a5082577ebd1", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:08:12", | ||
| + | "message": "转人工" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "2bcf58f0-68d0-11ef-83b8-4bfec06b6ea5", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:07:56", | ||
| + | "message": "" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "2790ebfa-68d0-11ef-9039-f34a605ce7ed", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:07:49", | ||
| + | "message": "1" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "16460ab0-68d0-11ef-902a-97f454dbb0ea", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:07:20", | ||
| + | "message": "机器人刚刚开小差了，您再重新问一次吧，或请转人工服务" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "16225624-68d0-11ef-917f-4ff505bde8d3", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:07:20", | ||
| + | "message": "1" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "150f8680-68d0-11ef-aa1d-e1245e99281a", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:07:18", | ||
| + | "message": "机器人刚刚开小差了，您再重新问一次吧，或请转人工服务" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "14e7da4a-68d0-11ef-998e-f79d64d511b7", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:07:18", | ||
| + | "message": "1" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ef423fb0-68cf-11ef-ab4d-9b589e3532ed", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:06:15", | ||
| + | "message": "机器人刚刚开小差了，您再重新问一次吧，或请转人工服务" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ef18709a-68cf-11ef-9178-8dfee2b7b872", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:06:14", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e2612130-68cf-11ef-a7ae-1f516ae0eb9a", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:05:53", | ||
| + | "message": "机器人刚刚开小差了，您再重新问一次吧，或请转人工服务" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e2442364-68cf-11ef-9f2d-252d66096e7f", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:05:53", | ||
| + | "message": "123" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "de09d500-68cf-11ef-99c9-1d5babf208b4", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-09-02 10:05:46", | ||
| + | "message": "机器人刚刚开小差了，您再重新问一次吧，或请转人工服务" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ddebc5b0-68cf-11ef-a84b-97ff35381b51", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-09-02 10:05:46", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "dde69590-68cf-11ef-ae10-11b786435b9c", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-09-02 10:05:46", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "dde3fd80-68cf-11ef-b3fd-e3c3bfed95d3", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:05:45", | ||
| + | "message": "1232" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserSet": [{ | ||
| + | "userId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "username": "robot@504311493.com", | ||
| + | "nicename": "WeiTeng", | ||
| + | "trueName": "", | ||
| + | "tenantId": "99501" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "username": "dyj@99501.com", | ||
| + | "nicename": "dyj@99501.com-昵称", | ||
| + | "trueName": "dyj@99501.com-姓名", | ||
| + | "tenantId": "99501" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserList": [{ | ||
| + | "userId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "username": "robot@504311493.com", | ||
| + | "nicename": "WeiTeng", | ||
| + | "trueName": "", | ||
| + | "tenantId": "99501" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "username": "dyj@99501.com", | ||
| + | "nicename": "dyj@99501.com-昵称", | ||
| + | "trueName": "dyj@99501.com-姓名", | ||
| + | "tenantId": "99501" | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueSet": [{ | ||
| + | "queueId": "276601", | ||
| + | "queueName": "售前技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | }, | ||
| + | { | ||
| + | "queueId": "226073", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueList": [{ | ||
| + | "queueId": "226073", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | }, | ||
| + | { | ||
| + | "queueId": "276601", | ||
| + | "queueName": "售前技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | } | ||
| + | ], | ||
| + | "specialFlag": false, | ||
| + | "visitorDuration": 203, | ||
| + | "serviceSessionEventHistoryList": [{ | ||
| + | "eventId": "dde64770-68cf-11ef-b28b-b5c891a0bdf4", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "actorName": "WeiTeng", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "WeiTeng", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:05:46", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "dde0f04a-68cf-11ef-8c5e-45cd2d1cd1c8", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": null, | ||
| + | "actorName": null, | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": null, | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Created", | ||
| + | "serviceSessionExt": "{\"fromAgentCallback\":false,\"routingPolicyType\":\"Channel\",\"sessionCreateType\":\"fromRoutingPolicy\",\"routingToRobot\":true,\"visitorActive\":false}", | ||
| + | "createDateTime": "2024-09-02 10:05:46", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "48fed040-68d0-11ef-89fa-3d1bfd2b79d2", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "actorName": "WeiTeng", | ||
| + | "fromId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromName": "", | ||
| + | "actorTrueName": "", | ||
| + | "fromState": "Processing", | ||
| + | "toId": "276601", | ||
| + | "toName": "售前技能组", | ||
| + | "toState": "Wait", | ||
| + | "type": "TransferRQ", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:08:45", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "4f794a90-68d0-11ef-9083-b5dc8a6e26e0", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromName": "dyj@99501.com-姓名", | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": "Processing", | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:08:56", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "51f435a0-68d0-11ef-ba95-d1fddd2dc367", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "FirstReplyTime", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:08:59", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "56de9a10-68d0-11ef-9eed-e14d305fae63", | ||
| + | "serviceSessionId": "ddcaa920-68cf-11ef-be3d-09a4110c0aac", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Closed", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:09:09", | ||
| + | "timeStamp": null | ||
| + | } | ||
| + | ], | ||
| + | "summarysDetail": "问题咨询-咨询01;问题咨询-咨询02;投诉建议-Hardware failure11;投诉建议-Network fault;投诉建议-Other;请求;投诉建议-System failure", | ||
| + | "serviceSessionAttribute": { | ||
| + | "referer": "https://99501.sh.absoloop.com/mo/admin/webapp/channels/web", | ||
| + | "searchType": "直接访问", | ||
| + | "ip": "123.52.18.222", | ||
| + | "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 Edg/128.0.0.0", | ||
| + | "region": "中国-河南省-郑州市-电信" | ||
| + | } | ||
| + | }, | ||
| + | { | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "techChannelId": 157861, | ||
| + | "queueId": 276601, | ||
| + | "chatGroupId": 602362464, | ||
| + | "messageSeqId": 19, | ||
| + | "agentUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "agentUserNiceName": "dyj@99501.com-昵称", | ||
| + | "agentUserType": 1, | ||
| + | "createDatetime": "2024-08-30 08:00:40", | ||
| + | "startDateTime": "2024-08-30 08:00:40", | ||
| + | "agentLastMessageDate": "2024-08-30 08:01:34", | ||
| + | "stopDateTime": "2024-09-02 10:05:43", | ||
| + | "techChannelType": "easemob", | ||
| + | "summarys": [ | ||
| + | [{ | ||
| + | "id": 1239137, | ||
| + | "name": "投诉建议", | ||
| + | "color": 464055807, | ||
| + | "parentId": 0 | ||
| + | }, | ||
| + | { | ||
| + | "id": 1239138, | ||
| + | "name": "System failure", | ||
| + | "color": 255, | ||
| + | "parentId": 1239137 | ||
| + | } | ||
| + | ] | ||
| + | ], | ||
| + | "enquirySummary": "0", | ||
| + | "enquiryDegree": "0", | ||
| + | "consultResult": "1", | ||
| + | "techChannelName": "dyj-测试专用", | ||
| + | "originType": [ | ||
| + | "webim" | ||
| + | ], | ||
| + | "visitorUser": { | ||
| + | "userId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "nicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "username": "webim-visitor-R9C96M7JGRK7FX3X9TJ7" | ||
| + | }, | ||
| + | "customer": { | ||
| + | "customerId": "e4d69130-6662-11ef-95fb-efc368d9d654", | ||
| + | "customerNiceName": "河南省郑州市电信客户2024.08.30", | ||
| + | "customerTrueName": null, | ||
| + | "userDefineColumn": [] | ||
| + | }, | ||
| + | "fromAgentCallback": false, | ||
| + | "visitorUserTags": [], | ||
| + | "chatMessages": [{ | ||
| + | "msgId": "d7adb83e-68cf-11ef-a753-6b6cc9186b9e", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-09-02 10:05:35", | ||
| + | "message": "12312" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "05550c70-6663-11ef-96c8-2f64c442f7ec", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-08-30 08:01:34", | ||
| + | "message": "12312321" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "fb19b990-6662-11ef-8b1f-051e2672c124", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-08-30 08:01:17", | ||
| + | "message": "232423423" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "f619aa40-6662-11ef-a243-2f220127f018", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-08-30 08:01:09", | ||
| + | "message": "asd as as asd " | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "f4b2792a-6662-11ef-baf1-8f1ea394b66b", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-08-30 08:01:06", | ||
| + | "message": "asd as " | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "f3182a10-6662-11ef-9b8c-b3cedb8e62be", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-08-30 08:01:04", | ||
| + | "message": "23423423" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "f1ea5884-6662-11ef-909c-d16bb8144904", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-08-30 08:01:02", | ||
| + | "message": "123213" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "f002acb0-6662-11ef-836a-f30b3b5573cc", | ||
| + | "fromType": "Agent", | ||
| + | "fromUserId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromNicename": "dyj@99501.com-昵称", | ||
| + | "createDateTime": "2024-08-30 08:00:59", | ||
| + | "message": "111" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ee0a3810-6662-11ef-a6f5-97bc9a1e6b3f", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-08-30 08:00:55", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ea9eab70-6662-11ef-813f-2b2b977432d2", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-08-30 08:00:50", | ||
| + | "message": "我想人工接待" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ea99c970-6662-11ef-aff8-9949cc5aa6d1", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-08-30 08:00:50", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "ea0aa8da-6662-11ef-9b82-c96182fa5d23", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-08-30 08:00:48", | ||
| + | "message": "hgj指令消息第一项转人工" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e8af5e90-6662-11ef-bdd9-cfc1836f9171", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-08-30 08:00:46", | ||
| + | "message": "" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e7c6fa6a-6662-11ef-9c4d-4733d2958912", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-08-30 08:00:45", | ||
| + | "message": "转人工" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e5f87bf0-6662-11ef-8e1c-e3d72733bc94", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-08-30 08:00:42", | ||
| + | "message": "" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e5f52090-6662-11ef-ae5a-572f49e566da", | ||
| + | "fromType": "Robot", | ||
| + | "fromUserId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromNicename": "WeiTeng", | ||
| + | "createDateTime": "2024-08-30 08:00:42", | ||
| + | "message": "我是未知问第一次" | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e50939f0-6662-11ef-980a-bdd9601f0c4e", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-08-30 08:00:40", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e503468a-6662-11ef-bbdb-01d384efc7aa", | ||
| + | "fromType": "Scheduler", | ||
| + | "fromUserId": "_2", | ||
| + | "fromNicename": "系统客服", | ||
| + | "createDateTime": "2024-08-30 08:00:40", | ||
| + | "message": null | ||
| + | }, | ||
| + | { | ||
| + | "msgId": "e501e6f0-6662-11ef-82c6-3b22443b131b", | ||
| + | "fromType": "Visitor", | ||
| + | "fromUserId": "e4d558b0-6662-11ef-93c5-81ad91a6354e", | ||
| + | "fromNicename": "河南省郑州市电信客户2024.08.30", | ||
| + | "createDateTime": "2024-08-30 08:00:40", | ||
| + | "message": "23423" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserSet": [{ | ||
| + | "userId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "username": "robot@504311493.com", | ||
| + | "nicename": "WeiTeng", | ||
| + | "trueName": "", | ||
| + | "tenantId": "99501" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "username": "dyj@99501.com", | ||
| + | "nicename": "dyj@99501.com-昵称", | ||
| + | "trueName": "dyj@99501.com-姓名", | ||
| + | "tenantId": "99501" | ||
| + | } | ||
| + | ], | ||
| + | "agentUserList": [{ | ||
| + | "userId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "username": "robot@504311493.com", | ||
| + | "nicename": "WeiTeng", | ||
| + | "trueName": "", | ||
| + | "tenantId": "99501" | ||
| + | }, | ||
| + | { | ||
| + | "userId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "username": "dyj@99501.com", | ||
| + | "nicename": "dyj@99501.com-昵称", | ||
| + | "trueName": "dyj@99501.com-姓名", | ||
| + | "tenantId": "99501" | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueSet": [{ | ||
| + | "queueId": "276601", | ||
| + | "queueName": "售前技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | }, | ||
| + | { | ||
| + | "queueId": "226073", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | } | ||
| + | ], | ||
| + | "agentQueueList": [{ | ||
| + | "queueId": "226073", | ||
| + | "queueName": "未分组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | }, | ||
| + | { | ||
| + | "queueId": "276601", | ||
| + | "queueName": "售前技能组", | ||
| + | "queueType": "QueueNormal", | ||
| + | "tenantId": 99501 | ||
| + | } | ||
| + | ], | ||
| + | "specialFlag": false, | ||
| + | "visitorDuration": 266703, | ||
| + | "serviceSessionEventHistoryList": [{ | ||
| + | "eventId": "e5036d90-6662-11ef-9dd5-3f14916637aa", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "actorName": "WeiTeng", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "WeiTeng", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-08-30 08:00:40", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "e4ff4eea-6662-11ef-b9cc-5958f30038b0", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": null, | ||
| + | "actorName": null, | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": null, | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Created", | ||
| + | "serviceSessionExt": "{\"fromAgentCallback\":false,\"routingPolicyType\":\"Channel\",\"sessionCreateType\":\"fromRoutingPolicy\",\"routingToRobot\":true,\"visitorActive\":false}", | ||
| + | "createDateTime": "2024-08-30 08:00:40", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "ea99a260-6662-11ef-99f7-bf6e4982c43f", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "actorName": "WeiTeng", | ||
| + | "fromId": "f7b2bcab-5669-4745-8448-d8f72ab84950", | ||
| + | "fromName": "", | ||
| + | "actorTrueName": "", | ||
| + | "fromState": "Processing", | ||
| + | "toId": "276601", | ||
| + | "toName": "售前技能组", | ||
| + | "toState": "Wait", | ||
| + | "type": "TransferRQ", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-08-30 08:00:50", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "ee0afb60-6662-11ef-8087-158bc74452d4", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "fromName": "dyj@99501.com-姓名", | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": "Processing", | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Opened", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-08-30 08:00:55", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "f007198a-6662-11ef-9877-5baed327fada", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "FirstReplyTime", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-08-30 08:00:58", | ||
| + | "timeStamp": null | ||
| + | }, | ||
| + | { | ||
| + | "eventId": "dc68a820-68cf-11ef-9f81-fbb8e8b6f786", | ||
| + | "serviceSessionId": "e4e8e0b0-6662-11ef-99fa-6fa344371375", | ||
| + | "tenantId": 99501, | ||
| + | "actorId": "bd364c8a-926c-4a43-8866-91f41dca9ee4", | ||
| + | "actorName": "dyj@99501.com-昵称", | ||
| + | "fromId": null, | ||
| + | "fromName": null, | ||
| + | "actorTrueName": "dyj@99501.com-姓名", | ||
| + | "fromState": null, | ||
| + | "toId": null, | ||
| + | "toName": null, | ||
| + | "toState": null, | ||
| + | "type": "Closed", | ||
| + | "serviceSessionExt": null, | ||
| + | "createDateTime": "2024-09-02 10:05:43", | ||
| + | "timeStamp": null | ||
| + | } | ||
| + | ], | ||
| + | "summarysDetail": "投诉建议-System failure", | ||
| + | "serviceSessionAttribute": { | ||
| + | "referer": "https://99501.sh.absoloop.com/mo/admin/webapp/channels/web", | ||
| + | "searchType": "直接访问", | ||
| + | "ip": "123.52.18.222", | ||
| + | "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 Edg/128.0.0.0", | ||
| + | "region": "中国-河南省-郑州市-电信" | ||
| + | } | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| } | } | ||
| </code> | </code> | ||
| 行 764: | 行 3011: | ||
| | techChannelId | int | 关联ID | | | techChannelId | int | 关联ID | | ||
| | queueId | int | 技能组ID | | | queueId | int | 技能组ID | | ||
| - | | state | String | 会话状态 | | + | | state | String | 会话状态 ，会话状态包含的是Wait(排队中)、Processing(进行中)、Terminal(已关闭)| |
| | chatGroupId | int | 访客的群组ID | | | chatGroupId | int | 访客的群组ID | | ||
| | messageSeqId | int | 最大消息序列自增标记 | | | messageSeqId | int | 最大消息序列自增标记 | | ||
| 行 781: | 行 3028: | ||
| | (summarys) parentId | int | 会话标签的父节点ID | | | (summarys) parentId | int | 会话标签的父节点ID | | ||
| | enquirySummary | String | 客户满意度评价 | | | enquirySummary | String | 客户满意度评价 | | ||
| - | | enquiryDetail | String | 客户满意度评价详情 | | + | | enquiryDetail | String | 客户满意度评价详情内容，为访客自行填写的评价文字内容 | |
| | techChannelName | String | 关联名称 | | | techChannelName | String | 关联名称 | | ||
| | originType | String | 渠道类型 网页:webim，APP：app，微信渠道weixin,微博为weibo，呼叫中心：phone | | | originType | String | 渠道类型 网页:webim，APP：app，微信渠道weixin,微博为weibo，呼叫中心：phone | | ||
| 行 796: | 行 3043: | ||
| | transfered | boolean | 是否转接 是：true 不是：false | | | transfered | boolean | 是否转接 是：true 不是：false | | ||
| | visitorUserTags | String | 访客标签 | | | visitorUserTags | String | 访客标签 | | ||
| - | | enquiryTags | String | 满意度评价标签 | | + | | enquiryTags | String | 满意度评价标签，此标签为管理员自定义的标签，支持多选 | |
| | chatMessages | String | 聊天消息 | | | chatMessages | String | 聊天消息 | | ||
| | lastChatMessage | String | 最后一条消息 | | | lastChatMessage | String | 最后一条消息 | | ||
| 行 807: | 行 3054: | ||
| | enquiryTagNames | String | 满意度评价标签的名字 | | | enquiryTagNames | String | 满意度评价标签的名字 | | ||
| | summarysDetail | String | 会话小结文本内容 | | | summarysDetail | String | 会话小结文本内容 | | ||
| + | |||| | ||
| + | |serviceSessionEventHistoryList||会话流转事件| | ||
| + | | eventId | String | 事件Id | | ||
| + | | serviceSessionId | String | 会话Id | | ||
| + | | tenantId | String | 租户Id | | ||
| + | | actorId | String | 操作人Id | | ||
| + | | actorName | String | 操作人昵称 | | ||
| + | | fromId | String | 转接自（操作人Id） | | ||
| + | | fromName | String | 转接自（操作人昵称）| | ||
| + | | actorTrueName | String | 操作人姓名| | ||
| + | | fromState | String | 操作前状态 | | ||
| + | | toId | String | 转接用户Id | | ||
| + | | toName | String | 转接用户姓名 | | ||
| + | | toState | String | 操作后状态| | ||
| + | | type | String | 事件类型：Created-创建，Opened-接起，FirstReplyTime-首次响应，Transfer转接（AA-坐席转坐席，AQ-坐席转技能组，QA-技能组转坐席，QQ-技能组转技能组，RA-机器人转坐席，RQ-机器人转技能组），Closed-关闭，Aborted-待接入会话关闭| | ||
| + | |||| | ||
| + | | serviceSessionExt | | 会话相关事件的详细信息 | | ||
| + | | fromAgentCallback | boolean | 用于记录会话创建事件，会话是否是回呼 | | ||
| + | | assignedAgent | String | 用于记录会话创建事件，记录会话是否指定坐席（指定：坐席的username， 未指定：null） | | ||
| + | | routingPolicyType | String | 用于记录会话创建事件，会话路由信息(UserSpecifiedChannel：入口指定，ChannelData：关联指定，Channel：渠道指定， OfficialAccount：服务号指定，SpecialIdentity：特殊身份指定，Default：默认指定) | | ||
| + | | sessionCreateType | String | 会话创建的方式( "fromAgentCallback", "fromAassignedAgent", "fromRoutingPolicy") | | ||
| + | | routingToRobot | boolean | 是否路由到机器人 | | ||
| + | | queueName | String | 路由到技能组的名称 | | ||
| + | | createDateTime | String | 事件时间 | | ||
| + | | timeStamp | String | 可忽略| | ||
| + | |||| | ||
| + | | (serviceSessionAttribute) carrierOperator | String | 运营商 | | ||
| + | | (serviceSessionAttribute)referer | String | 来源信息 | | ||
| + | | (serviceSessionAttribute)system | String | 操作系统 | | ||
| + | | (serviceSessionAttribute)userAgent | String | 软件环境 | | ||
| + | | (serviceSessionAttribute)version | String | 系统版本 | | ||
| + | | (serviceSessionAttribute)searchType | String | 推广来源 | | ||
| + | | (serviceSessionAttribute)accessUrl | String | 着陆页 | | ||
| + | | (serviceSessionAttribute)ip | String | IP | | ||
| + | | (serviceSessionAttribute)equipment | String | 设备 | | ||
| + | | (serviceSessionAttribute)region | String | 地区 | | ||
| + | | (serviceSessionAttribute)equipment | keyword | 搜索词 | | ||
| ==== 获取历史会话详情 ==== | ==== 获取历史会话详情 ==== | ||
| - | 根据会话ID查询历史会话详情。 | + | 根据会话ID查询历史会话对话内容详情。 |
| - | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/servicesessions/{sessionServiceId}/messages | + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/servicesessions/{sessionServiceId}/messages |
| * HTTP Method: GET | * HTTP Method: GET | ||
| * Request Headers: Kefu-Token=${accessToken} | * Request Headers: Kefu-Token=${accessToken} | ||
| 行 821: | 行 3104: | ||
| <code php> | <code php> | ||
| curl --request GET \ | curl --request GET \ | ||
| - | --url 'http://kefu.easemob.com/tenants/8019/servicesessions/05303239-dd9e-4afe-bf69-92469da17612/messages?page=0&size=10&_=1561514960554' \ | + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/8019/servicesessions/05303239-dd9e-4afe-bf69-92469da17612/messages?page=0&size=10&_=1561514960554' \ |
| --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| </code> | </code> | ||
| 行 888: | 行 3171: | ||
| "name": "个人-7", | "name": "个人-7", | ||
| "type": "SYSTEM", | "type": "SYSTEM", | ||
| - | "img": "//kefu.easemob.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", | + | "img": "//kefu.sh.absoloop.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", |
| "schedule_info": {} | "schedule_info": {} | ||
| } | } | ||
| 行 962: | 行 3245: | ||
| "name": "个人-7", | "name": "个人-7", | ||
| "type": "SYSTEM", | "type": "SYSTEM", | ||
| - | "img": "//kefu.easemob.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", | + | "img": "//kefu.sh.absoloop.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", |
| "schedule_info": {} | "schedule_info": {} | ||
| } | } | ||
| 行 1033: | 行 3316: | ||
| "name": "个人-7", | "name": "个人-7", | ||
| "type": "SYSTEM", | "type": "SYSTEM", | ||
| - | "img": "//kefu.easemob.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", | + | "img": "//kefu.sh.absoloop.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", |
| "schedule_info": {} | "schedule_info": {} | ||
| } | } | ||
| 行 1118: | 行 3401: | ||
| "name": "个人-7", | "name": "个人-7", | ||
| "type": "SYSTEM", | "type": "SYSTEM", | ||
| - | "img": "//kefu.easemob.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", | + | "img": "//kefu.sh.absoloop.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", |
| "schedule_info": {} | "schedule_info": {} | ||
| }, | }, | ||
| 行 1194: | 行 3477: | ||
| "name": "个人-7", | "name": "个人-7", | ||
| "type": "SYSTEM", | "type": "SYSTEM", | ||
| - | "img": "//kefu.easemob.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", | + | "img": "//kefu.sh.absoloop.com/v1/tenants/55899/mediafiles/c08adf10-b217-4b81-95ca-1f8345e4d6186ZSu55uYLmpwZw==/cutout?arg=699_291_1865_1865_300_300", |
| "schedule_info": {} | "schedule_info": {} | ||
| }, | }, | ||
| 行 1257: | 行 3540: | ||
| |(ext.weichat.service_session)robotId|Integer|机器人Id| | |(ext.weichat.service_session)robotId|Integer|机器人Id| | ||
| |(ext.weichat.service_session)state|String|会话状态| | |(ext.weichat.service_session)state|String|会话状态| | ||
| - | |(ext.weichat.service_session)messageSeqId|Long|最大消息序列自增标记| | + | |(ext.weichat.service_session)messageSeqId|Long|最大消息序列自增标记 ，注：messageSeqId 不代表完整消息数，其特殊情况下，messageSeqId 可能会有重复情况| |
| |(ext.weichat.service_session)agentUserId|String|坐席Id| | |(ext.weichat.service_session)agentUserId|String|坐席Id| | ||
| |(ext.weichat.service_session)agentUserType|Integer|坐席类型| | |(ext.weichat.service_session)agentUserType|Integer|坐席类型| | ||
| 行 1278: | 行 3561: | ||
| |totalPages|Integer|总页数| | |totalPages|Integer|总页数| | ||
| |totalElements|Integer|总个数| | |totalElements|Integer|总个数| | ||
| + | |||
| + | |||
| + | ==== 获取单条历史会话统计指标 ==== | ||
| + | |||
| + | 根据租户ID和会话ID查询历史会话里关于会话的响应时长等统计数据，包含 坐席姓名、首次响应时长、会话时长、平均响应时长、最大响应时长等字段。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/servicesession/{serviceSessionId}/quality | ||
| + | * HTTP Method: GET | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/78002/servicesession/df31a220-a004-11ef-a3a1-5124ecbca421/quality' \ | ||
| + | --header 'Kefu-Token: a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |serviceSessionId|String|Y|会话ID| | ||
| + | |||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "sessionId": "df31a220-a004-11ef-a3a1-5124ecbca421", // 会话id | ||
| + | "agentId": "ba4ad730-4fd5-11ef-a82e-09f43cdbdbc9", // 坐席id | ||
| + | "agentName": "WeiTeng大模型", // 坐席名称 | ||
| + | "firstResTime": 0, // 首次响应时长 | ||
| + | "workTime": 28, // 会话时长 | ||
| + | "avgResTime": 0, // 平均响应时长 | ||
| + | "maxResTime": 0 // 最大响应时长 | ||
| + | }, | ||
| + | { | ||
| + | "sessionId": "df31a220-a004-11ef-a3a1-5124ecbca421", | ||
| + | "agentId": "b15ac7b0-959f-11ef-be6f-eb99e19b6309", | ||
| + | "agentName": "xwp@78002.com", | ||
| + | "firstResTime": 10, | ||
| + | "workTime": 79, | ||
| + | "avgResTime": 10, | ||
| + | "maxResTime": 12 | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status|String|接口响应状态| | ||
| + | |sessionId|String|会话Id| | ||
| + | |agentId|String|坐席id| | ||
| + | |agentName|String|坐席名称| | ||
| + | |firstResTime|Integer|首次响应时长,单位是秒| | ||
| + | |workTime|Integer|会话时长,单位是秒| | ||
| + | |avgResTime|Integer|平均响应时长,单位是秒| | ||
| + | |maxResTime|Integer|最大响应时长,单位是秒| | ||
| + | |||
| + | |||
| + | ===== 呼叫中心 ===== | ||
| + | |||
| + | ==== 获取云呼历史通话列表 ==== | ||
| + | |||
| + | 根据呼叫类型、通话时间、技能组、坐席、挂断原因、满意度评价等条件查询历史通话列表。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/tinet/callhistory | ||
| + | * HTTP Method: GET | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/82801/tinet/callhistory?size=10&page=0&startTime=1747872000&endTime=1747958399' \ | ||
| + | --header 'Accept: */*' \ | ||
| + | --header 'Accept-Encoding: gzip, deflate, br' \ | ||
| + | --header 'Cache-Control: no-cache' \ | ||
| + | --header 'Connection: keep-alive' \ | ||
| + | --header 'Cookie: tgw_l7_route=ac6e8cfb38f79314f1d1a723829201ce' \ | ||
| + | --header 'Host: kefu.sh.absoloop.com' \ | ||
| + | --header 'Kefu-Token: 2ce5d27a0d8bf0d1117fa0f299ce832c' \ | ||
| + | --header 'User-Agent: PostmanRuntime-ApipostRuntime/1.1.0' | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |page|int|N|查询页码索引,默认为0，0代表查询第一页数据| | ||
| + | |size|int|N|每页显示的数据容量，默认为10，最大为50| | ||
| + | |startTime| String |N|时间戳，例如1747872000，对应时间2025-05-22 08:00:00| | ||
| + | |endTime| String |N|时间戳，例如1747958399| | ||
| + | |callType| String |N|通话类型，取值：ib(呼入),ob(呼出)| | ||
| + | |evaluation| String |N|是否邀评 取值：0(未邀评),1(已邀评)| | ||
| + | |queueAnswerInTime| String |N|是否及时应答 取值：0(否),1(是)| | ||
| + | |kefuId| String |N|坐席唯一ID，例如：08d1d9e0-1f85-4a69-82d1-0a47a816ff5b| | ||
| + | |hotline| String |N|热线号码，例如：02138278022| | ||
| + | |customerNumber| String |N|客户号码，例如：13121851391| | ||
| + | |mainUniqueId| String |N|通话唯一ID，例如：medias_6-1747904504.135482| | ||
| + | |||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "content": [ | ||
| + | { | ||
| + | "mainUniqueId": "medias_3-1747209447.102195", | ||
| + | "uniqueId": "medias_3-1747209447.102195", | ||
| + | "callId": "2c6f23d2-25be-49f5-9844-624e9b342d07", | ||
| + | "callType": "预览外呼", | ||
| + | "startTime": 1747209447, | ||
| + | "endTime": 1747209461, | ||
| + | "bridgeTime": 1747209457, | ||
| + | "bridgeDuration": 4, | ||
| + | "totalDuration": 14, | ||
| + | "numberHidden": false, | ||
| + | "customerNumber": "13121851391", | ||
| + | "customerNumberEncrypt": "TYjVlOWJiODRmMjJlYzMyY2UzYzVlOTk3YTU5OGY0YTE=", | ||
| + | "customerRealNumber": "13121851391", | ||
| + | "customerAreaCode": "010", | ||
| + | "customerProvince": "北京", | ||
| + | "customerCountry": null, | ||
| + | "customerCity": "北京", | ||
| + | "hotline": "02138278022", | ||
| + | "sipCause": "处理成功", | ||
| + | "endReason": "座席挂断", | ||
| + | "clientNumber": "0002", | ||
| + | "visitor": { | ||
| + | "tenantId": 200001, | ||
| + | "userId": "574c9790-fb1f-11ef-8d7b-51bbb1ab8865", | ||
| + | "createDateTime": 1741329750000, | ||
| + | "lastUpdateDateTime": 1741329750000, | ||
| + | "nickname": "未知访客", | ||
| + | "sex": 0, | ||
| + | "phone": "13121851391", | ||
| + | "customerRealNumber": "13121851391" | ||
| + | }, | ||
| + | "kefuId": "46dda1f0-fb20-11ef-9739-e90d07b13d7f", | ||
| + | "agentName": "tryh@200001.com", | ||
| + | "agentTrueName": "tryh@200001.com", | ||
| + | "agentUserName": "tryh@200001.com", | ||
| + | "groupId": "null", | ||
| + | "skillGroupName": null, | ||
| + | "status": "双方接听", | ||
| + | "ivrName": null, | ||
| + | "mark": 10, | ||
| + | "markData": null, | ||
| + | "keys": null, | ||
| + | "xnumber": "", | ||
| + | "tags": null, | ||
| + | "customerVip": 0, | ||
| + | "customerRingingTime": 1747209453, | ||
| + | "clientRingingTime": null, | ||
| + | "ibWaitDuration": null, | ||
| + | "taskId": null, | ||
| + | "taskName": null, | ||
| + | "taskInventoryId": null, | ||
| + | "joinQueueTime": null, | ||
| + | "leaveQueueTime": null, | ||
| + | "investigationKeys": null, | ||
| + | "ibRingingDuration": null, | ||
| + | "sayVoiceDuration": null, | ||
| + | "ringTime": null, | ||
| + | "queueAnswerInTime": null, | ||
| + | "evaluation": 0, | ||
| + | "numberTrunk": null, | ||
| + | "customerPostCode": "100000", | ||
| + | "firstJoinQueueTime": null, | ||
| + | "recordFile": "8010282-20250514155727-13121851391-0002--record-medias_3-1747209447.102195", | ||
| + | "statusCode": "双方接听-33", | ||
| + | "cno": "57668", | ||
| + | "clientName": "tryh@200001.com", | ||
| + | "qno": "1001" | ||
| + | }, | ||
| + | { | ||
| + | "mainUniqueId": "medias_3-1747203400.68876", | ||
| + | "uniqueId": "medias_3-1747203400.68876", | ||
| + | "callId": "477132af-4e27-43f2-bfbb-4c9156f84661", | ||
| + | "callType": "预览外呼", | ||
| + | "startTime": 1747203400, | ||
| + | "endTime": 1747203421, | ||
| + | "bridgeTime": null, | ||
| + | "bridgeDuration": 0, | ||
| + | "totalDuration": 21, | ||
| + | "numberHidden": false, | ||
| + | "customerNumber": "13121851391", | ||
| + | "customerNumberEncrypt": "TYjVlOWJiODRmMjJlYzMyY2UzYzVlOTk3YTU5OGY0YTE=", | ||
| + | "customerRealNumber": "13121851391", | ||
| + | "customerAreaCode": "010", | ||
| + | "customerProvince": "北京", | ||
| + | "customerCountry": null, | ||
| + | "customerCity": "北京", | ||
| + | "hotline": "02138278022", | ||
| + | "sipCause": "处理成功", | ||
| + | "endReason": null, | ||
| + | "clientNumber": "0002", | ||
| + | "visitor": { | ||
| + | "tenantId": 200001, | ||
| + | "userId": "574c9790-fb1f-11ef-8d7b-51bbb1ab8865", | ||
| + | "createDateTime": 1741329750000, | ||
| + | "lastUpdateDateTime": 1741329750000, | ||
| + | "nickname": "未知访客", | ||
| + | "sex": 0, | ||
| + | "phone": "13121851391", | ||
| + | "customerRealNumber": "13121851391" | ||
| + | }, | ||
| + | "kefuId": "46dda1f0-fb20-11ef-9739-e90d07b13d7f", | ||
| + | "agentName": "tryh@200001.com", | ||
| + | "agentTrueName": "tryh@200001.com", | ||
| + | "agentUserName": "tryh@200001.com", | ||
| + | "groupId": "null", | ||
| + | "skillGroupName": null, | ||
| + | "status": "客户未接听", | ||
| + | "ivrName": null, | ||
| + | "mark": 10, | ||
| + | "markData": null, | ||
| + | "keys": null, | ||
| + | "xnumber": "", | ||
| + | "tags": null, | ||
| + | "customerVip": 0, | ||
| + | "customerRingingTime": 1747203406, | ||
| + | "clientRingingTime": null, | ||
| + | "ibWaitDuration": null, | ||
| + | "taskId": null, | ||
| + | "taskName": null, | ||
| + | "taskInventoryId": null, | ||
| + | "joinQueueTime": null, | ||
| + | "leaveQueueTime": null, | ||
| + | "investigationKeys": null, | ||
| + | "ibRingingDuration": null, | ||
| + | "sayVoiceDuration": null, | ||
| + | "ringTime": null, | ||
| + | "queueAnswerInTime": null, | ||
| + | "evaluation": null, | ||
| + | "numberTrunk": null, | ||
| + | "customerPostCode": "100000", | ||
| + | "firstJoinQueueTime": null, | ||
| + | "recordFile": null, | ||
| + | "statusCode": "客户未接听-32", | ||
| + | "cno": "57668", | ||
| + | "clientName": "tryh@200001.com", | ||
| + | "qno": "1001" | ||
| + | }, | ||
| + | ], | ||
| + | "pageable": { | ||
| + | "sort": { | ||
| + | "unsorted": true, | ||
| + | "sorted": false, | ||
| + | "empty": true | ||
| + | }, | ||
| + | "pageNumber": 0, | ||
| + | "pageSize": 17, | ||
| + | "offset": 0, | ||
| + | "paged": true, | ||
| + | "unpaged": false | ||
| + | }, | ||
| + | "last": true, | ||
| + | "totalElements": 11, | ||
| + | "totalPages": 1, | ||
| + | "sort": { | ||
| + | "unsorted": true, | ||
| + | "sorted": false, | ||
| + | "empty": true | ||
| + | }, | ||
| + | "numberOfElements": 11, | ||
| + | "first": true, | ||
| + | "size": 17, | ||
| + | "number": 0, | ||
| + | "empty": false | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称:内容【说明】^ | ||
| + | |"mainUniqueId": "medias_6-1747101355.16931",【主通话唯一ID】| | ||
| + | |"uniqueId": "medias_6-1747101355.16931",【通话ID】| | ||
| + | |"callId": "e68ac7c1-3c1d-473f-80bf-ac51647e8969",【通话记录 Id】| | ||
| + | |"callType": "呼入",【类型】| | ||
| + | |"startTime": 1747101355,【开始时间】| | ||
| + | |"endTime": 1747101360,【结束时间】| | ||
| + | |"bridgeTime": null,【接通时间】| | ||
| + | |"bridgeDuration": 0,【通话时长，本项大于0即可视为成功接通的通话】| | ||
| + | |"totalDuration": 5,【总时长】| | ||
| + | |"numberHidden": false,【是否隐藏号码】| | ||
| + | |"customerNumber": "13121851391",【客户号码】| | ||
| + | |"customerNumberEncrypt": "TYjVlOWJiODRmMjJlYzMyY2UzYzVlOTk3YTU5OGY0YTE=",【客户号码加密串】| | ||
| + | |"customerRealNumber": "13121851391",【客户真实号码】| | ||
| + | |"customerAreaCode": "010",【客户号码区号】| | ||
| + | |"customerProvince": "北京",【首叫号码省份】| | ||
| + | |"customerCountry": null,【首叫号码国家】| | ||
| + | |"customerCity": "北京",【客户号码城市】| | ||
| + | |"hotline": "02138278022",【热线号码】| | ||
| + | |"sipCause": "处理成功",【呼叫情况】| | ||
| + | |"endReason": "座席挂断",,【挂机原因；0：系统挂机，1：座席挂机，2：客户挂机，3：未知】| | ||
| + | |"clientNumber": "0002",,【座席电话】| | ||
| + | |"visitor": 访客相关信息| | ||
| + | |"visitor">"tenantId": 200001,【环信租户ID】| | ||
| + | |"visitor">"userId": "574c9790-fb1f-11ef-8d7b-51bbb1ab8865",【环信用户唯一ID】| | ||
| + | |"visitor">"createDateTime": 1741329750000,| | ||
| + | |"visitor">"lastUpdateDateTime": 1741329750000,| | ||
| + | |"visitor">"nickname": "未知访客",【用户昵称】【已显示，对应客户】| | ||
| + | |"visitor">"sex": 0,【用户性别】| | ||
| + | |"visitor">"phone": "13121851391",【用户电话】| | ||
| + | |"visitor">"customerRealNumber": "13121851391"【用户真实号码】| | ||
| + | |"kefuId": "46dda1f0-fb20-11ef-9739-e90d07b13d7f",【客服id】| | ||
| + | |"agentName": "tryh@200001.com",【客服名称】| | ||
| + | |"agentTrueName": "tryh@200001.com",【客服真实名称】| | ||
| + | |"agentUserName": "tryh@200001.com",【客服真实名称】| | ||
| + | |"groupId": "c8382c90-fb1e-11ef-901e-19aa5fb086c6",【技能组ID】| | ||
| + | |"skillGroupName": "dyj呼叫",【技能组名称】| | ||
| + | |"status": "系统接听",【接听状态】| | ||
| + | |"ivrName": "工作时间",【IVR名称】| | ||
| + | |"mark": 11,【标记】| | ||
| + | |"markData": null,【备注】| | ||
| + | |"keys": null,【按键值】| | ||
| + | |"xnumber": "",【虚拟号码】| | ||
| + | |"tags": null,【标签】| | ||
| + | |"customerVip": 0,【客户VIP标识】| | ||
| + | |"customerRingingTime": 1747203537,【客户响铃时间】| | ||
| + | |"clientRingingTime": null,【座席响铃时间】| | ||
| + | |"ibWaitDuration": null,【排队时长】| | ||
| + | |"taskId": null,【外呼任务id】| | ||
| + | |"taskName": null,【外呼任务名称】| | ||
| + | |"taskInventoryId": null,【外呼任务详情id】| | ||
| + | |"joinQueueTime": 1747101358,【加入队列时间】| | ||
| + | |"leaveQueueTime": 1747101358,【离开队列时间】| | ||
| + | |"investigationKeys": null,【满意度评价】| | ||
| + | |"ibRingingDuration": 0,【座席振铃时长】| | ||
| + | |"sayVoiceDuration": 0,【语音播报时长】| | ||
| + | |"ringTime": null,【振铃时间】| | ||
| + | |"queueAnswerInTime": null,【队列及时应答:0: 否 1: 是 2: -】| | ||
| + | |"evaluation": 0,,【是否邀评,0-是，1-否】| | ||
| + | |"numberTrunk": "02138278022",【中继号】| | ||
| + | |"customerPostCode": "100000",【追加客户邮编】| | ||
| + | |"firstJoinQueueTime": 1747101358,【首次进入队列时间】| | ||
| + | |"recordFile": "8010282-20250514141509-13121851391-0002--record-medias_2-1747203309.68127",【录音文件】| | ||
| + | |"statusCode": "系统接听-3",【接听状态映射】| | ||
| + | |"cno": "",【座席号】| | ||
| + | |"clientName": null,【座席名称】| | ||
| + | |"qno": "1001"【所属技能组队列号】| | ||
| + | |||
| + | ==== 获取单个云呼的通话录音文件 ==== | ||
| + | |||
| + | 根据通话id查询通话录音。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/tinet/recording/{mainUniqueId}/single | ||
| + | * HTTP Method: GET | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/200001/tinet/recording/medias_4-1747295697.103581/single' \ | ||
| + | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |mainUniqueId|string|Y|通话id| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "tenantId": 200001, | ||
| + | "mainUniqueId": "medias_4-1747295697.103581", | ||
| + | "fileUrl": "https%3A%2F%2Fclink2-sh-voice.oss-cn-shanghai.aliyuncs.com%2F15052025%2Frecord%2F8010282%2F8010282-20250515155457-13121851391-19037177166--record-medias_4-1747295697.103581.mp3%3Fx-oss-date%3D20250519T090155Z%26x-oss-expires%3D3600%26x-oss-signature-version%3DOSS4-HMAC-SHA256%26x-oss-credential%3DLTAI5t9crdbhGT7CE9U7GPDm%252F20250519%252Fcn-shanghai%252Foss%252Faliyun_v4_request%26x-oss-signature%3De9221ec103ce59cfd4abbec88bf463a5d4c14c7c0abee706d004897fa7225fe5" | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status| String |接口响应状态,OK代表请求成功| | ||
| + | |tenantId| String |租户ID| | ||
| + | |mainUniqueId| String |通话ID| | ||
| + | |fileName| String |录音文件名| | ||
| + | |fileUrl| String |录音文件访问路径| | ||
| + | |||
| + | |||
| + | ===== 工单 ===== | ||
| + | |||
| + | ==== 查询自定义表单 ==== | ||
| + | |||
| + | 可查询在环信客服云后台设置的自定义表单列表。 | ||
| + | |||
| + | 应用场景： | ||
| + | 您自己的业务系统/APP里提交工单，您自己开发提交工单的页面，调用环信工单接口，工单数据提交至环信客服云。您自己开发提交工单的页面时，需要指定用户填写的工单字段，这一步调用此接口完成。获取自定义表单后，您可在页面上直接指定用户填写哪一个表单的字段，也可让用户自行选择表单（让用户选择业务分类）。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/integration-ticket/forms | ||
| + | * HTTP Method: GET | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/20016/integration-ticket/forms' \ | ||
| + | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId| int |Y|租户ID| | ||
| + | |page| int |N|页码，默认为0| | ||
| + | |size| int |N|每页的数据量，默认为10| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entities": [ | ||
| + | { | ||
| + | "id": "7f0f0af4-71bd-4c04-b049-c98802cb793b", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-28T03:11:18Z", | ||
| + | "updated": "2019-11-28T03:11:18Z", | ||
| + | "name": "自定义表单111", | ||
| + | "description": "测试自定义表单功能", | ||
| + | "status": "enabled", | ||
| + | "fields": [ | ||
| + | { | ||
| + | "id": "6cf63d66-5f0a-4a53-acb4-e46998227342", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-28T03:14:49Z", | ||
| + | "updated": "2019-11-28T03:14:49Z", | ||
| + | "name": "自定义表单222", | ||
| + | "description": "测试自定义表单2222", | ||
| + | "status": "enabled", | ||
| + | "fields": [ | ||
| + | { | ||
| + | "id": "e7d32c88-22e0-4ffd-95df-741e628ada8e", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-28T03:24:25Z", | ||
| + | "updated": "2019-11-28T03:24:25Z", | ||
| + | "form_id": "6cf63d66-5f0a-4a53-acb4-e46998227342", | ||
| + | "name": "男，女", | ||
| + | "label": "性别", | ||
| + | "type": "TEXT_STRING", | ||
| + | "visible": true, | ||
| + | "required": "ON", | ||
| + | "sort": 1, | ||
| + | "hint": "填写性别", | ||
| + | "dictionary_items": [], | ||
| + | "cascade_items": [] | ||
| + | }, | ||
| + | { | ||
| + | "id": "2c17ad7b-c808-4850-94e7-d39ecf743d7e", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-28T03:24:53Z", | ||
| + | "updated": "2019-11-28T03:24:53Z", | ||
| + | "form_id": "6cf63d66-5f0a-4a53-acb4-e46998227342", | ||
| + | "name": "填写爱好", | ||
| + | "label": "爱好", | ||
| + | "type": "SELECT_STRING", | ||
| + | "dictionary_id": "eb9fb55e-3978-40ac-bc79-8623af7bc11b", | ||
| + | "visible": true, | ||
| + | "required": "ON", | ||
| + | "sort": 2, | ||
| + | "dictionary_items": [], | ||
| + | "cascade_items": [] | ||
| + | }, | ||
| + | { | ||
| + | "id": "ceb2ca78-6118-42de-9e21-23baf366dba1", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-28T03:25:26Z", | ||
| + | "updated": "2019-11-28T03:25:26Z", | ||
| + | "form_id": "6cf63d66-5f0a-4a53-acb4-e46998227342", | ||
| + | "name": "填写出生日期", | ||
| + | "label": "出生日期", | ||
| + | "type": "NUMBER", | ||
| + | "visible": true, | ||
| + | "required": "ON", | ||
| + | "sort": 3, | ||
| + | "hint": "填写出生日期", | ||
| + | "dictionary_items": [], | ||
| + | "cascade_items": [] | ||
| + | } | ||
| + | ], | ||
| + | "topics": [ | ||
| + | { | ||
| + | "id": "351d899f-c83c-476c-8f71-bc1918eb4ba0", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:05Z", | ||
| + | "updated": "2019-11-27T10:31:05Z", | ||
| + | "parent_id": "eb72bc55-cbd6-454b-be81-1ad1b8df4940", | ||
| + | "name": "第二级别主题", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "full_name": "/hegj帮助主题1/第二级别主题", | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "2e272127-84d2-49a2-964e-e507d4a374f3", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:17Z", | ||
| + | "updated": "2019-11-27T10:31:17Z", | ||
| + | "parent_id": "351d899f-c83c-476c-8f71-bc1918eb4ba0", | ||
| + | "name": "第三级别主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "1ba44df9-ee60-4b8a-83ce-ff007a46bc38", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:30Z", | ||
| + | "updated": "2019-11-27T10:31:30Z", | ||
| + | "parent_id": "2e272127-84d2-49a2-964e-e507d4a374f3", | ||
| + | "name": "第四级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "full_name": "/hegj帮助主题1/第二级别主题/第三级别主题1/第四级主题1", | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "aca22ed9-f392-4620-8676-2d44da4a3891", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:40Z", | ||
| + | "updated": "2019-11-27T10:31:40Z", | ||
| + | "parent_id": "1ba44df9-ee60-4b8a-83ce-ff007a46bc38", | ||
| + | "name": "第五级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "1bb2a127-9179-4d4f-9352-20c341180c85", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:49Z", | ||
| + | "updated": "2019-11-27T10:31:49Z", | ||
| + | "parent_id": "aca22ed9-f392-4620-8676-2d44da4a3891", | ||
| + | "name": "第六级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1 | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | "id": "1bb2a127-9179-4d4f-9352-20c341180c85", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:49Z", | ||
| + | "updated": "2019-11-27T10:31:49Z", | ||
| + | "parent_id": "aca22ed9-f392-4620-8676-2d44da4a3891", | ||
| + | "name": "第六级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "full_name": "/hegj帮助主题1/第二级别主题/第三级别主题1/第四级主题1/第五级主题1/第六级主题1" | ||
| + | }, | ||
| + | { | ||
| + | "id": "1ba44df9-ee60-4b8a-83ce-ff007a46bc38", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:30Z", | ||
| + | "updated": "2019-11-27T10:31:30Z", | ||
| + | "parent_id": "2e272127-84d2-49a2-964e-e507d4a374f3", | ||
| + | "name": "第四级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "full_name": "/hegj帮助主题1/第二级别主题/第三级别主题1/第四级主题1", | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "aca22ed9-f392-4620-8676-2d44da4a3891", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:40Z", | ||
| + | "updated": "2019-11-27T10:31:40Z", | ||
| + | "parent_id": "1ba44df9-ee60-4b8a-83ce-ff007a46bc38", | ||
| + | "name": "第五级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1, | ||
| + | "children": [ | ||
| + | { | ||
| + | "id": "1bb2a127-9179-4d4f-9352-20c341180c85", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T10:31:49Z", | ||
| + | "updated": "2019-11-27T10:31:49Z", | ||
| + | "parent_id": "aca22ed9-f392-4620-8676-2d44da4a3891", | ||
| + | "name": "第六级主题1", | ||
| + | "is_active": 1, | ||
| + | "is_public": 1 | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ], | ||
| + | "topic_ids": [ | ||
| + | "1ba44df9-ee60-4b8a-83ce-ff007a46bc38", | ||
| + | "351d899f-c83c-476c-8f71-bc1918eb4ba0", | ||
| + | "1bb2a127-9179-4d4f-9352-20c341180c85" | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | "id": "kefu_27886", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2019-11-27T07:22:35Z", | ||
| + | "updated": "2019-11-27T07:22:35Z", | ||
| + | "name": "默认表单", | ||
| + | "description": "租户默认的自定义表单", | ||
| + | "status": "enabled", | ||
| + | "fields": [], | ||
| + | "topics": [], | ||
| + | "topic_ids": [] | ||
| + | } | ||
| + | ], | ||
| + | "first": true, | ||
| + | "last": true, | ||
| + | "size": 10, | ||
| + | "number": 0, | ||
| + | "numberOfElements": 3, | ||
| + | "totalPages": 1, | ||
| + | "totalElements": 3 | ||
| + | } | ||
| + | |||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |httpStatusCode| String |http状态码| | ||
| + | |status| String |接口响应状态| | ||
| + | |entities| |表单列表| | ||
| + | |first| Boolean |是否是第一页| | ||
| + | |last| Boolean |是否是最后一页| | ||
| + | |size| int |每页的数据量| | ||
| + | |number| String |第几页| | ||
| + | |numberOfElements| int |该页的数据量| | ||
| + | |totalPages| int |总页数| | ||
| + | |totalElements| int|总数据量| | ||
| + | |||| | ||
| + | |表单数据| | ||
| + | |id| String |表单ID，自定义表单的唯一标识| | ||
| + | |tenant_id| String |租户ID| | ||
| + | |created| int |表单创建时间| | ||
| + | |updated| String |表单修改时间| | ||
| + | |name| String |表单名称| | ||
| + | |description| String |描述| | ||
| + | |status| String|状态，enabled| | ||
| + | |fields| |List<FormField>，自定义字段信息| | ||
| + | |topics| |List<HelpTopic>,表单关联的帮助主题| | ||
| + | |topic_ids| String |表单关联的帮助主题Id列表| | ||
| + | |||| | ||
| + | |表单字段数据| | ||
| + | |id| String |字段ID，字段的唯一标识| | ||
| + | |tenant_id| String |租户ID| | ||
| + | |created| int |字段创建时间| | ||
| + | |updated| String |字段修改时间| | ||
| + | |form_id| String |表单ID| | ||
| + | |name| String |字段标识| | ||
| + | |label| String |字段名称| | ||
| + | |type| String|字段格式：TEXT_STRING 单行文本，DATE 日期，NUMBER 数字类型，URL URL，SELECT_STRING 下拉选项，TEXTAREA_STRING 多行文本，CASCADE_SELECT_STRING 级联选择| | ||
| + | |dictionary_id| String |关联下拉选项| | ||
| + | |visible| Boolean |访客是否可见| | ||
| + | |required| Boolean |是否必填| | ||
| + | |sort| String |排序字段| | ||
| + | |hint| String |文本框提示语| | ||
| + | |dictionary_items| |List<DictionaryItem>，下拉选项| | ||
| + | |cascade_items| |List<CascadeItem>，级联选项| | ||
| + | |||| | ||
| + | |选项数据| | ||
| + | |id| String |每个选项的ID| | ||
| + | |tenant_id| String |租户ID| | ||
| + | |created| int |选项创建时间| | ||
| + | |updated| String |选项修改时间| | ||
| + | |dictionary_Id| String |关联字段ID| | ||
| + | |item_value| String |选项名称| | ||
| + | |sort| String |排序字段| | ||
| + | |status| String |可忽略| | ||
| + | |||| | ||
| + | |级联选项| | ||
| + | |id| String |每个级联的ID| | ||
| + | |tenant_id| String |租户ID| | ||
| + | |created| int |选项创建时间| | ||
| + | |updated| String |选项修改时间| | ||
| + | |field_id| String |字段ID| | ||
| + | |form_id| String |表单ID| | ||
| + | |name| String |级联选项名称| | ||
| + | |parent_id| String |父节点ID| | ||
| + | |children| |List<CascadeItem>，子节点| | ||
| + | |||
| + | ==== 工单附件上传 ==== | ||
| + | |||
| + | 提交工单/回复工单时，若需要上传附件，则需要先调用此接口上传附件，再调用访客提交工单接口提交工单。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/integration-ticket/mediaFiles | ||
| + | * HTTP Method: POST | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/20016/integration-ticket/mediaFiles' \ | ||
| + | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | --form 'file=@/Users/heguojiao/Downloads/第024期-lcn.pptx' | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |file|form-data|Y|附件信息| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "uuid": "010b99ec-ba54-4062-b6cf-a20737ae782e56ysMDI05pyfLWxjbi5wcHR4", | ||
| + | "contentType": "application/vnd.openxmlformats-officedocument.presentationml.presentation", | ||
| + | "contentLength": 1385894, | ||
| + | "url": "/v2/tenants/20016/integration/ticket-server/visitors/mediaFiles/010b99ec-ba54-4062-b6cf-a20737ae782e56ysMDI05pyfLWxjbi5wcHR4", | ||
| + | "fileName": "第024期-lcn.pptx" | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status| String |接口响应状态| | ||
| + | |entity| |附件信息| | ||
| + | |||| | ||
| + | |附件信息| | ||
| + | |uuid| String |附件ID| | ||
| + | |contentType| String |附件类型| | ||
| + | |contentLength| String |附件大小| | ||
| + | |url| String |附件地址| | ||
| + | |fileName| String |附件名称| | ||
| + | |||
| + | ==== 工单状态接口 ==== | ||
| + | |||
| + | **获取token：** | ||
| + | |||
| + | 1.开放平台需要使用token进行身份验证。 | ||
| + | |||
| + | 2.Kefu-Token有效期2小时，到期需重新获取。 | ||
| + | |||
| + | 登录地址： | ||
| + | ^操作^|更新修改工单状态，标题，优先级，工单内容，分配组，分配人的接口| | ||
| + | ^协议^| HTTPS | | ||
| + | ^方式^| PUT | | ||
| + | ^URL^|/api/platform/tenants/{tenantId}/integration-ticket/{ticketId}/updateTicketInfo| | ||
| + | |||
| + | 请求参数： | ||
| + | ^参数^是否必传^描述^参数类型^数据类型^ | ||
| + | |tenantId| 是 |租户Id|Path|integer| | ||
| + | |ticketId|是|工单Id|Path|String| | ||
| + | |requestBody|是|请求体|Body|object| | ||
| + | |||
| + | requestBody包括以下几个参数： | ||
| + | ^参数^是否必传^描述^数据类型^ | ||
| + | |title|否|标题|String| | ||
| + | |status_id|否|工单状态id|String| | ||
| + | |staff_id|是|坐席id|String| | ||
| + | |team_id|否|技能组Id|String| | ||
| + | |priority_id|否|优先级id|String| | ||
| + | |content|否|工单内容|String| | ||
| + | |||
| + | 返回数据： | ||
| + | ^HTTP状态Code^含义^ | ||
| + | |200|OK| | ||
| + | |API_007|Staff_id不能为空| | ||
| + | ^成功返回数据^含义^ | ||
| + | |Status|OK| | ||
| + | |entities|List<from>| | ||
| + | |||
| + | **请求示例：** | ||
| + | |||
| + | 请求数据格式都应该是application/json，编码形式为UTF-8 | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "title":"开放平台45", | ||
| + | "status_id":"7732d036-fdcc-4996-973e-0d9323a39617", | ||
| + | "team_id":"dfdgsd", | ||
| + | "staff_id":"hksjdks77555", | ||
| + | "priority_id":"tjuncu1", | ||
| + | "content":"公章" | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | **成功返回示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "id": "eca76b2c-a69a-48d8-8056-7fad0ff290f3", | ||
| + | "tenant_id": 11, | ||
| + | "title":"开放平台45", | ||
| + | "status_id":"7732d036-fdcc-4996-973e-0d9323a39617", | ||
| + | "team_id":"dfdgsd", | ||
| + | "staff_id":"hksjdks77555", | ||
| + | "priority_id":"tjuncu1", | ||
| + | "content":"公章", | ||
| + | "satisfaction_score": 0, | ||
| + | "quality_score": 0, | ||
| + | "operator_id": "hksjdks77555", | ||
| + | "operator_type": "S", | ||
| + | "is_admin": true, | ||
| + | "form_values": [], | ||
| + | "is_read": 0 | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | |||
| + | ==== 访客提交工单 ==== | ||
| + | |||
| + | 访客提交工单接口。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/integration-ticket/visitors/ticket | ||
| + | * HTTP Method: POST | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/20016/integration-ticket/visitors/ticket' \ | ||
| + | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | --header 'Content-Type: application/json' \ | ||
| + | --data-raw '{ | ||
| + | "title": "标题222334", | ||
| + | "content": "描述222334", | ||
| + | "visitor_phone": "13662124786", | ||
| + | "visitor_email": "8122334@qq.com", | ||
| + | "visitor_nickname": "称呼222334", | ||
| + | "attachments": [ | ||
| + | { | ||
| + | "name": "message-center-server服务未升级组件.png", | ||
| + | "file_type": "image/png", | ||
| + | "size": 970870, | ||
| + | "url": "http://kefu.sh.absoloop.com//v2/tenants/27886/integration/ticket-server/visitors/mediaFiles/c5154e5e-09c4-476c-a2f6-f6a1ca42eaa1bWVzc2FnZS1jZW50ZXItc2VydmVy5pyN5Yqh5pyq5Y2H57qn57uE5Lu2LnBuZw==", | ||
| + | "uuid": "c5154e5e-09c4-476c-a2f6-f6a1ca42eaa1bWVzc2FnZS1jZW50ZXItc2VydmVy5pyN5Yqh5pyq5Y2H57qn57uE5Lu2LnBuZw==" | ||
| + | } | ||
| + | ], | ||
| + | "form_values": [ | ||
| + | { | ||
| + | "field_id": "2c17ad7b-c808-4850-94e7-d39ecf743d7e", | ||
| + | "field_value": "篮球" | ||
| + | }, | ||
| + | { | ||
| + | "field_id": "e7d32c88-22e0-4ffd-95df-741e628ada8e", | ||
| + | "field_value": "女" | ||
| + | }, | ||
| + | { | ||
| + | "field_id": "ceb2ca78-6118-42de-9e21-23baf366dba1", | ||
| + | "field_value": "22" | ||
| + | }, | ||
| + | { | ||
| + | "field_id": "030eb800-00f4-4ff0-96b1-01edb15d0016", | ||
| + | "field_value": "级联选项1/级联选项1-1", | ||
| + | "item_ids": "6b550cfd-74b6-405c-aadf-c82989f4b52e_09d44dab-196a-4529-9c8b-1c92f7152037" | ||
| + | } | ||
| + | ], | ||
| + | "form_id": "6cf63d66-5f0a-4a53-acb4-e46998227342" | ||
| + | }' | ||
| + | |||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |title|String|Y|标题| | ||
| + | |content|String|Y|内容| | ||
| + | |visitor_phone|String|Y|访客手机号| | ||
| + | |visitor_email|String|Y|访客邮箱| | ||
| + | |visitor_nickname|String|Y|访客昵称| | ||
| + | |attachments|String|N|附件信息| | ||
| + | |form_id|String|N|表单ID| | ||
| + | |form_values|String|N|表单自定义字段信息| | ||
| + | |||| | ||
| + | |附件信息| | ||
| + | |name|String||附件名，对应上传附件接口里的fileName字段| | ||
| + | |file_type|String||对应上传附件接口里的contentType字段| | ||
| + | |size|String||对应上传附件接口里的contentLength字段| | ||
| + | |url|String||对应上传附件接口里的url字段| | ||
| + | |uuid|String||对应上传附件接口里的uuid字段| | ||
| + | |||| | ||
| + | |自定义表单字段| | ||
| + | |field_id|String||字段ID| | ||
| + | |file_type|String||填写内容| | ||
| + | |item_ids|String||对于级联字段设置的层级id| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "id": "75eb5d2e-3235-431d-b716-5b634736cf5b", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2020-09-16T07:42:46Z", | ||
| + | "updated": "2020-09-16T07:42:46Z", | ||
| + | "title": "标题222334", | ||
| + | "code": "A0000004", | ||
| + | "visitor_user_id": "64022b77-166d-4a68-bc37-fdb146a07dfa", | ||
| + | "status_id": "ff22d6d8-3da5-4ec2-8920-aa645b332c5a", | ||
| + | "source": "API", | ||
| + | "creator_id": "64022b77-166d-4a68-bc37-fdb146a07dfa", | ||
| + | "creator_type": "C", | ||
| + | "content": "描述222334", | ||
| + | "form_id": "6cf63d66-5f0a-4a53-acb4-e46998227342", | ||
| + | "satisfaction_score": 0, | ||
| + | "quality_score": 0, | ||
| + | "operator_id": "64022b77-166d-4a68-bc37-fdb146a07dfa", | ||
| + | "operator_type": "C", | ||
| + | "form_values": [ | ||
| + | { | ||
| + | "id": "196fc01c-650d-4b3d-9755-e2221541155e", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2020-09-16T07:42:46Z", | ||
| + | "updated": "2020-09-16T07:42:46Z", | ||
| + | "field_id": "2c17ad7b-c808-4850-94e7-d39ecf743d7e", | ||
| + | "field_value": "篮球" | ||
| + | }, | ||
| + | { | ||
| + | "id": "d774aed5-6dc8-469d-ba30-287ebe99faaa", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2020-09-16T07:42:46Z", | ||
| + | "updated": "2020-09-16T07:42:46Z", | ||
| + | "field_id": "030eb800-00f4-4ff0-96b1-01edb15d0016", | ||
| + | "field_value": "级联选项1/级联选项1-1", | ||
| + | "item_ids": "6b550cfd-74b6-405c-aadf-c82989f4b52e_09d44dab-196a-4529-9c8b-1c92f7152037" | ||
| + | }, | ||
| + | { | ||
| + | "id": "611bfc78-b3a0-468a-80c7-89cf4c6b8d41", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2020-09-16T07:42:46Z", | ||
| + | "updated": "2020-09-16T07:42:46Z", | ||
| + | "field_id": "ceb2ca78-6118-42de-9e21-23baf366dba1", | ||
| + | "field_value": "22" | ||
| + | }, | ||
| + | { | ||
| + | "id": "6c51017a-de6e-426b-a4b8-038befc6a936", | ||
| + | "tenant_id": 200161, | ||
| + | "created": "2020-09-16T07:42:46Z", | ||
| + | "updated": "2020-09-16T07:42:46Z", | ||
| + | "field_id": "e7d32c88-22e0-4ffd-95df-741e628ada8e", | ||
| + | "field_value": "女" | ||
| + | } | ||
| + | ], | ||
| + | "is_read": 0 | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status| String |接口响应状态| | ||
| + | |entity| |工单信息| | ||
| + | |||| | ||
| + | |工单信息| | ||
| + | |id| String |工单id| | ||
| + | |tenant_id| String |租户id| | ||
| + | |created| String |创建时间| | ||
| + | |updated| String |修改时间| | ||
| + | |title| String |工单标题| | ||
| + | |code| String |工单编号| | ||
| + | |visitor_user_id| String |访客ID| | ||
| + | |status_id| String |工单状态ID| | ||
| + | |source| String |固定传值“API”| | ||
| + | |creator_id| String |创建者ID| | ||
| + | |creator_type| String |创建者类型（S、C）STAFF("S"), CUSTOMER("C")| | ||
| + | |content| String |工单内容| | ||
| + | |form_id| String |表单ID| | ||
| + | |satisfaction_score| String |满意度评分| | ||
| + | |quality_score| String |质检评分| | ||
| + | |operator_id| String |质检员ID| | ||
| + | |operator_type| String |质检员类型| | ||
| + | |form_values| String |List<FormValue>，表单自定义字段内容| | ||
| + | |is_read| String |工单已读未读功能| | ||
| + | |||| | ||
| + | |FormValue| | ||
| + | |id| String |工单和字段关联ID| | ||
| + | |tenant_id| String |租户id| | ||
| + | |created| String |创建时间| | ||
| + | |updated| String |修改时间| | ||
| + | |field_id| String |字段ID| | ||
| + | |field_value| String |字段对应的填写的内容| | ||
| + | ==== 访客回复工单 ==== | ||
| + | |||
| + | 访客回复工单接口。 | ||
| + | |||
| + | * Path: http://kefu.sh.absoloop.com/api/platform/tenants/{tenantId}/integration-ticket/visitors/{ticketId}/comments | ||
| + | * HTTP Method: POST | ||
| + | * Request Headers: Kefu-Token=${accessToken} | ||
| + | * 可能的错误码：详见：[[#错误码说明|错误码说明]] | ||
| + | |||
| + | **Curl示例：** | ||
| + | |||
| + | <code php> | ||
| + | curl --request GET \ | ||
| + | --url 'http://kefu.sh.absoloop.com/api/platform/tenants/20016/integration-ticket/visitors/{ticketId}/comments' \ | ||
| + | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
| + | -d '{ | ||
| + | "body": "<p>aaaappppiiii</p>", | ||
| + | "format": "html", | ||
| + | "attachments": [ | ||
| + | { | ||
| + | "contentType": "image/png", | ||
| + | "contentLength": 239008, | ||
| + | "url": "https://kefu.sh.absoloop.com/v2/tenants/29676/integration/ticket-server/visitors/mediaFiles/afec47f4-659d-4dd9-9406-1e07bc7ca9415raI5oGvLnBuZw==", | ||
| + | "name": "消息.png" | ||
| + | } | ||
| + | ], | ||
| + | "visitor_email": "qu@api.com" | ||
| + | }' | ||
| + | |||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
| + | |Kefu-Token| String |Y|调用接口的accessToken| | ||
| + | |tenantId|int|Y|租户ID| | ||
| + | |ticketId|String|Y|工单ID| | ||
| + | |body|String|Y|回复内容| | ||
| + | |format|String|Y|文本格式| | ||
| + | |visitor_email|String|Y|访客邮箱| | ||
| + | |attachments||N|附件| | ||
| + | |附件信息| | ||
| + | |contentType|String||类型| | ||
| + | |contentLength|String||附件大小| | ||
| + | |url|String||附件地址| | ||
| + | |name|String||附件名称| | ||
| + | |||
| + | **Response示例：** | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | "status": "OK", | ||
| + | "entity": { | ||
| + | "id": "01237efe-6d43-4092-afb3-49efbf22b9ef", | ||
| + | "tenant_id": 601, | ||
| + | "created": "2021-01-11T14:49:28Z", | ||
| + | "updated": "2021-01-11T14:49:28Z", | ||
| + | "ticket_id": "e863ba5e-6e54-429c-9674-7e5a43cf495c", | ||
| + | "visitor_user_id": "8fdfca59-9e4b-466c-84a7-06f3cd0ce942", | ||
| + | "body": "<p>aaaappppiiii</p>", | ||
| + | "format": "html", | ||
| + | "is_public": true, | ||
| + | "attachments": [ | ||
| + | { | ||
| + | "id": "c54109e1-98fe-4f62-a00f-8e4394f9b669", | ||
| + | "tenant_id": 601, | ||
| + | "url": "https://kefu.sh.absoloop.com/v2/tenants/29676/integration/ticket-server/visitors/mediaFiles/afec47f4-659d-4dd9-9406-1e07bc7ca9415raI5oGvLnBuZw==", | ||
| + | "right_attachment": false | ||
| + | } | ||
| + | ], | ||
| + | "public_response_type": "EMAIL" | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </code> | ||
| + | |||
| + | 参数说明： | ||
| + | ^名称^类型^说明^ | ||
| + | |status| String |接口响应状态| | ||
| + | |entity| |回复信息| | ||
| + | |id|String|评论ID| | ||
| + | |tenantId|String|租户ID| | ||
| + | |created|String|评论添加时间| | ||
| + | |updated|String|评论修改事件| | ||
| + | |ticket_id|String|工单id| | ||
| + | |visitor_user_id|String|访客ID| | ||
| + | |body|String|回复内容| | ||
| + | |format|String|文本格式| | ||
| + | |is_public|String|是否公开回复| | ||
| + | |attachments||附件| | ||
| + | |附件信息| | ||
| + | |id|String|类型| | ||
| + | |tenant_id|String|附件大小| | ||
| + | |url|String|附件地址| | ||
| + | |right_attachment|String|| | ||
| + | |public_response_type|String|回复渠道| | ||
| + | |||
| + | |||
| + | |||
| ===== 错误码说明 ===== | ===== 错误码说明 ===== | ||
| 行 1299: | 行 4688: | ||
| |API_111|page index must be more than 0.|分页索引必须大于0| | |API_111|page index must be more than 0.|分页索引必须大于0| | ||
| |API_112|page size must be less than 50.|分页每页的容量不能大于50| | |API_112|page size must be less than 50.|分页每页的容量不能大于50| | ||
| + | |API_113|state must be Online or Busy or Leave or Other or Offline or Hidden or Logout.|请求状态不正确| | ||
| |API_400|api request failed|服务间调用请求错误| | |API_400|api request failed|服务间调用请求错误| | ||
| + | |API_117|tenant without ticket function|租户没有开通工单功能| | ||
| + | |API_118|tenant without yuncentercall function|租户没有开通云呼功能| | ||
| + | |||
| + | ===== 不同格式消息结构 ===== | ||
| + | |||
| + | 新消息对应的报文格式 | ||
| + | |||
| + | 1.文本：txt | ||
| + | 报文： | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "91a007c0-1215-11ec-90a5-a10326678cd1", | ||
| + | "timestamp": 1631264438855, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "a06529e8-4b31-4042-a738-af2d1296b6cb", | ||
| + | "service_session_id": "54eeacc4-6946-4b80-bd8e-f0a4426211f8", | ||
| + | "msg_id_for_ack": "997f6f43-e11f-4898-a21f-4f643a6dfb18", | ||
| + | "create_at": 1631264438793, | ||
| + | "from": { | ||
| + | "id": "2735acf5-a003-42f9-8ada-fdcc6581ee09", | ||
| + | "name": "webim-visitor-8MQTGP9E4VEEGHEWBFXQ", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "f6a9ae57-6bd8-4ba5-9478-10027d6143a2", | ||
| + | "name": "宋晓伟", | ||
| + | "type": "Agent" | ||
| + | }, | ||
| + | "origin_type": "webim", | ||
| + | "channel": { | ||
| + | "id": 23457, | ||
| + | "name": "关联2", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "msg": "会尽快", | ||
| + | "type": "txt" | ||
| + | }, | ||
| + | "ext": { | ||
| + | | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 2.cmd命令消息 | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "51dfa130-121b-11ec-8511-fb6f37820f89", | ||
| + | "timestamp": 1631266908881, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "f7bc1803-1d3c-4346-b46d-a6a1f58e39af", | ||
| + | "service_session_id": "6baa6363-6770-4110-b319-4a2a6b14e02e", | ||
| + | "msg_id_for_ack": NULL, | ||
| + | "create_at": 1631266908814"from": { | ||
| + | "id": "_2", | ||
| + | "name": "关联设置调度员", | ||
| + | "type": "Scheduler" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "2735acf5-a003-42f9-8ada-fdcc6581ee09", | ||
| + | "name": "webim-visitor-8MQTGP9E4VEEGHEWBFXQ", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "origin_type": "webim", | ||
| + | "channel": { | ||
| + | "id": 23457, | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "action": "ServiceSessionOpenedEvent", | ||
| + | "type": "cmd" | ||
| + | }, | ||
| + | "ext": { | ||
| + | | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 3.图片类型消息：img | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "73c94200-1217-11ec-90ce-e186d8435957", | ||
| + | "timestamp": 1631265247817, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "aff765d2-f7b5-443a-939c-718446cf70a2", | ||
| + | "service_session_id": "3dea8e64-1f94-4ecd-aaab-daae8161b4a5", | ||
| + | "msg_id_for_ack": "fbc6ded2-62ba-4731-8d0b-65f8d3b074b0", | ||
| + | "create_at": 1631265247718, | ||
| + | "from": { | ||
| + | "id": "2735acf5-a003-42f9-8ada-fdcc6581ee09", | ||
| + | "name": "webim-visitor-8MQTGP9E4VEEGHEWBFXQ", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "", | ||
| + | "name": "", | ||
| + | "type": "Agent" | ||
| + | }, | ||
| + | "origin_type": "webim", | ||
| + | "channel": { | ||
| + | "id": 23457, | ||
| + | "name": "关联2", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "url": "/v1/Tenant/29676/MediaFiles/bf086bfe-2bb0-4b28-874e-dab6d09753c55YiG5biD5byP6ZSB6Zeu6aKYLnBuZw==", | ||
| + | "filename": "分布式锁问题.png", | ||
| + | "type": "img" | ||
| + | }, | ||
| + | "ext": {} | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 4.文件 file | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "15980750-1219-11ec-abcd-4112b9a39f21", | ||
| + | "timestamp": 1631265948754, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "c710292d-87c0-4d1a-ab11-4eb0af7c62f3", | ||
| + | "service_session_id": "7f76bdbd-cc65-4e04-a8b8-14c8b7139525", | ||
| + | "msg_id_for_ack": "", | ||
| + | "create_at": 1631265948677, | ||
| + | "from": { | ||
| + | "id": "c6e5df54-ce63-4c8c-8a1d-c1fac4feecc3", | ||
| + | "name": "webim-visitor-9BM6XB77QTE2R7Y7R6VH", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "8215d830-d998-4f54-9d66-eefabcaa36da", | ||
| + | "name": "客服机器人-小鹤", | ||
| + | "type": "Robot" | ||
| + | }, | ||
| + | "origin_type": "webim", | ||
| + | "channel": { | ||
| + | "id": 23700, | ||
| + | "name": "快速创建的关联", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "url": "/v1/Tenant/29762/MediaFiles/dd9372b3-958f-4295-9d90-b78bd6e25d6256uW5bGP6KeG6aKRLm1wNA==", | ||
| + | "secret": "FUNXqhIZEeyHRyM6cNo2pkf8p1g18YHIIVtPfkHst5LV8hUv", | ||
| + | "filename": "竖屏视频.mp4", | ||
| + | "type": "file", | ||
| + | "file_length": 0 | ||
| + | }, | ||
| + | "ext": {} | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 5.视频 video | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "05f38310-1219-11ec-9d15-f9ee668587e3", | ||
| + | "timestamp": 1631265922519, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "11050e01-0ff9-4953-a3c6-3d513ad1bda7", | ||
| + | "service_session_id": "7f76bdbd-cc65-4e04-a8b8-14c8b7139525", | ||
| + | "msg_id_for_ack": "", | ||
| + | "create_at": 1631265922427, | ||
| + | "from": { | ||
| + | "id": "c6e5df54-ce63-4c8c-8a1d-c1fac4feecc3", | ||
| + | "name": "webim-visitor-9BM6XB77QTE2R7Y7R6VH", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "8215d830-d998-4f54-9d66-eefabcaa36da", | ||
| + | "name": "客服机器人-小鹤", | ||
| + | "type": "Robot" | ||
| + | }, | ||
| + | "origin_type": "webim", | ||
| + | "channel": { | ||
| + | "id": 23700, | ||
| + | "name": "快速创建的关联", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "url": "/v1/Tenant/29762/MediaFiles/d97c5f88-8ac3-49d0-91ad-49cd7a66801daGFzYXNkLm1wNA==", | ||
| + | "secret": "BZt4ChIZEeyaUT88YVfVmi4oeK9hT0_UXefA6R87K8NgHxDG", | ||
| + | "filename": "hasasd.mp4", | ||
| + | "size": { | ||
| + | "width": 0, | ||
| + | "height": 0 | ||
| + | }, | ||
| + | "length": 0, | ||
| + | "type": "video", | ||
| + | "file_length": 0 | ||
| + | }, | ||
| + | "ext": {} | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 位置：loc | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "80bb8fd0-121d-11ec-87e8-d927c5568258", | ||
| + | "timestamp": 1631267846567, | ||
| + | "event ": "ServiceSessionMessageEvent ", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "42e2e99c-ab2d-430e-b91a-db5607328ed3", | ||
| + | "service_session_id": "776d6be3-cf1a-47d3-aad9-79f5d3288107", | ||
| + | "msg_id_for_ack": "a739f0f352c046748826f16c12ef20af", | ||
| + | "create_at": 1631267846444, | ||
| + | "from": { | ||
| + | "id": "f604a463-e27b-43d1-9273-16927ea1987d", | ||
| + | "name": "3bfbbc20cae9432c9753fc36a96b937334792", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "43d92e7f-f6a0-420e-8868-693ccc8afa6d", | ||
| + | "name": "fs", | ||
| + | "type": "Robot" | ||
| + | }, | ||
| + | "origin_type": "app", | ||
| + | "channel": { | ||
| + | "id": 97244, | ||
| + | "name": "快速创建的关联111", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "addr": "IDP教育(海淀分公司)", | ||
| + | "lat": "39.96616243929114", | ||
| + | "lng": "116.32302823756933", | ||
| + | "type": "loc" | ||
| + | }, | ||
| + | "ext": {} | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | 语音：audio | ||
| + | <code json> | ||
| + | { | ||
| + | "eventId": "78448230-121d-11ec-969a-83b2be719b1c", | ||
| + | "timestamp": 1631267832367, | ||
| + | "event": "ServiceSessionMessageEvent", | ||
| + | "payload": { | ||
| + | "message": { | ||
| + | "id": "b7a3ce9f-0672-4b84-948a-5224504e3e0c", | ||
| + | "service_session_id": "776d6be3-cf1a-47d3-aad9-79f5d3288107", | ||
| + | "msg_id_for_ack": "e0da0acff549417cb5b6d3e9801e577f", | ||
| + | "create_at": 1631267832242, | ||
| + | "from": { | ||
| + | "id": "f604a463-e27b-43d1-9273-16927ea1987d", | ||
| + | "name": "3bfbbc20cae9432c9753fc36a96b937334792", | ||
| + | "type": "Visitor" | ||
| + | }, | ||
| + | "to": { | ||
| + | "id": "43d92e7f-f6a0-420e-8868-693ccc8afa6d", | ||
| + | "name": "fs", | ||
| + | "type": "Robot" | ||
| + | }, | ||
| + | "origin_type": "app", | ||
| + | "channel": { | ||
| + | "id": 97244, | ||
| + | "name": "快速创建的关联111", | ||
| + | "type": "easemob" | ||
| + | }, | ||
| + | "body": { | ||
| + | "url": "/v1/Tenant/2112/MediaFiles/eb3c9468-e3b5-4421-b1de-39aa493f9104YXVkaW8=", | ||
| + | "secret": "eAMMahIdEeyeb8sE833GrNu3csSD9_RsgID97l0uvwrCCQtd", | ||
| + | "filename": "audio", | ||
| + | "length": 1, | ||
| + | "type": "audio" | ||
| + | }, | ||
| + | "ext": {} | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </code> | ||