设置自动通过好友请求接口

前言

在私域流量运营和微信客服场景中，人工逐条审核好友请求既耗时又容易漏单。尤其是当多个渠道同时引流、单日进线数百人时，手动点"接受"会直接拖慢用户触达速度，影响转化率。借助 WechatApi 个人微信API 提供的自动通过好友请求接口，可以在毫秒级完成验证回应，让每一条进线都不再等待。

为什么需要自动通过好友请求

人工审核的瓶颈

微信好友请求没有批量操作入口，官方客户端只能一条条点击。当你的运营号每天接收几十甚至几百条好友申请时，纯靠人工意味着：

• 响应延迟：用户发起申请到被通过，中间可能等待数小时，黄金触达窗口就此错失。
• 遗漏风险：消息列表混杂，好友请求气泡容易被忽视，高峰时段更难保证 100% 处理。
• 人力成本：分配专人盯屏或定时轮询，都是额外的运营负担。
• 多号管理困难：同时运营 3~5 个微信号时，人工切换审核几乎不可持续。

自动化接口彻底解决以上问题——系统收到好友请求事件后，立即调用接口完成通过，整个流程无需人介入。

适用业务场景

可以看到，自动通过好友请求不是孤立功能，它几乎是所有私域自动化流程的第一个节点。

WechatApi 接口原理与鉴权机制

WechatApi 基于 微信iPad协议 实现，绕开了官方客户端的 UI 层，直接在协议层完成消息收发与好友管理动作。这意味着调用接口与用户在手机上点击"接受"在协议层是完全等价的，不存在模拟点击或注入风险。

鉴权方式

所有请求通过 HTTP 请求头 VideosApi-token 传递鉴权令牌，令牌在 控制台 创建设备后获取。每个设备对应一个 appId（设备ID），在请求体中通过 appId 字段指定操作的微信账号。

基本请求结构：

POST /your-endpoint HTTP/1.1
Host: api.wechatapi.net
Content-Type: application/json
VideosApi-token: <your_token>

{
  "appId": "<your_device_id>",
  ...业务参数
}

返回体统一结构：

json{
  "ret": 200,
  "msg": "操作成功",
  "data": {
    "result": true
  }
}

ret 为 200 表示成功，非 200 时 msg 字段会说明失败原因，例如 token 失效、设备离线、参数缺失等。

触发时机：监听好友请求事件

自动通过好友请求的前提是知道"有人发来了好友申请"。WechatApi 支持 Webhook 回调——设备在线时，一旦收到好友请求，服务端会向你预先配置的回调地址推送事件消息。

典型的好友请求回调载荷包含以下字段：

json{
  "event": "friend_request",
  "appId": "device_abc123",
  "data": {
    "fromUser": "wxid_xxxxxxxx",
    "nickName": "张三",
    "avatar": "https://...",
    "content": "我是从公众号来的",
    "ticket": "v4_xxxxxx_xxxxx",
    "scene": 3
  }
}

关键字段说明：

• fromUser：申请人的微信 ID，后续可用于发送消息、设置备注等操作。
• ticket：好友请求的凭证，调用通过接口时必须携带此字段，相当于这次申请的唯一凭据。
• scene：加好友来源场景码，常见值：3=搜索号码，14=扫描二维码，17=通过名片，30=群聊。可根据 scene 做差异化处理，例如来自特定群聊的申请才自动通过。
• content：用户填写的验证信息，可用于关键词过滤。

调用通过好友请求接口

拿到 ticket 之后，调用通过接口即可完成好友确认。接口接受 HTTP POST 请求，携带设备 ID 和 ticket。

Python 示例

以下示例展示了一个完整的 Webhook 处理函数，收到好友请求事件后立即自动通过：

pythonimport httpx
from fastapi import FastAPI, Request

app = FastAPI()

WECHAT_API_BASE = "https://api.wechatapi.net"
API_TOKEN = "your_videos_api_token_here"
DEVICE_APP_ID = "your_app_id_here"

def accept_friend_request(ticket: str) -> dict:
    """调用 WechatApi 通过好友请求接口"""
    url = f"{WECHAT_API_BASE}/accept-friend"  # 示意路径，以文档为准
    headers = {
        "VideosApi-token": API_TOKEN,
        "Content-Type": "application/json",
    }
    payload = {
        "appId": DEVICE_APP_ID,
        "ticket": ticket,
        "remark": "",   # 可在通过时顺便设置备注
    }
    resp = httpx.post(url, json=payload, headers=headers, timeout=10)
    return resp.json()

