1. bot-发送消息
企微Work-bot
  • 开发指南
    • 了解Work-bot
    • 开发前必读
    • 基本概念介绍
    • 试用与支持
    • 获取token
      POST
  • 企微机器人
    • bot-发送消息
      • 获取表情包【matebot、probot、autobot】
        POST
      • 发送表情包【matebot、probot、autobot】
        POST
      • 收藏表情【matebot、probot、autobot】
        POST
      • 发送文本消息
        POST
      • 发送图片
        POST
      • 发送链接
        POST
      • 发送文件
        POST
      • 发送视频
        POST
      • 发送语音
        POST
      • 发送视频号视频消息
        POST
      • 发送小程序
        POST
      • 发送表情包、动图gif【nanobot、probot】
        POST
      • 发送群公告
        POST
      • 转发消息
        POST
      • 发送引用消息
        POST
      • 消息撤回
        POST
      • 语音转文字
        POST
      • 发送位置消息
        POST
      • 发送名片
        POST
    • 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
      • 群发任务详情
      • 终止群发任务
      • 群发任务列表
    • 入群邀请
      • 创建拉群任务
    • 机器人设置-群聊
      • 群欢迎语-开启关闭
      • 群欢迎语内容-设置
      • 群欢迎语内容-查询
      • 群欢迎语时间-设置
      • 群欢迎语时间-查询
      • 模板参数-设置
      • 机器人客户群列表
      • 默认回复开关-打开/关闭
      • 默认回复内容-设置
      • 图片回复内容-设置
      • 图片回复内容-查询
      • 图片回复规则-查询
      • 图片回复规则-设置
      • 群管理员-设置
    • 机器人设置-私聊
      • 获取私聊设置
      • 自动拉人入群-设置
      • 自动拉人进群-打开/关闭
      • 图片回复开关-打开/关闭
      • 链接回复内容-设置
      • 链接回复开关-打开/关闭
      • 口令入群-打开/关闭
      • 口令入群-设置
      • 默认回复-设置
      • 默认回复开关-打开/关闭
      • 默认回复时间设置-查询
      • 关键字打标签开关状态-查询
      • 关键词打标签-开启/关闭
      • 关键词打标签配置信息-查询
    • 机器人设置-通用
      • 私聊/群聊 关键词回复内容设置
      • 查询标签数据
      • 打开/关闭 关键词回复开关
      • 获取关键词回复设置
    • 客户与客户群
      • 接口拓客手机号列表
      • 企微群列表
      • 企微群成员列表
      • 客户列表
    • 其它
      • 上传图片/文件
      • 资源url加签名
    • 账号
      • 删除子账号(注意删除后不能在创建同名账号)
      • 创建子账号
    • 会话
      • 聊天记录
      • 最近会话列表
    • scrm-回调通知
      • 添加企业客户事件
      • 删除企业客户事件
      • 删除跟进成员事件
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
    • Schemas
      • TaskData
      • MessageContent
      • AcceptTarget
      • TextMessage
      • ImageMessage
      • LinkMessage
  1. bot-发送消息

发送视频号视频消息

POST
/wxworkapi/message/exchange
发送视频号视频消息
命令字:robot.channels.send

请求参数示例#

