企微手机版
企微协议版微信协议版
企微协议版微信协议版
  1. 回调
  • 文档首页
  • 更新日志
  • 手机版后台保活设置指南
  • 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
  1. 回调

回调格式

Fila 回调 API 文档#

1. 回调管理接口#

通过 GuidRequest 接口(OpenApp 鉴权)管理回调 URL,设置后设备事件自动 POST 到指定地址。

2. 回调推送格式#

设置回调后,设备事件会以 HTTP POST 推送到 callback_url。

2.1 HTTP 请求#

POST {callback_url}
Content-Type: application/json
AppKey: {open_app 的 app_key}
AppSecret: {open_app 的 app_secret}

2.2 推送 JSON 结构#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 1,
  "payload": { ... }
}

2.3 事件类型#

notify_type类型说明
1设备上线设备连接成功,含企微用户资料
2设备下线设备断开连接
3新消息收到聊天消息(数组)
4客户申请收到好友申请
5客户变更联系人信息变更
6群信息变更群信息/群成员等变更
7朋友圈变更朋友圈新增动态/评论/点赞等(v1.0.44+)
8朋友圈任务管理员下发朋友圈任务/提醒(v1.0.44+)
9群发任务管理员群发任务提醒(v1.0.44+)
10群名称变更群被改名(v1.0.44+)

3. 各事件 payload 详情#

notify_type: 1 — 设备上线#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 1,
  "payload": {
    "profile": {
      "user_id": "1688853377964182",
      "name": "张三",
      "avatar": "https://wx.qlogo.cn/xxx",
      "corp_id": "1970325782990871",
      "corp_short_name": "XX科技",
      "corp_full_name": "XX科技有限公司"
    }
  }
}
字段类型说明
profile.user_idstring企微 uin
profile.namestring用户昵称
profile.avatarstring头像 URL
profile.corp_idstring企业 ID
profile.corp_short_namestring企业简称
profile.corp_full_namestring企业全称
corp_* 三字段需网关 v1.0.44+,旧版可能缺失。

notify_type: 2 — 设备下线#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 2,
  "payload": {
    "profile": {
      "user_id": "1688853377964182",
      "name": "张三"
    },
    "scene": 1
  }
}
字段类型说明
profile.user_idstring企微 uin
profile.namestring用户昵称
sceneint下线场景

notify_type: 3 — 新消息#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 3,
  "payload": {
    "messages": [
      {
        "msg_type": "text",
        "id": "41952752",
        "seq": "23629366",
        "sender": "1688858271876706",
        "receiver": "1688855875615249",
        "roomid": "10855906979082597",
        "sender_name": "张三",
        "sendtime": 1793957776,
        "content_type": 2,
        "referid": "0",
        "flag": 83886592,
        "appinfo": "CIGABBD4vrbXBhjijPyqn4CAAyDvWQ==",
        "asid": "0",
        "extra_content": "base64 编码的额外数据",
        "msg": {
          "content": "你好",
          "at_list": ["7881300144304401"]
        }
      }
    ]
  }
}
顶层公共字段(所有消息类型一致):
字段类型说明
msg_typestring消息类型,见下表
idstring消息 ID(用户维度唯一)
seqstring消息序号(用户维度唯一)
appinfostring消息全局唯一 ID(撤回、引用消息会用到)
senderstring发送者 ID
receiverstring接收者 ID
roomidstring群 ID;私聊为 "0"
sender_namestring发送者昵称
sendtimeint发送时间戳(秒)
content_typeint内容类型
referidstring0=原消息;非 0 时其值等于某条消息的 id,代表该消息的附属事件(已读回执、撤回等)
flagint消息标记位
asidstring客服场景账号 ID,一般为 "0"
extra_contentstring额外数据(被引用消息快照等,base64)
msgobject消息体,字段随 msg_type 变化,见下表
msg_type 类型表(各类型 msg 字段结构见下方「消息类型详解」):
msg_type说明msg 内主要字段
text文本content、at_list
image图片file_id、aes_key、auth_key、md5、size、image_width、image_height、is_hd
video / big_video视频file_id、aes_key、auth_key、md5、size、video_duration、video_width、video_height、preview_img_file_id;big_video 另有 preview_image_* 封面字段
voice语音file_id、aes_key、md5、size、voice_time(秒)
file文件file_id、aes_key、md5、size、file_name
emotion表情url、md5、image_width、image_height
link链接卡片title、desc、url、image_url
location位置title、address、longitude、latitude、zoom
personal_card个人名片user_id
weapp小程序title、appname、appid、page_path、appicon、username、file_id、aes_key、md5、size
feed_video / feed_live / feed_video_h5 / finder_video_h5视频号nickname、title、desc、url、cover_url、avatar 等
mixed图文混合msg_list
app_text_card文本卡片title、desc、url
forward / nested_forward合并转发message_title、message_list
revoke撤回msg 为事件骨架;被撤回消息 id 见顶层 referid
hongbao红包hongbao_id、money(分)、remark、desc
transfer转账转账提示文案
word_chain群接龙content、chain_config
system系统提示content
pv_merge_single音视频通话记录record_wording(未接听/对方已取消等)、record_type
图片/视频/语音/文件的 file_id、aes_key、md5、size 是下载凭证,可直接传给 CDN下载文件 下载。

