1. 引言

智能客服要接个人微信，接口不要按「每个微信能力一个函数」去想，按会话生命周期来：消息进入、状态变更、回复出去。两边字段对齐了，后面换模型也不用改通道。

本文将围绕「个人微信API：AI智能客服的接口实现思路」给出一套内部接口划分。GeWe API 提供个人号 RPA 收发，你的智能客服只认自己的入站 / 出站接口，外部群走同一套出站。

2. 接口怎么划

2.1 对内三组即可

接口	方向	作用
入站	微信 → 客服	推送文本 / 事件，带消息标识
出站	客服 → 微信	按设备 + 对方发回复
会话	双向	查询 / 设置：自动、人工、静音

入站要快返回。生成、检索放到出站之前的异步任务，避免微信侧重试把同一条再推一次。

2.2 主键用对方标识

会话 ID 用好友或群的稳定标识，不要用昵称。设备 ID 和对方 ID 成对出现，多开个人号时才不会串号。

入站怎么接到、出站怎么发出，以这份说明为准。

GeWe API文档

3. 示例

def inbound_api(body):
    msg_id, device, peer, text = parse(body)
    if seen(msg_id):
        return {"ok": True}
    enqueue_cs(device, peer, text, msg_id)
    return {"ok": True}

def outbound_job(device, peer, text):
    send(device=device, to=peer, text=text)

入站只负责解析和入队。出站任务才调用发送，失败进重试表，不回流入站。

4. 验收

• 入站重复请求返回成功，且不会再入队。

• 客服把会话设为人工后，出站任务会被跳过。

• 两只个人号的同一句测试，不会发到错误的设备。

5. 总结

智能客服接微信，用入站、出站、会话三组接口就够。GeWe API 对应真实收发，你们内部协议保持短、异步、可重试。