差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
cs:400systemintegration:api-open-platform [2019/09/10 09:38] wumaochang [获取历史会话列表] 修改per_page默认值 |
cs:400systemintegration:api-open-platform [2019/11/15 10:22] candywang [获取历史通话列表] |
||
---|---|---|---|
行 1278: | 行 1278: | ||
|totalPages|Integer|总页数| | |totalPages|Integer|总页数| | ||
|totalElements|Integer|总个数| | |totalElements|Integer|总个数| | ||
+ | |||
+ | ===== 查询历史通话 ===== | ||
+ | |||
+ | ==== 获取历史通话列表 ==== | ||
+ | |||
+ | 根据呼叫类型、通话时间、技能组、坐席、挂断原因、满意度评价等条件查询历史通话列表。 | ||
+ | |||
+ | * Path: http://kefu.easemob.com/api/platform/tenants/{tenantId}/calldetails | ||
+ | * HTTP Method: GET | ||
+ | * Request Headers: Kefu-Token=${accessToken} | ||
+ | * 可能的错误码:详见:[[#错误码说明|错误码说明]] | ||
+ | |||
+ | **Curl示例:** | ||
+ | |||
+ | <code php> | ||
+ | curl --request GET \ | ||
+ | --url 'http://kefu.easemob.com/api/platform/tenants/28994/calldetails?page=0&size=14&startTime=2019-11-10%2023:00:00&stopTime=2019-11-16%2023:00:00&contactType=Inbound&orderType=DESC&order=&contactDisposition=ALL&phoneNumber=&useStop=false&satisfaction=' \ | ||
+ | --header 'Kefu-Token:a7f3d2bcb62721a3c67b8f567acfd553' \ | ||
+ | </code> | ||
+ | |||
+ | 参数说明: | ||
+ | ^名称^类型^是否非空(Y:是;N:否)^说明^ | ||
+ | |Kefu-Token| String |Y|调用接口的accessToken| | ||
+ | |tenantId|int|Y|租户ID| | ||
+ | |page|int|N|查询页码索引,默认为1| | ||
+ | |size|int|N|每页显示的数据容量,默认为10,最大为50| | ||
+ | |startTime| String |N|通话时间(开始范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | ||
+ | |stopTime| String |N|通话时间(结束范围条件),时间格式 2018-06-16T23%3A59%3A59.000Z| | ||
+ | |contactType| String |N|通话类型,取值:Inbound(呼入),Outbound(呼出),Back2Back(双呼),Internal(内部通话),多个条件以英文逗号隔开| | ||
+ | |orderType| String |N|排序方式,取值:ASC/DESC,默认DESC| | ||
+ | |contactDisposition| String |N|挂断原因,取值:ALL(全部),Success(正常),NoAnswer(未接通),AbandonedInContactFlow(IVR中放弃),AbandonedInQueue(排队放弃),AbandonedRing(振铃放弃),QueueOverflow(排队超时),OneStepTransfer(转外线)| | ||
+ | |phoneNumber| String |N|手机号码,同时检索主叫和被叫号码| | ||
+ | |satisfaction| String |N|满意度评价,取值:0(未发送),998(未评价),满意,一般,不满意| | ||
+ | |||
+ | **Response示例:** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "status": "OK", | ||
+ | "entities": [ | ||
+ | { | ||
+ | "id": "10301193-7c1a-4b9a-9285-164040c189b8", | ||
+ | "ccId": "d00842df-e406-4f32-9929-80b02f26e07c", | ||
+ | "contactId": "2561536188", | ||
+ | "staffId": "83162635-be49-486e-9334-d358276feda0", | ||
+ | "groupId": "e155be22-05ca-4535-89aa-ad3c8d358d45", | ||
+ | "labelId": null, | ||
+ | "visitorId": "fd07207a-d2d5-4dab-8637-800a27c526f9", | ||
+ | "contactType": "Inbound", | ||
+ | "contactDisposition": "Success", | ||
+ | "callingNumber": "18612390240", | ||
+ | "calledNumber": "02160556504", | ||
+ | "recordFileName": "157372327914600080309018.wav", | ||
+ | "province": "北京", | ||
+ | "city": "北京", | ||
+ | "duration": 22, | ||
+ | "satisfaction": 0, | ||
+ | "satisfactionDesc": "未发送", | ||
+ | "startTime": 1573723266000, | ||
+ | "stopTime": 1573723288000, | ||
+ | "syncStartTime": 1573723266000, | ||
+ | "syncStopTime": 1573723288000, | ||
+ | "syncFlag": true, | ||
+ | "recordSyncFlag": 1, | ||
+ | "agentNames": "aliyun_cc_02", | ||
+ | "skillGroupNames": "沙箱技能组", | ||
+ | "visitor": { | ||
+ | "tenantId": 28994, | ||
+ | "userId": "fd07207a-d2d5-4dab-8637-800a27c526f9", | ||
+ | "createDateTime": 1543994461000, | ||
+ | "lastUpdateDateTime": 1563959840000, | ||
+ | "nickname": "18612390240", | ||
+ | "trueName": "大帅哥", | ||
+ | "sex": 0, | ||
+ | "qq": "260553619", | ||
+ | "weixin": "嘻嘻,喜闻乐见", | ||
+ | "email": "leoli@easemob.com", | ||
+ | "phone": "18612390240", | ||
+ | "companyName": "环信", | ||
+ | "description": "环信环信环信环信环信环信" | ||
+ | }, | ||
+ | "evaluateContent": null, | ||
+ | "recordingDataList": [ | ||
+ | { | ||
+ | "fileName": "157372327914600080309018.wav", | ||
+ | "fileUrl": null, | ||
+ | "startTime": 1573723279000 | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | ], | ||
+ | "first": true, | ||
+ | "last": true, | ||
+ | "number": 0, | ||
+ | "numberOfElements": 4, | ||
+ | "totalPages": 1, | ||
+ | "totalElements": 4 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | 参数说明: | ||
+ | ^名称^类型^说明^ | ||
+ | |status| String |接口响应状态| | ||
+ | |id| String |接口响应状态| | ||
+ | |ccid| String |接口响应状态| | ||
+ | |contactId| String |接口响应状态| | ||
+ | |staffId| String |客服ID| | ||
+ | |groupId| int |技能组ID| | ||
+ | |labelId| int |通话标签ID| | ||
+ | |visitorId| String |访客环信ID| | ||
+ | |contactType| String |通话类型,包括呼入和呼出| | ||
+ | |contactDisposition| String |挂断原因| | ||
+ | |callingNumber| String |主叫号码| | ||
+ | |calledNumber| String |被叫号码| | ||
+ | |recordFileName| String |通话录音文件名称| | ||
+ | |province| String |访客号码归属地-省| | ||
+ | |city| String |访客号码归属地-市| | ||
+ | |duration| String |客服响应时长| | ||
+ | |satisfaction| String |满意度值| | ||
+ | |satisfactionDesc| String |满意度评价信息| | ||
+ | |startTime| String |通话开始时间| | ||
+ | |stopTime| String |通话结束时间| | ||
+ | |agentNames| String |客服昵称,若存在转接,则为多个| | ||
+ | |skillGroupNames| String |技能组名称| | ||
+ | |tenantId| int |租户ID| | ||
+ | |userId| String |访客ID| | ||
+ | |createDateTime| String |访客创建时间| | ||
+ | |lastUpdateDateTime| String |更新时间| | ||
+ | |nickname| String |昵称| | ||
+ | |trueName| String |姓名| | ||
+ | |sex| String |性别| | ||
+ | |qq| String |QQ| | ||
+ | |weixin| String |微信| | ||
+ | |email| String |邮箱| | ||
+ | |phone| String |电话| | ||
+ | |companyName| String |公司名称| | ||
+ | |description| String |备注| | ||
+ | |evaluateContent| String |服务小结| | ||
+ | |fileName| String |录音文件名| | ||
+ | |fileUrl| String |录音文件路径| | ||
+ | |startTime| String |录音开始时间| | ||
+ | |first| boolean || | ||
+ | |last| boolean || | ||
+ | |number| String || | ||
+ | |numberOfElements| String || | ||
+ | |totalPages| String |总页数| | ||
+ | |totalElements| String |总数据量| | ||
+ | |||
===== 错误码说明 ===== | ===== 错误码说明 ===== |