企业微信三方开发(四)：发送消息

￡神魔★判官ぃ 2023-02-26 06:22 66阅读 0赞

**其他链接**

[初识微信开发][Link 1]

[企业微信三方开发：注册企业微信服务商][Link 2]

[企业微信三方开发(一)：回调验证及重要参数获取][Link 3]

[企业微信三方开发(二)：获取access\_token][access_token]

[企业微信三方开发(三)：网页授权登录][Link 4]

[企业微信三方开发(四)：发送消息][Link 5]

[企业微信三方开发(五)：扫码登录][Link 6]

### 目录 ###

*  前言
 *  发送文字消息
 *   *  重要参数说明
     *   *  access\_token
         *  touser、toparty、totag
         *  agentid
     *  写MessageController
 *  总结

# 前言 #

1、应用可以向指定的员工（通过userid来指定）推送消息。

2、可以推送的消息有文字、图片、语音、视频、卡片这几种类型，这里以发送文字为例，其它消息类型的发送参考[官方接口][Link 7]。

3、再次强调一下，我们这里的后台目前仅是为了验证企业微信三方开发的逻辑，所以并未分层。所有请求接收和业务处理都在controller中完成，数据也都存在配置文件data.properties中。也未做必要逻辑判断和排错处理，以尽量使代码简洁清晰。请知悉！

# 发送文字消息 #

## 重要参数说明 ##

接口文档查看官方：https://work.weixin.qq.com/api/doc/90001/90143/90372  
这里捡几个总要参数说一下

### access\_token ###

access\_token就是我们在 [【企业微信三方开发(二)：获取access\_token】][access_token]中通过永久授权码获得的，保存在`data.properties`中。现在终于派上用场！（如若过期，请在请求一次）

需放在接口链接中。

### touser、toparty、totag ###

touser、toparty、totag分别表示向**哪个员工**发送消息、向**哪个部门**发送消息、向带**哪个标签**的员工发送消息。

三个参数都是id形式。多个id用 ‘|’ 分隔开。

三个参数都不是必须的，但至少填一个（不然发给谁？）

### agentid ###

还是在 [【企业微信三方开发(二)：获取access\_token】][access_token]中，进行永久授权时获取，放在`data.properties`的 **auth\_company** 中

注意 agentid 叫 **授权应用id**，只有通过企业授权才有，不同的企业授权agentid也不同。要与生成应用时的 **agentid(应用id)** 区分清！

## 写MessageController ##

还是新建个MessageController用于发送消息：  
![在这里插入图片描述][20200714163539756.png]  
具体代码：

package com.tan.cwp.controller;
    
    import com.tan.cwp.util.HttpHelper;
    import com.tan.cwp.util.PropertiesUtil;
    import org.json.JSONArray;
    import org.json.JSONException;
    import org.json.JSONObject;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    
    
    import java.io.IOException;
    
    @RestController
    @RequestMapping("/message")
    public class MessageController { 
        @RequestMapping(value = "sendtext.do" ,method = RequestMethod.POST)
        public static void sendTextMessage() throws JSONException, IOException { 
    
            // 在获取永久授权码存入的auth_company中获取agentid
            String companyInfo= PropertiesUtil.getProperty("auth_company");
            JSONObject companyInfoObj = new JSONObject(companyInfo);
            JSONArray agent = (JSONArray) ((JSONObject) companyInfoObj.get("auth_info")).get("agent");
            Object agentid = agent.getJSONObject(0).get("agentid");
    
            System.out.println(agentid);
    
            // 发送给指定user
            String userid = (String) ((JSONObject) companyInfoObj.get("auth_user_info")).get("userid");
    
    
            JSONObject jsonParms = new JSONObject();
    
            // touser、toparty、totag不能同时为空！
            // 成员ID列表,指定接收消息的成员（多个接收者用‘|’分隔)
            jsonParms.put("touser", userid);
            // 部门ID列表,指定接收消息的部门
            //jsonParms.put("toparty", "");
            // 标签ID列表,指定接收消息的标签
            //jsonParms.put("totag", "");
    
            jsonParms.put("msgtype", "text");
            jsonParms.put("agentid", agentid);
    
            // 发送的文本消息
            String text = "哈哈你收到我的文字消息了，请访问<a href=\"http://www.baidu.com\">我们的主页</a>";
            JSONObject textJson = new JSONObject();
            textJson.put("content",text);
            jsonParms.put("text", textJson);
    
            String url = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=";
            String access_token = PropertiesUtil.getProperty("access_token");
            url += access_token;
    
            JSONObject jsonObj = HttpHelper.doPost(url,jsonParms);
        }
    
    
    }

> 注意，touser这里是写死的，这里我用授权安装应用时授权人的userid（也就是我自己）

保存运行，并用postman访问：  
![在这里插入图片描述][20200714165431383.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1lORVdB_size_16_color_FFFFFF_t_70]

> 成功收到消息！

# 总结 #

自此，发送文本消息已经打通。接下来可以试着发送下其它类型消息。

[Link 1]: https://blog.csdn.net/YNEWA/article/details/106499467
[Link 2]: https://blog.csdn.net/YNEWA/article/details/106555178
[Link 3]: https://blog.csdn.net/YNEWA/article/details/106784137
[access_token]: https://blog.csdn.net/YNEWA/article/details/106885604
[Link 4]: https://blog.csdn.net/YNEWA/article/details/106949281
[Link 5]: https://blog.csdn.net/YNEWA/article/details/107340385
[Link 6]: https://blog.csdn.net/YNEWA/article/details/107381341
[Link 7]: https://work.weixin.qq.com/api/doc/90001/90143/90372
[20200714163539756.png]: /images/20230209/db5742c479a74796b05656b7ce9ecff7.png
[20200714165431383.png]: /images/20230209/3d7a4c41920649cc90ca79d5ebcf6bdc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1lORVdB_size_16_color_FFFFFF_t_70]: /images/20230209/38c7e6a2bcc04a619c8e25e06bfa60cc.png