消息类型详解(notify_type: 3 的 msg_type)#

以下按 msg_type 逐一说明 msg 消息体结构。示例均来自线上真实消息(超长凭证字段已截短)。

text — 文本#

字段类型说明
msg.contentstring文本内容;@某人时内容里带 @昵称 尾缀
msg.at_liststring[]被 @ 的用户 ID 列表(无 @ 时字段缺失),"0" 表示 @所有人
msg.quote_appinfostring引用消息时为被引用消息的 appinfo
msg.quote_contentstring引用摘要(可能为空)
引用消息:被引用原消息的完整快照在顶层 extra_content(base64 编码)。
"msg": {
  "content": "这个是旧的吧?要新的FBA19QRMMGNS@慧宇港前  ",
  "at_list": ["7881300144304401"],
  "quote_appinfo": "6940925687550447375",
  "quote_content": ""
}

image — 图片#

字段类型说明
msg.file_idstringCDN 文件标识(URL 形态,实际下发为完整地址)
msg.aes_keystring解密密钥
msg.auth_keystring鉴权凭证(可能为空)
msg.md5string文件 MD5
msg.sizeint文件字节数
msg.image_widthint图片宽(像素)
msg.image_heightint图片高(像素)
msg.is_hdbool是否原图
"msg": {
  "file_id": "https://imunion.weixin.qq.com/...(完整 URL)",
  "aes_key": "73d70ead3a5876cd97cbab6e5cfb1c17",
  "auth_key": "v1_dfc7d18371ea90f154ef2...",
  "md5": "dc0300e806912072fb776ab9baa37c4a",
  "size": 57338,
  "image_width": 150,
  "image_height": 105,
  "is_hd": false
}

video / big_video — 视频#

字段类型说明
msg.file_idstringCDN 文件标识(URL 形态)
msg.aes_key / msg.auth_key / msg.md5 / msg.size—下载凭证(同图片)
msg.file_namestring文件名(可能为空)
msg.video_durationint时长(秒)
msg.video_width / msg.video_heightint视频分辨率
msg.preview_img_file_idstring封面图 CDN 标识
msg.preview_img_sizeint封面图大小(字节)
big_video(大视频)另有 preview_image_url(封面直链)与 preview_image_width / preview_image_height / preview_image_size / preview_image_md5。
"msg": {
  "file_id": "https://imunion.weixin.qq.com/...(完整 URL)",
  "aes_key": "97359c5f73f8961ddcb6e5c0a2925414",
  "auth_key": "v1_4942a3efb0ee9353d5946...",
  "md5": "e59c5e076eada47e36e1a253bafb738a",
  "size": 6841441,
  "file_name": "",
  "video_duration": 42,
  "video_width": 1080,
  "video_height": 1920,
  "preview_img_file_id": "https://imunion.weixin.qq.com/...(完整 URL)",
  "preview_img_size": 7710
}

voice — 语音#

字段类型说明
msg.file_idstringCDN 文件标识(hex 串形态)
msg.aes_key / msg.md5string解密凭证
msg.sizeint文件字节数
msg.voice_timeint语音时长(秒)
"msg": {
  "file_id": "308181020102047a30780201...",
  "aes_key": "6F6E626A6F63656374796D6F62756366",
  "md5": "9584c336d1091943119692e58f5e0db6",
  "size": 26727,
  "voice_time": 15
}

file — 文件#

字段类型说明
msg.file_idstringCDN 文件标识(hex 串形态)
msg.aes_key / msg.md5string解密凭证
msg.sizeint文件字节数
msg.file_namestring文件名(含扩展名)
"msg": {
  "file_id": "306b02010204643062020100...",
  "aes_key": "66373232333637313665623563343138",
  "md5": "7822499fe5fc1838fbdd8258d0a3e801",
  "size": 904140,
  "file_name": "报关资料1106.zip"
}

