微信公众号客服 简单实现

最新推荐文章于 2024-07-30 21:49:27 发布
最新推荐文章于 2024-07-30 21:49:27 发布
阅读量6.4k 收藏 19
点赞数 4
分类专栏： 编程 文章标签： 微信客服 微信公众号客服
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/somdip/article/details/87991228
版权

实现语言  java

实现的前提：已经实现了公众号的其他一些基本功能，比如访问菜单。

1、微信公众号中添加客服功能 

2、添加客服 

 3、接口编写。

3-1、 我找了好久才找到。微信公众号接口文档中--自定义菜单中，创建一个类型为click的菜单（如下图1，2）

图1

这里会去访问 创建客服会话的- 新版客服功能 - 创建会话接口，微信文档中都有（https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN）

然后点击立即咨询 客服连接成功 回复消息。

图2

{    
          "type":"click",
          "name":"立即咨询",
          "key":"kf"
      },

kf是自定义的。 

 

*  1、click：点击推事件用户点击click类型按钮后，微信会会向你的接口工程发送消息（你自己接口工程的地址是公众号配置中的验证地址 如图3）消息类型为event的结构给开发者（参考消息接口指南），并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值与用户进行交互；

这个button 会跟关注和取消关注一样去发送给后端服务器请求，就是配置的地址。 （公众号中配置的地址位置如下）

图3

 

3-2 、java代码  ，

controller

/**
 * 处理消息请求(包括关注和取消关注) 包好所有微信发给服务器的通知
 *
 * @param msg
 * @return
 */
@RequestMapping(value = "validate", method = RequestMethod.POST, produces = {MediaType.TEXT_XML_VALUE})
@ResponseBody
public Object handleMesg(@RequestBody RecieveMsg msg) throws Exception {
    Object out = weiXinService.handleMessage(msg);
    System.out.println(String.valueOf(msg));
    return out;
}

 

 

 

service 

/**
 * 取消和关注操作 推送  也有客服按钮请求的操作（kf为自定义）
 *  
 * @param msg
 * @return
 */
public Object handleMessage(RecieveMsg msg) {

    if(Objects.equals(msg.getEvent(),"CLICK") &&Objects.equals(msg.getEventKey(),"kf")){
        String kf = kfseesion(msg.getFromUserName());
        PushMsg out = new PushMsg();
        out.setFromUserName(msg.getToUserName());
        out.setToUserName(msg.getFromUserName());
        out.setMsgType("text");
        out.setCreateTime(System.currentTimeMillis());
        out.setContent(kf);
        return out;
    }


    String url = "/handleValidate";
    JSONObject obj = HttpClientUtils.httpRequest(weiXinBean.getHttpUrl() + url, "POST", JSONUtils.beanToJson(msg));
    PushMsg out = new PushMsg();
    out.setContent(String.valueOf(obj.get("content")).replace("APPID",weiXinBean.getAppId()).replace("REDIRECT_URL",weiXinBean.getYuMing()));
    out.setFromUserName(String.valueOf(obj.get("fromUserName")));
    out.setMsgType(String.valueOf(obj.get("msgType")));
    out.setToUserName(String.valueOf(obj.get("toUserName")));
    out.setCreateTime(obj.getLong("createTime"));
    return out;
}

 

 

/**
 * 功能描述:创建会话
 * @param:
 * @return:
 * @author: syl
 * @date: 2019/2/23 0023 下午 4:02
 */
public String kfseesion(String openId) {
    String accessToken = Tools.getAccessToken(getAccessTokenUrl());
    String urlToken = WxContstants.kfSessionUrl.replace("ACCESS_TOKEN",accessToken);

    JSONObject kfInfo = getonlinekflist();
    if(!StringUtils.isEmpty(kfInfo.get("kf_online_list"))){
        JSONArray kfOnlineList = kfInfo.getJSONArray("kf_online_list");
        if(kfOnlineList.size()==0){
            return "服务人员未在线";
        }
        Random random = new Random();
        int i = random.nextInt(kfOnlineList.size());
        JSONObject pj = new JSONObject();
        JSONObject item = (JSONObject) kfOnlineList.get(i);
        pj.put("kf_account",String.valueOf(item.get("kf_account")));
        //pj.put("kf_account","kf2002@gh_02e32b1d4ea2");
        pj.put("openid",openId);
        JSONObject jsonObject = HttpClientUtils.httpRequest(urlToken,"POST", String.valueOf(pj));
        Integer errcode =  jsonObject.getInteger("errcode");
        String errmsg =  jsonObject.getString("errmsg");
        if (Objects.equals(0, errcode)) {
            return "客服连接成功，请问有什么可以帮助您";
        } else if(Objects.equals(65415, errcode)) {
            return "服务人员未在线";
        }else{
            return errmsg;
        }
    }else{
        return "服务人员未在线";
    }

}

