微信開發六傳送訊息（客服/群發/模板）

阿新 • • 發佈：2019-02-01

本例中有些引用的類與方法不做過多介紹，之後會提供完整原始碼下載，請自行檢視。

客服介面

當用戶主動發訊息給公眾號的時候（包括髮送資訊、點選自定義選單、訂閱事件、掃描二維碼事件、支付成功事件、使用者維權），微信將會把訊息資料推送給開發者，開發者在一段時間內（目前修改為48小時）可以呼叫客服訊息介面，通過POST一個JSON資料包來發送訊息給普通使用者，在48小時內不限制傳送次數。此介面主要用於客服等有人工訊息處理環節的功能，方便開發者為使用者提供更加優質的服務。

為了幫助公眾號使用不同的客服身份服務不同的使用者群體，客服介面進行了升級，開發者可以管理客服賬號，並設定客服賬號的頭像和暱稱。該能力針對所有擁有客服介面許可權的公眾號開放。

/*
 * 客服
 * http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html
 */
public class KFAccount {

    private String kf_account;      //是 完整客服賬號，格式為：賬號字首@公眾號微訊號
    private String kf_nick;         //是 客服暱稱
    private String kf_id;           //是 客服工號
    private String nickname;        //是 客服暱稱，最長6個漢字或12個英文字元 

    private String password;        //否 客服賬號登入密碼，格式為密碼明文的32位加密MD5值。該密碼僅用於在公眾平臺官網的多客服功能中使用，若不使用多客服功能，則不必設定密碼
    private String media;           //是 該引數僅在設定客服頭像時出現，是form-data中媒體檔案標識，有filename、filelength、content-type等資訊
}

@RunWith(SpringJUnit4ClassRunner.class)        // 表示繼承了 SpringJUnit4ClassRunner 類 

@ContextConfiguration("classpath:spring-mybatis.xml")
public class TestWXCustomService {

    @Resource   
    private CustomServiceService customServiceService;

//  @Test
    public void addKFAccount() {
        KFAccount kfAccount = new KFAccount();
        kfAccount.setKf_account("[email protected]");
        kfAccount.setNickname("小白");
        kfAccount.setPassword("hq246512");
      System.out.println(">>>"+customServiceService.addKFAccount(kfAccount));
    }

//  @Test
    public void updateKFAccount() {
        KFAccount kfAccount = new KFAccount();
        kfAccount.setKf_account("[email protected]");
        kfAccount.setNickname("大白");
        kfAccount.setPassword("hq246512");
      System.out.println(">>>"+customServiceService.updateKFAccount(kfAccount));
    }

//  @Test
    public void deleteKFAccount() {
        KFAccount kfAccount = new KFAccount();
        kfAccount.setKf_account("[email protected]");
        kfAccount.setNickname("大白");
        kfAccount.setPassword("hq246512");
      System.out.println(">>>"+customServiceService.deleteKFAccount(kfAccount));
    }

//  @Test
    public void setKFAccountHeadImg() {
      System.out.println(">>>"+customServiceService.setKFAccountHeadImg("D:\\test\\head.jpg", "[email protected]"));
    }

// @Test
    public void getAllKFAccount() {
      System.out.println(">>>"+customServiceService.getAllKFAccount());
    }

//  @Test
    public void sendMessageByKF() {
        KFResponse kfResponse = new KFResponse();
        kfResponse.setTouser(WeChatCertificate.OPENID1);
        //傳送文字訊息
        kfResponse.setMsgtype("text");
        KFResponse.Text text = kfResponse.new Text();
        text.setContent("hello, this is kf response!");
        kfResponse.setText(text);
        //傳送音樂訊息    注：40007需重新上傳素材，Remark->第三條。
//      kfResponse.setMsgtype("music");
//      KFResponse.Music music = kfResponse.new Music();
//      music.setTitle("殘酷月光");
//      music.setDescription(" 林宥嘉 詞:向月娥 曲:陳小霞");
//      music.setMusicurl("http://wma.5282.cc/2008-11//20140226/1.mp3");
//      music.setHqmusicurl("http://wma.5282.cc/2008-11//20140226/1.mp3");
//      music.setThumb_media_id(WeChatCertificate.VIDEOMEDIAID);
//      kfResponse.setMusic(music);
        //傳送圖文訊息    
//      kfResponse.setMsgtype("news");
//      KFResponse.News news = kfResponse.new News();
//      for(int i=0; i<3; i++) {
//          KFResponse.News.Article article = news.new Article();
//          article.setTitle("title"+i);
//          article.setDescription("description"+i);
//          article.setPicurl("picurl"+i);
//          article.setUrl("url"+i);
//          news.getArticles().add(article);
//      }
//      kfResponse.setNews(news);
        //某個客服帳號來發訊息
//      KFResponse.CustomService customservice = kfResponse.new CustomService();
//      customservice.setKF_Account("[email protected]");
//      kfResponse.setCustomservice(customservice);
      System.out.println(">>>"+customServiceService.sendMessageByKF(kfResponse));
    }
}

