微信公眾平臺客服接口發(fā)消息的實現(xiàn)代碼(Java接口開發(fā))

更新時間：2019年04月17日 10:09:39 作者：天才小小布

這篇文章主要介紹了微信公眾平臺客服接口發(fā)消息的實現(xiàn)代碼(Java接口開發(fā))，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧

微信公眾平臺技術(shù)文檔：客服消息

一、接口說明

當(dāng)用戶和公眾號產(chǎn)生特定動作的交互時（具體動作列表請見下方說明），微信將會把消息數(shù)據(jù)推送給開發(fā)者，開發(fā)者可以在一段時間內(nèi)（目前修改為48小時）調(diào)用客服接口，通過POST一個JSON數(shù)據(jù)包來發(fā)送消息給普通用戶。此接口主要用于客服等有人工消息處理環(huán)節(jié)的功能，方便開發(fā)者為用戶提供更加優(yōu)質(zhì)的服務(wù)。

目前允許的動作列表如下（公眾平臺會根據(jù)運營情況更新該列表，不同動作觸發(fā)后，允許的客服接口下發(fā)消息條數(shù)不同，下發(fā)條數(shù)達到上限后，會遇到錯誤返回碼，具體請見返回碼說明頁）：

1、用戶發(fā)送信息
2、點擊自定義菜單（僅有點擊推事件、掃碼推事件、掃碼推事件且彈出“消息接收中”提示框這3種菜單類型是會觸發(fā)客服接口的）
3、關(guān)注公眾號
4、掃描二維碼
5、支付成功
6、用戶維權(quán)

二、客服接口-發(fā)消息

1 接口調(diào)用請求說明

http請求方式: POST

https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

2 發(fā)送客服消息

各消息類型所需的JSON數(shù)據(jù)包如下：

（1）發(fā)送文本消息

{
 "touser":"OPENID",
 "msgtype":"text",
 "text":
 {
   "content":"Hello World"
 }
}

（2）發(fā)送圖片消息

{
 "touser":"OPENID",
 "msgtype":"image",
 "image":
 {
  "media_id":"MEDIA_ID"
 }
}

（3）發(fā)送語音消息

{
 "touser":"OPENID",
 "msgtype":"voice",
 "voice":
 {
  "media_id":"MEDIA_ID"
 }
}

（4）發(fā)送視頻消息

{
 "touser":"OPENID",
 "msgtype":"video",
 "video":
 {
  "media_id":"MEDIA_ID",
  "thumb_media_id":"MEDIA_ID",
  "title":"TITLE",
  "description":"DESCRIPTION"
 }
}

（5）發(fā)送音樂消息

{
 "touser":"OPENID",
 "msgtype":"music",
 "music":
 {
  "title":"MUSIC_TITLE",
  "description":"MUSIC_DESCRIPTION",
  "musicurl":"MUSIC_URL",
  "hqmusicurl":"HQ_MUSIC_URL",
  "thumb_media_id":"THUMB_MEDIA_ID" 
 }
}

（6）發(fā)送圖文消息（點擊跳轉(zhuǎn)到外鏈）圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過8，則將會無響應(yīng)。

{
 "touser":"OPENID",
 "msgtype":"news",
 "news":{
  "articles": [
   {
    "title":"Happy Day",
    "description":"Is Really A Happy Day",
    "url":"URL",
    "picurl":"PIC_URL"
   },
   {
    "title":"Happy Day",
    "description":"Is Really A Happy Day",
    "url":"URL",
    "picurl":"PIC_URL"
   }
   ]
 }
}

（7）發(fā)送圖文消息（點擊跳轉(zhuǎn)到圖文消息頁面）圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過8，則將會無響應(yīng)。

{
 "touser":"OPENID",
 "msgtype":"mpnews",
 "mpnews":
 {
   "media_id":"MEDIA_ID"
 }
}

（8）發(fā)送卡券

{
 "touser":"OPENID", 
 "msgtype":"wxcard",
 "wxcard":{    
   "card_id":"123dsdajkasd231jhksad"  
   },
}

特別注意客服消息接口投放卡券僅支持非自定義Code碼和導(dǎo)入code模式的卡券的卡券，詳情請見：是否自定義code碼。

請注意，如果需要以某個客服帳號來發(fā)消息（在微信6.0.2及以上版本中顯示自定義頭像），則需在JSON數(shù)據(jù)包的后半部分加入customservice參數(shù)，例如發(fā)送文本消息則改為：

{
 "touser":"OPENID",
 "msgtype":"text",
 "text":
 {
   "content":"Hello World"
 },
 "customservice":
 {
   "kf_account": "test1@kftest"
 }
}

3 請求參數(shù)說明

