微信开发 图文消息 发送

微信图文消息发送：

要发送微信图文消息，首先我们需要知道的几个接口，主动发送和被动发送，这里的主动的意思就是微信公众号，主动给关注的用户发送图文消息，被动就是服务号在接收到用户的请求或者别的事件的时回复给用户的消息。浸提那咱们就来看一下微信主动发送图文消息给用户。
首先的要素就是咱们的公众号呢还是需要认证的服务号。当然发送的对象也是关注咱们服务号的用户，应为进行这些操作的依据还是用户的openId，只有获取到用户的openId，才能根据openId群发消息，当然还可以根据组进行消息的发送，咱们这里讲的就只是根据openId来群发消息。
还是之前两节说的首先咱们需要获取到用户的openId，就是进行认证，当然只是openId不需要昵称之类的私人信息的话，咱们可以进行静默授权的方式，就是用户无感知的方式进行。好了openId有了咱们需要发送图文消息的话剩下的就是图文素材了。下面咱们就来详细说一下这个图文素材。
1.图文素材的组成：
1.1图片素材,图片素材就是咱们发送图文素材中的图片。在后面上传的图文素材中是这个参数的值：thumb_media_id。
1.2标题：发送图文消息素材的title
1.3作者：author，
1.4图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空：digest
1.5是否显示封面，0为false，即不显示，1为true，即显示,showCoverPic,这个字段设置在我们点击发送的消息的时候进入之后首页图是否展示的标识。
1.6图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS， content，这里要是服务号支持支付功能的话，内容里面可以使用 a 标签，点击发送的图文消息进入就可以随时一个图片电弧图片就可以进入咱们希望用户看到的页面。要是没有支付功能的话，只能是引导用户点击阅读原文，进入我们希望用户进入的页面。
1.7图文消息的原文地址，即点击“阅读原文”后的URL， contentSourceUrl，要是咱们的服务号支持支付功能的话，这个连接就可以配置在点击图片的反应连接里。
2.图文素材的组成我们了解之后，就是上传
2.1首先是上传图片素材。
2.2获取上一步上传的图片素材，作为图文素材的参数，上传图文素材。
3.通过上传的图文素材，发送图文消息。用户就可以接受消息，点击查看消息。

下面我们来看一下上传1.上传图片素材。2.上传图文素材。
1.上传图片素材。注意这里和文档中给的有点差异。但是总体上还是安装文档上面的来，就是给出的Url，使用我们这里使用的，亲测有效！！！

//注意这个URl 文档中给出的URl是没有这个参数的：type，但是这个参数是必须的，咱们这里上传的是图片的话，就是用image就可以啦
private static String ADD_MATERIAL_URL = "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=%s&type=%s";
    String addImageMedia(String type, File imageFile, String token) {
        String url = String.format(ADD_MATERIAL_URL, token, type);
        String materialResult = null;
        try {
            LOGGER.info("上传微信图文素材Url :{}", url);
            materialResult = HttpsUtil.connectHttpsByPost(url, null, imageFile);
            LOGGER.info("上传微信图文素材结果:{}", materialResult);
        } catch (Exception ex) {
            LOGGER.error("上传微信图文素材异常:", ex);
        }
        return materialResult;
    }

其中的三个请求参数分别是：
type：上传的文件类型，这里图片的话即使image；
imageFile：上传文件的路径，这里是咱们准备上传文件路径，方便程序可以找到咱们上传的资源。
token：就是每一次接口调用的凭证。这个数值是7200的有效时间，又有接口的请求限制所以就做一个缓存，或者是搞一个任务定时刷则个token都是OK的。
使用的是https的post方法，返回的结果是：

