com.riversoft.weixin.mp.care.Sessions Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weixin-mp Show documentation
There is a newer version: 0.9.8
package com.riversoft.weixin.mp.care;

import com.fasterxml.jackson.annotation.JsonProperty;
import com.riversoft.weixin.common.WxClient;
import com.riversoft.weixin.common.util.JsonMapper;
import com.riversoft.weixin.mp.MpWxClientFactory;
import com.riversoft.weixin.mp.base.AppSetting;
import com.riversoft.weixin.mp.base.WxEndpoint;
import com.riversoft.weixin.mp.care.bean.Session;
import com.riversoft.weixin.mp.care.bean.SessionLog;
import com.riversoft.weixin.mp.care.bean.WaitingSessions;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * 客服会话管理
 * Created by exizhai on 11/22/2015.
 */
public class Sessions {

    private static Logger logger = LoggerFactory.getLogger(Accounts.class);

    private WxClient wxClient;

    public static Sessions defaultSessions() {
        return with(AppSetting.defaultSettings());
    }

    public static Sessions with(AppSetting appSetting) {
        Sessions sessions = new Sessions();
        sessions.setWxClient(MpWxClientFactory.getInstance().with(appSetting));
        return sessions;
    }

    public void setWxClient(WxClient wxClient) {
        this.wxClient = wxClient;
    }

    /**
     * 创建回话
     *
     * @param care   客服账号
     * @param openId openid
     * @param text   消息
     */
    public void create(String care, String openId, String text) {
        String url = WxEndpoint.get("url.care.session.create");
        Map request = new HashMap<>();
        request.put("kf_account", care);
        request.put("openid", openId);
        if(!(text == null || "".equals(text))) {
            request.put("text", text);
        }

        String json = JsonMapper.nonEmptyMapper().toJson(request);
        logger.debug("create session: {}", json);
        wxClient.post(url, json);
    }

    /**
     * 关闭回话
     *
     * @param care   客服账号
     * @param openId openid
     * @param text   消息
     */
    public void close(String care, String openId, String text) {
        String url = WxEndpoint.get("url.care.session.close");
        Map request = new HashMap<>();
        request.put("kf_account", care);
        request.put("openid", openId);
        if(!(text == null || "".equals(text))) {
            request.put("text", text);
        }

        String json = JsonMapper.nonEmptyMapper().toJson(request);
        logger.debug("close session: {}", json);
        wxClient.post(url, json);
    }

    /**
     * 获取客户回话状态
     *
     * @param openId
     * @return
     */
    public Session get(String openId) {
        String url = WxEndpoint.get("url.care.session.get");

        String response = wxClient.get(String.format(url, openId));
        logger.debug("get session {} for user: {}", response, openId);
        return JsonMapper.defaultMapper().fromJson(response, Session.class);
    }

    /**
     * 获取某客服人员会话列表
     *
     * @param account 客服账号
     * @return
     */
    public List getSessionsByAccount(String account) {
        String url = WxEndpoint.get("url.care.session.list.byaccount");
        String response = wxClient.get(String.format(url, account));
        logger.debug("list care sessions by care account :{}", response);
        SessionList sessionList = JsonMapper.defaultMapper().fromJson(response, SessionList.class);
        return sessionList.getSessions();
    }

    /**
     * 获取未接入会话列表
     *
     * @return
     */
    public WaitingSessions getWaitingSessions() {
        String url = WxEndpoint.get("url.care.session.listwait");
        String response = wxClient.get(url);
        logger.debug("list care waiting sessions :{}", response);
        WaitingSessions sessionList = JsonMapper.defaultMapper().fromJson(response, WaitingSessions.class);
        return sessionList;
    }

    /**
     * 获取客服聊天记录
     *
     * @param start 开始时间
     * @param end   结束时间
     * @param index 查询第几页
     * @param size  每页大小
     * @return 聊天记录
     */
    public List listSessionLogs(Date start, Date end, int index, int size) {
        String url = WxEndpoint.get("url.care.session.logs");
        Map request = new HashMap<>();
        request.put("starttime", start.getTime() / 1000);
        request.put("endtime", end.getTime() / 1000);
        request.put("pageindex", index);
        request.put("pagesize", size);

        String json = JsonMapper.nonEmptyMapper().toJson(request);
        logger.debug("get session logs: {}", json);
        String response = wxClient.post(url, json);
        SessionLogList sessionLogList = JsonMapper.defaultMapper().fromJson(response, SessionLogList.class);
        return sessionLogList.getLogs();
    }

    public static class SessionList {

        @JsonProperty("sessionlist")
        private List sessions;

        public List getSessions() {
            return sessions;
        }

        public void setSessions(List sessions) {
            this.sessions = sessions;
        }
    }

    public static class SessionLogList {

        @JsonProperty("sessionlist")
        private List logs;

        public List getLogs() {
            return logs;
        }

        public void setLogs(List logs) {
            this.logs = logs;
        }
    }
}