发送消息

机器人发送消息

请求URL

https://chat-go.jwzhd.com/open-apis/v1/bot/send?token=xxxxxxxxxx

请求类型

POST

请求示例

curl --location --request POST 'https://chat-go.jwzhd.com/open-apis/v1/bot/send?token=xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recvId": "7058262",
    "recvType": "user",
    "contentType": "text",
    "content": {
        "text": "这里是消息内容"
    }
}'

请求头

Content-Type: "application/json; charset=utf-8"

请求参数

字段	类型	是否必填	说明
recvId	string	是	接收消息对象ID 用户: userId 群: groupId
recvType	string	是	接收对象类型 用户: user 群: group
contentType	string	是	消息类型，取值如下 text\image\video\file\markdown\html （html支持标签）
content	Content对象	是	消息对象
parentId	string	否	引用消息 ID

Content对象

contentType为text

字段	类型	是否必填	说明
text	string	是	消息正文
buttons	Button对象列表	否	消息中包括button

contentType为image

字段	类型	是否必填	说明
imageKey	string	是	图片Key, 通过图片上传接口获得
buttons	Button对象列表	否	消息中包括button

contentType为markdown

字段	类型	是否必填	说明
text	string	是	markdown字符串
buttons	Button对象列表	否	消息中包括button

contentType为file

字段	类型	是否必填	说明
fileKey	string	是	文件Key, 通过文件上传接口获得
buttons	Button对象列表	否	消息中包括button

contentType为video

字段	类型	是否必填	说明
videoKey	string	是	视频Key, 通过视频上传接口获得
buttons	Button对象列表	否	消息中包括button

Button对象

字段	类型	是否必填	说明
text	string	是	按钮上的文字
actionType	int	是	1: 跳转URL 2: 复制 3: 点击汇报
url	string	否	当actionType为1时使用
value	string	否	当actionType为2时，该值会复制到剪贴板 当actionType为3时，该值会发送给订阅端

响应内容

字段	类型	说明
code	int	响应代码
msg	string	响应信息，包括异常信息
data	Object	返回数据

完整示例

发送文本消息请求示例

{
    "recvId": "7058262",
    "recvType": "user",
    "contentType": "text",
    "content": {
        "text": "这里是消息内容",
        "buttons": [
            [
                {
                    "text": "复制",
                    "actionType": 2,
                    "value": "xxxx"
                },
                {
                    "text": "点击跳转",
                    "actionType": 1,
                    "url": "http://www.baidu.com"
                }
            ]
        ]
    }
}