Skip to content

群内消息类型控制

请求URL

请求类型

POST

请求示例

bash
curl --location 'https://chat-go.jwzhd.com/open-apis/v1/group/msg-type-limit?token=016ec8e4d17a4fbda3ccb0e99b44aca0' \
--header 'Content-Type: application/json' \
--data '{
    "groupId": "307149245",
    "type": "text,image,video"
}'

请求头

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

请求参数

字段类型是否必填说明
groupIdstring群组ID
typestring允许的消息类型,多个类型用逗号分隔。为空表示不限制任何消息类型

type参数说明

type参数为消息类型名称,多个类型用逗号分隔,如:"text,image,video"

为空时表示不限制任何消息类型

消息类型对照表

类型名称说明
text文本消息
image图片消息
markdownMARKDOWN消息
file文件消息
post帖子消息
expression表情消息
htmlHTML消息
video视频消息
audio语音消息
liveAudio语音通话

权限说明

机器人需要在该群聊中,且拥有允许修改群信息权限(allowEditGroupInfo = 1)

响应内容

字段类型说明
codeint响应代码
msgstring响应信息,包括异常信息
dataObject返回数据

响应示例

json
{
    "code": -1,
    "msg": "机器人无修改群信息权限"
}
json
{
    "code": 1002,
    "msg": "type格式错误,应为消息类型名称(如: text,image,video)"
}
json
{
    "code": 1,
    "msg": "success"
}

错误码说明

错误码说明
1002参数缺失或有误
1003未授权(非法token)
-1服务错误(如机器人不在群中、无权限等)

请求示例

允许多种消息类型

json
{
    "groupId": "307149245",
    "type": "text,image,video,audio"
}

只允许文本消息

json
{
    "groupId": "307149245",
    "type": "text"
}

不限制消息类型

json
{
    "groupId": "307149245",
    "type": ""
}