#

在公眾平臺網站上，為訂閱號提供了每天一條的群發許可權，為服務號提供每月（自然月）4條的群發許可權。而對於某些具備開發能力的公眾號運營者，可以通過高階群發介面，實現更靈活的群發能力。

/*
 * 根據標籤進行群發【訂閱號與服務號認證後均可用】
 * https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140549&token=&lang=zh_CN
 */
public class MassSendResponse {

    private String  msgtype;    //群發的訊息型別，
    private Filter  filter;     //用於設定圖文訊息的接收者
    private String  previewUser;//用於設定圖文訊息的接收者
    private List<String> touser;//填寫圖文訊息的接收者，一串OpenID列表，OpenID最少2個，最多10000個
    private MPNews  mpnews;     //圖文訊息（注意圖文訊息的media_id需要通過上述方法來得到）：
    private MPVideo mpvideo;    //此處視訊的media_id需通過POST請求WeChatInterface.uploadVideo的返回結果獲得
    private Text    text;       //文字
    private Voice   voice;      //語音（注意此處media_id需通過基礎支援中的上傳下載多媒體檔案來得到）：
    private Image   image;      //圖片（注意此處media_id需通過基礎支援中的上傳下載多媒體檔案來得到）：
    private WXCard  wxcard;     //卡券訊息（注意圖文訊息的media_id需要通過上述方法來得到）

    public String getMsgtype() {
        return msgtype;
    }
    public void setMsgtype(String msgtype) {
        this.msgtype = msgtype;
    }

    public Filter getFilter() {
        return filter;
    }
    public void setFilter(Filter filter) {
        this.filter = filter;
    }

    public MPNews getMpnews() {
        return mpnews;
    }
    public void setMpnews(MPNews mpnews) {
        this.mpnews = mpnews;
    }

    public MPVideo getMpvideo() {
        return mpvideo;
    }
    public void setMpvideo(MPVideo mpvideo) {
        this.mpvideo = mpvideo;
    }

    public Text getText() {
        return text;
    }
    public void setText(Text text) {
        this.text = text;
    }

    public Voice getVoice() {
        return voice;
    }
    public void setVoice(Voice voice) {
        this.voice = voice;
    }

    public Image getImage() {
        return image;
    }
    public void setImage(Image image) {
        this.image = image;
    }

    public WXCard getWxcard() {
        return wxcard;
    }
    public void setWxcard(WXCard wxcard) {
        this.wxcard = wxcard;
    }

    public List<String> getTouser() {
        if(touser==null) touser= new ArrayList<String>();
        return touser;
    }
    public void setTouser(List<String> touser) {
        this.touser = touser;
    }

    public String getPreviewUser() {
        return previewUser;
    }
    public void setPreviewUser(String previewUser) {
        this.previewUser = previewUser;
    }

    public class Filter{
        private boolean is_to_all;  //用於設定是否向全部使用者傳送，值為true或false，選擇true該訊息群發給所有使用者，選擇false可根據tag_id傳送給指定群組的使用者
        private String group_id;    //群發到的分組的group_id.若is_to_all值為true，可不填寫group_id 

        public boolean getIs_to_all() {
            return is_to_all;
        }
        public void setIs_to_all(boolean is_to_all) {
            this.is_to_all = is_to_all;
        }

        public String getGroup_id() {
            return group_id;
        }
        public void setGroup_id(String group_id) {
            this.group_id = group_id;
        }
    }

    public class MPNews{
        private String media_id;    //用於群發的訊息的media_id

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

    public class MPVideo{
        private String media_id;

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

    public class Text{
        private String content;

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

    public class Voice{
        private String media_id;

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

    public class Image{
        private String media_id;

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

