企业微信如何推送应用信息?
文章目录
- 前言
- 一、应用消息接口定义
- 二、推送文本消息
- 1. 文本消息类型概述
- 2. 代码实现
- 2.1 实体类
- 2.1.1 消息基类 --- BaseMessage
- 2.1.2 文本消息 --- Text、TextMessage
- Text.java
- TextMessage.java
- 2.2 发送消息业务类 --- SendMessageService
- 2.3 工具类
- MyX509TrustManager.java
- AccessToken.java
- WXUtil.java
- 2.4 发送消息
- 总结
前言
企业微信开放了消息发送接口,企业可以使用这些接口让自定义应用与企业微信后台或用户间进行双向通信。
消息接口总体上分为主动发送单聊消息、接收单聊消息以及发送消息到群三部分:
- 主动发送应用消息:企业后台调用接口通过应用向指定成员发送单聊消息
- 接收消息:企业后台接收来自成员的消息或事件 要使用接收消息,需要在应用中设置开发者的回调服务器配置。 接收消息分为两种: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);
}
运行一下就可以收到消息了~~~
总结
以上就是全部的企业微信推送文本消息的内容了,其他的消息推送基本都差不多,由于后期改动了一些代码,如有异常麻烦大家提示我更正哈哈哈。
下面是参考引用的资料:
企业微信接口文档
推荐阅读
-
[重磅商机】腾讯云开放【企业微信客服API】开发应用对接!
-
最佳实践|如何利用腾讯云微窗从0到1开发企业门户应用
-
最佳实践|如何利用腾讯云微窗从0到1开发企业门户应用
-
企业微信知识库:从了解到建立的全过程-|如何创建企业微信知识库
-
如何在 PHP 中实现微信公众号事件推送
-
如何使用 Vue 实现模仿微信语音信息的效果
-
如何办理经公证的企业微信主题变更?
-
反传销网8月30日发布:视频区块链里的骗子,币里的韭菜,杜子建骂人了!金融大V周召说区块链!——“一小帮骗子玩一大帮小白,被割韭菜,小白还轮流被割,割的就是你!” 什么区块链,统统是骗子 作者:周召(知乎金融领域大V,毕业于上海财经大学,目前任职上海某股权投资基金合伙人) 有人问我,区块链现在这么火,到底是不是骗局? 我的回答是: 是骗局。而且我并不是说数字货币是骗局,而是说所有搞区块链的都是骗局。 -01- 区块链是一种鸡肋技术 人类社会任何技术的发明应用,本质都是为了提高社会的生产效率。而所谓区块链技术本质不过是几种早已成熟的技术的大杂烩,冗余且十分低效,除了提高了洗钱和诈骗的效率以外,对人类社会的进步毫无贡献。 真正意义上的区块链得包含三个要素:分布式系统(包括记账和存储),无法篡改的数据结构,以及共识算法,三者互为基础和因果,就像三体世界一样。看上去挺让人不明觉厉的,而经过几年的瞎折腾,稍微懂点区块链的碰了几次壁后都已经渐渐明白区块链其实并没有什么卵用,区块链技术已经名存实亡,沦为了营销工具和传销组织的画皮。 因为符合上述定义的、以比特币为代表的原教旨区块链技术,是反效率的,从经济学角度来说,不但不是一种帕累托改进,甚至还可以说是一种帕累托倒退。 原教旨区块链技术的效率十分低下,因为要遍历所有节点,只能做非常轻量级的数据应用,一旦涉及到大量的数据传输与更新,区块链就瞎了。 一方面整条链交易速度会极慢,另一方面数据库容量极速膨胀,考虑到人手一份的存储机制,区块链其实是对存储资源和能源的一种极大的浪费。 这里还没有加上为了取得所谓的共识和挖矿消耗的巨大的能源,如果说区块链技术是屎,那么这波区块链投机浪潮可谓人类历史上最大规模的搅屎运动。 区块链也验证不了任何东西。 所谓的智能合约,即不智能,也非合约。我看有人还说,如果有了智能合约,就可以跟老板签一份放区块链上,如果明年销售业绩提升30%,就加薪10%,由于区块链不能篡改,不能抵赖,所以老板必须得执行,说得有板有眼,不懂行的愣一看,好像还真是那么回事。 但仔细一想,问题就来了。首先,在区块链上如何证明你真的达到了30%业绩提升?即便真的达到老板耍赖如何执行? 也就是说,如果区块链真这么厉害,要法院和仲裁干什么。 人类社会真正的符合成本效益原则的是代理制度。之前有人说要用区块链改造注册会计师行业,我不知道他准备怎么设计,我猜想他思路大概是这样的,首先肯定搞去中心化,让所有会计师到链上来,然后一个新人要成为注册会计师就要所有会计师同意并记录在链上。 那我就请问了,我每天上班累死累活,为什么还要花时间去验证一个跟我无关的的人的专业能力?最优做法当然是组织一个委员会,让专门的人来负责,这不就是现在注册会师协会干的事儿吗?区块链的逻辑相当于什么事情都要拿出来公投,这个绝对是扯淡的。 当然这么说都有点抬举区块链了,区块链技术本身根本没有判断是非能力,如果这么高级的人工智能,靠一个无脑分布式记账就能实现的话,我们早就进入共产主义社会了。 虽然EOS等数字货币采用了超级节点,通过再中心化的方式提高效率,有点行业协会的意思,是对区块链原教旨主义的一种修正,但是依然无法突破区块链技术最本质的局限性。有人说,私有链和联盟链是区块链技术的未来,也是扯淡,因为区块链技术没有未来。如果有,说明他是包装成区块链的伪区块链技术。 区块链所涉及的所有底层技术,不管是分布式数据库技术,加密技术,还是点对点传输技术等,基本都是早已存在没什么秘密可言的技术。 比特币系统最重要的特性是封闭性和自洽性,他验证不了任何系统自身以外产生的信息的真实性。 所谓系统自身产生的信息,就是数据库数据的变动信息,有价值的基本上有且只有交易信息。所以说比特币最初不过是中本聪一种炫技的产物,来证明自己对几种技术的掌握,你看我多牛逼,设计出了一个像三体一样的系统。因此,数字货币很有可能是区块链从始至终唯一的杀手应用。 比特币和区块链概念从诞生到今天已经快10年了,很多人说区块链技术在爆发的前夜,但这个前夜好像是不是有点过长了啊朋友,跟三体里的长夜有一拼啊。都说区块链技术像是90年代初的互联网,可是90年代初的互联网在十年发展后,已经出现了一大批伟大的公司,阿里巴巴在99年都成立了,区块链怎么除了币还是币呢? 正规的数字货币未来发展的形式无外乎几种,要么就是论坛币形式,或者类似股票的权益凭证等。问题是论坛币和股票之前,本来也都电子化了,区块链来了到底改变了什么呢? 所有想把TOKEN和应用场景结合起来的人最后都很痛苦,最后他们会发现区块链技术就是脱裤子放屁,自己辛苦搞半天,干嘛不自己作为中心关心门来收钱?最后这些人都产生了价值的虚无感,最终精神崩溃,只能发币疯狂收割韭菜,一边嘴里还说着我是个好人之类的奇怪的话。 因此,之前币圈链圈还泾渭分明,互相瞧不起,但这两年链圈逐渐坐不住了,想着是不是趁着泡沫没彻底破灭之前赶快收割一波,不然可能什么都捞不着了。 前段时间和一个名校毕业的链圈朋友瞎聊天,他说他们“致力于用区块链技术解决数字版权保护问题”,我就问他一个问题,你们如何保证你链的版权所有权声明是真实的,万一盗版者抢先一步把数据放在链上怎么办。他说他们的解决方案是连入国家数字版权保护中心的数据库进行验证…… 所以说区块链技术就是个鸡肋,研究到最后都会落入效率与真实性的黑洞,很多人一头扎进链圈后才发现,真正意义上的区块链技术,其实什么都干不了。 -02- 不是蠢就是坏的区块链媒体 空气币和区块链的造富神话,让区块链自媒体也开始迎风乱扭。一群群根本不知道区块链为何物的妖魔鬼怪纷纷进驻区块链自媒体战场,开始大放厥词胡编乱造。 任何东西,但凡只要和区块,链,分,分布式,记账,加密,验证,可追溯等等这些个关键词沾到哪怕一点点,这些所谓的区块链媒体人就会像狗闻到了屎了一样疯狂地把区块链概念往上套。 这让我想起曾经一度也是热闹非凡的物联网,我曾经去看过江苏一家号称要改变世界的“物联网”企业,过去一看是生产路由器的,我黑人问号脸,对方解释说没有路由器万物怎么互联,我觉得他说得好有道理,竟无言以对。 好,下面让我们进入奇葩共赏析时间,来看看区城链媒体经常有哪些危言耸听的奇谈怪论 区块链(分布式记账)的典型应用是*?? 正如前面所说,真正意义上的区块链分布式记账,不光包括“记”这个动作,还包括分布式存储和共识机制等。而*诞生远远早于区块链这个词的出现,勉强算是“分布式编辑”吧,就被很多区块链媒体拿来强行充当区块链技术应用的典范。 其实事实恰恰相反,*恰恰是去中心化失败的典范,现在如果没有精英和专业人士的编辑和维护,*早就没法看了。 区块链会促进社会分工?? 罗振宇好像就说过类似的话,虽然罗振宇说过很多没有逻辑的话,但这句话绝对是最没逻辑思维的。很多区块链自媒体也常常用这句话来忽悠老百姓,说分工代表效率提高社会进步,而区块链“无疑”会促进分工,他们的理由仅仅是分工和分布式记账都共用一个“分”字,就强行把他们扯到一起。 实际情况恰恰相反,区块链是逆分工的,区块链精神是号召所有人积极地参与到他不擅长也不想掺合的事情里面去。 区块链不能像上帝一样许诺他的子民死后上天国,只能给他们许诺你们是六度人脉中的第一级,我可以赚后面五级人的钱,你处于金字塔的顶端。
-
微信企业开发 [I] - 创建应用程序
-
视频会议场景中的空间音频--为何选择空间音频这一主题? 首先,为什么选择空间音频这一主题?我在视频会议领域工作了近二十年,我们的目标一直是让声音更清晰、视频更清晰。但在过去的 20 年中,视频会议的产品形态并没有发生本质的变化。去年元宇宙比较火,微软、Facebook都在做基于VR和元宇宙的企业协作研究,我们也进行了这方面的探索。 一开始,我们想从纯技术角度研究空间音频技术如何应用于视频会议场景,但在研究过程中,我们发现这是一个非常复杂的场景。因为视频会议本质上是人与人之间的交流。人与人之间的沟通是多维度的信息传递,声音、图像、眼神、肢体语言、触觉都是人与人之间沟通的要素,音频只是其中之一。本次分享从沟通与交流的角度,从视频会议的应用场景出发,分析视频会议产品需要什么样的空间音频技术以及如何实现。 02 空间音频与沉浸式交流