{
    "channelUrl":"https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",    
"extras":"CAEQACLrPgAE9OmXBAAAAQAAAAAAQeApQR9H+NuqJTvRVGQgAAAAaeq5SzX7s7sPwaz04zCEwYwyALHFYGIb/l1etP1AtP3LRBAkKwZM3PU0Vxuko2v5qogX8pnYl0zLSoA6UmN1CQFtOUTG3iNQRNYsL+fpAovQGwleYcUU4f2sNOVKN7cn0cquVvjtcZtaO6NOmbAhM4xDUa/r2JFaBLq/jwiTzkyc0bS89ycHTtlBDWlnk13+0QdAVqD1Psr5HL3IFKDVBCcKUxPWjzq7sVLJQTpLuKsW0puCVuHh2nxLrUsTBG7/A9K0l3v5d3oDWW7ZkIojI9n2BqM6/xqmWpkDmopGUHtm4uzsl/S4afCWME/wXv0ziKHxGhmf1pIs2Ayhv5jfeq7xvU9gELlJHyzi36XaQPz0wgMUGoT2O7T5AGTH204OP9qV+Q1mBzRqiSkvC//KXEd+/lz9S0lSxnlxPXwLF03FSRPKhuyvRl5iWoHD+2BLvzAMZpUAf+GFqj9V2ZH",
    "messageId":"202305051832464996",
    "type":"robot.channels.send",
    "friends":[
        "7881300926912210"
    ],
    "robotKey":"34f9f026d68b45a0bbef07c25b633096",
    "channelCoverUrl":"http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7Ym3K77SEULgkia2WaBVDkHGrrwibYGN7pDRSylw23t6kGnoBGkOgjPXGXI6uv0fhUrLiaL3JXxR6SsG4964bia8DDQzWicZJr74XoIwA&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=&scene=0&token=AxricY7RBHdUBibeuE79n930NjQMFAKXfZkkZtV5ziaSl0Y5QysKyaibQnp6jSMzJgrg8gyvYSojQPY&finder_expire_time=1683884987&finder_eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",
    "channelThumbUrl":"http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7Ym3K77SEULgkia2WaBVDkHGrrwibYGN7pDRSylw23t6kGnoBGkOgjPXGXI6uv0fhUrLiaL3JXxR6SsG4964bia8DDQzWicZJr74XoIwA&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=&scene=0&token=AxricY7RBHdUBibeuE79n930NjQMFAKXfZkkZtV5ziaSl0Y5QysKyaibQnp6jSMzJgrg8gyvYSojQPY&finder_expire_time=1683884987&finder_eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",
    "channelAvatar":"http://wx.qlogo.cn/finderhead/ver_1/JA8yibECWnr2JASkGk6rxZ3YFzSbueuf9QB6Z6Wz6RkD5XN1IwXZSGIiaPQj3AJyDwEgoTGkAVL6B1c1CF7yM3kzXrQC7K37pOZaJ4mZsH7r8/0",
    "channelName":"跨境前沿",
    "desc":"马云当众质疑大屏幕成本过高,阿里巴巴CFO蔡崇信用一番话巧妙解围,让马云心服口服!#马云#蔡崇信#阿里巴巴#企业家"
}

回调通知接口-发送结果通知数据示例#

