微信公众号-关注取消关注后图文和普通消息自动回复

骑猪看日落 2022-12-22 09:39 185阅读 0赞

当用户发送消息给公众号时（或某些特定的用户操作引发的事件推送时），会产生一个POST请求，开发者可以在响应包（Get）中返回特定XML结构，来对该消息进行响应（现支持回复文本、图片、图文、语音、视频、音乐）。严格来说，发送被动响应消息其实并不是一种接口，而是对微信服务器发过来消息的一次回复。

微信服务器在将用户的消息发给公众号的开发者服务器地址（开发者中心处配置）后，微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次，如果在调试中，发现用户无法收到响应的消息，可以检查是否消息处理超时。关于重试的消息排重，有msgid的消息推荐使用msgid排重。事件类型消息推荐使用FromUserName + CreateTime 排重。

如果开发者希望增强安全性，可以在开发者中心处开启消息加密，这样，用户发给公众号的消息以及公众号被动回复用户消息都会继续加密，详见被动回复消息加解密说明。

假如服务器无法保证在五秒内处理并回复，必须做出下述回复，这样微信服务器才不会对此作任何处理，并且不会发起重试（这种情况下，可以使用客服消息接口进行异步回复），否则，将出现严重的错误提示。详见下面说明：

1、直接回复success（推荐方式） 2、直接回复空串（指字节长度为0的空字符串，而不是XML结构体中content字段的内容为空）

一旦遇到以下情况，微信都会在公众号会话中，向用户下发系统提示“该公众号暂时无法提供服务，请稍后再试”：

1、开发者在5秒内未回复任何内容 2、开发者回复了异常数据，比如JSON数据等

另外，请注意，回复图片（不支持gif动图）等多媒体消息时需要预先通过素材管理接口上传临时素材到微信服务器，可以使用素材管理中的临时素材，也可以使用永久素材。

各消息类型需要的XML数据包结构如下：

### 文章目录 ###

*   *  回复文本消息
     *  回复图片消息
     *  回复语音消息
     *  回复视频消息
     *  回复音乐消息
     *  回复图文消息
     *  \*\*ArticleItem\*\*
     *  InMsgEntity
     *  OutMsgEntity
     *  EchostrController

1 回复文本消息

2 回复图片消息

3 回复语音消息

4 回复视频消息

5 回复音乐消息

6 回复图文消息

## 回复文本消息 ##

> 参数 是否必须 描述  
> ToUserName 是 接收方帐号（收到的OpenID）  
> FromUserName 是 开发者微信号  
> CreateTime 是 消息创建时间 （整型）  
> MsgType 是 消息类型，文本为text  
> Content 是 回复的消息内容（换行：在content中能够换行，微信客户端就支持换行显示）

## 回复图片消息 ##

参数 是否必须 说明

> ToUserName 是 接收方帐号（收到的OpenID） FromUserName 是 开发者微信号  
> CreateTime 是 消息创建时间 （整型） MsgType 是 消息类型，图片为image  
> MediaId 是 通过素材管理中的接口上传多媒体文件，得到的id。

## 回复语音消息 ##

> 参数 是否必须 说明 ToUserName 是 接收方帐号（收到的OpenID） FromUserName 是 开发者微信号  
> CreateTime 是 消息创建时间戳 （整型） MsgType 是 消息类型，语音为voice  
> MediaId 是 通过素材管理中的接口上传多媒体文件，得到的id

## 回复视频消息 ##

> 参数 是否必须 说明 ToUserName 是 接收方帐号（收到的OpenID） FromUserName 是 开发者微信号  
> CreateTime 是 消息创建时间 （整型） MsgType 是 消息类型，视频为video  
> MediaId 是 通过素材管理中的接口上传多媒体文件，得到的id Title 否 视频消息的标题  
> Description 否 视频消息的描述

## 回复音乐消息 ##

参数 是否必须 说明

> ToUserName 是 接收方帐号（收到的OpenID） FromUserName 是 开发者微信号  
> CreateTime 是 消息创建时间 （整型） MsgType 是 消息类型，音乐为music Title 否 音乐标题  
> Description 否 音乐描述 MusicURL 否 音乐链接  
> HQMusicUrl 否 高质量音乐链接，WIFI环境优先使用该链接播放音乐  
> ThumbMediaId 是 缩略图的媒体id，通过素材管理中的接口上传多媒体文件，得到的id