emotion — 表情#

字段类型说明
msg.urlstring表情图直链 URL,可直接展示
msg.md5string文件 MD5
msg.image_width / msg.image_heightint尺寸(像素)
file_id / aes_key / size 一般为空值,直接用 url 展示即可。
"msg": {
  "url": "https://wework.qpic.cn/wework_pic/...",
  "md5": "8b72abdfbac216939cd3c9a7f42d221c",
  "image_width": 240,
  "image_height": 258
}

link — 链接卡片#

字段类型说明
msg.titlestring标题
msg.descstring描述
msg.urlstring跳转链接
msg.image_urlstring缩略图 URL
msg.cdnobject可选。部分带图卡片(如会议邀请)的封面图 CDN 凭证,字段同 image(file_id / aes_key / auth_key / md5 / size)
"msg": {
  "title": "邀请你加入群聊",
  "desc": "运营-小邱邀请你加入群聊",
  "url": "https://work.weixin.qq.com/...",
  "image_url": "https://wework.qpic.cn/wework_pic/..."
}

location — 位置#

字段类型说明
msg.titlestring位置名称
msg.addressstring详细地址
msg.longitudedouble经度
msg.latitudedouble纬度
msg.zoomint地图缩放级别
"msg": {
  "title": "龙户人家串串香火锅(奎星楼店)",
  "address": "四川省成都市青羊区吉祥苑39号附1号",
  "longitude": 104.052276611,
  "latitude": 30.669752121,
  "zoom": 15
}

weapp — 小程序#

字段类型说明
msg.titlestring消息标题
msg.appnamestring小程序名称
msg.appidstring小程序 appid
msg.usernamestring小程序原始 ID(gh_xxx@app)
msg.page_pathstring页面路径
msg.appiconstring图标 URL
msg.file_id / msg.aes_key / msg.md5 / msg.size—封面图 CDN 凭证
"msg": {
  "title": "进入小程序->点击保存至相册",
  "appname": "小飞豆去水印",
  "appid": "wx10572f6c399c5df7",
  "username": "gh_47d063cd6d11@app",
  "page_path": "pages/video/index.html?...",
  "appicon": "http://wx.qlogo.cn/mmhead/...",
  "file_id": "30819602010204818e30818b...",
  "aes_key": "76786A736475706D707962796A6B7868",
  "md5": "4e2b88af29a4c842ebab288db64e2cfd",
  "size": 147895
}

feed_video / feed_live / feed_video_h5 / finder_video_h5 — 视频号#

视频号卡片消息,四个 msg_type 结构相同。以线上最常见的 finder_video_h5(H5 视频号)为例:
字段类型说明
msg.feed_typeint视频号内容类型
msg.nicknamestring视频号账号昵称
msg.avatarstring账号头像 URL
msg.titlestring卡片标题("[视频号]" + 内容标题)
msg.descstring内容描述
msg.urlstring跳转链接
msg.cover_url / msg.image_urlstring封面图 URL
msg.thumb_urlstring缩略图 URL(可能为空)
msg.export_new_urlstring导出链接
msg.is_h5 / msg.use_h5boolH5 卡片标记
msg.is_horizontalbool是否横屏
msg.live_statusint直播状态(feed_live 相关)
msg.extras / msg.object_id / msg.object_nonce_idstring扩展信息(可能为空)
"msg": {
  "feed_type": 4,
  "nickname": "金石三维深圳总生产基地",
  "avatar": "https://wx.qlogo.cn/finder/...",
  "title": "[视频号]尼龙3d打印和注塑要怎么选#3d打印#注塑模具",
  "desc": "尼龙3d打印和注塑要怎么选#3d打印#注塑模具#塑料成型#机械原理",
  "url": "https://channels.weixin.qq.com/...",
  "cover_url": "https://finder.video.qq.com/...",
  "image_url": "https://finder.video.qq.com/...",
  "export_new_url": "https://channels.weixin.qq.com/...",
  "is_h5": true,
  "use_h5": true,
  "is_horizontal": false,
  "live_status": 0,
  "thumb_url": "",
  "extras": "",
  "object_id": "",
  "object_nonce_id": ""
}

mixed — 图文混合#