/**
 * 功能描述:获取在线客服列表 
 * @param: 
 * @return: 
 * @author: syl
 * @date: 2019/8/13 0013 上午 10:31
 */
public JSONObject getonlinekflist() {
    String accessToken = Tools.getAccessToken(getAccessTokenUrl());
    String urlToken = WxContstants.getonlinekflist.replace("ACCESS_TOKEN",accessToken);
    JSONObject jsonObject = HttpClientUtils.httpRequest(urlToken, "GET", "");
    return jsonObject;
}

 

 

 

工具类

RecieveMsg.java 

package com.navitek.maternal.apiweb.bean;

import lombok.Getter;
import lombok.Setter;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlRootElement;

/**
 * @author 26968
 */
@Setter
@Getter
@XmlRootElement(name="xml")
@XmlAccessorType(XmlAccessType.FIELD)
public class RecieveMsg {


    /**
     * 开发者微信号
     */
    protected String FromUserName;
    /**
     * 发送方帐号（一个OpenID）
     */
    protected String ToUserName;
    /**
     *  消息创建时间
      */

    protected Long CreateTime;
    /**
     * 消息类型
     * text 文本消息
     * image 图片消息
     * voice 语音消息
     * video 视频消息
     * music 音乐消息
     */
    protected String MsgType;
    /**
     * 消息id
     */
    protected Long MsgId;
    /**
     * 文本内容
     */
    private String Content;
    /**
     * 图片链接地址 有系统生成
     */
    private String PicUrl;
    /**
     * 多媒体
     */
    private String MediaId;

    /**
     * 事件
     */
    private  String Event;


    /**
     * 菜单的KEY值
     */
    private String EventKey;

    /**
     *
     */
    private String Ticket;


}

WxContstants.java




import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;

/**
 * @author 26968
 */
public class WxContstants {


    //保存用户验证码
    public static ConcurrentMap<String, Map<String, Object>> VERIFY_CODE = new ConcurrentHashMap<String, Map<String, Object>>();

    //验证码超时时间
    public static long maxTime = 300;


    /**
     * 菜单类型
     */
    public static String VIEW = "view";




    /**
     * 网页授权后根据code 获取用access_token
     */
    public static final String WEB_ACCESS_TOKEN = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code";

    /**
     * 获取用户基本信息接口
     */
    public static final String GET_USER_INFO = "https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN";


    /**
     * 暂时存储accesstoken
     */
    public static final Map<String, Long> currentHashMap = new HashMap<>();

    /**
     * 放token值
     */
    public static final Map<String, Object> TOKEN_MAP = new HashMap<>();


    public static final String ACCESS_TOKEN = "access_token";

    /**
     * 消息类型 （文本类型）
     */
    public static final String TEXT = "text";

    /**
     * image类型
     */
    public static final String IMAGE = "image";
    /**
     * event 事件类型
     */
    public static final String Event = "event";

    /**
     * subscribe 关注事件
     */
    public static final String SUBSCRIBE = "subscribe";

    /**
     * unsubscribe 取消关注事件
     */
    public static final String UNSUBSCRIBE = "unsubscribe";

    /**
     * 菜单点击事件
     */
    public static final String CLICK = "CLICK";

    /**
     * news 图文消息
     */
    public static final String NEWS = "news";

    /**
     * 获取access_token的Url
     */
    public static final String ACCESSTOKENURL = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=SECRET";


    /**
     * 创建自定义菜单接口
     */
    public static final String ButtonUrl = " https://api.weixin.qq.com/cgi-bin/menu/create?access_token=";

    /**
     * 删除菜单
     */
    public static final String DELETEBUTTON = "https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=";