## 回复图文消息 ##

参数 是否必须 说明  
ToUserName 是 接收方帐号（收到的OpenID）  
FromUserName 是 开发者微信号  
CreateTime 是 消息创建时间 （整型）  
MsgType 是 消息类型，图文为news  
ArticleCount 是 图文消息个数；当用户发送文本、图片、语音、视频、图文、地理位置这六种消息时，开发者只能回复1条图文消息；其余场景最多可回复8条图文消息  
Articles 是 图文消息信息，注意，如果图文数超过限制，则将只发限制内的条数  
Title 是 图文消息标题  
Description 是 图文消息描述  
PicUrl 是 图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200  
Url 是 点击图文消息跳转链接

代码：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMjI1NzI1_size_16_color_FFFFFF_t_70_pic_center]

## **ArticleItem** ##

package com.camel.ssm.bean;
    
    
    import lombok.Getter;
    import lombok.Setter;
    
    import javax.xml.bind.annotation.XmlAccessType;
    import javax.xml.bind.annotation.XmlAccessorType;
    import javax.xml.bind.annotation.XmlElementWrapper;
    import javax.xml.bind.annotation.XmlRootElement;
    import java.util.List;
    
    /**
     * 接收普通消息
     */
    @XmlRootElement(name="xml")
    @XmlAccessorType(XmlAccessType.FIELD)
    @Setter
    @Getter
    public class OutMsgEntity {
    // 如果要是小写的话 在每个字段都填上
    // @XmlRootElement(name="ToUserName")
    
       private String ToUserName;	//开发者微信号
        private String FromUserName;	//发送方帐号（一个OpenID）
        private Long CreateTime;	//消息创建时间 （整型）
        private String Content;	//文本消息内容
     private String MsgType;	//消息类型，文本为text
     @XmlElementWrapper(name="Image")
     private String[] MediaId;	//图片消息媒体id，可以调用获取临时素材接口拉取数据。
     private String ThumbMediaId;	//视频消息缩略图的媒体id，可以调用多媒体文件下载接口拉取数据。
     private String Scale;//	地图缩放大小
     private String Label;//	地理位置信息
     private String Title;//	消息标题
     private String Description;//	消息描述
     private String Url;//	消息链接
     private String MusicURL;	//否	音乐链接
     private String HQMusicUrl;	//否	高质量音乐链接，WIFI环境优先使用该链接播放音乐
     //图文消息
     private int ArticleCount;	//是	图文消息个数；当用户发送文本、图片、语音、视频、图文、地理位置这六种消息时，开发者只能回复1条图文消息；其余场景最多可回复8条图文消息
     private List<ArticleItem> Articles;	//是	图文消息信息，注意，如果图文数超过限制，则将只发限制内的条数 多条图文消息信息，默认第一个item为大图
     private String PicUrl	;//是	图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
     //图文列表明细
     @XmlElementWrapper(name="Articles")
     private ArticleItem[] item;
    
    }

## InMsgEntity ##

package com.camel.ssm.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;
    
    /**
     * 接收普通消息
     */
    @Getter
    @Setter
    @XmlRootElement(name="xml")
    @XmlAccessorType(XmlAccessType.FIELD)
    
    public class InMsgEntity {
    // 如果要是小写的话 在每个字段都填上
    // @XmlRootElement(name="ToUserName")
    
       private String ToUserName;	//开发者微信号
        private String FromUserName;	//发送方帐号（一个OpenID）
        private Long CreateTime;	//消息创建时间 （整型）
        private String MsgType;	//消息类型，文本为text
        private String Content;	//文本消息内容
        private  Long MsgId;	//，64位整型
     private  String PicUrl;	//图片链接（由系统生成）
    
     // 图片消息媒体id，可以调用多媒体文件下载接口拉取数据
     private String MediaId;
     private String Format;	//语音格式，如amr，speex等
     private String Recognition;	//语音识别结果，UTF8编码
     private String ThumbMediaId;	//视频消息缩略图的媒体id，可以调用多媒体文件下载接口拉取数据。
     private String  Location_X;	//地理位置纬度
     private String Location_Y;	;//地理位置经度
     private String Scale;//	地图缩放大小
     private String Label;//	地理位置信息
     private String Title;//	消息标题
     private String Description;//	消息描述
     private String Url;//	消息链接
     private String Event; 事件类型，subscribe(订阅)、unsubscribe(取消订阅/click)
     private String EventKey; //菜单的KEY值
    
    }

