_send_group_notice

_send_group_notice写操作扩展
发送群公告(支持置顶、弹窗、新成员、群昵称引导与确认)

Call via POST http://127.0.0.1:3000/_send_group_notice (JSON params as the body) or WebSocket.

Parameters

Param Type Required Default Description
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=否

Returns (data)

Returns the standard OneBot envelope; the data shape is not yet documented.

Examples

curl
Python
JavaScript
Go
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}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.