群聊 @

向微信群发送带 @ 的文本消息。content 中需要包含可见的 @昵称，at 中传入被 @ 成员的微信 ID。

接口地址： POST /sendText

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 接收方 wcId 必须是群 ID，通常以 @chatroom 结尾。
• content 中需要拼接 @昵称，否则微信侧不会展示为 @ 效果。
• at 使用群成员微信 ID；需要 @ 多人时用英文逗号分隔。
• 群主或管理员 @ 全员时，at 传 notify@all。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方群 ID
content	是	string	文本内容；需要包含 @昵称
at	是	string	被 @ 成员的微信 ID，多个用英文逗号分隔；@ 全员传 notify@all

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.type	int	类型
data.msgId	long	消息 ID
data.newMsgId	long	新消息 ID
data.createTime	long	发送时间戳（秒）
data.wcId	string	接收方 ID

请求示例

{
 "wId": "0000016f-8911-484a-0001-db2943fc2786",
 "wcId": "22270365143@chatroom",
 "at": "wxid_lr6j4nononb921,wxid_i6qsbbjenjuj22",
 "content": "@E云Team_Mr Li 请确认今天的客户跟进记录"
}

成功响应

{
 "code": "1000",
 "message": "处理成功",
 "data": {
 "type": 1,
 "msgId": 2562652205,
 "newMsgId": 4482117376572170921,
 "createTime": 1641457769,
 "wcId": "22270365143@chatroom"
 }
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 发送前建议先通过「获取群成员列表」确认成员微信 ID，避免 @ 错人。
• @ 全员会强提醒群成员，建议仅在群主或管理员后台开放。
• 业务侧建议保存返回的 msgId、newMsgId、createTime，用于后续撤回或发送结果追踪。