对话列表
GET /apiv2/kchat/history.json
返回所有对话记录,默认按对话结束时间降序排序。
调用权限
agent
Query参数
Name | Required | Type | Comment |
---|---|---|---|
visitor_id | 否 | integer | 筛选指定访客的对话列表 |
start | 否 | string | 按创建时间筛选,开始时间,如:2016-01-01 |
end | 否 | string | 按创建时间筛选,结束时间,如:2016-01-01 |
user_id | 否 | integer | 工单系统用户ID(IM访客已关联工单系统用户) |
page | 否 | integer | 页码,默认为 1 |
per_page | 否 | integer | 分页尺寸,默认为 100 |
curl示例
curl https://{subdomain}.kf5.com/apiv2/kchat/history.json -v -u {email_address}:{password}
curl https://{subdomain}.kf5.com/apiv2/kchat/history.json?visitor_id={visitor_id}&per_page={per_page}&page={page} \ -v -u {email_address}:{password}
返回示例
Status: 200 OK{ "chats": [ { "id": 1, "type": "chat", ... }, { "id": 2, "type": "chat", ... } ]}