字段类型说明
msg.msg_listarray子消息列表,每项结构同顶层消息(msg_type / sender / sender_name / sendtime / content_type / conv_id / conv_type / corp_id / appinfo / extra_content / msg)
"msg": {
  "msg_list": [
    {
      "msg_type": "image",
      "sender": "0",
      "sender_name": "",
      "sendtime": 0,
      "content_type": 14,
      "conv_id": "0",
      "conv_type": 0,
      "corp_id": "0",
      "appinfo": "",
      "msg": {
        "file_id": "306a02010204633061020100...",
        "aes_key": "54499d68c0a1aa8cf75298dad28df9bc",
        "md5": "daa914f99c82770aabe1df6022c1c96e",
        "size": 22141,
        "image_width": 964,
        "image_height": 175,
        "is_hd": true
      }
    },
    {
      "msg_type": "text",
      "sender": "0",
      "sender_name": "",
      "sendtime": 0,
      "content_type": 2,
      "conv_id": "0",
      "conv_type": 0,
      "corp_id": "0",
      "appinfo": "",
      "msg": {
        "content": "@王莲  不带芯片",
        "at_list": ["1688854525943308"]
      }
    }
  ]
}

forward / nested_forward — 合并转发#

字段类型说明
msg.message_titlestring合集标题(如 "张三的聊天记录")
msg.message_listarray子消息列表,结构同 mixed 的 msg_list;nested_forward 的子项可再嵌一层(子项 msg 内含 messages 数组)
"msg": {
  "message_title": "大米的聊天记录",
  "message_list": [
    {
      "msg_type": "image",
      "sender": "0",
      "sender_name": "大米",
      "sendtime": 1793899861,
      "content_type": 101,
      "conv_id": "0",
      "conv_type": 0,
      "corp_id": "1970325134026788",
      "appinfo": "",
      "msg": {
        "file_id": "https://imunion.weixin.qq.com/...",
        "aes_key": "ec856fd6e561b1ced6f964af356891b7",
        "auth_key": "v1_3f6c9c18740f8ab9bdd20...",
        "md5": "12861bc638c17cfbc1558d99c0e7d23a",
        "size": 287124
      }
    },
    {
      "msg_type": "text",
      "sender": "0",
      "sender_name": "大米",
      "sendtime": 1793899868,
      "content_type": 2,
      "conv_id": "0",
      "conv_type": 0,
      "corp_id": "1970325134026788",
      "appinfo": "",
      "msg": { "content": "破损" }
    }
  ]
}

personal_card — 个人名片#

字段类型说明
msg.user_idstring名片对应的企微用户 ID

app_text_card — 文本卡片#

字段类型说明
msg.titlestring标题
msg.descstring描述
msg.urlstring跳转链接

revoke — 撤回#

撤回事件的 msg 不是常规消息体,而是事件骨架(id / seq 为 "0")。被撤回消息的 id 在顶层 referid(其值等于被撤回那条消息的 id 字段)。
"msg": {
  "id": "0",
  "seq": "0",
  "roomid": "10773936684217073",
  "sender": "1688856934750639",
  "receiver": "0",
  "sendtime": 1793957731,
  "content_type": 0,
  "referid": "0",
  "flag": 32,
  "appinfo": "CIGABBDjvrbXBhivs7CtmoCAAyD6Bw==",
  "asid": "0"
}

hongbao — 红包#

字段类型说明
msg.hongbao_idstring红包 ID
msg.moneyint金额(分)
msg.remarkstring祝福语
msg.descstring提示文案(如 "来自xx的红包,请进入手机版企业微信查看")
"msg": {
  "hongbao_id": "1800008896202611067245505760033",
  "money": 1000,
  "remark": "恭喜发财,大吉大利",
  "desc": "来自_阿巧的红包,请进入手机版企业微信查看"
}

transfer — 转账#

msg 内为转账提示文案,金额等明细需进入手机版企业微信查看,字段以实际推送为准。

word_chain — 群接龙#

字段类型说明
msg.contentstring接龙全文("#接龙\n\n1. xxx\n2. xxx" 格式)
msg.chain_configobject接龙配置
msg.chain_config.chain_typeint接龙类型
msg.chain_config.creator_idstring发起人 ID
msg.chain_config.delimiterstring序号分隔符
msg.chain_config.start_position / end_position / placeholderstring位置标记
msg.chain_config.versionint版本号
msg.chain_config.participant_editsarray参与者编辑记录,每项含 user_id / content_range / edit_timestamp / edit_type / content_delimiter
"msg": {
  "content": "#接龙\n\n1. TTclub_坨面\n2. TTclub_七星(恩师坨坨)",
  "chain_config": {
    "chain_type": 1,
    "creator_id": "7881301818129670",
    "delimiter": ".",
    "start_position": "0-3",
    "end_position": "0-0",
    "placeholder": "0-0",
    "version": 0,
    "participant_edits": [
      {
        "user_id": "7881301818129670",
        "content_range": "8-9",
        "edit_timestamp": 1793958955,
        "edit_type": 0,
        "content_delimiter": "."
      }
    ]
  }
}

