群聊 @成员

在群聊中发送文本消息，并 @ 指定群成员。

接口地址： POST /sendText

前置条件

• 微信实例已登录，并已获得可用 wId。
• 当前微信实例仍在目标群聊中，并已获得可用的群 ID。
• content 需要自行拼接 @昵称 文本，否则微信端可能不会展示为有效 @。
• at 需要传被 @ 成员的微信 ID；如群主或管理员需要 @所有人，可传 notify@all。

请求参数

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

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object/null	成功时返回消息发送结果，失败时通常为空
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
}

使用建议

• 先通过 获取群成员 获取成员 userName，再组装 at。
• @所有人属于高打扰操作，建议只开放给管理员角色并记录操作日志。
• 发送成功后可使用返回的 data.newMsgId 做消息排重和后续追踪。