公众号会话控制和获取聊天记录

洛塔服务号回复013获取代码。

功能说明

会话控制：此接口在客服和用户之间创建一个会话，如果该客服和用户会话已存在，则直接返回0。指定的客服帐号必须已经绑定微信号且在线。

获取聊天记录：此接口返回的聊天记录中，对于图片、语音、视频，分别展示成文本格式的[image]、[voice]、[video]。对于较可能包含重要信息的图片消息，后续将提供图片拉取URL，近期将上线。

准备工作

公众号后台设置ip白名单

创建会话

创建会话中，客服账号格式为客服账号@公众号的微信号。比如我的客服账号是lootaa，公众号微信号是lootaayun，则请求参数为lootaa@lootaayun。
需要先从网页登录客服，然后创建会话，就能看到对应的会话消息了。为了方便后面测试关闭会话，我创建了两个会话。

		// 先获取access_token，这部分正式环境需要配置定时获取，每天2000次调用限制
		String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECRET;
		String result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		String accessToken = JSON.parseObject(result).getString("access_token");
		
		// 创建会话
		url = "https://api.weixin.qq.com/customservice/kfsession/create?access_token=" + accessToken;
		JSONObject param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6iaFJq6SISTVwHS5lkb9Pb8");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 再创建一个会话，用来测试关闭会话
		param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6tQGQMqM-WuHMaCiR5AkY2Q");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

关闭会话

将上面创建的两个会话关闭掉一个

		// 关闭会话
		url = "https://api.weixin.qq.com/customservice/kfsession/close?access_token=" + accessToken;
		param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6tQGQMqM-WuHMaCiR5AkY2Q");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

获取客户会话状态

如果客服不繁忙，这个返回的一般都是状态0

		// 获取客户会话状态
		url = "https://api.weixin.qq.com/customservice/kfsession/getsession?openid=ohUHp6iaFJq6SISTVwHS5lkb9Pb8&access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);

获取客服会话列表

如果关闭掉会话，这个接口就获取不到了。

		// 获取客服会话列表
		url = "https://api.weixin.qq.com/customservice/kfsession/getsessionlist?kf_account=lootaa@lootaayun&access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);

获取未接入的会话

不容易测试出来数据，除非客服繁忙

		// 获取未接入会话列表
		url = "https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);

获取聊天记录

每次查询时段不能超过24小时。
每次获取条数，最多10000条。

		// 获取聊天记录
		url = "https://api.weixin.qq.com/customservice/msgrecord/getmsglist?access_token=" + accessToken;
		param = new JSONObject();
		param.put("starttime", System.currentTimeMillis()/1000-24*3600*3);
		param.put("endtime", System.currentTimeMillis()/1000-24*3600*2);
		param.put("msgid", 1);
		param.put("number", 10000);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);

全部代码

package com.lootaa.wechat;

import org.jsoup.Connection.Method;
import org.jsoup.Jsoup;
import org.springframework.web.bind.annotation.RestController;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;

/**
 * 客服消息-会话控制和获取聊天记录
 * 前置条件：公众号后台设置ip白名单
 */
@RestController
public class Test013 {

	public static final String APPID = "wx276049d6a7551dca";
	public static final String SECRET = "cbe109fdf6f399bd72ed3a4afafa21b1";
	
	/**
	 * 完整项目源码可关注公众号"lootaayun"（洛塔），回复013获取
	 */
	public static void main(String[] args) throws Exception {
		// 先获取access_token，这部分正式环境需要配置定时获取，每天2000次调用限制
		String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + APPID + "&secret=" + SECRET;
		String result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		String accessToken = JSON.parseObject(result).getString("access_token");
		
		// 创建会话
		url = "https://api.weixin.qq.com/customservice/kfsession/create?access_token=" + accessToken;
		JSONObject param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6iaFJq6SISTVwHS5lkb9Pb8");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		// 再创建一个会话，用来测试关闭会话
		param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6tQGQMqM-WuHMaCiR5AkY2Q");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		
		// 关闭会话
		url = "https://api.weixin.qq.com/customservice/kfsession/close?access_token=" + accessToken;
		param = new JSONObject();
		param.put("kf_account", "lootaa@lootaayun");
		param.put("openid", "ohUHp6tQGQMqM-WuHMaCiR5AkY2Q");
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
		
		// 获取客户会话状态
		url = "https://api.weixin.qq.com/customservice/kfsession/getsession?openid=ohUHp6iaFJq6SISTVwHS5lkb9Pb8&access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		
		// 获取客服会话列表
		url = "https://api.weixin.qq.com/customservice/kfsession/getsessionlist?kf_account=lootaa@lootaayun&access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		
		// 获取未接入会话列表
		url = "https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=" + accessToken;
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.GET).execute().body();
		System.out.println(result);
		
		// 获取聊天记录
		url = "https://api.weixin.qq.com/customservice/msgrecord/getmsglist?access_token=" + accessToken;
		param = new JSONObject();
		param.put("starttime", System.currentTimeMillis()/1000-24*3600*3);
		param.put("endtime", System.currentTimeMillis()/1000-24*3600*2);
		param.put("msgid", 1);
		param.put("number", 10000);
		result = Jsoup.connect(url).ignoreContentType(true).method(Method.POST).requestBody(param.toString()).execute().body();
		System.out.println(result);
	}
	
}