在Java中调企微机器人发送消息到群里

飞的肖2024-01-24 11:45

目录

如何使用群机器人

消息类型及数据格式

文本类型

markdown类型

图片类型

图文类型

文件类型

模版卡片类型

文本通知模版卡片

图文展示模版卡片

消息发送频率限制

文件上传接口

Java 执行语句

String url = "webhook的Url";

String result = HttpRequest.post(url)

.header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 Edg/118.0.2088.76")

.header("Content-Type", "application/json")

.body(json)

.execute().body();

摘自企微机器人开发说明

如何使用群机器人

特别特别要注意：一定要保护好机器人的webhook地址，避免泄漏！不要分享到github、博客等可被公开查阅的地方，否则坏人就可以用你的机器人来发垃圾消息了。

以下是用curl工具往群组推送文本消息的示例（注意要将url替换成你的机器人webhook地址，content必须是utf8编码）：

linenums 复制代码
  1. curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa' \
  2. -H 'Content-Type: application/json' \
  3. -d '
  4. {
  5. "msgtype": "text",
  6. "text": {
  7. "content": "hello world"
  8. }
  9. }'
  • 当前自定义机器人支持文本（text）、markdown（markdown）、图片（image）、图文（news）四种消息类型。
  • 机器人的text/markdown类型消息支持在content中使用<@userid>扩展语法来@群成员

消息类型及数据格式

文本类型

linenums 复制代码
  1. {
  2. "msgtype": "text",
  3. "text": {
  4. "content": "广州今日天气：29度，大部分多云，降雨概率：60%",
  5. "mentioned_list":["wangqing","@all"],
  6. "mentioned_mobile_list":["13800001111","@all"]
  7. }
  8. }
参数 是否必填 说明
msgtype 是 消息类型，此时固定为text
content 是 文本内容，最长不超过2048个字节，必须是utf8编码
mentioned_list 否 userid的列表，提醒群中的指定成员(@某个成员)，@all表示提醒所有人，如果开发者获取不到userid，可以使用mentioned_mobile_list
mentioned_mobile_list 否 手机号列表，提醒手机号对应的群成员(@某个成员)，@all表示提醒所有人

markdown类型

linenums 复制代码
  1. {
  2. "msgtype": "markdown",
  3. "markdown": {
  4. "content": "实时新增用户反馈<font color="warning">132例，请相关同事注意。\n

  5. 类型:<font color="comment">用户反馈

  6. 普通用户反馈:<font color="comment">117例

  7. VIP用户反馈:<font color="comment">15例"

  8. }
  9. }
参数 是否必填 说明
msgtype 是 消息类型，此时固定为markdown
content 是 markdown内容，最长不超过4096个字节，必须是utf8编码

目前支持的markdown语法是如下的子集：

  1. 标题 （支持1至6级标题，注意#与文字中间要有空格）

    linenums 复制代码

    1. 标题一

    2. 标题二

    3. 标题三

    4. 标题四

    5. 标题五
    6. 标题六

  2. 加粗

    linenums 复制代码
    1. bold

  3. 链接

    linenums 复制代码
    1. 这是一个链接

  4. 行内代码段（暂不支持跨行）

    linenums 复制代码
    1. code

  5. 引用

    linenums 复制代码

    1. 引用文字

  6. 字体颜色(只支持3种内置颜色)

    linenums 复制代码
    1. <font color="info">绿色
    2. <font color="comment">灰色
    3. <font color="warning">橙红色

图片类型

linenums 复制代码
  1. {
  2. "msgtype": "image",
  3. "image": {
  4. "base64": "DATA",
  5. "md5": "MD5"
  6. }
  7. }
参数 是否必填 说明
msgtype 是 消息类型，此时固定为image
base64 是 图片内容的base64编码
md5 是 图片内容（base64编码前）的md5值

注：图片（base64编码前）最大不能超过2M，支持JPG,PNG格式

图文类型

linenums 复制代码
  1. {
  2. "msgtype": "news",
  3. "news": {
  4. "articles" : [
  5. {
  6. "title" : "中秋节礼品领取",
  7. "description" : "今年中秋节公司有豪礼相送",
  8. "url" : "www.qq.com",
  9. "picurl" : "http://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png"
  10. }
  11. ]
  12. }
  13. }