    /**
     * 网页授权url
     */
    public static final String AUTHORIZE = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT&response_type=code&scope=snsapi_userinfo&state=22#wechat_redirect";

    /**
     * 客服相关 新增  获取 删除 绑定
     */


    public static final String addKfUrl = " https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN";
    public static final String getKfListUrl = " https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN";
    public static final String getonlinekflist = " https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN";
    public static final String delKfUrl = "https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT";
    public static final String bbKfUrl = " https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN";
    public static final String kfSessionUrl = " https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN";
    public static final String actSessionUrl = " https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN";
    public static final String templateSend = " https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN";


}

tools.java



import com.alibaba.fastjson.JSONObject;
import com.navitek.maternalweb.common.WxContstants;
import lombok.extern.slf4j.Slf4j;
import org.springframework.util.StringUtils;

import javax.servlet.http.HttpServletRequest;
import java.time.Instant;
import java.util.Iterator;
import java.util.Map;
import java.util.Random;
import java.util.UUID;

/**
 * @author 26968
 */
@Slf4j
public class Tools {


    /**
     * 将 map转化为xml格式
     *
     * @param params
     * @return
     */
    public static String toXml(Map<String, String> params) {
        StringBuilder xml = new StringBuilder();
        xml.append("<xml>");
        Iterator iterator = params.entrySet().iterator();
        while (iterator.hasNext()) {
            Map.Entry<String, String> entry = (Map.Entry) iterator.next();
            String key = (String) entry.getKey();
            String value = (String) entry.getValue();
            if (!StringUtils.isEmpty(value)) {
                xml.append("<").append(key).append(">");
                xml.append((String) entry.getValue());
                xml.append("</").append(key).append(">");
            }
        }

        xml.append("</xml>");
        return xml.toString();
    }

    /**
     * 将xml格式的字符串转化为 map
     *
     * @param xmlStr
     * @return
     */
    public static Map<String, String> xmlToMap(String xmlStr) {
        XmlHelper xmlHelper = XmlHelper.of(xmlStr);
        return xmlHelper.toMap();
    }


    public static String getRealIp(HttpServletRequest request) {
        String ip = request.getHeader("x-forwarded-for");
        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
            ip = request.getHeader("Proxy-Client-IP");
        }

        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
            ip = request.getHeader("WL-Proxy-Client-IP");
        }

        if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) {
            ip = request.getRemoteAddr();
        }

        return ip;
    }

    public static String getRealIpV2(HttpServletRequest request) {
        String accessIP = request.getHeader("x-forwarded-for");
        return null == accessIP ? request.getRemoteAddr() : accessIP;
    }


    /**
     * 获取access_Token
     *
     * @return
     */
    public static String getAccessToken(String ACCESSTOKENURL) {

        /**
         * @Todo 暂时存在静态 map中
         */
        String accessToken = null;
        //先判断时间
        Long tokenTime = StringUtils.isEmpty((Long) WxContstants.currentHashMap.get(WxContstants.ACCESS_TOKEN)) ? 0:(Long) WxContstants.currentHashMap.get(WxContstants.ACCESS_TOKEN);
        //如果当前时间大于设置的时间则进行重新获取accessToken
        if (Instant.now().getEpochSecond() > tokenTime) {
            JSONObject result = HttpClientUtils.httpRequest(ACCESSTOKENURL, "GET", "");
            if (StringUtils.isEmpty(result.get(WxContstants.ACCESS_TOKEN))){
                log.info("调取微信接口获取access_token失败=="+result);
            }
            accessToken = String.valueOf(result.get(WxContstants.ACCESS_TOKEN));
            WxContstants.TOKEN_MAP.put(WxContstants.ACCESS_TOKEN,accessToken);
            WxContstants.currentHashMap.put(WxContstants.ACCESS_TOKEN,Instant.now().getEpochSecond()+6000);
        }
        accessToken = String.valueOf(WxContstants.TOKEN_MAP.get(WxContstants.ACCESS_TOKEN));
        return accessToken;
    }




    public static String getRandCode(){
        Random ne=new Random();
        return String.valueOf(ne.nextInt(9999-1000+1)+1000);
    }

    public static String getUUID(){
        UUID uuid=UUID.randomUUID();
        String str = uuid.toString();
        String uuidStr=str.replace("-", "");
        return uuidStr;
    }


}

 

