1. 消息群发
企微Work-bot
  • 开发指南
    • 了解Work-bot
    • 开发前必读
    • 基本概念介绍
    • 试用与支持
    • 获取token
      POST
  • 企微机器人
    • bot-发送消息
      • 获取表情包【matebot、probot、autobot】
      • 发送表情包【matebot、probot、autobot】
      • 收藏表情【matebot、probot、autobot】
      • 发送文本消息
      • 发送图片
      • 发送链接
      • 发送文件
      • 发送视频
      • 发送语音
      • 发送视频号视频消息
      • 发送小程序
      • 发送表情包、动图gif【nanobot、probot】
      • 发送群公告
      • 转发消息
      • 发送引用消息
      • 消息撤回
      • 语音转文字
      • 发送位置消息
      • 发送名片
    • bot-收到消息
      • 收到文本消息
      • 收到图片消息
      • 收到链接消息
      • 收到文件消息
      • 收到视频消息
      • 收到视频号消息
      • 收到小程序消息
      • 收到红包消息
      • 收到位置消息
      • 收到动图gif消息
      • 收到引用消息
      • 根据appInfo 查找引用消息
      • 对方撤回通知
      • 收到语音消息
      • 收到名片消息
    • bot-机器人
      • 检查授权码数量
      • 创建机器人
      • 企微机器人列表
      • 获取登录二维码
      • 提交验证码
      • 登录检查
      • 下线机器人(退出企微登录)
      • 删除机器人
      • 登录通知
      • 退出通知
      • 账号退出
      • 机器人企业成员信息通知
    • bot-联系人
      • 同步联系人
      • 查询联系人
      • 同步标签
      • 同步企业成员
      • 给客户打标签
      • 设置客户备注、描述
      • 设置客户手机号
      • 手机号加粉
      • 添加手机号搜索到的客户微信
      • 删除好友
    • bot-客户群
      • 同步客户群
      • 客户群列表
      • 创建群
      • 添加群成员
      • 查询群信息
      • 修改群名
      • 修改群公告
      • 群解散
      • 群踢人(移除群成员)
      • 拉人进群
      • 退出群聊
      • 添加/删除群管理员
      • 开启/关闭群邀请验证
      • 转让群主
      • 群二维码
      • 禁止修改群名开关
    • bot-朋友圈
      • 获取朋友圈详情
      • 大文件上传
      • 发朋友圈
    • bot-回调通知
      • 联系人通知
        • 查询收到的好友请求列表
        • 添加好友请求(客户添加机器人)
        • 通过添加好友邀请
        • 新增好友通知
        • 好友删除通知
      • 客户群通知
        • 新增群成员通知robot.members.chain
        • 新增群成员通知robot.group.member.changed
        • 新增群成员通知robot.contact.modify
        • 群成员退群通知
        • 群名称变更通知
        • 新增群聊通知
        • 群管理变更通知
    • bot-数据转换
      • 官方群chatId转换为企微群ID
      • 官方客户数据转机器人数据
      • 机器人客户数据转官方自建应用客户数据
      • 机器人企业成员数据转官方自建应用企业成员数据
      • 机器人群id转为官方群id
  • 企微SCRM
    • 客户群
      • 群成员列表
    • 企业成员
      • 企业成员
    • 消息群发
      • 新建群发任务-4
        POST
      • 群发任务详情
        POST
      • 终止群发任务
        POST
      • 群发任务列表
        POST
    • 入群邀请
      • 创建拉群任务
    • 机器人设置-群聊
      • 群欢迎语-开启关闭
      • 群欢迎语内容-设置
      • 群欢迎语内容-查询
      • 群欢迎语时间-设置
      • 群欢迎语时间-查询
      • 模板参数-设置
      • 机器人客户群列表
      • 默认回复开关-打开/关闭
      • 默认回复内容-设置
      • 图片回复内容-设置
      • 图片回复内容-查询
      • 图片回复规则-查询
      • 图片回复规则-设置
      • 群管理员-设置
    • 机器人设置-私聊
      • 获取私聊设置
      • 自动拉人入群-设置
      • 自动拉人进群-打开/关闭
      • 图片回复开关-打开/关闭
      • 链接回复内容-设置
      • 链接回复开关-打开/关闭
      • 口令入群-打开/关闭
      • 口令入群-设置
      • 默认回复-设置
      • 默认回复开关-打开/关闭
      • 默认回复时间设置-查询
      • 关键字打标签开关状态-查询
      • 关键词打标签-开启/关闭
      • 关键词打标签配置信息-查询
    • 机器人设置-通用
      • 私聊/群聊 关键词回复内容设置
      • 查询标签数据
      • 打开/关闭 关键词回复开关
      • 获取关键词回复设置
    • 客户与客户群
      • 接口拓客手机号列表
      • 企微群列表
      • 企微群成员列表
      • 客户列表
    • 其它
      • 上传图片/文件
      • 资源url加签名
    • 账号
      • 删除子账号(注意删除后不能在创建同名账号)
      • 创建子账号
    • 会话
      • 聊天记录
      • 最近会话列表
    • scrm-回调通知
      • 添加企业客户事件
      • 删除企业客户事件
      • 删除跟进成员事件
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
    • Schemas
      • TaskData
      • MessageContent
      • AcceptTarget
      • TextMessage
      • ImageMessage
      • LinkMessage
  1. 消息群发