参数 是否必填 说明
msgtype 是 消息类型，此时固定为news
articles 是 图文消息，一个图文消息支持1到8条图文
title 是 标题，不超过128个字节，超过会自动截断
description 否 描述，不超过512个字节，超过会自动截断
url 是 点击后跳转的链接。
picurl 否 图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图 1068*455，小图150*150。

文件类型

linenums 复制代码
  1. {
  2. "msgtype": "file",
  3. "file": {
  4. "media_id": "3a8asd892asd8asd"
  5. }
  6. }
参数 是否必填 说明
msgtype 是 消息类型，此时固定为file
media_id 是 文件id，通过下文的文件上传接口获取

模版卡片类型

文本通知模版卡片
linenums 复制代码
  1. {
  2. "msgtype":"template_card",
  3. "template_card":{
  4. "card_type":"text_notice",
  5. "source":{
  6. "icon_url":"https://wework.qpic.cn/wwpic/252813_jOfDHtcISzuodLa_1629280209/0",
  7. "desc":"企业微信",
  8. "desc_color":0
  9. },
  10. "main_title":{
  11. "title":"欢迎使用企业微信",
  12. "desc":"您的好友正在邀请您加入企业微信"
  13. },
  14. "emphasis_content":{
  15. "title":"100",
  16. "desc":"数据含义"
  17. },
  18. "quote_area":{
  19. "type":1,
  20. "url":"https://work.weixin.qq.com/?from=openApi",
  21. "appid":"APPID",
  22. "pagepath":"PAGEPATH",
  23. "title":"引用文本标题",
  24. "quote_text":"Jack：企业微信真的很好用~\nBalian：超级好的一款软件！"
  25. },
  26. "sub_title_text":"下载企业微信还能抢红包！",
  27. "horizontal_content_list":[
  28. {
  29. "keyname":"邀请人",
  30. "value":"张三"
  31. },
  32. {
  33. "keyname":"企微官网",
  34. "value":"点击访问",
  35. "type":1,
  36. "url":"https://work.weixin.qq.com/?from=openApi"
  37. },
  38. {
  39. "keyname":"企微下载",
  40. "value":"企业微信.apk",
  41. "type":2,
  42. "media_id":"MEDIAID"
  43. }
  44. ],
  45. "jump_list":[
  46. {
  47. "type":1,
  48. "url":"https://work.weixin.qq.com/?from=openApi",
  49. "title":"企业微信官网"
  50. },
  51. {
  52. "type":2,
  53. "appid":"APPID",
  54. "pagepath":"PAGEPATH",
  55. "title":"跳转小程序"
  56. }
  57. ],
  58. "card_action":{
  59. "type":1,
  60. "url":"https://work.weixin.qq.com/?from=openApi",
  61. "appid":"APPID",
  62. "pagepath":"PAGEPATH"
  63. }
  64. }
  65. }

请求参数

参数 类型 必须 说明
msgtype String 是 消息类型，此时的消息类型固定为template_card
template_card Object 是 具体的模版卡片参数

template_card的参数说明

