企业微信发送应用消息

已于 2022-03-01 11:32:43 修改
阅读量2.5k 收藏 10
点赞数
分类专栏： 后端 # 微信 文章标签： 微信 微信小程序 小程序
于 2022-03-01 11:26:58 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_46114643/article/details/123188360
版权

文章目录

前言

企业微信开放了消息发送接口，企业可以使用这些接口让自定义应用与企业微信后台或用户间进行双向通信。
消息接口总体上分为主动发送单聊消息、接收单聊消息以及发送消息到群三部分：

  • 主动发送应用消息：企业后台调用接口通过应用向指定成员发送单聊消息
  • 接收消息：企业后台接收来自成员的消息或事件 要使用接收消息，需要在应用中设置开发者的回调服务器配置。 接收消息分为两种：1. 成员在应用客户端里发送的消息；2. 某种条件下触发的事件消息。
  • 开发者后台在接收消息后，可以在响应的返回包里带上回复消息，企业微信会将这条消息推送给成员。这就是“被动回复消息”。
  • 发送消息到群聊会话：企业后台调用接口创建群聊后，可通过应用推送消息到群内。（暂不支持接收群聊消息）
    本章实现企业微信向企业用户主动发送应用文本消息。

一、应用消息接口定义

应用支持推送文本、图片、视频、文件、图文等类型。
请求方式：POST（HTTPS） 请求地址：
https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN
参数说明：access_token 必传，是调用接口的凭证

二、推送文本消息

1. 文本消息类型概述

前面写到，应用支持推送多种类型的消息，其实大同小异，这里我们实现推送文本消息。
首先，在 微信开发者中心服务端API 中有详细的开发指导，其中有他们提供的请求示例：

{
   "touser" : "UserID1|UserID2|UserID3",
   "toparty" : "PartyID1|PartyID2",
   "totag" : "TagID1 | TagID2",
   "msgtype" : "text",
   "agentid" : 1,
   "text" : {
       "content" : "你的快递已到，请携带工卡前往邮件中心领取。\n出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>，聪明避开排队。"
   },
   "safe":0,
   "enable_id_trans": 0,
   "enable_duplicate_check": 0,
   "duplicate_check_interval": 1800
}

参数说明：
在这里插入图片描述
了解了文本消息基本的内容就可以尝试开发了

2. 代码实现

2.1 实体类

2.1.1 消息基类 — BaseMessage
/**
 * FileName: BaseMessage
 * Author:   XH
 * Date:     2022/2/28 14:59
 * Description: 消息基类
 * History:
 */
package com.xh.wx.sendMessage.entity;

import lombok.Data;

/**
 * 〈一句话功能简述〉
 * 〈消息基类〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
@Data
public class BaseMessage {
    /**
     * 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。
     * 非必传
     * 特殊情况：指定为@all，则向该企业应用的全部成员发送
     * touser、toparty、totag不能同时为空。
     */
     private String touser;
    /**
     * 部门ID列表，多个接收者用‘|’分隔，最多支持100个。
     * 非必传
     * 当touser为@all时忽略本参数
     */
    private String toparty;
    /**
     * 标签ID列表，多个接收者用‘|’分隔，最多支持100个。
     * 非必传
     * 当touser为@all时忽略本参数
     */
    private String totag;
    /**
     * 消息类型
     * 必传
     */
    private String msgtype;
    /**
     * 企业应用的id。可在应用的设置页面查看
     * 必传
     */
    private int agentid;
}
2.1.2 文本消息 — Text、TextMessage

上面我们贴出了企业微信官方文档提供的关于文本消息请求的说明 我们可把整个 json 对象看做一个 java 对象，而在这个 json 对象中又包含一个 text 对象。（json中的对象用 { } 包裹起来，json 中的数组用 [ ] 包裹起来）
需注意 agentid、safe 为 int 型。于是可以把 text 看做一个 java 对象，这样 TextMessage 类组合了 Text 类，转 json 字符串的时候，就可以直接使用
String jsonTextMessage = gson.toJson(textMessage)
于是，我们开始对文本消息进行封装。

Text.java
/**
 * FileName: Text
 * Author:   XH
 * Date:     2022/2/28 15:10
 * Description: 消息
 * History:
 */
package com.xh.wx.sendMessage.entity;

import lombok.Data;

/**
 * 〈一句话功能简述〉
 * 〈文本〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
@Data
public class Text {
    /**
     * 消息内容，最长不超过2048个字节
     * 必传
     */
    private String content;
}
TextMessage.java
/**
 * FileName: TextMessage
 * Author:   XH
 * Date:     2022/2/28 15:11
 * Description: 文本消息
 * History:
 */
