功能简介
基于指定消息向发送者发起好友申请。
使用场景
- 需要从群聊成员消息直接发起加好友时。
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 消息序号 | 整数 | 是 | 消息在最近一次消息列表中的序号。 |
| 附加消息 | 字符串 | 否 | 添加好友时附带的消息内容。 |
| 备注 | 字符串 | 否 | 添加成功后设置的备注。 |
| 权限 | 字符串 | 否 | 添加好友后的权限。 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 是否成功 | 布尔值 | 是 | 表示本指令的执行判定结果:调用过程中未抛出异常,且底层未返回明确失败值时为 True;若底层抛出异常或返回明确失败值,则判定为失败。 |
注意事项
- 消息序号基于最近一次【获取当前消息】、【获取历史消息】或【获取下一个新消息】的输出结果。
- 若消息序号来自【获取历史消息】,通常仅对获取完成后当前聊天窗口底部可见的一屏历史消息范围内的消息更稳定。
- 「是否成功」为执行层判定;好友申请是否成功发出及最终结果,受对方设置、验证状态等因素影响,请以微信客户端实际结果为准。