參數(shù)	是否必須	說明
access_token	是	調(diào)用接口憑證
touser	是	普通用戶openid
msgtype	是	消息類型，文本為text，圖片為image，語音為voice，視頻消息為video，音樂消息為music，圖文消息（點擊跳轉(zhuǎn)到外鏈）為news，圖文消息（點擊跳轉(zhuǎn)到圖文消息頁面）為mpnews，卡券為wxcard
content	是	文本消息內(nèi)容
media_id	是	發(fā)送的圖片/語音/視頻/圖文消息（點擊跳轉(zhuǎn)到圖文消息頁）的媒體ID
thumb_media_id	是	縮略圖的媒體ID
title	否	圖文消息/視頻消息/音樂消息的標(biāo)題
description	否	圖文消息/視頻消息/音樂消息的描述
musicurl	是	音樂鏈接
hqmusicurl	是	高品質(zhì)音樂鏈接，wifi環(huán)境優(yōu)先使用該鏈接播放音樂
url	否	圖文消息被點擊后跳轉(zhuǎn)的鏈接
picurl	否	圖文消息的圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640320，小圖8080

4 java接口開發(fā)

（1）Message客服接口消息封裝對象

public class Message {

 private String touser;
 private String msgtype;
 private TextContent text;
 private MediaContent image;
 private MediaContent voice;
 private MediaContent video;
 private MusicContent music;
 private Articles news;

 public String getTouser() {
  return touser;
 }
 public void setTouser(String touser) {
  this.touser = touser;
 }
 public String getMsgtype() {
  return msgtype;
 }
 public void setMsgtype(String msgtype) {
  this.msgtype = msgtype;
 }
 public TextContent getText() {
  return text;
 }
 public void setText(TextContent text) {
  this.text = text;
 }
 public MediaContent getImage() {
  return image;
 }
 public void setImage(MediaContent image) {
  this.image = image;
 }
 public MediaContent getVoice() {
  return voice;
 }
 public void setVoice(MediaContent voice) {
  this.voice = voice;
 }
 public MediaContent getVideo() {
  return video;
 }
 public void setVideo(MediaContent video) {
  this.video = video;
 }
 public MusicContent getMusic() {
  return music;
 }
 public void setMusic(MusicContent music) {
  this.music = music;
 }
 public Articles getNews() {
  return news;
 }
 public void setNews(Articles news) {
  this.news = news;
 }
 @Override
 public String toString() {
  return "Message [touser=" + touser + ", msgtype=" + msgtype + ", text="
    + text + ", image=" + image + ", voice=" + voice + ", video="
    + video + ", music=" + music + ", news=" + news + "]";
 }
}

（2）TextContent文本消息內(nèi)容封裝對象

public class TextContent {

 private String content;

 public String getContent() {
  return content;
 }

 public void setContent(String content) {
  this.content = content;
 }
}

（3）MediaContent媒體ID封裝對象

public class MediaContent {

 private String media_id;

 public String getMedia_id() {
  return media_id;
 }
 public void setMedia_id(String media_id) {
  this.media_id = media_id;
 }
}

（4）MusicContent音樂消息封裝對象

public class MusicContent {

 private String title;
 private String description;
 private String musicurl;
 private String hqmusicurl;
 private String thumb_media_id;

 public String getTitle() {
  return title;
 }
 public void setTitle(String title) {
  this.title = title;
 }
 public String getDescription() {
  return description;
 }
 public void setDescription(String description) {
  this.description = description;
 }
 public String getMusicurl() {
  return musicurl;
 }
 public void setMusicurl(String musicurl) {
  this.musicurl = musicurl;
 }
 public String getHqmusicurl() {
  return hqmusicurl;
 }
 public void setHqmusicurl(String hqmusicurl) {
  this.hqmusicurl = hqmusicurl;
 }
 public String getThumb_media_id() {
  return thumb_media_id;
 }
 public void setThumb_media_id(String thumb_media_id) {
  this.thumb_media_id = thumb_media_id;
 }
}

（5）Articles圖文集合封裝對象

public class Articles {

 private Article[] articles;

 public Article[] getArticles() {
  return articles;
 }
 public void setArticles(Article[] articles) {
  this.articles = articles;
 }
}

（6）Article圖文消息封裝對象

public class Article {
 private String title;
 private String description;
 private String url;
 private String picurl;
 private String thumb_media_id;
 private String author; 
 private String content_source_url; 
 private String content; 
 private String digest; 
 private Integer show_cover_pic;

