====在线聊天会话记录====
此接口用来获取从微信、网页、机器人、帮我吧客户端来的历史会话记录。
====会话JSON格式====
^名称 ^类型 ^注释 ^
|r_id |int |会话id |
|type |tinyint |会话来源:1-客户端,2-网页,3-微信,4-机器人,5-客服|
|support_id |int |处理客服id|
|client_id |varchar | 用户id |
|create_time |datetime | 创建时间,格式为:2017-8-20 10:23:34 |
|client_ip |varchar| 用户IP|
|ip_info |datetime | 用户IP详情 |
|contents |object | 聊天内容 |
====消息JSON格式====
^名称 ^类型 ^注释 ^
|spokesman |int |当前发言人id |
|spokesman_identity |tinyint |发言人的身份:1-客服,2-用户,3-机器人|
|msg |text |聊天内容|
|msg_type |tinyint |聊天内容类型:1-普通文本,2-图片|
|create_time |datetime |消息发送时间|
====JSON示例====
{
"r_id": 122,
"type": 2,
"support_id": 2321,
"client_id": u2314,
"create_time": "2017-8-23 12:23:12",
"client_ip": ”114.248.128.190“,
"ip_info": "归属地为北京市",
"contents": {
"spokesman": 213,
"spokesman_identity": 1,
"msg": "这里是具体的聊天内容",
"msg_type": 1,
"create_time": 2017-8-23 13:12:23
}
}
====会话列表====
GET /api/imchat/history.json
//说明:返回所有的会话记录,默认按编号升序排列。//
调用者权限
所有客服
调用参数
^名称 ^必需的 ^类型 ^注释
|client_id |否 |int |按用户id筛选|
|starttime |否 |datetime |按创建时间筛选,开始时间,格式为:2017-8-27|
|endtime |否 |datetime |按创建时间筛选,结束时间,格式为:2017-8-29|
|page |否 |int |分页获取,默认为1|
|page |否 |int |每页大小,默认为100|
调用示例
curl https://www.bangwo8.com/api/imchat/history.json -v -u {account}:{password}
返回值示例
{
"chats": [
{
"r_id": 111,
"type": "1",
...
},
{
"r_id": 112,
"type": "2",
...
}
]
}
====查看会话====
GET /api/imchat/history/{id}.json
调用者权限
所有客服
调用参数
^名称 ^必需的 ^类型 ^注释
|client_id |否 |int |按用户id筛选|
|starttime |否 |datetime |按创建时间筛选,开始时间,格式为:2017-8-27|
|endtime |否 |datetime |按创建时间筛选,结束时间,格式为:2017-8-29|
|page |否 |int |分页获取,默认为1|
|page |否 |int |每页大小,默认为100|
调用示例
curl https://www.bangwo8.com/api/imchat/history/{id}.json -v -u {account}:{password}
返回值示例
Status: 200 OK
{
"chat": {
"r_id": 1,
"type": 2,
...
}
}