差别

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

--- 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|总页数|
 |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 |总数据量|
 ===== 错误码说明 =====