 public String getTitle() {
  return title;
 }
 public void setTitle(String title) {
  this.title = title;
 }
 public String getDescription() {
  return description;
 }
 public void setDescription(String description) {
  this.description = description;
 }
 public String getUrl() {
  return url;
 }
 public void setUrl(String url) {
  this.url = url;
 }
 public String getPicurl() {
  return picurl;
 }
 public void setPicurl(String picurl) {
  this.picurl = picurl;
 }
 public String getThumb_media_id() {
  return thumb_media_id;
 }
 public void setThumb_media_id(String thumb_media_id) {
  this.thumb_media_id = thumb_media_id;
 }
 public String getAuthor() {
  return author;
 }
 public void setAuthor(String author) {
  this.author = author;
 }
 public String getContent_source_url() {
  return content_source_url;
 }
 public void setContent_source_url(String content_source_url) {
  this.content_source_url = content_source_url;
 }
 public String getContent() {
  return content;
 }
 public void setContent(String content) {
  this.content = content;
 }
 public String getDigest() {
  return digest;
 }
 public void setDigest(String digest) {
  this.digest = digest;
 }
 public Integer getShow_cover_pic() {
  return show_cover_pic;
 }
 public void setShow_cover_pic(Integer show_cover_pic) {
  this.show_cover_pic = show_cover_pic;
 }
}

（7）客服消息請求接口

public class CrmSendMessageService{

 private RestTemplate restTemplate ; 

 private String serviceHost = "https://api.weixin.qq.com";

 public CrmSendMessageServiceImpl() {
  restTemplate = RestTemplateFactory.makeRestTemplate();
 }

 @Override
 public WeixinResponse sendMessage(String accessToken, Message message) {
  WeixinResponse weixinResponse = null;
  String url = new StringBuffer(serviceHost).append("/cgi-bin/message/custom/send?access_token=")
    .append(accessToken).toString();
  weixinResponse = restTemplate.postForObject(url, message, WeixinResponse.class);
  return weixinResponse;
 }

}

注：接口發(fā)送http請求基于Spring RestTemplate。

參考文章地址：

1.Spring RestTemplate詳解

（8）WeixinResponse客服消息接口返回對象

public class WeixinResponse {
 private String msgid;
 private String code;
 private int errcode;
 private String errmsg;

 public String getMsgid() {
  return msgid;
 }
 public void setMsgid(String msgid) {
  this.msgid = msgid;
 }
 public int getErrcode() {
  return errcode;
 }
 public void setErrcode(int errcode) {
  this.errcode = errcode;
 }
 public String getErrmsg() {
  return errmsg;
 }
 public void setErrmsg(String errmsg) {
  this.errmsg = errmsg;
 }
 public String getCode() {
  return code;
 }
 public void setCode(String code) {
  this.code = code;
 } 
}

5 接口實例開發(fā)

/**
 * 發(fā)送客服消息
 * @param openId 要發(fā)給的用戶
 * @param accessToken 微信公眾號token
 * @param weixinAppId 微信公眾號APPID
 */
private void sendCustomMessage(String openId,String accessToken,String weixinAppId){
  try {
   RestTemplate rest = new RestTemplate();
   String postUrl = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=" + accessToken;
   //推送圖文消息
   Message message = new Message();
   message.setTouser(openId);//普通用戶openid
   message.setMsgtype("news");//圖文消息（點擊跳轉(zhuǎn)到外鏈）為news
   Articles news = new Articles();
   Article article = new Article();
   article.setDescription("客服消息圖文描述");//圖文消息/視頻消息/音樂消息的描述
          article.setPicurl("http://mmbiz.qpic.cn/mmbiz_jpg/CDW6Ticice130g6RcXCkNNDWic4dEaAHQDia2OG5atHBqSvsPuCfuqoyeeLWENia4ciaKt3KHWQ9t2LRPDpUo5AkOyyA/0");//圖文消息的圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80
   article.setTitle("客服消息圖文標(biāo)題");//圖文消息/視頻消息/音樂消息的標(biāo)題
   //圖文推送鏈接
   String url="https://www.baidu.com";
   article.setUrl(url);//圖文消息被點擊后跳轉(zhuǎn)的鏈接
   Article[] articles = {article};
   news.setArticles(articles);
   message.setNews(news);
   int i=1;
   while(i<=3){//循環(huán)發(fā)送3次
    WeixinResponse response = rest.postForObject(postUrl, message, WeixinResponse.class, new HashMap<String,String>());
    LOG.info("發(fā)送客服消息返回信息:"+response.toString());
    if(response.getErrcode()==0){//發(fā)送成功-退出循環(huán)發(fā)送
     i=4;
     break;
    }else{
     i++;//發(fā)送失敗-繼續(xù)循環(huán)發(fā)送
    }
   }
  } catch (Exception e) {
   LOG.error("發(fā)送客服消息失敗,openId="+openId,e);
  }
 }

6 客服接口圖文推送上傳圖片

在發(fā)送圖文消息時，我們需要添加圖片的地址，介紹一個好方法。

（1）進入微信公眾平臺接口調(diào)試工具

https://mp.weixin.qq.com/debug

（2）選擇類型和列表

接口類型：基礎(chǔ)支持

接口列表：上傳logo接口/media/uploadimg