@app.post("/webhook/wechat")
async def wechat_webhook(request: Request):
    body = await request.json()
    event = body.get("event")

    if event == "friend_request":
        ticket = body["data"]["ticket"]
        from_user = body["data"]["fromUser"]
        result = accept_friend_request(ticket)

        if result.get("ret") == 200:
            print(f"[OK] 已通过 {from_user} 的好友请求")
            # 可在此处触发后续动作：发欢迎语、打标签、记录 CRM
        else:
            print(f"[FAIL] 通过失败：{result.get('msg')}")

    return {"status": "ok"}

整个处理过程在 Webhook 回调的生命周期内完成，用户体验到的是：发出申请后几乎立即收到通过通知。

curl 快速验证示例

在正式接入前，可以用 curl 手动触发一次，确认 token 和 appId 配置正确：

bashcurl -X POST https://api.wechatapi.net/accept-friend \
  -H "VideosApi-token: your_videos_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "your_app_id_here",
    "ticket": "v4_sample_ticket_string",
    "remark": "广告渠道A"
  }'

正常返回：

json{
  "ret": 200,
  "msg": "success",
  "data": {
    "result": true
  }
}

若返回 ret 非 200，请检查：token 是否过期、设备是否在线（控制台状态显示"已连接"）、ticket 是否为最新请求生成的值（ticket 有时效，超时会失效）。

进阶：条件过滤与差异化处理

全量自动通过并非适合所有场景。实际业务中，往往需要根据来源、验证信息做条件判断，只通过符合条件的请求，其余的进入人工队列或直接忽略。

按场景码过滤

pythonALLOWED_SCENES = {14, 30}  # 只自动通过：扫码 + 来自群聊

if event == "friend_request":
    scene = body["data"].get("scene", 0)
    ticket = body["data"]["ticket"]

    if scene in ALLOWED_SCENES:
        accept_friend_request(ticket)
    else:
        # 推送到人工审核队列（如飞书、钉钉通知）
        notify_manual_review(body["data"])

按验证信息关键词过滤

pythonKEYWORDS = ["公众号", "小红书", "活动"]

content = body["data"].get("content", "")
if any(kw in content for kw in KEYWORDS):
    accept_friend_request(ticket)

通过后自动触发欢迎消息

好友通过之后，通常需要立即发送欢迎语。WechatApi 提供发送文本消息接口，可以在通过后的回调中串联调用，实现"通过+欢迎"一气呵成的自动化链路，这也是 微信机器人开发 中最典型的入口场景。

注意事项与风险控制

频率与并发

• 单设备不建议在极短时间内大量通过好友请求（比如几秒内通过数十条），建议在代码中加入适当延迟（100~500ms）或队列限速，模拟正常用户操作节奏。
• 如果有多个设备同时运营，每个设备的 appId 相互独立，确保在 Webhook 路由时正确区分设备，避免跨设备调用 ticket。

ticket 时效性

好友请求的 ticket 在微信协议层有有效期，通常为数天，但建议收到 Webhook 后立即处理，不要将 ticket 存库后延迟处理，以免失效导致通过失败。

异常重试

网络抖动可能导致接口调用失败。建议实现简单的重试逻辑（最多 2~3 次，指数退避），同时记录失败的 ticket 和 fromUser，便于后续人工补救。

合规与账号安全

WechatApi 基于 微信iPad协议 接入，属于协议层调用，相比 Xposed/注入方案更稳定，但仍需在正常的使用频率范围内操作。建议：

• 不要在短时间内对同一设备发起海量好友通过动作；
• 配合 微信SCRM 系统做用户行为记录，保留通过记录以备核查；
• 定期检查控制台设备状态，发现掉线及时重新登录，避免因设备离线导致请求堆积。

接口文档与调试

所有接口的完整参数、错误码和返回示例请以 WechatApi 开发文档 为准，本文示例仅展示调用范式，实际 endpoint 路径以文档最新版本为准。在开发阶段建议开启详细日志，打印每次请求的完整 payload 和响应，便于快速定位问题。

小结

自动通过好友请求接口是微信私域自动化的核心入口之一。整体实现路径清晰：配置 Webhook 接收事件 → 解析 ticket → 调用通过接口 → 串联后续动作（欢迎语、打标签、CRM 录入）。借助 WechatApi 提供的 iPad 协议接入方式，整个链路稳定可靠，鉴权逻辑统一（VideosApi-token + appId），返回结构规范，易于与现有业务系统集成。

对于需要管理多个微信运营号、或有大量进线需求的团队，这套方案可以将好友通过响应时间从分钟级压缩到秒级，显著提升私域运营效率。如需了解更多接口能力，可前往 WechatApi 控制台 注册试用，或查阅完整的 开发文档。