简体中文

_send_group_notice

_send_group_notice写操作扩展

发送群公告（支持置顶、弹窗、新成员、群昵称引导与确认）

通过 POST http://127.0.0.1:3000/_send_group_notice（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数	类型	必填	默认	说明
`group_id`	uint	✓		群号
`content`	string	✓		公告正文
`image`	string	–	`""`	可选公告图片（本地路径、URL 或 base64）
`pinned`	int	–	`0`	是否置顶：1=置顶，0=不置顶
`type`	int	–		发布类型：1=普通公告，20=新成员公告；建议使用 send_to_new_members
`send_to_new_members`	bool	–		是否在成员新加入群时发送（与 type=20 等价）
`is_show_edit_card`	int	–	`1`	是否引导群成员修改群昵称：1=是，0=否
`tip_window_type`	int	–	`1`	弹窗展示：0=开启弹窗，1=关闭弹窗（QQ 原始字段为反向语义）
`confirm_required`	int	–	`1`	是否需要群成员确认收到：1=是，0=否

返回 (data)

该动作返回标准 OneBot 信封；data 结构待补充。

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/_send_group_notice \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456,"content":"","image":"","pinned":0,"type":0,"send_to_new_members":false,"is_show_edit_card":1,"tip_window_type":1,"confirm_required":1}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

_send_group_notice#

输入参数#

返回 (data)#

调用示例#

_send_group_notice

输入参数

返回 (data)

调用示例