{"media_id":"dQ30hiyMqdIdtRcsy7yc6_w5rcmiAMAmaw5g9_XXdZo",
"url":"http://mmbiz.qpic.cn/mmbiz_png/c9uhCXXHZCxNWH4hknQw2rFchdGCrI1jbsvN9KhRHOBiaj6kbGh6SfCUB9VKU561gibpnN3Azuz6esvvMxYJWCiag/0?wx_fmt=png"}
咱们需要注意的是咱们发送的图文消息，使用的图片素材必须是永久图片素材，临时的图片素材不管用。我们这里得到的media_id就是下一步咱们上传图文素材的 thumb_media_id。
2.好啦图片素材上传完毕，下面咱们上传图文素材。

//上传图文素材
 private static final String PERMANENT_MEDIA_URL = "https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=%s";

    String addPermanentMediaArticle(MediaArticle mediaArticle) {
        String url = String.format(PERMANENT_MEDIA_URL, mediaArticle.getToken());
        try {
            Map<String, Object> paramMap = Maps.newHashMap();

            List<Map> articleList = Lists.newArrayList();

            for (MediaArticle.Article article : mediaArticle.getArticles()) {
                Map<String, String> articleMap = Maps.newHashMap();
                articleMap.put("title", article.getTitle());
                articleMap.put("thumb_media_id", article.getThumbMediaId());
                articleMap.put("author", article.getAuthor());
                articleMap.put("digest", article.getDigest());
                articleMap.put("show_cover_pic", article.getShowCoverPic());
                articleMap.put("content", article.getContent());
                articleMap.put("content_source_url", article.getContentSourceUrl());
                articleList.add(articleMap);
            }
            paramMap.put("articles", articleList);
            String param = GsonHolder.getGson().toJson(paramMap);
            LOGGER.info("添加微信图文素材请求url:{},参数:{}", url, param);
            String result = HttpClientUtils.sendHttpsPost(url, param);
            LOGGER.info("添加微信图文素材返回结果:{}", result);
            return result;
        } catch (Exception ex) {
            LOGGER.error("添加微信图文素材异常:", ex);
        }
        return null;
    }

1.还是使用的是https，的post方法进行请求，url里面直接带着咱们接口请求的凭证参数token。
2.下面看一下这些请求参数：这里的参数就不一一详解了，这里的参数是上面咱们已经一一列举。
来看一下返回值：

//永久图文消息返回的media_id
{"media_id":"dQ30hiyMqdIdtRcsy7yc6xsMazGcezOQXYb6GvcoWWw"}

使用上面返回的media_id就可以发送图文消息啦。

3.下面咱们调用发送图文消息试试。在这里咱们可以使用正式的线上环境的API直接发送正式的通知消息，也可以使用预览的接口发送一部分人首先看下结果，预览接口的调用限制是100次每天。

    /**
     * 图文素材发送 预览
     */
    private static String MEDIA_PRE_VIEW_URL = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=%s";

    String mediaPreView(String mediaId, String msgtype, String openId, String token) {

        String url = String.format(MEDIA_PRE_VIEW_URL, token);

        String preViewResult = null;
        try {
            Map<String, Object> paramMap = Maps.newHashMap();
            Map<String, String> touser = Maps.newHashMap();
            paramMap.put("touser", openId);
            paramMap.put("msgtype", msgtype);
            touser.put("media_id", mediaId);
            paramMap.put("mpnews", touser);
            String param = GsonHolder.getGson().toJson(paramMap);
            LOGGER.info("图文消息发送预览,url:{}, param:{}", url, param);
            preViewResult = HttpClientUtils.sendHttpsPost(url, param);
            LOGGER.info("图文消息发送预览,result:{}", preViewResult);
        } catch (Exception ex) {
            LOGGER.error("图文消息发送预览异常:", ex);
        }
        return preViewResult;
    }

这个就是咱们的预览接口发送图文消息，过期点击无效。touser就是需要发送消息的openIds，注意这里要是群发消息的话，这个集合里必须是两个以上的openId,msgtype就是图片类型：mpnews，mpnews这个参数就是咱们上面得到的图文消息的media_id.
发送成功之后返回的，errroCode:0,errorMessage:"success"

好了这一期咱们看了微信图文消息发送，下一期咱们看一下微信素材管理。