企微WorkTool API
首页文档中心合作申请
首页文档中心合作申请
  1. 指令消息
  • 快速入门
  • 功能演示
  • 机器人流程图
  • 消息回调接口规范
  • 常见问题
  • 错误码
  • 指令消息
    • 发送消息
      POST
    • 推送任意图片/音视频/文件
      POST
    • 转发消息(不推荐)
      POST
    • 创建外部群
      POST
    • 修改群信息(含拉人等)
      POST
    • 解散群
      POST
    • 推送微盘图片
      POST
    • 推送腾讯文档
      POST
    • 推送收集表
      POST
    • 推送微盘文件
      POST
    • 按手机号添加好友
      POST
    • 从外部群添加好友
      POST
    • 修改好友信息
      POST
    • 修改群成员备注
      POST
    • 删除联系人
      POST
    • 添加待办
      POST
    • 清空客户端指令
      POST
    • 批量发送指令
      POST
    • 切换企业(定制)
      POST
    • 发送链接(定制)
      POST
    • 发送自定义path小程序(定制)
      POST
    • 消息撤回(定制)
      POST
  • 机器人配置
    • 机器人后端通讯加密
    • 机器人集成微信对话开放平台
    • 获取机器人信息
    • 查询机器人是否在线
    • 查询机器人登录日志
    • 获取机器人企业列表(定制)
  • 群管理
    • 群列表查询
  • 历史消息
    • 历史消息列表查询
    • 指令消息API调用查询
    • 指令执行结果查询
    • 机器人消息回调日志列表查询
  • 机器人回调配置
    • 机器人消息回调配置
    • 机器人配置回调
    • 查询机器人回调
    • 删除机器人回调
    • 机器人回调接口标准
    • 删除机器人回调(旧)
    • 机器人配置回调(旧)
  • 回调接口Demo
    • QA回调接口Demo2(复读机)
    • QA回调接口Demo3(不回复)
  1. 指令消息

批量发送指令

POST
https://api.worktool.ymdyes.cn/wework/sendRawMessage
功能介绍:
可以将多条发送指令合并在一个请求当中,提高网络效率
单次调用该接口可合并最多100条指令
此接口可解决并发请求太多导致被服务器拦截的问题
指令消息IP请求频率不可超过60QPM
注:
1.
【指令消息】目录下的所有指令均可合并

请求参数

Query 参数
robotId
string 
客户端链接唯一标识
必需
示例值:
{{robot_id}}
Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
socketType
integer 
必需
通讯类型 固定值=2
list
array [object] 
必需
示例
{
  "socketType": 2,
  "list": [
    {
      "type": 203,
      "titleList": [
        "AA"
      ],
      "receivedContent": "第一条发送文本消息指令"
    },
    {
      "type": 203,
      "titleList": [
        "AA"
      ],
      "receivedContent": "第二条发送文本消息指令"
    },
    {
      "type": 218,
      "titleList": [
        "BB"
      ],
      "objectName": "logo.png",
      "fileUrl": "https://cdn.asrtts.cn/static/image/logo3_180_raw.png",
      "fileType": "image",
      "extraText": "第三条发送文件消息指令"
    }
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api.worktool.ymdyes.cn/wework/sendRawMessage?robotId=worktool1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "socketType":2,
    "list":[
        {
            "type":203,
            "titleList":[
                "AA"
            ],
            "receivedContent":"第一条发送文本消息指令"
        },
        {
            "type":203,
            "titleList":[
                "AA"
            ],
            "receivedContent":"第二条发送文本消息指令"
        },
        {
            "type": 218,
            "titleList": [
                "BB"
            ],
            "objectName": "logo.png",
            "fileUrl": "https://cdn.asrtts.cn/static/image/logo3_180_raw.png",
            "fileType": "image",
            "extraText": "第三条发送文件消息指令"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
code
number 
必需
message
string 
必需
data
string 
必需
示例
{
  "code": 0,
  "message": "string",
  "data": "string"
}
上一页
清空客户端指令
下一页
切换企业(定制)
Built with