WTAPI开发文档
    • 平台简介
    • 快速入门
    • 登陆视频教程
    • 接入开发规范
    • 运维封控规范
    • 消息订阅收发
    • 综合问题排查
    • 回调信息速览
    • 回调消息详解
    • AI 辅助开发
    • 更新日志
    • API模块
      • 登录接口
        • ①获取登录二维码
        • ②执行登录
        • 弹窗登录
        • ③设置回调地址
        • 检查是否在线
        • 退出
        • 断线重连
      • 联系人接口
        • 获取通讯录列表
        • 获取通讯录列表缓存
        • 获取群/好友简要信息
        • 获取群/好友详细信息
        • 搜索好友
        • 添加联系人/同意添加好友
        • 删除好友
        • 设置好友仅聊天
        • 设置好友备注
        • 获取手机通讯录
        • 上传手机通讯录
        • 搜索企微
        • 添加企微好友
        • 同步企微好友
        • 获取企微好友详情
      • 消息接口
        • 下载
          • 下载文件
          • 下载CDN
          • 下载图片
          • 下载语音
          • 下载视频
          • 下载emoji和表情包
        • 发送文字消息
        • 发送文件消息
        • 发送图片消息
        • 发送语音消息
        • 发送视频消息
        • 发送链接消息
        • 发送名片消息
        • 发送emoji消息
        • 发送appmsg消息
        • 发送小程序消息
        • 转发文件
        • 转发图片
        • 转发视频
        • 转发链接
        • 转发小程序
        • 撤回消息
      • 个人接口
        • 获取个人资料
        • 获取自己的二维码
        • 获取设备记录
        • 隐私设置
        • 修改个人信息
        • 修改头像
      • 标签接口
        • 添加标签
        • 删除标签
        • 标签列表
        • 修改好友标签
      • 群聊接口
        • 创建微信群
        • 修改群名称
        • 修改群备注
        • 修改我在群内的昵称
        • 邀请/添加 进群
        • 删除群成员
        • 退出群聊
        • 解散群聊
        • 获取群信息
        • 获取群成员列表
        • 获取群成员详情
        • 设置群公告
        • 获取群公告
        • 同意进群
        • 添加群成员为好友
        • 获取群二维码
        • 群保存到通讯录
        • 管理员操作
        • 聊天置顶
        • 设置消息免打扰
        • 扫码进群
        • 确认进群申请
      • 朋友圈接口
        • 自己的朋友圈列表
        • 联系人的朋友圈列表
        • 点赞/取消点赞
        • 删除自己朋友圈
        • 设置朋友圈可见范围
        • 是否允许陌生人查看朋友圈
        • 设置某条朋友圈为隐私/公开
        • 下载朋友圈视频
        • 发送文字朋友圈
        • 发送图片朋友圈
        • 发送视频朋友圈
        • 发送链接朋友圈
        • 上传朋友圈图片
        • 上传朋友圈视频
        • 转发朋友圈
        • 某条朋友圈详情
        • 评论/删除评论
      • 收藏夹接口
        • 同步收藏夹
        • 获取收藏夹内容
        • 删除收藏夹
      • 视频号接口
        • 获取我的视频号信息
        • 修改我的视频号信息
        • 用户主页
        • 关注
        • 评论
        • 浏览
        • 发布视频-新
        • 关注列表
        • 消息列表
        • 评论列表
        • 获取赞与收藏的视频列表
        • 搜索视频号
        • 创建视频号
        • 同步私信消息
        • 根据id点赞
        • 根据id点小红心
        • 发送视频号消息
        • 发送视频号朋友圈
        • 获取私信人信息
        • 发私信文本消息
        • 发私信图片消息
        • 扫码关注
        • 搜索并关注
        • 扫码浏览
        • 扫码评论
        • 扫码点赞
        • 扫码点小红心
        • 延迟点赞、小红心
        • 扫码登录视频号助手
        • 扫码获取视频详情
        • 我的视频号二维码
        • 上传CDN视频
        • 发布CDN视频

    AI 辅助开发

    若你使用 ChatGPT / Claude / Cursor / 通义等 AI 编写对接代码,可按本节减少乱猜字段与鉴权错误。

    1. 先准备这些信息#

    把下面备好(不要把真实 Token 粘贴到公开对话里):
    项目示例
    Base URLhttps://wx.chuapi.com
    HeaderX-finder-TOKEN(必填);可能还需 Authorization: Bearer <JWT>
    Content-Typeapplication/json
    设备 IDappId(登录成功后保存)
    测试对象文件传输助手 / 自己的 wxid
    推荐:先在控制台完成登录拿到 appId,再让 AI 只写业务调用代码。

    2. 怎么把文档给 AI#

    1.
    打开文档站:https://weiti.apifox.cn/
    2.
    打开要用的接口页(例如「发送文字消息」)
    3.
    复制:路径、请求参数表、请求示例 JSON、返回示例
    4.
    贴进 AI,再加上面的提示词
    也可把「接入开发规范」+ 单个接口章节一起给 AI(不要一次粘贴全部 API,易超上下文)。

    3. 推荐提示词#

    通用模板#

    你是资深后端工程师。请根据我粘贴的 WTAPI 接口文档写代码。
    
    硬性要求:
    1. Base URL: https://wx.chuapi.com
    2. Header 必须带 X-finder-TOKEN;若文档有 Authorization 则同时带 Bearer JWT
    3. Content-Type: application/json
    4. 业务接口 Body 必须带 appId
    5. 以文档中的路径与字段名为准,不要自创字段
    6. 用环境变量占位 Token / appId,不要写死真实密钥
    7. 先写可运行的最小示例,再写封装
    
    我的语言:Python(可改为 Node.js / PHP / Java)
    我的目标:[例如:发一条文本给文件传输助手]
    
    下面是接口文档:
    [粘贴路径 + 参数表 + 示例 JSON]

    发文本消息#

    请用 Python requests 调用:
    POST https://wx.chuapi.com/finder/v2/api/message/postText
    
    Header:
    X-finder-TOKEN: ${TOKEN}
    Authorization: Bearer ${JWT}
    Content-Type: application/json
    
    Body 字段以文档为准,至少包含:appId、toWxid、content。
    请输出完整可运行脚本,并打印响应 JSON。

    接收回调(Webhook)#

    请用 Node.js + Express(或 Flask)写一个 Webhook:
    1. 接收 POST JSON
    2. 立即返回 200
    3. 异步打印原始 body
    4. 若是文本消息,再调用 WTAPI 发送接口回复「收到」
    5. 做简单幂等(按消息 ID 去重)
    6. 不要假设「自己发出的消息也会回调」
    
    鉴权与 appId 用环境变量。

    4. 推荐开发顺序#

    1.
    登录节点(控制台或登录接口)→ 拿到 appId
    2.
    检查在线(checkOnline)
    3.
    发测试文本给文件传输助手
    4.
    配 Webhook(setCallback + 接收服务)
    5.
    打印回调样例后再建模
    6.
    再扩展自动回复、群发、好友等
    可对 AI 说:「先别写完整产品,先给我第 1–3 步的最小可运行示例」。

    5. 常见坑#

    坑正确做法
    自创路径 / 字段必须以文档为准(/finder/v2/api/...)
    忘记 appId几乎所有业务接口都要带
    Header 写错是 X-finder-TOKEN
    多线程狂发单队列 + 间隔
    回调里同步重逻辑先 200,业务异步
    期待主动发送也回调API 主动发送通常无回声
    媒体首包就下载等待二次回调再下
    把真实密钥粘给 AI用环境变量 / 占位符

    6. 验收清单(约 30 秒)#

    URL 与文档一致
    带了 X-finder-TOKEN 与 appId
    Body 字段名来自文档
    能先发通一条测试消息
    Webhook 快速返回 200
    有基本错误处理(打印 ret / msg)

    7. 最小工程结构#

    project/
      .env                 # TOKEN / JWT / APP_ID(勿提交到 Git)
      send_text.py         # 发测试文本
      webhook_server.py    # 接收回调
      README.md
    完成最小闭环后,再让 AI 扩展群发队列、好友通过、多媒体发送等。
    修改于 2026-09-08 12:30:24
    上一页
    回调消息详解
    下一页
    更新日志
    Built with