## OutMsgEntity ##

## EchostrController ##

package com.camel.ssm.controller;
    
    import com.camel.ssm.bean.ArticleItem;
    import com.camel.ssm.bean.InMsgEntity;
    import com.camel.ssm.bean.OutMsgEntity;
    import com.camel.ssm.util.SecurityUtil;
    import com.camel.ssm.util.WeChatUtil;
    import org.aspectj.bridge.MessageUtil;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestBody;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    import javax.xml.bind.annotation.XmlElementWrapper;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Date;
    import java.util.List;
    
    /**
     *开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：
     *
     * 1）将token、timestamp、nonce三个参数进行字典序排序 2）将三个参数字符串拼接成一个字符串进行sha1加密 3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
     *
     *
     */
    @Controller
    public class EchostrController {
        @RequestMapping(value = "wechat", method = RequestMethod.GET)
        @ResponseBody
        public String vailidate(String signature, String timestamp, String nonce, String echostr) {
    //        1）将token、timestamp、nonce三个参数进行字典序排序
            String[] arr = {WeChatUtil.TOKKN, timestamp, nonce};
            Arrays.sort(arr);
    //    2）将三个参数字符串拼接成一个字符串进行sha1加密
            StringBuilder scs = new StringBuilder();
            for (String temp : arr) {
                scs.append(temp);
            }
    //获得自己的加密
            String mySignature = SecurityUtil.stringMD5(scs.toString());
    //    3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
            if (mySignature.equals(signature)) {
                System.out.println("接入成功");
                return echostr;
            }
    
            System.out.println("接入失败");
            return null;
        }
    
        /**
         * 普通消息
         */
        @RequestMapping(value = "wechat", method = RequestMethod.POST)
        @ResponseBody
    
        public Object handleMessage(@RequestBody InMsgEntity ime) {
            String outcontent = null;
            OutMsgEntity outMsg = new OutMsgEntity();
            //发送方
            outMsg.setFromUserName(ime.getToUserName());
            //接收方
            outMsg.setToUserName(ime.getFromUserName());
            //消息创建时间
            outMsg.setCreateTime(new Date().getTime());
            //判断一下回复的图片还是文本
            String msgType = ime.getMsgType();
            if (msgType.equals("text")) {
                //设置消息类型
                outMsg.setMsgType("text");
    //            关键字回复
                String content = ime.getContent();
    
                //回复的信息
                if (content.contains("开班")) {
                    outcontent = "ddd";
                } else if (content.contains("地址")) {
                    outcontent = "cccc";
                } else {
                    //设置消息内容
                    outcontent = ime.getContent();
                }
                outMsg.setContent(outcontent);
            } else if (msgType.equals("image")) {
                outMsg.setMsgType("image");
                outMsg.setMediaId(new String[]{ime.getMediaId()});
    
            }
            else if (msgType.equals("event")) {
                //判断关注的事件
                if (ime.getEvent().equals("subscribe")) {
                    //回复普通消息
    //                outMsg.setContent("欢迎关注");
    //                outMsg.setMsgType("text");
                    //回复图文消息
                   outMsg.setMsgType("news");
    //                //设置图文个数
                    outMsg.setArticleCount(1);
    //                //设置图文明细列表
                    ArticleItem articleitem = new ArticleItem();
                    articleitem.setTitle("欢迎关注KingYiFan's Blog");
                    articleitem.setPicUrl("https://www.runoob.com/wp-content/uploads/2013/12/12-130Q0221Q5602.jpg");
                    articleitem.setDescription("点击进入详情");
                    articleitem.setUrl("http://cnbuilder.cn/");
                    outMsg.setItem(new ArticleItem[]{articleitem});
    
               }
    
    //            else  if (ime.getEvent().equals("click")){
    //           String eventkey=ime.getEventKey();
    //                    //判断按钮的key值
    //                if("V1001_TODAY_MUSIC".equals(eventkey)){
    //                    outcontent="vvv";
    //                }else  if("V1001_GOOD".equals(eventkey)){
    //                    outcontent="www";
    //                }
    //                outMsg.setContent(outcontent);
    //                outMsg.setMsgType("text");
    //            }
    //
                }
            return outMsg;
    
        }
    }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMjI1NzI1_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/2020111914402758.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMjI1NzI1,size_16,color_FFFFFF,t_70#pic_center