微信公眾平臺(tái)技術(shù)文檔：客服消息
一、接口說(shuō)明
當(dāng)用戶和公眾號(hào)產(chǎn)生特定動(dòng)作的交互時(shí)（具體動(dòng)作列表請(qǐng)見(jiàn)下方說(shuō)明），微信將會(huì)把消息數(shù)據(jù)推送給開(kāi)發(fā)者，開(kāi)發(fā)者可以在一段時(shí)間內(nèi)（目前修改為48小時(shí)）調(diào)用客服接口，通過(guò)POST一個(gè)JSON數(shù)據(jù)包來(lái)發(fā)送消息給普通用戶。此接口主要用于客服等有人工消息處理環(huán)節(jié)的功能，方便開(kāi)發(fā)者為用戶提供更加優(yōu)質(zhì)的服務(wù)。
目前允許的動(dòng)作列表如下（公眾平臺(tái)會(huì)根據(jù)運(yùn)營(yíng)情況更新該列表，不同動(dòng)作觸發(fā)后，允許的客服接口下發(fā)消息條數(shù)不同，下發(fā)條數(shù)達(dá)到上限后，會(huì)遇到錯(cuò)誤返回碼，具體請(qǐng)見(jiàn)返回碼說(shuō)明頁(yè)）：
1、用戶發(fā)送信息
2、點(diǎn)擊自定義菜單（僅有點(diǎn)擊推事件、掃碼推事件、掃碼推事件且彈出“消息接收中”提示框這3種菜單類型是會(huì)觸發(fā)客服接口的）
3、關(guān)注公眾號(hào)
4、掃描二維碼
5、支付成功
6、用戶維權(quán)
二、客服接口-發(fā)消息
1 接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式: 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ā)送語(yǔ)音消息
{ "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ā)送音樂(lè)消息
{ "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ā)送圖文消息（點(diǎn)擊跳轉(zhuǎn)到外鏈） 圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過(guò)8，則將會(huì)無(wú)響應(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ā)送圖文消息（點(diǎn)擊跳轉(zhuǎn)到圖文消息頁(yè)面） 圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過(guò)8，則將會(huì)無(wú)響應(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模式的卡券的卡券，詳情請(qǐng)見(jiàn)：是否自定義code碼。
請(qǐng)注意，如果需要以某個(gè)客服帳號(hào)來(lái)發(fā)消息（在微信6.0.2及以上版本中顯示自定義頭像），則需在JSON數(shù)據(jù)包的后半部分加入customservice參數(shù)，例如發(fā)送文本消息則改為：
{ "touser":"OPENID", "msgtype":"text", "text": { "content":"Hello World" }, "customservice": { "kf_account": "test1@kftest" }}3 請(qǐng)求參數(shù)說(shuō)明
| 參數(shù) | 是否必須 | 說(shuō)明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| touser | 是 | 普通用戶openid |
| msgtype | 是 | 消息類型，文本為text，圖片為image，語(yǔ)音為voice，視頻消息為video，音樂(lè)消息為music，圖文消息（點(diǎn)擊跳轉(zhuǎn)到外鏈）為news，圖文消息（點(diǎn)擊跳轉(zhuǎn)到圖文消息頁(yè)面）為mpnews，卡券為wxcard |
| content | 是 | 文本消息內(nèi)容 |
| media_id | 是 | 發(fā)送的圖片/語(yǔ)音/視頻/圖文消息（點(diǎn)擊跳轉(zhuǎn)到圖文消息頁(yè)）的媒體ID |
| thumb_media_id | 是 | 縮略圖的媒體ID |
| title | 否 | 圖文消息/視頻消息/音樂(lè)消息的標(biāo)題 |
| description | 否 | 圖文消息/視頻消息/音樂(lè)消息的描述 |
| musicurl | 是 | 音樂(lè)鏈接 |
| hqmusicurl | 是 | 高品質(zhì)音樂(lè)鏈接，wifi環(huán)境優(yōu)先使用該鏈接播放音樂(lè) |
| url | 否 | 圖文消息被點(diǎn)擊后跳轉(zhuǎn)的鏈接 |
| picurl | 否 | 圖文消息的圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80 |
4 java接口開(kāi)發(fā)
（1）Message客服接口消息封裝對(duì)象
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)容封裝對(duì)象
public class TextContent { private String content; public String getContent() { return content; } public void setContent(String content) { this.content = content; }}（3）MediaContent媒體ID封裝對(duì)象
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音樂(lè)消息封裝對(duì)象
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圖文集合封裝對(duì)象
public class Articles { private Article[] articles; public Article[] getArticles() { return articles; } public void setArticles(Article[] articles) { this.articles = articles; }}（6）Article圖文消息封裝對(duì)象
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）客服消息請(qǐng)求接口
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請(qǐng)求基于Spring RestTemplate。
參考文章地址：
（8）WeixinResponse客服消息接口返回對(duì)象
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 接口實(shí)例開(kāi)發(fā)
/** * 發(fā)送客服消息 * @param openId 要發(fā)給的用戶 * @param accessToken 微信公眾號(hào)token * @param weixinAppId 微信公眾號(hào)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");//圖文消息（點(diǎn)擊跳轉(zhuǎn)到外鏈）為news Articles news = new Articles(); Article article = new Article(); article.setDescription("客服消息圖文描述");//圖文消息/視頻消息/音樂(lè)消息的描述 article.setPicurl("http://mmbiz.qpic.cn/mmbiz_jpg/CDW6Ticice130g6RcXCkNNDWic4dEaAHQDia2OG5atHBqSvsPuCfuqoyeeLWENia4ciaKt3KHWQ9t2LRPDpUo5AkOyyA/0");//圖文消息的圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80 article.setTitle("客服消息圖文標(biāo)題");//圖文消息/視頻消息/音樂(lè)消息的標(biāo)題 //圖文推送鏈接 String url="https://www.baidu.com"; article.setUrl(url);//圖文消息被點(diǎn)擊后跳轉(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ā)送圖文消息時(shí)，我們需要添加圖片的地址，介紹一個(gè)好方法。
（1）進(jìn)入微信公眾平臺(tái)接口調(diào)試工具
https://mp.weixin.qq.com/debug
（2）選擇類型和列表
接口類型：基礎(chǔ)支持
接口列表：上傳logo接口/media/uploadimg
添加access_token，選擇類型是image，最后選擇文件
注：添加視頻、音樂(lè)是一樣的
（3）最后就會(huì)生成圖片的url
（4）在瀏覽器訪問(wèn)url即可看見(jiàn)生成的圖片
以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持VeVb武林網(wǎng)。
新聞熱點(diǎn)
疑難解答