    public class WXCard{
        private String media_id;

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

@RunWith(SpringJUnit4ClassRunner.class)        // 表示繼承了 SpringJUnit4ClassRunner 類
@ContextConfiguration("classpath:spring-mybatis.xml")
public class TestWXMassSendMsg {

    @Resource   
    private MassSendMsgService massSendMsgService;

//  @Test
    public void getUrlByUploadImg() {
        //curl: (60) SSL certificate problem: unable to get local issuer certificate   請檢視 Remark第五條
  System.out.println(">>>"+massSendMsgService.getUrlByUploadImg("D:/test/test.jpg"));
    }

//  @Test
    public void getVideoMediaIdMassMsg() {
        Material massMsg = new Material();
        massMsg.setMedia_id(WeChatCertificate.VIDEO_MEDIAID);
        massMsg.setTitle("title");
        massMsg.setDescription("description");
  System.out.println(">>>"+massSendMsgService.getVideoMediaIdMassMsg(massMsg));
    }

//  @Test
    public void uploadNews() {
        Material mass = new Material();
        for(int i=0; i<1; i++) {
            Material.Article article = mass.new Article();
            article.setThumb_media_id(WeChatCertificate.THUMB_MEDIA_ID);
            article.setAuthor("Author"+i);
            article.setTitle("Title"+i);
            article.setContent_source_url("www.baidu.com");
            article.setContent("Content"+i);
            article.setDigest("Digest"+i);
            article.setShow_cover_pic(article.SHOW);
            mass.getArticles().add(article);
        }
        System.out.println(">>>"+massSendMsgService.uploadNews(mass));
    }

//  @Test
    public void massMsgByPacket() {
        MassSendResponse mass = new MassSendResponse();
        mass.setMsgtype("mpnews");
        MassSendResponse.Filter filter = mass.new Filter();
        filter.setIs_to_all(false);
        filter.setGroup_id("101");
        mass.setFilter(filter);
        MassSendResponse.MPNews mpnews = mass.new MPNews();
        mpnews.setMedia_id(WeChatCertificate.NEWS_ID);
        mass.setMpnews(mpnews);
      System.out.println(">>>"+massSendMsgService.massMsgByPacket(mass));
    }

//  @Test
    public void massMsgByOpenID() {
        MassSendResponse mass = new MassSendResponse();
        mass.setMsgtype("mpnews");
        mass.getTouser().add(WeChatCertificate.OPENID1);
        mass.getTouser().add(WeChatCertificate.OPENID2);
        MassSendResponse.MPNews mpnews = mass.new MPNews();
        mpnews.setMedia_id(WeChatCertificate.NEWS_ID);
        mass.setMpnews(mpnews);
      System.out.println(">>>"+massSendMsgService.massMsgByOpenID(mass));
    }

//  @Test
    public void deleteMassMsg() {
        Material mass = new Material();
        mass.setMsg_id(WeChatCertificate.MSG_ID);
      System.out.println(">>>"+massSendMsgService.deleteMassMsg(mass));
    }

//  @Test
    public void previewMassMsg() {
        MassSendResponse mass = new MassSendResponse(); 
        mass.setMsgtype("mpnews");
        mass.setPreviewUser(WeChatCertificate.OPENID1);
        MassSendResponse.MPNews mpnews = mass.new MPNews();
        mpnews.setMedia_id(WeChatCertificate.NEWS_ID);
        mass.setMpnews(mpnews);
      System.out.println(">>>"+massSendMsgService.previewMassMsg(mass));
    }

//  @Test
    public void getMassMsgStatus() {
        Material mass = new Material();
        mass.setMsg_id(WeChatCertificate.MSG_ID);
      System.out.println(">>>"+massSendMsgService.getMassMsgStatus(mass));
    }
}

模板訊息介面

模板訊息僅用於公眾號向用戶傳送重要的服務通知，只能用於符合其要求的服務場景中，如信用卡刷卡通知，商品購買成功通知等。不支援廣告等營銷類訊息以及其它所有可能對使用者造成騷擾的訊息。

/*
 * 模板訊息
 * http://mp.weixin.qq.com/wiki/17/304c1885ea66dbedf7dc170d84999a9d.html
 */
public class MessageModel {

    public String industry_id1;         //公眾號模板訊息所屬行業編號
    public String industry_id2;         //公眾號模板訊息所屬行業編號