参数 类型 必须 说明
card_type String 是 模版卡片的模版类型，文本通知模版卡片的类型为text_notice
source Object 否 卡片来源样式信息，不需要来源样式可不填写
source.icon_url String 否 来源图片的url
source.desc String 否 来源图片的描述，建议不超过13个字
source.desc_color Int 否 来源文字的颜色，目前支持：0(默认) 灰色，1 黑色，2 红色，3 绿色
main_title Object 是 模版卡片的主要内容，包括一级标题和标题辅助信息
main_title.title String 否 一级标题，建议不超过26个字。模版卡片主要内容的一级标题main_title.title和二级普通文本sub_title_text必须有一项填写
main_title.desc String 否 标题辅助信息，建议不超过30个字
emphasis_content Object 否 关键数据样式
emphasis_content.title String 否 关键数据样式的数据内容，建议不超过10个字
emphasis_content.desc String 否 关键数据样式的数据描述内容，建议不超过15个字
quote_area Object 否 引用文献样式，建议不与关键数据共用
quote_area.type Int 否 引用文献样式区域点击事件，0或不填代表没有点击事件，1 代表跳转url，2 代表跳转小程序
quote_area.url String 否 点击跳转的url，quote_area.type是1时必填
quote_area.appid String 否 点击跳转的小程序的appid，quote_area.type是2时必填
quote_area.pagepath String 否 点击跳转的小程序的pagepath，quote_area.type是2时选填
quote_area.title String 否 引用文献样式的标题
quote_area.quote_text String 否 引用文献样式的引用文案
sub_title_text String 否 二级普通文本，建议不超过112个字。模版卡片主要内容的一级标题main_title.title和二级普通文本sub_title_text必须有一项填写
horizontal_content_list Object[] 否 二级标题+文本列表，该字段可为空数组，但有数据的话需确认对应字段是否必填，列表长度不超过6
horizontal_content_list.type Int 否 链接类型，0或不填代表是普通文本，1 代表跳转url，2 代表下载附件，3 代表@员工
horizontal_content_list.keyname String 是 二级标题，建议不超过5个字
horizontal_content_list.value String 否 二级文本，如果horizontal_content_list.type是2，该字段代表文件名称（要包含文件类型），建议不超过26个字
horizontal_content_list.url String 否 链接跳转的url，horizontal_content_list.type是1时必填
horizontal_content_list.media_id String 否 附件的media_id，horizontal_content_list.type是2时必填
horizontal_content_list.userid String 否 被@的成员的userid，horizontal_content_list.type是3时必填
jump_list Object[] 否 跳转指引样式的列表，该字段可为空数组，但有数据的话需确认对应字段是否必填，列表长度不超过3
jump_list.type Int 否 跳转链接类型，0或不填代表不是链接，1 代表跳转url，2 代表跳转小程序
jump_list.title String 是 跳转链接样式的文案内容，建议不超过13个字
jump_list.url String 否 跳转链接的url，jump_list.type是1时必填
jump_list.appid String 否 跳转链接的小程序的appid，jump_list.type是2时必填
jump_list.pagepath String 否 跳转链接的小程序的pagepath，jump_list.type是2时选填
card_action Object 是 整体卡片的点击跳转事件，text_notice模版卡片中该字段为必填项
card_action.type Int 是 卡片跳转类型，1 代表跳转url，2 代表打开小程序。text_notice模版卡片中该字段取值范围为[1,2]
card_action.url String 否 跳转事件的url，card_action.type是1时必填
card_action.appid String 否 跳转事件的小程序的appid，card_action.type是2时必填
card_action.pagepath String 否 跳转事件的小程序的pagepath，card_action.type是2时选填
图文展示模版卡片
linenums 复制代码
  1. {
  2. "msgtype":"template_card",
  3. "template_card":{
  4. "card_type":"news_notice",
  5. "source":{
  6. "icon_url":"https://wework.qpic.cn/wwpic/252813_jOfDHtcISzuodLa_1629280209/0",
  7. "desc":"企业微信",
  8. "desc_color":0
  9. },
  10. "main_title":{
  11. "title":"欢迎使用企业微信",
  12. "desc":"您的好友正在邀请您加入企业微信"
  13. },
  14. "card_image":{
  15. "url":"https://wework.qpic.cn/wwpic/354393_4zpkKXd7SrGMvfg_1629280616/0",
  16. "aspect_ratio":2.25
  17. },
  18. "image_text_area":{
  19. "type":1,
  20. "url":"https://work.weixin.qq.com",
  21. "title":"欢迎使用企业微信",
  22. "desc":"您的好友正在邀请您加入企业微信",
  23. "image_url":"https://wework.qpic.cn/wwpic/354393_4zpkKXd7SrGMvfg_1629280616/0"
  24. },
  25. "quote_area":{
  26. "type":1,
  27. "url":"https://work.weixin.qq.com/?from=openApi",
  28. "appid":"APPID",
  29. "pagepath":"PAGEPATH",
  30. "title":"引用文本标题",
  31. "quote_text":"Jack：企业微信真的很好用~\nBalian：超级好的一款软件！"
  32. },
  33. "vertical_content_list":[
  34. {
  35. "title":"惊喜红包等你来拿",
  36. "desc":"下载企业微信还能抢红包！"
  37. }
  38. ],
  39. "horizontal_content_list":[
  40. {
  41. "keyname":"邀请人",
  42. "value":"张三"
  43. },
  44. {
  45. "keyname":"企微官网",
  46. "value":"点击访问",
  47. "type":1,
  48. "url":"https://work.weixin.qq.com/?from=openApi"
  49. },
  50. {
  51. "keyname":"企微下载",
  52. "value":"企业微信.apk",
  53. "type":2,
  54. "media_id":"MEDIAID"
  55. }
  56. ],
  57. "jump_list":[
  58. {
  59. "type":1,
  60. "url":"https://work.weixin.qq.com/?from=openApi",
  61. "title":"企业微信官网"
  62. },
  63. {
  64. "type":2,
  65. "appid":"APPID",
  66. "pagepath":"PAGEPATH",
  67. "title":"跳转小程序"
  68. }
  69. ],
  70. "card_action":{
  71. "type":1,
  72. "url":"https://work.weixin.qq.com/?from=openApi",
  73. "appid":"APPID",
  74. "pagepath":"PAGEPATH"
  75. }
  76. }
  77. }