4、效果。这样就可以实现简单的客服功能了，客服必须在线。 不在线就回复代码中写的反馈信息。

（如图4 ，5）

图4

 

图5

 

somdip
关注
专栏目录
基于微信公众号，搭建一套简单的电商支付环境（下）-- 微信公众号的对接
天草二十六
04-13 1095
access_token是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取access_token失效。回到我们的目标，本文非对接全部的微信公众号，只需两个接口。正所谓“弱水三千，只取一瓢饮”，还是那句话，你如果要对接其他的更多接口，请参考上文给的开源项目。
微信公众号多客服功能的实现--向指定客服发送信息
weixin_33720452的博客
06-26 710
   微信本身的文档有点（hen）坑，看半天看不明白，所以多客服这块我们用飞哥的easyWechat的三方来做。 1. 下载安装easyWechat，或者拷贝一份vendor文件也行。 2. 新建一个文件夹, 引入 composer 入口文件： include __DIR__ . '/vendor/autoload.php';3.加载要用的文件：   use EasyWeChat\Fou...
公众号开发模式下客服消息开发
10-26
微信公众号开发模式下客服消息开发详细介绍，用代码详细介绍了文本、图片、视频、音频、音乐、小程序卡片等多种客服消息的发送XML内容格式
不写代码，不用服务器 ，让自己的公众号拥有一个智能客服
最新发布
一切总会归于平淡
07-30 677
想象一下，你的公众号粉丝正在浏览你的内容，突然她遇到一个问题，不知道该如何操作。就在她有些困惑时，一个友善的智能客服出现了，瞬间解答了她的疑惑。这一切竟然都没有你写一行代码。我们常常认为，技术的应用需要专业的编程技能和复杂的开发过程。然而，事实上，通过一些简单易用的工具和平台，你可以在无需编写代码的情况下，为你的公众号添加智能客服功能。这不仅能提升粉丝的互动体验，还能解放你的时间，专注于创作更有价值的内容。接下来，让我们一起探索一下这些神奇的工具和方法，看看如何轻松实现这个目标。
php 微信客服聊天开发,客服服务
weixin_36215903的博客
03-18 198
企业客服服务客服服务是企业号为企业提供的客服功能，如下图所示，目前支持两种客服场景：外部客户客服：外部客户在公众号或企业自有门户进行问题咨询，客服人员在企业号聊天进行咨询回复。内部客户客服：企业号内部成员在企业号应用进行问题咨询，客服人员在企业号聊天进行咨询回复。客服业务场景外部客服业务场景外部客服的业务流程大致为：1.客户关注服务号；2.客户使用服务号的发消息功能向客服人员发起问题咨询；3.客户...
java 微信多客服开发_微信开发——微信多客服   后续我会放出更多代码
weixin_42741930的博客
02-16 287
好久没给大家写博客了动态了，最近项目有点紧，所以没啥时间写些记录和语法了，好了不扯淡了，今天给大家示范一下微信多客服开发的环节。。。。-----------------------------------------正文--------------------------------------------微多客服在7.1号会有一次大改版，微信官方要把多客服客户端和多客服助手不维护了，所有多客服通...
微信小程序【客服消息】功能开发
热门推荐
jilinmly的博客
05-30 7万+
最近在开发微信小程序，前后端均是我一个人负责，也着实受了不少苦网上客服消息开发挺多的，但是大多数说的都不详尽对新人来说有很多坑，最后还是根据官方说明文档一步一步走下来，写一份新人版的供大家参考，望大佬指正注：如果要参考官方文档的话，这里有一个我推荐的阅读顺序https://developers.weixin.qq.com/miniprogram/dev/component/contact-butt...
微信公众平台 客服接口发消息的实现代码(Java接口开发)
01-19
微信公众平台技术文档：客服消息 一、接口说明 当用户和公众号产生特定动作的交互时（具体动作列表请见下方说明），微信将会把消息数据推送给开发者，开发者可以在一段时间内（目前修改为48小时）调用客服接口，通过POST一个JSON数据包来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。 目前允许的动作列表如下（公众平台会根据运营情况更新该列表，不同动作触发后，允许的客服接口下发消息条数不同，下发条数达到上限后，会遇到错误返回码，具体请见返回码说明页）： 1、用户发送信息 2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中
python微信公众号开发简单流程实现
12-20
本文为大家分享了python微信公众号开发的简单过程，供大家参考，具体内容如下 网上有很多微信公众号的开发教程，但是都是好几年前的了，而且很多都是抄袭其他人的，内容几乎一模一样。真的无语了。只好自己总结一下...
ASP.NET Core2静默获取微信公众号的用户OpenId实例代码
01-20
微信公众号静默获取用户OpenId：要实现该功能，可以通过微信公众号提供的“网页授权”接口完成（官网描述：以snsapi_base为scope发起的网页授权，是用来获取进入页面的用户的openid的，并且是静默授权并自动跳转到回...
微信公众号和mysql连接_微信公众号连接数据库如何实现?
weixin_42620913的博客
01-19 2671
微信公众号连接数据库如何实现?各位微信用户们，如果您想知道微信公众号连接数据库，但是又不知道怎么去做，大家可以参考以下小编整理的微信公众号连接数据库如何实现的方法。微信公众号连接数据库如何实现?小编原本是在BAE通过简单的JDBC试过，但是可能某个地方失误，微信公众平台最大的缺点就是调试很困难，我花的时间不多，没找到什么调试的方法，悲催的无法成功，又不会调试，百度，看到很多通过request.ge...
微信公众号 客服接口的开发实例详解
09-01
主要介绍了微信公众号 客服接口的开发实例详解的相关资料,需要的朋友可以参考下
微信小程序如何实现在线客服功能
10-16
主要介绍了微信小程序如何实现在线客服功能,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
微信在线客服功能开发问题记录
yang651158的博客
12-10 551
由于负责公司语音客服系统开发。本着拓展客服系统功能，完善客服系统生态的原则。需要开发在线客服系统。首先对接的就是微信公众号关注用户的在线客服功能。 在微信测试平台http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 需要将微信发送的消息推到自己的接口中进行业务处理。首先要填写接口配置信息。 阅读官方文档，感觉很简单，于是通过frp将本机端口映射到公司外网端口上，开始调试验证方法。照官方文档所说，验证通过后只需将echostr
微信客服和消息模块开发
spt_dream的博客
05-31 729
客户针对微信开发的需求包含提供微信客服，和主动发消息。经过文档学习，在正式申请的公众号管理平台，注意，一定是正式认证的公众号中，有客服模块，没有在添加中查找，找到后不用做开发，直接登录用。而主动消息要发建模板，但是公众号模板要审核，建议在模板库找类似的，多花点时间总能找到...
接入微信公众号客服功能
sinat_33201781的博客
07-06 1285
公众号客服包括PC版客服系统和手机版客服系统 一、PC版 1.登录公众号——》新的功能——》广告与服务——》客服，选择开通。我已经开通过了，所以在广告与服务里直接就有客服了 选择添加客服，按照步骤添加客服微信，添加完之后再选择《在线客服功能》，就可以接入客户咨询了。 二、手机版 公众号搜索《微小助》，关注，新增授权，完成公众号授权，然后就能接收客户咨询了。 开发公众号服务的时候遇到一个坑，每次给公众号发消息之后就有提示“该公众号提供的服务出现故障，请稍候再试”。百度之后说公众号授权给第三方了
微信公众号多客服开发介绍
叩首前行
01-27 1万+
非开发者模式：如果公众号没有处于开发者模式，则只需要单纯的在 微信公众号后台进行设置就可以启用多客服功能 开发者模式： 用户发送消息时的2种情况：          普通微信用户向公众号发消息时，微信服务器会先将消息POST到开发者填写的url上。          开发者响应包有两种（普通消息响应包，带有启动多客服指令的包）         如果希望将消息转发到多客服系统，需要开发者在
java 微信公众号项目构建
10-11
要构建一个Java微信公众号项目，你可以使用开源的Java框架Spring来实现。具体步骤如下： 1.注册微信公众平台账号，获取AppID和AppSecret。 2.创建Spring Boot项目，并添加Web和微信Java SDK依赖。 3.在Spring Boot配置文件中设置服务器端口和微信公众平台的AppID和AppSecret。 4.编写微信认证和消息接收的Controller，并在其中处理微信的各种消息类型和事件。 5.将项目部署到服务器上。
评论 15
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

somdip

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值