package com.xh.wx.sendMessage.entity;

import lombok.Data;

/**
 * 〈一句话功能简述〉
 * 〈文本消息〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
@Data
public class TextMessage extends BaseMessage{
    /**
     * 文本
     */
    private Text text;
    /**
     * 表示是否是保密消息，0表示否，1表示是，默认0
     */
    private int safe;

}

2.2 发送消息业务类 — SendMessageService

/**
 * FileName: SendMessageService
 * Author:   XH
 * Date:     2022/2/28 15:14
 * Description: 发送消息
 * History:
 */
package com.xh.wx.sendMessage.service;

import com.xh.wx.sendMessage.utils.WeiXinUtil;
import com.xh.wx.sendMessage.entity.BaseMessage;
import com.xh.wx.sendMessage.entity.Text;
import com.xh.wx.sendMessage.entity.TextMessage;
import com.google.gson.Gson;
import net.sf.json.JSONObject;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

/**
 * 〈一句话功能简述〉
 * 〈发送消息〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
@Component
public class SendMessageService {
	
    @Value("${qywx.agentid}")
    private String qyWxAgentId;
    @Value("${qywx.corpsecret}")
    private String qyWxCorpsecret;
    /**
	 * 应用消息接口的请求地址
	 */
    @Value("${qywx.sendMessage_url}")
    private String sendMessageUrl;

    /**
     *  文本消息
     * @param content 消息
     * @param touser 成员ID列表
     */
    public void testSendTextMessage(String touser, String content){
        //创建文本消息对象
        TextMessage message = new TextMessage();
        message.setTouser(touser);
        message.setMsgtype("text");
        Text text = new Text();
        text.setContent(content);
        message.setText(text);
        //发送消息
        sendMessage(message);
    }

    /**
    * 公共方法：发送消息
    * @param message
    */
    public void sendMessage(BaseMessage message){
		message.setAgentid(qyWxAgentId);
        // 获取 accessToken
        // 此处仅做示例，因为每日获取 accessToken 有次数限制，不建议每次调用消息接口就重新请求获取
        // 实际应用建议把查询到的 accessToken 存入缓存或者存入数据库中以便查询
        // 等待 accessToken 过期后再重新查询
        String accessToken = WeiXinUtil.getAccessToken(qyWxAgentId, qyWxCorpsecret).getToken();
         // 1.获取 json 字符串：将 message 对象转换为 json 字符串
         Gson gson = new Gson();
        // 使用 gson.toJson(message) 即可将 message 对象顺序转成 json
         String jsonMessage = gson.toJson(message);
         System.out.println("jsonTextMessage:"+jsonMessage);

         // 2.请求的 url
        sendMessageUrl = sendMessageUrl.replace("ACCESS_TOKEN", accessToken);

         // 3.调用接口，发送消息
         JSONObject jsonObject = WeiXinUtil.httpRequest(sendMessageUrl, "POST", jsonMessage);
         System.out.println("jsonObject:"+jsonObject.toString());

         // 4.错误消息处理
         if (null != jsonObject) {
             if (0 != jsonObject.getInt("errcode")) {
                 System.err.println("发送消息失败 errcode:"+jsonObject.getInt("errcode")+"， errmsg:"+jsonObject.getString("errmsg"));
             }
         }
    }
}

这里我使用读取配置文件的内容，加入后期改动的话会比较方便，这里看大家选择哪种咯～
配置文件：
在这里插入图片描述

2.3 工具类

MyX509TrustManager.java
/**
 * FileName: MyX509TrustManager
 * Author:   XH
 * Date:     2022/2/28 15:27
 * Description:
 * History:
 */
package com.xh.wx.sendMessage.util;

import javax.net.ssl.X509TrustManager;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;

/**
 * 〈一句话功能简述〉
 * 〈证书信任管理器（用于https请求） 〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
public class MyX509TrustManager implements X509TrustManager {
    @Override
    public void checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {
    }

    @Override
    public void checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {
    }

    @Override
    public X509Certificate[] getAcceptedIssuers() {
        return null;
    }
}
AccessToken.java
/**
 * FileName: TextMessage
 * Author:   XH
 * Date:     2022/2/28 15:11
 * Description: 文本消息
 * History:
 */
package com.xh.wx.sendMessage.util;

import lombok.Data;