请求参数

参数 类型 必须 说明
msgtype String 是 模版卡片的消息类型为template_card
template_card Object 是 具体的模版卡片参数

template_card的参数说明

参数 类型 必须 说明
card_type String 是 模版卡片的模版类型，图文展示模版卡片的类型为news_notice
source Object 否 卡片来源样式信息，不需要来源样式可不填写
source.icon_url String 否 来源图片的url
source.desc String 否 来源图片的描述，建议不超过13个字
source.desc_color Int 否 来源文字的颜色，目前支持：0(默认) 灰色，1 黑色，2 红色，3 绿色
main_title Object 是 模版卡片的主要内容，包括一级标题和标题辅助信息
main_title.title String 是 一级标题，建议不超过26个字
main_title.desc String 否 标题辅助信息，建议不超过30个字
card_image Object 是 图片样式
card_image.url String 是 图片的url
card_image.aspect_ratio Float 否 图片的宽高比，宽高比要小于2.25，大于1.3，不填该参数默认1.3
image_text_area Object 否 左图右文样式
image_text_area.type Int 否 左图右文样式区域点击事件，0或不填代表没有点击事件，1 代表跳转url，2 代表跳转小程序
image_text_area.url String 否 点击跳转的url，image_text_area.type是1时必填
image_text_area.appid String 否 点击跳转的小程序的appid，必须是与当前应用关联的小程序，image_text_area.type是2时必填
image_text_area.pagepath String 否 点击跳转的小程序的pagepath，image_text_area.type是2时选填
image_text_area.title String 否 左图右文样式的标题
image_text_area.desc String 否 左图右文样式的描述
image_text_area.image_url String 是 左图右文样式的图片url
quote_area Object 否 引用文献样式，建议不与关键数据共用
quote_area.type Int 否 引用文献样式区域点击事件，0或不填代表没有点击事件，1 代表跳转url，2 代表跳转小程序
quote_area.url String 否 点击跳转的url，quote_area.type是1时必填
quote_area.appid String 否 点击跳转的小程序的appid，quote_area.type是2时必填
quote_area.pagepath String 否 点击跳转的小程序的pagepath，quote_area.type是2时选填
quote_area.title String 否 引用文献样式的标题
quote_area.quote_text String 否 引用文献样式的引用文案
vertical_content_list Object[] 否 卡片二级垂直内容，该字段可为空数组，但有数据的话需确认对应字段是否必填，列表长度不超过4
vertical_content_list.title String 是 卡片二级标题，建议不超过26个字
vertical_content_list.desc String 否 二级普通文本，建议不超过112个字
horizontal_content_list Object[] 否 二级标题+文本列表，该字段可为空数组，但有数据的话需确认对应字段是否必填，列表长度不超过6
horizontal_content_list.type Int 否 模版卡片的二级标题信息内容支持的类型，1是url，2是文件附件
horizontal_content_list.keyname String 是 二级标题，建议不超过5个字
horizontal_content_list.value String 否 二级文本，如果horizontal_content_list.type是2，该字段代表文件名称（要包含文件类型），建议不超过26个字
horizontal_content_list.url String 否 链接跳转的url，horizontal_content_list.type是1时必填
horizontal_content_list.media_id String 否 附件的media_id，horizontal_content_list.type是2时必填
jump_list Object[] 否 跳转指引样式的列表，该字段可为空数组，但有数据的话需确认对应字段是否必填，列表长度不超过3
jump_list.type Int 否 跳转链接类型，0或不填代表不是链接，1 代表跳转url，2 代表跳转小程序
jump_list.title String 是 跳转链接样式的文案内容，建议不超过13个字
jump_list.url String 否 跳转链接的url，jump_list.type是1时必填
jump_list.appid String 否 跳转链接的小程序的appid，jump_list.type是2时必填
jump_list.pagepath String 否 跳转链接的小程序的pagepath，jump_list.type是2时选填
card_action Object 是 整体卡片的点击跳转事件，news_notice模版卡片中该字段为必填项
card_action.type Int 是 卡片跳转类型，1 代表跳转url，2 代表打开小程序。news_notice模版卡片中该字段取值范围为[1,2]
card_action.url String 否 跳转事件的url，card_action.type是1时必填
card_action.appid String 否 跳转事件的小程序的appid，card_action.type是2时必填
card_action.pagepath String 否 跳转事件的小程序的pagepath，card_action.type是2时选填

