企微手机版
企微协议版微信协议版
企微协议版微信协议版
    • 文档首页
    • 回调
      • 回调格式
      • 设置回调URL
        POST
      • 查询回调URL
        POST
      • 删除回调URL
        POST
    • 用户
      • 获取用户信息
        POST
      • 获取联系人二维码
        POST
      • 修改姓名
        POST
      • 修改别名
        POST
      • 修改头像
        POST
      • 修改性别
        POST
    • 消息
      • 发送文本消息
        POST
      • 撤回消息
        POST
      • 发送大视频
        POST
      • 发送视频号
        POST
      • 发送文件
        POST
      • 发送合并转发
        POST
      • 发送表情/GIF
        POST
      • 发送图片
        POST
      • 发送链接
        POST
      • 发送名片
        POST
      • 发送@消息(群聊)
        POST
      • 发送视频
        POST
      • 发送语音
        POST
      • 发送小程序
        POST
    • 客户
      • 同意客户申请
        POST
      • 获取企业联系人列表
        POST
      • 批量获取客户信息
        POST
      • 删除好友
        POST
      • 获取客户申请列表
        POST
      • 获取客户列表
        POST
      • 同步申请联系人
        POST
      • 同步联系人
        POST
      • 更新联系人
        POST
      • 批量删除单向好友
        POST
      • 获取缓存联系人列表
        POST
      • 获取单向好友列表
        POST
      • 获取用户信息(带检查)
        POST
      • 查询是否双向好友
        POST
      • 获取好友MultiData
        POST
    • 会话
      • 获取会话群列表
      • 获取群置顶消息
      • 获取会话列表
      • 设置会话折叠
      • 设置会话免打扰
      • 设置会话置顶
      • 消息置顶/取消置顶
    • 群组
      • 接受群邀请
      • 通过群添加联系人
      • 获取群成员列表
      • 批量获取群详情
      • 转让群主
      • 创建客户群
      • 解散群
      • 获取群聊黑名单
      • 获取群二维码
      • 添加群成员
      • 设置群昵称
      • 设置群邀请确认
      • 禁止改群名
      • 修改群名
      • 设置群公告
      • 修改群备注
      • 操作群黑名单
      • 退群
      • 移除群成员
      • 设置群管理员
      • 保存群到通讯录
      • 禁止互加联系人
      • 同步群信息
    • 朋友圈
      • 设置朋友圈签名
    • 客户标签
      • 批量打标签
      • 创建标签
      • 删除标签
      • 获取企业标签
      • 获取个人标签
      • 修改标签
      • 操作用户标签
      • 获取企业和个人标签
    • 开放平台
      • ChatId转RoomId
      • 获取应用信息
      • 获取附件素材
      • 获取Banner列表
      • 获取个人Banner信息
      • OpenID转VID
      • RoomId转ChatId
      • VID转ExternalUserID
      • VID转OpenID
    • CDN
      • FTN下载文件
      • CDN下载文件
      • CDN上传文件
      • 上传图片
      • FTN上传文件
      • 微信文件下载
    • 组织架构
      • 获取架构节点数据
      • 修改同事信息
      • 同步公司架构
      • 同步同事信息
    • 企业
      • 获取企业简要信息
    • 数据模型
      • BaseRequest
      • GuidParam
      • ErrorResponse
      • CommonResponse

    文档首页

    此版本接口并非最全版本，更全版本建议使用 https://wework.apifox.cn/ ，手机版可以避免出现发送资源（小程序、图片、文件）频繁
    🚀🚀🚀 本项目运行在安卓手机上，可以是真实物理机也可以是虚拟机。手机需要安装 magisk https://juhexbot.feishu.cn/docx/HZmzdcML1opcaRx1F0WcOxxynPc

    联系#

    +v hansonskr2
    登录前3天，不要做群发、发朋友圈、主加好友。
    提示风控、环境异常等原因导致退出登录，都是属于正常现象，登录久了设备就会转成常用设备，就不会退出登录。

    调用方式#

    此文档所有接口调用需根据 https://juhexbot.feishu.cn/docx/Vh6Qd2HwGoAdoaxvaovcmJGWnnh 操作。

    调用频率#

    手机版暂时不设置频率限制，但为了你的账号安全，请合理调用接口。

    概念说明#

    实例#

    创建实例相当于创建了一个虚拟机器，一个实例只登录一个号，如需登录其他账号请重新创建实例，不用的实例可以删除。

    登录#

    原则上扫码确认后即可登录，无需调用 manual_login 和 keep_login

    云存储#

    云存储可以把文件直接上传到阿里云或腾讯云，开发者无需二次开发这部分

    ID 说明#

    微信的外部联系人开头为 788
    企微用户的开头为 168（无论是自己企业还是他人企业）
    外部群一般为 10 开头
    这里的ID不会因为不同用户、不同企业改变而改变，都是固定值
    发送消息的 conversation_id 为
    私聊 S:788xxxxx
    群聊 R:10xxxxxxxx
    群ID开头要有 R:
    联系人ID开头要有 S:
    否则会报错
    conversation_id 可以通过同步联系人、获取客户群列表或者消息回调里面获取。

    file id#

    file id 为资源参数，可以通过调用上传接口获取。或者通过消息回调获取。

    seq#

    seq为序号，首次不传，下一页传返回值里返回的seq

    file_type#

    图片：1 （回调 is_hd=true）
    图片：2 （默认均用2）
    小程序封面：3
    视频：4
    文件、语音：5

    消息#

    referid#

    referid 为0 证明是原消息，不为0 时 referID 等于消息 ID，证明消息有过变动（例如该消息为某条消息的 已读、撤回 等附属消息）。

    CDN#

    下载#

    file_id（某些场景字段名可能为URL）#

    https://wework.qpic.cn 开头的可以直接访问
    30 开头的用 C2C文件下载
    其他 https:// 的使用 微信文件下载
    *开头的需要用 大文件下载

    上传#

    消息使用 C2C 上传
    朋友圈资源使用 BIG CDN
    修改于 2026-06-12 19:03:13
    下一页
    回调格式
    Built with