微信好友管理 API：私域好友资产的增删改查与自动化

做私域，好友列表就是核心资产。WTAPI 文档"好友管理"模块提供添加、删除、备注、标签、列表检索等能力，配合 Webhook 事件可实现自动通过、僵尸粉清理等自动化。本文按好友资产的生命周期梳理这些能力的组合用法。

一、好友关系生命周期与能力对照

注：接口路径与字段以官方文档实际定义为准。

二、三个高价值自动化组合

组合 1：自动通过 + 欢迎语（社群运维场景）

文档"社群自动化运维"明确支持自动通过好友、发送欢迎语：新好友请求经 Webhook 推送 → 自动通过 → 即时发送欢迎语/资料 → 按标签邀请入群，全程无需人工盯守。

组合 2：标签分组 + 定向群发（群发通知场景）

通过备注与标签给好友分层（如"新客/老客/高意向"），群发通知系统批量发送图文/卡片/文件，支持定时任务——不同标签发不同内容，实现精细化运营。

组合 3：列表检索 + 僵尸粉清理（账号养护）

定期检索好友列表，清理僵尸粉与无效关系，维持账号互动质量；建议使用注册满 3 个月的实名账号 + 官方微信客户端登录。

三、代码示例：新客承接自动化（Python 形态，以官方文档为准）

def on_friend_request(event):
    """好友请求事件：自动通过 → 备注来源 → 打标签 → 欢迎语"""
    uid = event.get("fromWxId")
    scene = event.get("scene", "")          # 来源字段以文档为准

    call_api("friend/acceptRequest", {"wxId": uid})          # 自动通过
    call_api("friend/remark", {"wxId": uid,
             "remark": f"广告引流-{scene}"})                  # 备注来源
    call_api("friend/tag", {"wxId": uid, "tag": "新客"})      # 打标签
    call_api("sendText", {"to": uid,
             "content": "您好！欢迎添加，回复【资料】领取新人福利"})
    # call_api 统一携带 appId/instanceId 与双 Token，按 code:"1000" 判成败

四、多号资产管理：私域中台

文档"私域流量中台"场景支持统一管理多微信号、同步消息、聚合会话、留存聊天记录。通过 instanceId 区分不同微信账号，好友资产可在业务侧汇聚成统一客户库——这正是平安集团、泰康人寿等私域营销类客户的典型用法。

五、合规提醒

• 添加、群发面向真实意愿用户，控制频率，避免骚扰
• 客户数据的存储与使用遵守相关法律法规
• 平台内置动态 IP、支持自定义独享代理，AID 本地登录降低异地异常风险

背书

好友管理能力服务于私域营销与社群运维场景，WTAPI 平台 10w+ 日均调用、99.9% 可用性，SaaS（不存敏感数据）与私有化部署可选。