回调通知接口 /XXXX/service/result
{
    "robotKey":"34f9f026d68b45a0bbef07c25b633096",
    "bizType":5,
    "robotType":2,
    "os":"win",
    "isSendFromMac":1,
    "code":"0",
    "msg":"OK",
    "sendTime":"2023-05-05 18:33:03",
    "sendTimeTs":1683282783,
    "dts":1683282783000,
    "isGroupChat":0,
    "msgSvrID":1142861,
    "msgSeq":11961678,
    "cppContentType":141,
    "receiverId":"7881300926912210",
    "conversationId":"S:1688850230787417_7881300926912210",
    "senderId":"1688850230787417",
    "content":"马云当众质疑大屏幕成本过高,阿里巴巴CFO蔡崇信用一番话巧妙解围,让马云心服口服!#马云#蔡崇信#阿里巴巴#企业家",
    "channelAvatar":"http://wx.qlogo.cn/finderhead/ver_1/JA8yibECWnr2JASkGk6rxZ3YFzSbueuf9QB6Z6Wz6RkD5XN1IwXZSGIiaPQj3AJyDwEgoTGkAVL6B1c1CF7yM3kzXrQC7K37pOZaJ4mZsH7r8/0",
    "channelCoverUrl":"http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7Ym3K77SEULgkia2WaBVDkHGrrwibYGN7pDRSylw23t6kGnoBGkOgjPXGXI6uv0fhUrLiaL3JXxR6SsG4964bia8DDQzWicZJr74XoIwA&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=&scene=0&token=AxricY7RBHdUBibeuE79n930NjQMFAKXfZkkZtV5ziaSl0Y5QysKyaibQnp6jSMzJgrg8gyvYSojQPY&finder_expire_time=1683884987&finder_eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",
    "channelThumbUrl":"http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7Ym3K77SEULgkia2WaBVDkHGrrwibYGN7pDRSylw23t6kGnoBGkOgjPXGXI6uv0fhUrLiaL3JXxR6SsG4964bia8DDQzWicZJr74XoIwA&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=&scene=0&token=AxricY7RBHdUBibeuE79n930NjQMFAKXfZkkZtV5ziaSl0Y5QysKyaibQnp6jSMzJgrg8gyvYSojQPY&finder_expire_time=1683884987&finder_eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",
    "channelName":"跨境前沿",
    "extras":"CAEQACLrPgAE9OmXBAAAAQAAAAAAQeApQR9H+NuqJTvRVGQgAAAAaeq5SzX7s7sPwaz04zCEwYwyALHFYGIb/l1etP1AtP3LRBAkKwZM3PU0Vxuko2v5qogX8pnYl0zLSoA6UmN1CQFtOUTG3iNQRNYsL+fpAovQGwleQVdqHIkg+WBWFyN6CCUEZPDDVw8Z/mZJZnLVm4JdHiCg0CL/6Qem7uIZ+4ck8MKexDxBFDk/kqTdNeWW3yCAoXDCef6Qn15CINeTvIzQ4KG61WEQfJDwGum+b6N4KWs/m3qqd/Ay1NZdgyCMDwcGbE/mpsTxpZOCgA",
    "chatUser":"1688850230787417",
    "chat_user":"1688850230787417",
    "isSendFromSelf":0,
    "isSelfInAtUserList":0,
    "atUserList":"",
    "friends":[
        "1688850230787417"
    ],
    "type":"robot.channels.send",
    "messageId":"202305051832464996",
    "nodeServerCode":"node_server_0001",
    "siteCode":"wenode_win_test_0001",
    "channelUrl":"https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAApDsAO7xD1gAAAAstQy6ubaLX4KHWvLEZgBPEvoJ0fwR5HKqBzNPgMIJcgrVDxnM6OtifPaVgkJPm",
    "routing":"SEND",
    "desc":"马云当众质疑大屏幕成本过高,阿里巴巴CFO蔡崇信用一番话巧妙解围,让马云心服口服!#马云#蔡崇信#阿里巴巴#企业家"
}

字段说明#

字段名称数据类型是否必填说明
typeString是指令类型,固定值"robot.channels.send"表示视频号消息
robotKeyString是机器人唯一标识key
channelAvatarString是视频号头像URL
channelCoverUrlString是视频号封面图URL
channelThumbUrlString是视频缩略图URL
channelUrlString是视频号主页链接
channelNameString是视频号名称
extrasString是视频资源唯一标识符
descString否视频描述文字(可选)

friendsArray是String数组, 接收消息的联系人VID列表
sendTimeString否消息发送时间,格式"yyyy-MM-dd HH:mm:ss"
sendTimeTslong否消息发送时间戳(秒级)
msgSvrIDlong否服务端消息ID
msgSeqlong否消息序列号
contentTypeinteger否消息类型,141代表短视频消息
chatUserstring否会话对象标识

请求参数

Authorization
Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.example.com/wxworkapi/message/exchange?acttype=channels' \
--header 'token: cf95e27e49a58a63798dc48e13b6f866' \
--header 'request_id: {{$string.alphanumeric(length=32)}}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2025-12-16 07:53:33
上一页
发送语音
下一页
发送小程序
Built with