wx-tools 消息相關(guān)API

2023-03-22 17:20 更新

包括如下接口:
- sendAllByTag - 群發(fā)-通過標簽
- sendAllByOpenid - 群發(fā)-通過openid
- sendAllPreview - 群發(fā)預(yù)覽
- sendAllDelete - 刪除群發(fā)
- sendAllGetStatus - 查詢?nèi)喊l(fā)狀態(tài)
- templateSetIndustry - 設(shè)置模板行業(yè)
- templateGetIndustry - 查詢模板行業(yè)
- templateGetId - 獲取模板ID
- templateGetList - 獲取模板列表
- templateDelete - 刪除模板
- templateSend - 發(fā)送模板

3.4.1 sendAllByTag 通過用戶標簽來群發(fā)

  1. WxTagSender sender = new WxTagSender();
  2. //設(shè)置哪些組需要接受群發(fā)
  3. sender.setFilter(new SenderFilter(true, 1));
  4. //群發(fā)文本內(nèi)容
  5. sender.setText(new Text("文本內(nèi)容"));
  6. try {
  7. SenderResult result = iService.sendAllByTag(sender);
  8. System.out.println(result.toString());
  9. } catch (WxErrorException e) {
  10. e.printStackTrace();
  11. }

如果發(fā)其他類型的消息:

  1. //群發(fā)圖片,以此類推
  2. sender.setImage(new Media("media_id"));

3.4.2 sendAllByOpenid 針對某群人的openid群發(fā)

  1. WxOpenidSender sender = new WxOpenidSender();
  2. List<String> openidList = new ArrayList<>();
  3. openidList.add("openid1");
  4. openidList.add("openid2");
  5. sender.setTouser(openidList);
  6. //群發(fā)文本內(nèi)容
  7. sender.setText(new Text("文本內(nèi)容"));
  8. try {
  9. SenderResult result = iService.sendAllByOpenid(sender);
  10. System.out.println(result.toString());
  11. } catch (WxErrorException e) {
  12. e.printStackTrace();
  13. }

3.4.3 sendAllPreview 群發(fā)預(yù)覽

  1. PreviewSender sender = new PreviewSender();
  2. //設(shè)置openid或者微信號,優(yōu)先級為wxname高
  3. sender.setTouser("openid");
  4. sender.setTowxname("微信號");
  5. //群發(fā)文本內(nèi)容
  6. sender.setText(new Text("文本內(nèi)容"));
  7. try {
  8. SenderResult result = iService.sendAllPreview(sender);
  9. System.out.println(result.toString());
  10. } catch (WxErrorException e) {
  11. e.printStackTrace();
  12. }

3.4.4 sendAllDelete 刪除群發(fā)

  1. try {
  2. //msg_id參數(shù)在群發(fā)接口中返回
  3. SenderResult result = iService.sendAllDelete("msg_id");
  4. System.out.println(result.toString());
  5. } catch (WxErrorException e) {
  6. e.printStackTrace();
  7. }

3.4.5 sendAllGetStatus 獲取群發(fā)狀態(tài)

  1. try {
  2. SenderResult result = iService.sendAllGetStatus("msg_id");
  3. System.out.println(result.toString());
  4. } catch (WxErrorException e) {
  5. e.printStackTrace();
  6. }

3.4.6 templateSetIndustry 設(shè)置模板消息的行業(yè)

  1. //行業(yè)代碼參考官方文檔。
  2. try {
  3. iService.templateSetIndustry("1", "4");
  4. } catch (WxErrorException e) {
  5. // TODO Auto-generated catch block
  6. e.printStackTrace();
  7. }

3.4.7 templateGetIndustry獲取模板消息的行業(yè)設(shè)置

  1. try {
  2. IndustryResult result = iService.templateGetIndustry();
  3. System.out.println(result.getPrimary_industry());
  4. System.out.println(result.getSecondary_industry());
  5. } catch (WxErrorException e) {
  6. e.printStackTrace();
  7. }

3.4.8 templateGetId通過短ID獲取模板ID

  1. //模板庫中模板的編號,有“TM**”和“OPENTMTM**”等形式
  2. try {
  3. TemplateResult result = iService.templateGetId("template_id_short");
  4. System.out.println(result.toString());
  5. } catch (WxErrorException e) {
  6. e.printStackTrace();
  7. }

3.4.9 templateGetList 獲取模板列表

  1. try {
  2. TemplateListResult result = iService.templateGetList();
  3. System.out.println(result.toString());
  4. } catch (WxErrorException e) {
  5. e.printStackTrace();
  6. }

3.4.10 templateDelete 刪除模板

  1. try {
  2. iService.templateDelete("template_id");
  3. } catch (WxErrorException e) {
  4. e.printStackTrace();
  5. }

3.4.11 templateSend 模板消息發(fā)送

  1. TemplateSender sender = new TemplateSender();
  2. sender.setTouser("openid");
  3. sender.setTemplate_id("templateId");
  4. sender.setData("Object:與模板內(nèi)容對應(yīng)的對象");
  5. sender.setUrl("url");
  6. try {
  7. TemplateSenderResult result = iService.templateSend(sender);
  8. System.out.println(result.toString());
  9. } catch (WxErrorException e) {
  10. e.printStackTrace();
  11. }

參數(shù)說明:

  • openid需要發(fā)送給哪個用戶
  • templateId 模板ID
  • Data: 假設(shè)模板格式中有三個字段,分別為:

    • first.DATA
    • keyword1.DATA
    • remark.DATA

    那么就需要創(chuàng)建一個類, 里面包含三個成員變量.如:

    public class Template{
    private String first;
    private String keyword1;
    private String remark;
    }

  • Url 點擊模板消息時跳轉(zhuǎn)的頁面.
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號