====在线聊天会话记录====
此接口用来获取从微信、网页、机器人、帮我吧客户端来的历史会话记录。

====会话JSON格式====
^名称  	^类型	^注释	^
|r_id		|int		|会话id |
|type		|tinyint		|会话来源：1-客户端，2-网页，3-微信，4-机器人，5-客服|
|support_id	|int		|处理客服id|
|support_name	|varchar		|处理客服名字|
|client_id		|varchar	| 用户id	|
|client_name		|varchar	| 用户名字	|
|create_time	|datetime	| 创建时间，格式为：2017-8-20 10:23:34	|
|client_ip	|varchar| 用户IP|
|ip_info	|datetime	| 用户IP详情	|
|evaluate  	|tinyint	| 评价：1-满意，2-一般，3-不满意	|
|contents	|array	| 聊天内容	|


====消息JSON格式====
^名称  	^类型	^注释	^
|spokesman		|varchar		|发言人的名字|
|spokesman_identity		|tinyint		|发言人的身份：1-客服，2-用户，3-机器人|
|msg		|text		|聊天内容|
|msg_type		|tinyint		|聊天内容类型：1-普通文本，2-图片|
|create_time		|datetime		|消息发送时间|




====JSON示例====
<code>
{
   "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":  "归属地为北京市",
   "evaluate": 1,
   "contents": [
      {
 	 "spokesman": 213,
  	 "spokesman_identity": 1,
         "msg": "这里是具体的聊天内容",
  	 "msg_type": 1,
  	 "create_time": 2017-8-23 13:12:23
      },
      {
 	 "spokesman": 234,
  	 "spokesman_identity": 1,
         "msg": "这里是具体的聊天内容",
  	 "msg_type": 1,
  	 "create_time": 2017-8-23 13:12:23
      }
   ]

}
</code>


====会话列表====
<code>
GET /api/v1/imchat/histories.json
</code>
//说明：返回所有的会话记录，默认按编号升序排列。//

调用者权限
  所有客服
  
调用参数
^名称	^必需的  ^类型 	^注释^
|client_id	|否	|int	|按用户id筛选|
|starttime	|否	|datetime	|按创建时间筛选，开始时间，格式为：2017-8-27|
|endtime	|否	|datetime	|按创建时间筛选，结束时间，格式为：2017-8-29|
|page |否	|int	|分页获取，默认为1|
|per_page |否	|int	|每页大小，默认为100|
  
调用示例
<code>
curl https://www.bangwo8.com/api/v1/imchat/histories.json -v -u {account}:{password}
</code>  

返回值示例
<code>
{
	"chatrecords": [
		{
			"r_id": 111,
			"type": "1",
			...
		},
		{
			"r_id": 112,
			"type": "2",
			...
		}
                ...
	],
        "count": 42,
        "next_page": "https://www.bangwo8.com/api/v1/visitrecord/histories.json?per_page=40&page=2",
        "previous_page": null
}
</code>

====查看会话====
<code>
GET /api/v1/imchat/histories/{id}.json
</code>

调用者权限
  所有客服
  
调用参数
^名称	^必需的  ^类型 	^注释^
|client_id	|否	|int	|按用户id筛选|
|starttime	|否	|datetime	|按创建时间筛选，开始时间，格式为：2017-8-27|
|endtime	|否	|datetime	|按创建时间筛选，结束时间，格式为：2017-8-29|
|page |否	|int	|分页获取，默认为1|
|page |否	|int	|每页大小，默认为100|

调用示例
<code>
curl https://www.bangwo8.com/api/v1/imchat/histories/{id}.json -v -u {account}:{password}
</code>

返回值示例
<code>
Status: 200 OK

{
	"chat": {
		"r_id": 1,
		"type": 2,
		...
	}
}
</code>