/**
 * 〈一句话功能简述〉
 * 〈AccessToken〉
 *
 * @author XH
 * @create 2022/2/28
 * @since 1.0.0
 */
@Data
public class TextMessage extends BaseMessage{
   
    /**
     * 获取到的凭证
     */
    private String token;
    /**
     * 凭证有效时间，单位：秒
     */
    private int expiresIn;
}
WXUtil.java
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.ConnectException;
import java.net.URL;

import javax.net.ssl.HttpsURLConnection;
import javax.net.ssl.SSLContext;
import javax.net.ssl.SSLSocketFactory;
import javax.net.ssl.TrustManager;

import net.sf.json.JSONException;
import net.sf.json.JSONObject;

public class WeiXinUtil {
        //微信的请求url
        //获取access_token的接口地址（GET） 限200（次/天）
        public final static String access_token_url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpId}&corpsecret={corpsecret}";
        //获取jsapi_ticket的接口地址（GET） 限200（次/天）
        public final static String jsapi_ticket_url = "https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token=ACCESSTOKEN";

        /**
         * 1.发起https请求并获取结果
         *
         * @param requestUrl 请求地址
         * @param requestMethod 请求方式（GET、POST）
         * @param outputStr 提交的数据
         * @return JSONObject(通过JSONObject.get(key)的方式获取json对象的属性值)
         */
        public static JSONObject httpRequest(String requestUrl, String requestMethod, String outputStr) {
            JSONObject jsonObject = null;
            StringBuffer buffer = new StringBuffer();
            try {
                // 创建SSLContext对象，并使用我们指定的信任管理器初始化
                TrustManager[] tm = { new MyX509TrustManager() };
                SSLContext sslContext = SSLContext.getInstance("SSL", "SunJSSE");
                sslContext.init(null, tm, new java.security.SecureRandom());
                // 从上述SSLContext对象中得到SSLSocketFactory对象
                SSLSocketFactory ssf = sslContext.getSocketFactory();

                URL url = new URL(requestUrl);
                HttpsURLConnection httpUrlConn = (HttpsURLConnection) url.openConnection();
                httpUrlConn.setSSLSocketFactory(ssf);

                httpUrlConn.setDoOutput(true);
                httpUrlConn.setDoInput(true);
                httpUrlConn.setUseCaches(false);
                // 设置请求方式（GET/POST）
                httpUrlConn.setRequestMethod(requestMethod);

                if ("GET".equalsIgnoreCase(requestMethod))
                    httpUrlConn.connect();

                // 当有数据需要提交时
                if (null != outputStr) {
                    OutputStream outputStream = httpUrlConn.getOutputStream();
                    // 注意编码格式，防止中文乱码
                    outputStream.write(outputStr.getBytes("UTF-8"));
                    outputStream.close();
                }

                // 将返回的输入流转换成字符串
                InputStream inputStream = httpUrlConn.getInputStream();
                InputStreamReader inputStreamReader = new InputStreamReader(inputStream, "UTF-8");
                BufferedReader bufferedReader = new BufferedReader(inputStreamReader);

                String str = null;
                while ((str = bufferedReader.readLine()) != null) {
                    buffer.append(str);
                }
                bufferedReader.close();
                inputStreamReader.close();
                // 释放资源
                inputStream.close();
                inputStream = null;
                httpUrlConn.disconnect();
                jsonObject = JSONObject.fromObject(buffer.toString());
            } catch (ConnectException ce) {
                ce.printStackTrace();
            } catch (Exception e) {
                e.printStackTrace();
            }
            return jsonObject;
        }
       	/** 
         * 获取access_token 
         *  
         * @param appid 凭证 
         * @param appsecret 密钥 
         * @return 
         */  
        public static AccessToken getAccessToken(String appid, String appsecret) {  
            AccessToken accessToken = null;  

            String requestUrl = access_token_url.replace("{corpId}", appid).replace("{corpsecret}", appsecret);  
            JSONObject jsonObject = httpRequest(requestUrl, "GET", null);  
            // 如果请求成功  
            if (null != jsonObject) {  
                try {  
                    accessToken = new AccessToken();  
                    accessToken.setToken(jsonObject.getString("access_token"));  
                    accessToken.setExpiresIn(jsonObject.getInt("expires_in"));  
                } catch (JSONException e) {  
                    accessToken = null;  
                    // 获取token失败  
                    System.out.println("获取token失败 errcode:{} errmsg:{}"+jsonObject.getInt("errcode")+":"+ jsonObject.getString("errmsg"));  
                }  
            }  
            return accessToken;  
        }  
    }

