差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
cs:400systemintegration:api-open-platform [2019/09/10 09:38]
吴茂昌 [获取历史会话列表] 修改per_page默认值
cs:400systemintegration:api-open-platform [2019/11/15 10:50] (当前版本)
王芳 [获取历史通话列表]
行 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 |通话记录ID|
 +|ccid| String |呼叫中心实例ID|
 +|contactId| String |通话ID|
 +|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|
 +| |
 +|visitor访客信息|
 +|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| int |当前页码|
 +|numberOfElements| int |当前页数据量|
 +|totalPages| int |总页数|
 +|totalElements| int |总数据量|
 +
  
 ===== 错误码说明 ===== ===== 错误码说明 =====