消息发送频率限制

每个机器人发送的消息不能超过20条/分钟。

文件上传接口

素材上传得到media_id，该media_id仅三天内有效

media_id只能是对应上传文件的机器人可以使用

请求方式： POST（HTTPS ）
**请求地址：**https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=KEY\&type=TYPE

使用multipart/form-data POST上传文件， 文件标识名为"media"
参数说明：

参数 必须 说明
key 是 调用接口凭证, 机器人webhookurl中的key参数
type 是 固定传file

POST的请求包中，form-data中媒体文件标识，应包含有 filename、filelength、content-type等信息

filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制

请求示例：

linenums 复制代码
  1. POST https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa&type=file HTTP/1.1
  2. Content-Type: multipart/form-data; boundary=-------------------------acebdf13572468
  3. Content-Length: 220
  4. ---------------------------acebdf13572468
  5. Content-Disposition: form-data; name="media";filename="wework.txt"; filelength=6
  6. Content-Type: application/octet-stream
  7. mytext
  8. ---------------------------acebdf13572468--

返回数据：

linenums 复制代码
  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "type": "file",
  5. "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
  6. "created_at": "1380000000"
  7. }

参数说明：

参数 说明
type 媒体文件类型，分别有图片（image）、语音（voice）、视频（video），普通文件(file)
media_id 媒体文件上传后获取的唯一标识，3天内有效
created_at 媒体文件上传时间戳

上传的文件限制：

  • 要求文件大小在5B~20M之间
相关推荐
百事老饼干15 分钟前
Java[面试题]-真实面试
java·开发语言·面试
customer0823 分钟前
【开源免费】基于SpringBoot+Vue.JS医院管理系统（JAVA毕业设计）
java·vue.js·spring boot·后端·spring cloud·开源·intellij-idea
2402_8575893633 分钟前
SpringBoot框架：作业管理技术新解
java·spring boot·后端
HBryce2437 分钟前
缓存-基础概念
java·缓存
一只爱打拳的程序猿1 小时前
【Spring】更加简单的将对象存入Spring中并使用
java·后端·spring
杨荧1 小时前
【JAVA毕业设计】基于Vue和SpringBoot的服装商城系统学科竞赛管理系统
java·开发语言·vue.js·spring boot·spring cloud·java-ee·kafka
minDuck1 小时前
ruoyi-vue集成tianai-captcha验证码
java·前端·vue.js
为将者,自当识天晓地。1 小时前
c++多线程
java·开发语言
daqinzl1 小时前
java获取机器ip、mac
java·mac·ip
热门推荐
01【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总02(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【AIGC】重塑未来的科技巨轮05全面解析：构建基于深度学习的安全帽检测系统（UI界面+YOLO代码+数据集）06【经验分享】Ubuntu22.04安装微信(linux官方版)07基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测08Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO09RAG 实践- Ollama+RagFlow 部署本地知识库10【TC3xx芯片】TC3xx芯片电源管理系统PMS详解