2.4 发送消息

public class SendMessageTest {

    @Autowired
    SendMessageService sendMessageService;
    
    public void testSendTextMessage(){
        //0.设置消息内容
        String content="你的快递已到，请携带工卡前往邮件中心领取。\n出发前可查看" +
                "<a href=\"http://work.weixin.qq.com\">邮件中心视频实况" +
                "</a>，聪明避开排队。";
        // 企业微信消息推送
        // touser 可发送全部："@all"，也可填写人员的id
        sendMessageService.testSendTextMessage(touser, content);
    }

运行一下就可以收到消息了～～～
在这里插入图片描述

总结

以上就是全部的企业微信推送文本消息的内容了，其他的消息推送基本都差不多，由于后期改动了一些代码，如有异常麻烦大家提示我更正哈哈哈。
下面是参考引用的资料：
企业微信接口文档

沉默星河
关注
  • 0
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
企业微信之发送应用消息案例
hacker0825的博客
02-14 1982
企业微信消息发送开发步骤： 1、到企业微信官网注册企业用户 企业微信， 找到“立即注册”。 2、下载企业微信APP到手机 3、找到关键信息，AgentId、企业ID（CropID）、秘钥（Secret） ① AgentId，到“企业微信” -> "应用管理"->"自建"一个自己的要接受信息的应用 ->最上面会有“AgentId” ②CropID，到“企业微信” -> “我的企业” -> 最下面“企业ID” 或者 手机上的企业微信APP ->“工作台” -&gt
企业微信机器人发送消息
weixin_49278803的博客
02-21 985
企业微信外部接口、外部应用、企业微信机器人、企业微信交互、任务跟踪 、企业微信扫码登录
企业微信开发：接受消息和发送消息
2401_84103903的博客
04-09 629
点击这里即可获取，包括答案解析。讲解视频，并且会持续更新！**如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：前端）点击这里即可获取，包括答案解析。[外链图片转存中…(img-mA4oRJyV-1712592926646)]
Java对接企业微信发送应用消息
最新发布
kaoninian的博客
06-06 1163
Java对接企业微信发送应用消息和回调配置
消息推送（二）企业微信消息推送
Strawberry_ahh的博客
08-06 1787
企业微信消息推送 CorpID:企业ID AgentID:应用ID Secret:应用密钥 2、功能实现 3、方法调用 4、结果展示
在java项目中实现企业微信自建应用发送消息的基础方法
Snape2323的博客
05-05 3165
很多企业项目逐渐和企业微信连通，下面详细介绍一下Java语言实现企业微信自建应用发送消息的方法提示：以下是本篇文章正文内容，下面案例可供参考，可优化的地方很多，可以把“CorpID”和“Secret”写在配置文件中，写一个工具类获取access_token，因为每天获取access_token的次数有限，7200秒过期，所以要设置定时获取并存储，发送消息也可以封装成方法函数，在使用的时候调用更加灵活。
企业微信 消息推送,发送应用消息提醒
码小呆的博客
10-29 1万+
概述 企业微信提供了消息推送的功能，我需要的是发送应用消息，主要做的功能就是，提醒用户未打卡提醒，缺卡提醒等需求，先看看官方文档 企业微信开放了消息发送接口，企业可以使用这些接口让自定义应用与企业微信后台或用户间进行双向通信。 企业微信消息推送API 请大家一定要先仔细看看官方文档api： 接口概括 消息接口总体上分为主动发送单聊消息、接收单聊消息以及发送消息到群三部分 主动发送应用消息：企业后台调用接口通过应用向指定成员发送单聊消息 接收消息：企业后台接收来自成员的消息或事件 要使用接收消息，需要在应
java调用企业微信接口API发送消息(替代短信验证码的一种解决方案)
热门推荐
zxl782340680的博客
04-10 3万+
使用企业微信发送验证码文章采纳源地址：https://www.cnblogs.com/kuzaman/p/6564632.html使用微信发送验证码配置页面：以下步骤获取页面上的参数1、注册企业微信：注册网址：https://work.weixin.qq.com/...
Python实现企业微信机器人消息发送.rar
08-30
【Python实现企业微信机器人消息发送】 企业微信机器人是企业微信提供的一个强大功能，它允许开发者通过API接口向企业成员或指定的外部联系人发送各种类型的消息，如文本、Markdown格式和图文消息，从而实现自动化...
java实现企业微信消息推送
03-10
这个例子中，我们创建了一个JSON对象，包含了消息的目标用户、消息类型和内容，然后通过POST请求发送到企业微信服务器。 以上就是使用Java实现企业微信消息推送的主要步骤和知识点，实际开发中还需要根据具体业务...
java调用企业微信接口发送消息所需依赖.zip
05-09
java调用企业微信接口发送消息所需依赖 文章链接：https://blog.csdn.net/zxl782340680/article/details/79876502
labview发送企业微信消息
09-09
要使用LabVIEW发送消息到企业微信，首先你需要在企业微信开发者中心注册一个企业应用，并获取到对应的copid和copsecret。然后，你需要了解企业微信API的调用方式，通常包括HTTP请求或者使用SDK。在LabVIEW中，你可以...
C#最精简的微信企业号发送消息
03-20
首先，"C#最精简的微信企业号发送消息"这个标题暗示我们关注的是一个简单的C#程序，该程序可以向微信企业号发送消息。在微信企业号的API中，发送消息通常涉及到调用HTTP接口，通过POST请求将JSON格式的数据发送到...
C#企业微信发送文本消息，发送图片给指定人员
03-30
在本文中，我们将深入探讨如何使用C#编程语言在企业微信平台上实现文本消息和图片的发送功能。企业微信是一款高效的企业级通讯工具，允许开发者通过其开放API接口进行各种定制化开发，例如发送消息给指定的人员。...
企业微信发送消息.zip
05-12
企业微信是一款专为企业和组织设计的通讯与协作平台，它提供了丰富的API接口，使得开发者能够构建自定义的应用，实现各种自动化或定制化的消息发送功能。本文将深入探讨企业微信的API使用，特别是针对消息发送这一...
企业微信自建应用收发消息
qq_50761817的博客
04-18 949
企业微信实现自建应用获取消息，以及回复用户消息
SpringBoot集成企业微信自建应用消息
Blueeyedboy521的博客
06-19 1009
消息群发，是企业微信提供的用于企业向成员推送企业通知的工具，支持管理端手动发送以及API接口发送。支持的消息类型包含文本、图文、外链图文、音频、视频、图片。同时针对企业内的场景，企业微信还提供诸如消息自动回复设置、管理员可查看用户上行消息、素材库等功能。
【企业微信实现免密登录以及发送消息（企业内部应用）】
cocos2dx zzzzz
09-16 4179
企业微信实现免密登录以及消息推送
如何在go语言中向企业微信发送应用消息
07-16
在 Go 语言中向企业微信发送应用消息，你可以使用企业微信提供的应用消息接口来实现。以下是一个简单的示例代码： ```go package main import ( "bytes" "encoding/json" "fmt" "net/http" ) type WeChatMessage struct { ToUser string `json:"touser"` MsgType string `json:"msgtype"` AgentID int `json:"agentid"` Text struct { Content string `json:"content"` } `json:"text"` } func main() { apiURL := "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=YOUR_ACCESS_TOKEN" // 构建消息内容 message := WeChatMessage{ ToUser: "userid1|userid2", // 接收消息的用户，多个用户使用 | 分隔 MsgType: "text", // 消息类型为文本消息 AgentID: 1000001, // 企业微信应用的 AgentID Text: struct { Content string `json:"content"` }{ Content: "这是一条来自企业微信应用的消息", }, } // 将消息内容转换为 JSON 格式 messageData, err := json.Marshal(message) if err != nil { fmt.Println("JSON marshal error:", err) return } // 发送 POST 请求到企业微信的应用消息接口 resp, err := http.Post(apiURL, "application/json", bytes.NewReader(messageData)) if err != nil { fmt.Println("HTTP request error:", err) return } defer resp.Body.Close() // 处理响应结果 if resp.StatusCode != http.StatusOK { fmt.Println("API request failed:", resp.Status) return } fmt.Println("Message sent successfully!") } ``` 请注意，在上述代码中，你需要将 `YOUR_ACCESS_TOKEN` 替换为你的企业微信应用的访问令牌（Access Token）。你可以通过企业微信提供的接口获取访问令牌，并确保访问令牌是有效的。 此外，还需要替换 `userid1|userid2` 为接收消息的用户的 UserID，多个用户之间使用 `|` 分隔。你可以在企业微信后台管理界面查找和管理用户的 UserID。 以上代码仅提供了一个基本的示例，你可以根据自己的实际需求进行扩展和调整。注意保护好访问令牌的安全性，避免泄露给未授权的人员。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值