新建群发任务-4

POST
/wxworkapi/multiple/task/save
创建新的消息群发任务,支持定时发送和周期发送两种模式,可发送多种类型的消息内容。支持向群聊或客户批量发送文本、图片、链接、文件、小程序、视频号、群公告等类型的消息。
说明: 新建群发任务
URL:  /wxworkapi/multiple/task/save
request method: POST
Content-Type: application/json;charset=UTF-8
参数说明
名称类型必须描述
nameString是任务昵称
taskTypeInteger是任务类型 1 定时发送,2 周期发送
startTimeLong否taskType为1时,可提供该参数设置预期任务开始时间,unixtime,单位毫秒。不提供该参数时,任务立即开始。
weekdayString数组否taskType为2时,需提供该参数。Day-of-Week (1~7,1=SUN 或者"SUN, MON, TUE, WED, THU, FRI, SAT”)
startDateLong否askType为2时,需提供该参数,任务预期开始日期,unixtime
endDateLong否askType为2时,需提供该参数,任务预期结束日期,unixtime
execStartTimeString否taskType为2时,需提供该参数。任务在周期内每天的开始时间,格式“hh:mm”
endTmString否taskType为1或2均可设置。任务在当天的结束时间,到达结束时间后未发送完的消息将不再发送,格式“hh:mm”
commandTypeString是指令类型 消息群发固定传wxwork.robot.batch.send
isGroupChatInteger是1 好友 2 群聊
taskRuleInteger是1 默认策略(30秒一个发送对象,建议用2) 2 自定义发送间隔
suitCountInteger否taskRule为2时必填,一批次并发多少个对象,建议12个以内,可根据发送内容不同进行适当调整,例如发送文件这类需要消耗资源的内容时,并发尽量减少。传1默认为12,最好不要传1
perSuitSecondInteger否taskRule为2时必填,发送频率(每批次发送对象的间隔时间) 最小值
perSuitSecondUpperInteger否taskRule为2时必填,发送频率(每批次发送对象的间隔时间)最大值
loginTypeInteger否机器人类型,1 matebot、20 所有版本的probot
taskData.acceptTarget.robotKeyString是机器人robotKey
taskData.acceptTarget.chatUserString数组是发送对象数组,可指定客户和群
relativeDelayInteger是消息发送间隔,多个消息时为需要叠加计算,例如发3条消息,每条消息间隔10s,则第1条消息可为0,第2条消息为10s,第3条消息为20s
msgTypeInteger是消息类型: 1 文字 、3 图片 、16 h5链接卡片 、49 文件 、23 直发小程序 、78 转发小程序、141 视频号、100 群公告(发送对象为群聊、机器人为群主或管理员时生效)
taskData.contentsarray是文本内容/图片路径/文件外链路径/收录小程序内容,参考示例
taskData.acceptTargetarray是发送对象,参考示例
文本:
名称类型必须描述
msgTypeInteger是消息类型:1 文本
contentString否文本内容
图片:
名称类型必须描述
msgTypeInteger是消息类型:3 图片
contentString否图片url
h5链接:
名称类型必须描述
msgTypeInteger是消息类型:16 h5链接
titleString否链接标题
descriptionString否链接描述
coverImgFileString否链接图片
linkString否链接地址
appTypeInteger否链接类型 1 链接卡片 2 音乐卡片
文件:
名称类型必须描述
msgTypeInteger是消息类型:49 文件
contentString否文件url
转发小程序:小程序78是根据标题、内容和发送者来确定收录到的小程序进行发送,基本不使用这种场景
名称类型必须描述
msgTypeInteger是消息类型:78 转发小程序
titleString否转发收录小程序标题
senderNameString否转发收录小程序的发送者
senderHeadImgString否转发收录小程序发送者的头像
logoString否转发收录小程序的logo
msgSvrIDLong否转发的消息 msgSvrID
直发小程序:小程序23是直接拼小程序参数直发
名称类型必须描述
msgTypeInteger是消息类型:23 直发小程序
appNameString否直发小程序名称
usernameString否直发小程序原始id
appidString否直发小程序appid
titleImgString否直发小程序封面图url
headImgUrlString否直发小程序头像url
titleString否小程序页面标题
pathString否直发小程序路径
视频号:
名称类型必须描述
msgTypeInteger是消息类型:141 视频号
titleString否视频号标题
descriptionString否视频号描述
linkString否视频号路径
headImgUrlString否视频号头像
coverImgFileString否视频号封面图
thumbUrlString否视频号封面缩略图,可与封面图一致
extrasString否资源标识,每个视频不一样
feedIdString否视频ID
nonceIdString否随机nonceId
群公告:
名称类型必须描述
msgTypeInteger是消息类型:100 群公告
contentString否公告内容
request 参数示例:

定时任务:#

{
    "name": "定时任务1",
    "taskType": "1",
    "commandType": "wxwork.robot.batch.send",
    "taskRule": "2",
    "taskData": {
        "contents": [
            {
                "content": "文本消息",
                "msgType": 1,
                "relativeDelay": 0
            },
            {
                "content": "http://media.yjiyun.com/407/2025061016/1e38fa43/315k.png",
                "msgType": 3,
                "relativeDelay": 10
            },
            {
                "title": "链接标题",
                "description": "链接描述",
                "coverImgFile": "http://media.yjiyun.com/407/2025061016/32a302d/315k.png",
                "link": "https://www.yjiyun.com",
                "appType": 1,
                "msgType": 16,
                "relativeDelay": 20
            },
            {
                "content": "http://media.yjiyun.com/407/2025061016/12e87c3f/测试.docx",
                "msgType": 49,
                "relativeDelay": 30
            },
            {
                "msgType": 23,
                "relativeDelay": 40,
                "appName": "海绵青年GO",
                "username": "gh_6fc10ea13aa8@app",
                "appid": "wxe94f0c31170b1752",
                "titleImg": "https://yjyfile-1350470482.cos.ap-guangzhou.myqcloud.com/cloudphone/30e2381f5b05475bba872428e305e049/2025-06-05/e03396f0dedc323cf6aed9ffa353bff6.jpg",
                "headImgUrl": "http://mmbiz.qpic.cn/mmbiz_png/XcLD1UB4K3SRILxdh6UrNzayjSt0ZtFk4iau8A6icugARAVgxlMJZz60QrFsV0nc4rbXaE8nnBxBQGrs09pcRKhQ/640?wx_fmt=png&wxfrom=200",
                "title": "广州海绵青年夜校12345",
                "path": "pages/client/index.html"
            },
            {
                "msgType": 141,
                "relativeDelay": 50,
                "title": "宫崎峻的天空",
                "description": "人就该待在没有天花板的地方.",
                "link": "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "headImgUrl": "http://wx.qlogo.cn/finderhead/JVDECnNjedF1yaxfNLeRC84songDXw969ciaFWVd94BIhmsq4GqLNSMoJtHmHFAenEKhATv22bvk/0",
                "coverImgFile": "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=oibeqyX228riaCwo9STVsGLPj9UYCicgttvI3dANibYroziagGib2AScj0CmYIOn1Bpv2lXqO42vP6WvNQvyH16CqlJpfcxIVxIrL2fFdAeKslfpwuMUFIwepYQbB7hyBDl9DnntXoaQVzFIk&token=o3K9JoTic9IjOkic1fvJnZu5IBBnnianIJ9HojlKkDOibzKDujxmNQJzvqVB7gZo2ZlmM0Tm0CWSCo9TBOM4FXKsibzNIGactzSUYkZhFmO3icER255ib9Z3Nfxe1YdgGSyJVBjiaWBtcBp7ibNHic0xhO1Is9OgLvsIRrUpdCz73vzqXrSrkpRzicaETySuQ&idx=1&hy=SH&m=52c7957fca22c01cd04504b8382d34b0&uzid=1&finder_expire_time=1744612536&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "thumbUrl": "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=oibeqyX228riaCwo9STVsGLPj9UYCicgttvI3dANibYroziagGib2AScj0CmYIOn1Bpv2lXqO42vP6WvNQvyH16CqlJpfcxIVxIrL2fFdAeKslfpwuMUFIwepYQbB7hyBDl9DnntXoaQVzFIk&token=o3K9JoTic9IjOkic1fvJnZu5IBBnnianIJ9HojlKkDOibzKDujxmNQJzvqVB7gZo2ZlmM0Tm0CWSCo9TBOM4FXKsibzNIGactzSUYkZhFmO3icER255ib9Z3Nfxe1YdgGSyJVBjiaWBtcBp7ibNHic0xhO1Is9OgLvsIRrUpdCz73vzqXrSrkpRzicaETySuQ&idx=1&hy=SH&m=52c7957fca22c01cd04504b8382d34b0&uzid=1&finder_expire_time=1744612536&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "extras": "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",
                "feedId": "14625178928586360946",
                "nonceId": "4219178557600633736_0_0_0_0_0"
            },
            {
                "content": "公告内容",
                "msgType": 100,
                "relativeDelay": 60
            }
        ],
        "acceptTarget": [
            {
                "robotKey": "418abc07169a4516b6eda68dc67c9cfd",
                "chatUser": [
                    "R:10855853651814697"
                ]
            },
            {
                "robotKey": "64ab3e40aa4048148cf12f4393c10dea",
                "chatUser": [
                    "R:10840519545087580"
                ]
            }
        ],
        "isGroupChat": "2",
        "loginType": 1
    },
    "suitCount": 12,
    "perSuitSecond": 120,
    "perSuitSecondUpper": 150,
    "endTm": "16:05:00",
    "startTime": 1751212800000
}

周期任务:#

任务执行前会生成一个子任务,用子任务去发送
{
    "name": "周期任务1",
    "taskType": "2",
    "commandType": "wxwork.robot.batch.send",
    "taskRule": "2",
    "taskData": {
        "contents": [
            {
                "content": "文本消息",
                "msgType": 1
            },
            {
                "content": "http://media.yjiyun.com/407/2025061016/1e38fa43/315k.png",
                "msgType": 3,
                "relativeDelay": 10
            },
            {
                "title": "链接标题",
                "description": "链接描述",
                "coverImgFile": "http://media.yjiyun.com/407/2025061016/32a302d/315k.png",
                "link": "https://www.yjiyun.com",
                "appType": 1,
                "msgType": 16,
                "relativeDelay": 20,
                "customizedSettings": {
                    "group": 0
                }
            },
            {
                "content": "http://media.yjiyun.com/407/2025061016/12e87c3f/测试.docx",
                "msgType": 49,
                "relativeDelay": 30
            },
            {
                "msgType": 23,
                "relativeDelay": 40,
                "appName": "海绵青年GO",
                "username": "gh_6fc10ea13aa8@app",
                "appid": "wxe94f0c31170b1752",
                "titleImg": "https://yjyfile-1350470482.cos.ap-guangzhou.myqcloud.com/cloudphone/30e2381f5b05475bba872428e305e049/2025-06-05/e03396f0dedc323cf6aed9ffa353bff6.jpg",
                "headImgUrl": "http://mmbiz.qpic.cn/mmbiz_png/XcLD1UB4K3SRILxdh6UrNzayjSt0ZtFk4iau8A6icugARAVgxlMJZz60QrFsV0nc4rbXaE8nnBxBQGrs09pcRKhQ/640?wx_fmt=png&wxfrom=200",
                "title": "广州海绵青年夜校12345",
                "path": "pages/client/index.html",
                "customizedSettings": {
                    "group": 0
                }
            },
            {
                "msgType": 141,
                "relativeDelay": 50,
                "title": "宫崎峻的天空",
                "description": "人就该待在没有天花板的地方.",
                "link": "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "headImgUrl": "http://wx.qlogo.cn/finderhead/JVDECnNjedF1yaxfNLeRC84songDXw969ciaFWVd94BIhmsq4GqLNSMoJtHmHFAenEKhATv22bvk/0",
                "coverImgFile": "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=oibeqyX228riaCwo9STVsGLPj9UYCicgttvI3dANibYroziagGib2AScj0CmYIOn1Bpv2lXqO42vP6WvNQvyH16CqlJpfcxIVxIrL2fFdAeKslfpwuMUFIwepYQbB7hyBDl9DnntXoaQVzFIk&token=o3K9JoTic9IjOkic1fvJnZu5IBBnnianIJ9HojlKkDOibzKDujxmNQJzvqVB7gZo2ZlmM0Tm0CWSCo9TBOM4FXKsibzNIGactzSUYkZhFmO3icER255ib9Z3Nfxe1YdgGSyJVBjiaWBtcBp7ibNHic0xhO1Is9OgLvsIRrUpdCz73vzqXrSrkpRzicaETySuQ&idx=1&hy=SH&m=52c7957fca22c01cd04504b8382d34b0&uzid=1&finder_expire_time=1744612536&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "thumbUrl": "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=oibeqyX228riaCwo9STVsGLPj9UYCicgttvI3dANibYroziagGib2AScj0CmYIOn1Bpv2lXqO42vP6WvNQvyH16CqlJpfcxIVxIrL2fFdAeKslfpwuMUFIwepYQbB7hyBDl9DnntXoaQVzFIk&token=o3K9JoTic9IjOkic1fvJnZu5IBBnnianIJ9HojlKkDOibzKDujxmNQJzvqVB7gZo2ZlmM0Tm0CWSCo9TBOM4FXKsibzNIGactzSUYkZhFmO3icER255ib9Z3Nfxe1YdgGSyJVBjiaWBtcBp7ibNHic0xhO1Is9OgLvsIRrUpdCz73vzqXrSrkpRzicaETySuQ&idx=1&hy=SH&m=52c7957fca22c01cd04504b8382d34b0&uzid=1&finder_expire_time=1744612536&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAsQ0nUI_PsQAAAAstQy6ubaLX4KHWvLEZgBPEpqNcSWc7Hp6JzNPgMIIedzryRNaWMb-M6GfglxNR",
                "extras": "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",
                "feedId": "14625178928586360946",
                "nonceId": "4219178557600633736_0_0_0_0_0"
            },
            {
                "content": "公告内容",
                "msgType": 100,
                "relativeDelay": 60
            }
        ],
        "acceptTarget": [
            {
                "robotKey": "0620cddfeb6a42b9a1a9395e0e869b11",
                "chatUser": [
                    "R:10895442973492489"
                ]
            }
        ],
        "isGroupChat": "2",
        "loginType": 20
    },
    "suitCount": 12,
    "perSuitSecond": 120,
    "perSuitSecondUpper": 150,
    "endTm": "16:05:00",
    "execStartTime": "14:14",
    "weekday": [
        "2",
        "3"
    ],
    "startDate": 1750348800000,
    "endDate": 1751299199000
}

请求参数

Authorization
Query 参数

Body 参数application/json

示例

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://www.example.com/wxworkapi/multiple/task/save?token=5bdc88a9c3a644392b64f6cae7bbbdfa' \
--header 'Content-Type: application/json' \
--data '{
    "name": "周期任务1",
    "taskType": 2,
    "commandType": "wxwork.robot.batch.send",
    "taskRule": 2,
    "taskData": {
        "contents": [
            {
                "content": "每日提醒",
                "msgType": 1
            }
        ],
        "acceptTarget": [
            {
                "robotKey": "0620cddfeb6a42b9a1a9395e0e869b11",
                "chatUser": [
                    "R:10895442973492489"
                ]
            }
        ],
        "isGroupChat": "2",
        "loginType": 20
    },
    "suitCount": 12,
    "perSuitSecond": 120,
    "perSuitSecondUpper": 150,
    "autoRetry": 0,
    "retryTime": "1",
    "retrySpecificTime": "",
    "retryInterval": 3,
    "enableImmediateRetry": 0,
    "immediateRetryDelay": 0,
    "enableAutoRetry": 0,
    "autoRetryEndTm": "20:00:00",
    "endTm": "16:05:00",
    "execStartTime": "14:14",
    "weekday": [
        "2",
        "3"
    ],
    "startDate": 1750348800000,
    "endDate": 1751299199000
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{
    "msg": "OK",
    "code": "0",
    "wxworkMultipleTaskId": 951047
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🔴500服务器错误
修改于 2026-05-06 10:31:06
上一页
企业成员
下一页
群发任务详情
Built with