system — 系统提示#

字段类型说明
msg.contentstring提示文案(如 "xx开启了联系人验证,你还不是他(她)的联系人")

pv_merge_single — 音视频通话记录#

音视频通话的状态记录消息。
字段类型说明
msg.invite_typeint邀请类型
msg.record_typeint记录类型
msg.record_wordingstring状态文案(如 "未接听"、"对方已取消")
msg.record_timeint通话时间戳
msg.accept_or_reject_imeistring接听/拒绝设备标识
msg.accept_or_reject_platform / msg.valid_platformint平台标识

notify_type: 4 — 客户申请#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 4,
  "payload": null
}
当前版本 payload 暂无数据,收到申请后调用同步申请联系人接口获取明细。

notify_type: 5 — 客户变更#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 5,
  "payload": null
}
当前版本 payload 暂无数据,收到后调用同步联系人接口获取最新列表。

notify_type: 6 — 群信息变更#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 6,
  "payload": {
    "room_id": "1234567890",
    "operator_id": "1688853377964182"
  }
}
字段类型说明
room_idstring群 ID
operator_idstring操作者企微 uin

notify_type: 7 — 朋友圈变更(v1.0.44+)#

朋友圈有新增动态、评论、点赞等变更时推送。
{
  "guid": "ad1615a1ee59860e",
  "notify_type": 7,
  "payload": {
    "sendtime": 1793957776,
    "sid": "1234567890",
    "type": 4,
    "postid": "base64 编码的动态 ID"
  }
}
字段类型说明
sendtimeint事件时间戳(秒)
sidstring朋友圈动态 ID
typeint变更类型(位标记):0=新增评论 1=删除评论 2=新增点赞 3=删除点赞 4=新增动态 5=删除动态 6=封面点赞
postidstring朋友圈 postid(base64)

notify_type: 8 — 朋友圈任务(v1.0.44+)#

管理员下发朋友圈任务或任务提醒时推送。
{
  "guid": "ad1615a1ee59860e",
  "notify_type": 8,
  "payload": {
    "sendtime": 1793957776,
    "appinfo": "base64 编码的原始消息 appinfo",
    "sns_info": {
      "type": 2,
      "title": "任务标题"
    }
  }
}
字段类型说明
sendtimeint事件时间戳(秒)
appinfostring原始消息 appinfo(base64)
sns_info.typeint2=管理员下发新任务 3=管理员任务提醒 4=成为负责人 5=规则变更 6=可见范围变更 7=修改封面
sns_info.titlestring任务标题(base64)

notify_type: 9 — 群发任务(v1.0.44+)#

管理员群发任务提醒时推送。
{
  "guid": "ad1615a1ee59860e",
  "notify_type": 9,
  "payload": {
    "sendtime": 1793957776,
    "appinfo": "base64 编码的原始消息 appinfo",
    "group_msg": {
      "admin_vid": "1688853377964182",
      "msgid": "1234567890",
      "title": "任务标题",
      "content": "任务内容",
      "type": 1,
      "msgts": 1793957776
    }
  }
}
字段类型说明
sendtimeint事件时间戳(秒)
appinfostring原始消息 appinfo(base64)
group_msgobject群发任务信息
group_msg.admin_vidstring下发任务的管理员 ID
group_msg.msgidstring任务 ID
group_msg.titlestring任务标题
group_msg.contentstring任务内容
group_msg.typeint任务类型
group_msg.msgtsint任务时间戳

notify_type: 10 — 群名称变更(v1.0.44+)#

{
  "guid": "ad1615a1ee59860e",
  "notify_type": 10,
  "payload": {
    "room_id": "10750973332920638",
    "room_name": "新群名称",
    "operator_id": "1688857050497654"
  }
}
字段类型说明
room_idstring群 ID
room_namestring新群名称
operator_idstring操作者企微 uin

4. 补充说明#

guid 是设备 device_id(手机硬件 ID),不是企微 uin
payload 字段为 snake_case 格式(如 user_id、room_id、operator_id)
HTTP 头自动携带 AppKey + AppSecret(来自设置回调的 OpenApp)
推送失败不重试,仅记录日志
修改于 2026-11-09 17:48:25
上一页
Q&A 常见疑问
下一页
设置回调URL
Built with