发送消息

POST

/wework/sendRawMessage

功能介绍：

由机器人发送指定内容消息到相应的好友或群聊中，支持@指定人

注意：

at所有人可以填入"@所有人"（应为群主或群管理）

减号- 空格和英文括号()为保留字请勿在人名/群名/备注名中使用

群名定义尽量短，一般不要超过12个汉字（调小企微内字体设置更佳）

存在重名问题考虑设置好友备注名或群备注名（不要以数字开头，企微搜索bug！长度不要超长被...截断）

建议titleList仅填一个，因为有失败重试机制，防止多个批量重试导致重发

指令接口IP请求限流为60QPM，如果请求量过大可使用批量发送指令减少总请求次数（https://worktool.apifox.cn/api-147612959）

注意：本文档所有接口的请求为QPM为60（每分钟60次请求），超过QPM的请求会被拦截丢弃，多次频繁被拦截则会对IP拦截。

请求参数

Query 参数

robotId

string

客户端链接唯一标识

必需

示例值:

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

socketType

integer

必需

通讯类型固定值=2

list

array [object {4}]

必需

type

integer

必需

消息类型固定值=203

titleList

array[string]

昵称或群名

必需

receivedContent

string

必需

发送文本内容 (\n换行)

atList

array[string]

可选

at的人(at所有人用"@所有人")

示例

{
  "socketType": 2,
  "list": [
    {
      "type": 203,
      "titleList": [
        "仑哥(这里改成你的微信昵称或群名)"
      ],
      "receivedContent": "你好~"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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":[
                "仑哥(这里改成你的微信昵称或群名)"
            ],
            "receivedContent":"你好~"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

number

必需

message

string

必需

data

string

必需

示例

{
  "code": 0,
  "message": "string",
  "data": "string"
}

修改于 2024-11-12 01:42:50

错误码

推送任意图片/音视频/文件