企微手机版
企微协议版微信协议版
企微协议版微信协议版
    • 文档首页
    • 更新日志
    • 手机版后台保活设置指南
    • Q&A 常见疑问
    • 回调
      • 回调格式
      • 设置回调URL
        POST
      • 查询回调URL
        POST
      • 删除回调URL
        POST
    • 用户
      • 获取用户信息
        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
      • 发送H5视频号消息
        POST
      • 发送位置
        POST
    • 客户
      • 同意客户申请
      • 获取企业联系人列表
      • 批量获取客户信息
      • 删除好友
      • 获取客户申请列表
      • 获取客户列表
      • 同步申请联系人
      • 同步联系人
      • 更新联系人
      • 批量删除单向好友
      • 获取缓存联系人列表
      • 获取单向好友列表
      • 获取用户信息(带检查)
      • 查询是否双向好友
      • 获取好友MultiData
      • 搜索微信/企微用户
      • 添加搜索的微信用户
      • 添加名片为联系人
      • 通过二维码名片获取联系人
      • 通过二维码名片添加微信用户
      • 重新添加被删联系人
      • 主动分页同步消息
      • 添加搜索到的企微用户
      • 检查名片联系人
      • 操作联系人黑名单
      • 批量删除单向好友
      • 获取缓存联系人列表
      • 获取单向好友列表
      • 获取用户信息(带检查)
      • 查询是否双向好友
      • 搜索微信/企微用户
      • 添加搜索的微信用户
      • 添加名片为联系人
      • 通过二维码名片获取联系人
      • 通过二维码名片添加微信用户
      • 重新添加被删联系人
      • 添加搜索到的企微用户
      • 检查名片联系人
      • 操作联系人黑名单
    • 会话
      • 获取会话群列表
      • 获取群置顶消息
      • 获取会话列表
      • 设置会话折叠
      • 设置会话免打扰
      • 设置会话置顶
      • 消息置顶/取消置顶
      • 会话操作(旧路径兼容)
      • 独立获取会话配置
      • 同步聊天标签列表
      • 创建聊天标签
      • 修改聊天标签
      • 删除聊天标签
      • 同步会话所属标签
      • 修改会话所属标签
      • 设置群置顶消息(协议)
      • 取消群置顶消息(协议)
    • 群组
      • 接受群邀请
      • 通过群添加联系人
      • 获取群成员列表
      • 批量获取群详情
      • 转让群主
      • 创建客户群
      • 解散群
      • 获取群聊黑名单
      • 获取群二维码
      • 添加群成员
      • 设置群昵称
      • 设置群邀请确认
      • 禁止改群名
      • 修改群名
      • 设置群公告
      • 修改群备注
      • 操作群黑名单
      • 退群
      • 移除群成员
      • 设置群管理员
      • 保存群到通讯录
      • 禁止互加联系人
      • 同步群信息
      • 获取客户群列表(协议)
      • 邀请/添加群成员(协议)
      • 获取入群欢迎语列表
      • 创建文本入群欢迎语
      • 应用已有入群欢迎语
      • 获取群防骚扰规则
      • 设置群关联的防骚扰规则
      • 操作客户群白名单
      • 审批群邀请申请
      • 设置群自动回复
      • 获取群模板
      • 将群模板应用到指定群
      • 创建客户群(空群别名)
      • 获取群置顶消息(别名)
      • 置顶群消息(别名)
      • 取消置顶群消息(别名)
      • 取消群管理员(别名)
    • 朋友圈
      • 设置朋友圈签名
      • 发布朋友圈
      • 获取发布的朋友圈记录
      • 获取指定朋友圈详情
      • 删除朋友圈
      • 评论朋友圈
      • 删除朋友圈评论
      • 点赞/取消点赞
      • 确认发送朋友圈任务
      • 获取朋友圈任务记录
      • 获取朋友圈任务发送状态
      • 设置朋友圈封面
    • 客户标签
      • 批量打标签
      • 创建标签
      • 删除标签
      • 获取企业标签
      • 获取个人标签
      • 修改标签
      • 操作用户标签
      • 获取企业和个人标签
      • 批量追加客户标签
    • 开放平台
      • ChatId转RoomId
      • 获取应用信息
      • 获取附件素材
      • 获取Banner列表
      • 获取个人Banner信息
      • OpenID转VID
      • RoomId转ChatId
      • VID转ExternalUserID
      • 检查OAuth URL
      • VID转OpenID
      • 获取URL动作码
    • CDN
      • 配置存储(OSS/COS/MinIO)
      • FTN下载文件
      • CDN下载文件
      • CDN上传文件
      • 上传图片
      • FTN上传文件
      • 微信文件下载
      • CDN上传文件(别名)
      • CDN下载文件(别名)
    • 组织架构
      • 获取架构节点数据
      • 修改同事信息
      • 同步公司架构
      • 同步同事信息
    • 企业
      • 获取企业简要信息
    • 同步
    • 数据模型
      • BaseRequest
      • GuidParam
      • ErrorResponse
      • CommonResponse

    Q&A 常见疑问

    如果你认为文档没能解决你的问题,可以把文档和demo https://github.com/Hanson/juhe-api-demo 复制粘贴到 deepseek 提问,亲测能解决 99% 的问题。
    Q: 没有收到回调?
    A: 要么不在线要么接收回调的代码有bug要么换设备登录没重新设置,不会有其他情况。
    Q: 发送参数看不懂?
    A: 接受回调,都有对应的参数,直接拿去传参,不要漏。适用于 视频号、小程序、图片、视频、文件。
    Q: 会话ID/conversation_id 是什么?如何获取
    A: 会话ID由 S:或R: + 用户ID或群聊ID 组成,例如 S:788xxxxx S:1688xxxxx R:10xxxxx。私聊前缀为 S: 群聊前缀为 R:。用户 ID 可以通过同步联系人、获取客户群列表或者消息回调里面获取。
    Q: 如何发送图片、视频、文件等资源?又如何下载?
    A: 先通过设置OSS配置云存储,调用 CDN上传文件 会有对应的发送参数,下载就调用 CDN下载文件 传参对应的回调参数便能下载到CDN。域名 https://imunion.weixin.qq.com 不是给你直接访问的。
    Q: 不同 file_id 格式的下载接口?
    https://wework.qpic.cn 开头的可以直接访问
    30 开头的用 CDN下载文件
    其他 https:// 开头的使用 微信文件下载
    *开头的需要用 FTN下载文件
    Q: file_type 区别?
    原图:1 (回调 is_hd=true)
    中图:2 (默认均用2)
    缩略图:3
    文件、语音:4
    视频:5
    CDN文件:6
    Q: 如何发送小程序?参数怎么传?点开小程序是空白的或点开出错?
    A: 接口地址,参数可以通过机器人的好友,发送给机器人一个小程序消息,从消息回调里面拿,封面图可以自行上传替换,所有参数都不能漏。
    Q: 发送的图片或文件空白、或点开无法查看?
    A: 上传参数有问题,URL需要确保能访问,图片上传的filetype 为 2,文件、语音为 4.
    Q: 参数的 seq 是什么?如何传参?
    A: 序号,首次传0或传空,下一页传返回值的seq,seq要保存起来。
    Q: 回调没有变动详情?
    A: 根据回调事件调用同步群信息 / 同步联系人去获取变动内容。
    Q: 如何获取自己非群主的群列表?
    A: 需要根据消息回调中的群ID,去调用批量获取群详情自行存起来。
    Q: 如何获取企业通讯录?内部联系人?
    A: 调用同步公司架构、同步同事信息获取。
    Q: 消息里的appinfo是什么?
    A: 消息的全局唯一ID,撤回消息可以通过这个找出撤回的消息。
    Q: 关于消息回调的 msgid, seq, appinfo 分别是什么?
    A: msgid 是用户维度下的唯一消息id。seq 是消息的序号,也是用户下唯一。appinfo 是全局的唯一 id,引用消息会用到。
    Q: 同一条消息有多条回调?
    A: 多条回调是含义不一样的,例如消息已读,撤回等等,可以只处理 referid 为 0 的消息。
    Q: 语音如何下载?如何转文字?
    A: CDN下载文件,file type = 4(文件/语音),文件为 silk 格式,可以通过 silk-v3-decoder 转成 mp3。如需转文字,使用申请语音转文字和查询语音转文字结果。
    Q: upload 或 download 接口出现报错 { "error_code": 4, "error_message": "OSS upload failed" }
    A:
    1.
    手机上的企微需要开通所有权限
    2.
    检查OSS配置
    3.
    检查调用参数
    修改于 2026-11-16 18:37:43
    上一页
    手机版后台保活设置指南
    下一页
    回调格式
    Built with