    public String template_id_short;    //模板庫中模板的編號，有“TM**”和“OPENTMTM**”等形式

    public String template_id;          //公眾帳號下模板訊息ID

    public String touser;               //是 接收者openid
    public String url;                  //否 模板跳轉連結
    public String data;                 //是 模板資料

    public String getTouser() {
        return touser;
    }
    public void setTouser(String touser) {
        this.touser = touser;
    }

    public String getUrl() {
        return url;
    }
    public void setUrl(String url) {
        this.url = url;
    }

    public String getData() {
        return data;
    }
    public void setData(String data) {
        this.data = data;
    }

    public String getTemplate_id() {
        return template_id;
    }
    public void setTemplate_id(String template_id) {
        this.template_id = template_id;
    }

    public String getTemplate_id_short() {
        return template_id_short;
    }
    public void setTemplate_id_short(String template_id_short) {
        this.template_id_short = template_id_short;
    }
    public String getIndustry_id1() {
        return industry_id1;
    }
    public void setIndustry_id1(String industry_id1) {
        this.industry_id1 = industry_id1;
    }

    public String getIndustry_id2() {
        return industry_id2;
    }
    public void setIndustry_id2(String industry_id2) {
        this.industry_id2 = industry_id2;
    }
}

@RunWith(SpringJUnit4ClassRunner.class)        // 表示繼承了 SpringJUnit4ClassRunner 類
@ContextConfiguration("classpath:spring-mybatis.xml")
public class TestWXMsgModel {

    @Resource   
    private MsgModelService msgModelService;

//  @Test
    public void setIndustry() {
        MessageModel industry = new MessageModel();
        industry.setIndustry_id1("2");
        industry.setIndustry_id2("31");
        System.out.println(">>>"+msgModelService.setIndustry(industry));
    }

//  @Test
    public void getIndustry() {
        System.out.println(">>>"+msgModelService.getIndustry());
    }

//  @Test
    public void getIdByaddTemplate() {
        MessageModel model = new MessageModel();
        model.setTemplate_id_short("TM00015");
      System.out.println(">>>"+msgModelService.getIdByaddTemplate(model));
    }

//  @Test
    public void deleteTemplate() {
        MessageModel model = new MessageModel();
        model.setTemplate_id(WeChatCertificate.MODELID);
        System.out.println(">>>"+msgModelService.deleteTemplate(model));
    }

//  @Test
    public void getAllTemplate() {
        System.out.println(">>>"+msgModelService.getAllTemplate());
    }

//  @Test
    public void sendTemplate() {
        MessageModel model = new MessageModel();
        model.setTouser(WeChatCertificate.OPENID2);
        model.setTemplate_id(WeChatCertificate.MODELID);
        model.setUrl("http://www.baidu.com");
        System.out.println(">>>"+msgModelService.sendTemplate(model));
    }
}

微信開發六傳送訊息（客服/群發/模板）

客服介面

#

模板訊息介面

微信開發六傳送訊息（客服/群發/模板）

微信開發之傳送訊息介面

EasyWeChat微信開發平臺第三方接入（Laravel5+，EasyWeChat3.0）

Python && 微信企業號傳送訊息指令碼

PHP實現微信開發中提現功能（企業付款到使用者零錢）

java之微信開發回覆圖片訊息

java 微信開發常用工具類（xml傳輸和解析 json轉換物件）

微信公眾平臺傳送訊息-群發介面

微信開發一伺服器地址（URL）、令牌（Token）配置

向微信公眾號傳送訊息

微信公眾號傳送訊息給使用者 php

微信小程序之初探（常見語法 VS vue）常見問題（點擊不生效，數據綁定）

微信小程序基礎操作（邊做邊學）

php5.6 微信退款回撥處理（AES-256-ECB+PKCS7Padding）

微信公眾號接入第三方平臺客服系統的操作步驟：

微信自定義分享連結（設定標題+簡介+圖片）

微信公眾平臺—使用者管理（獲取使用者基本資訊）

微信一鍵啟用會員卡（跳轉外鏈）

微信公眾號和公眾號客服系統有什麽區別,要怎麽綁定？

微信點餐系統感悟（上1-6章）

微信開發六 傳送訊息（客服/群發/模板）

客服介面

#

模板訊息介面

相關推薦

微信開發六傳送訊息（客服/群發/模板）