1. bot-联系人
企微Work-bot
  • 开发指南
    • 了解Work-bot
    • 开发前必读
    • 基本概念介绍
    • 试用与支持
    • 获取token
      POST
  • 企微机器人
    • bot-发送消息
      • 获取表情包【matebot、probot、autobot】
      • 发送表情包【matebot、probot、autobot】
      • 收藏表情【matebot、probot、autobot】
      • 发送文本消息
      • 发送图片
      • 发送链接
      • 发送文件
      • 发送视频
      • 发送语音
      • 发送视频号视频消息
      • 发送小程序
      • 发送表情包、动图gif【nanobot、probot】
      • 发送群公告
      • 转发消息
      • 发送引用消息
      • 消息撤回
      • 语音转文字
      • 发送位置消息
      • 发送名片
    • bot-收到消息
      • 收到文本消息
      • 收到图片消息
      • 收到链接消息
      • 收到文件消息
      • 收到视频消息
      • 收到视频号消息
      • 收到小程序消息
      • 收到红包消息
      • 收到位置消息
      • 收到动图gif消息
      • 收到引用消息
      • 根据appInfo 查找引用消息
      • 对方撤回通知
      • 收到语音消息
      • 收到名片消息
    • bot-机器人
      • 检查授权码数量
      • 创建机器人
      • 企微机器人列表
      • 获取登录二维码
      • 提交验证码
      • 登录检查
      • 下线机器人(退出企微登录)
      • 删除机器人
      • 登录通知
      • 退出通知
      • 账号退出
      • 机器人企业成员信息通知
    • bot-联系人
      • 同步联系人
        POST
      • 查询联系人
        POST
      • 同步标签
        POST
      • 同步企业成员
        POST
      • 给客户打标签
        POST
      • 设置客户备注、描述
        POST
      • 设置客户手机号
        POST
      • 手机号加粉
        POST
      • 添加手机号搜索到的客户微信
        POST
      • 删除好友
        POST
    • bot-客户群
      • 同步客户群
      • 客户群列表
      • 创建群
      • 添加群成员
      • 查询群信息
      • 修改群名
      • 修改群公告
      • 群解散
      • 群踢人(移除群成员)
      • 拉人进群
      • 退出群聊
      • 添加/删除群管理员
      • 开启/关闭群邀请验证
      • 转让群主
      • 群二维码
      • 禁止修改群名开关
    • bot-朋友圈
      • 获取朋友圈详情
      • 大文件上传
      • 发朋友圈
    • bot-回调通知
      • 联系人通知
        • 查询收到的好友请求列表
        • 添加好友请求(客户添加机器人)
        • 通过添加好友邀请
        • 新增好友通知
        • 好友删除通知
      • 客户群通知
        • 新增群成员通知robot.members.chain
        • 新增群成员通知robot.group.member.changed
        • 新增群成员通知robot.contact.modify
        • 群成员退群通知
        • 群名称变更通知
        • 新增群聊通知
        • 群管理变更通知
    • bot-数据转换
      • 官方群chatId转换为企微群ID
      • 官方客户数据转机器人数据
      • 机器人客户数据转官方自建应用客户数据
      • 机器人企业成员数据转官方自建应用企业成员数据
      • 机器人群id转为官方群id
  • 企微SCRM
    • 客户群
      • 群成员列表
    • 企业成员
      • 企业成员
    • 消息群发
      • 新建群发任务-4
      • 群发任务详情
      • 终止群发任务
      • 群发任务列表
    • 入群邀请
      • 创建拉群任务
    • 机器人设置-群聊
      • 群欢迎语-开启关闭
      • 群欢迎语内容-设置
      • 群欢迎语内容-查询
      • 群欢迎语时间-设置
      • 群欢迎语时间-查询
      • 模板参数-设置
      • 机器人客户群列表
      • 默认回复开关-打开/关闭
      • 默认回复内容-设置
      • 图片回复内容-设置
      • 图片回复内容-查询
      • 图片回复规则-查询
      • 图片回复规则-设置
      • 群管理员-设置
    • 机器人设置-私聊
      • 获取私聊设置
      • 自动拉人入群-设置
      • 自动拉人进群-打开/关闭
      • 图片回复开关-打开/关闭
      • 链接回复内容-设置
      • 链接回复开关-打开/关闭
      • 口令入群-打开/关闭
      • 口令入群-设置
      • 默认回复-设置
      • 默认回复开关-打开/关闭
      • 默认回复时间设置-查询
      • 关键字打标签开关状态-查询
      • 关键词打标签-开启/关闭
      • 关键词打标签配置信息-查询
    • 机器人设置-通用
      • 私聊/群聊 关键词回复内容设置
      • 查询标签数据
      • 打开/关闭 关键词回复开关
      • 获取关键词回复设置
    • 客户与客户群
      • 接口拓客手机号列表
      • 企微群列表
      • 企微群成员列表
      • 客户列表
    • 其它
      • 上传图片/文件
      • 资源url加签名
    • 账号
      • 删除子账号(注意删除后不能在创建同名账号)
      • 创建子账号
    • 会话
      • 聊天记录
      • 最近会话列表
    • scrm-回调通知
      • 添加企业客户事件
      • 删除企业客户事件
      • 删除跟进成员事件
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
    • Schemas
      • TaskData
      • MessageContent
      • AcceptTarget
      • TextMessage
      • ImageMessage
      • LinkMessage
  1. bot-联系人

同步企业成员

POST
/wxworkapi/message/exchange
命令字Type : robot.member.list

请求示例:#

{
	"type": "robot.member.list"
	"robotKey": "bbd4b93912df4dda9ffe3650d22123e4",
	"messageId": "202403111737999999999",
}
名称类型必须描述
typeString是命令字,“robot.member.list”请求企业成员列表
robotKeyString是机器人robotKey

回调通知:#

结果数据会分批上送,每页100个
{
	"msg": "OK",
	"dts": 1710411469197,
	"code": 0,
	"totalPage": 1,
	"messageId": "2023071018471411666616033666666",
	"pageSize": 100,
	"sendTimeTs": 1710411469,
	"type": "robot.member.list",
	"totalCount": 4,
	"pageNum": 1,
	"users": [{
		"corpWxid": "YangJianTong",
		"gender": 1,
		"mobile": "",
		"userId": 1688858104495211,
		"realName": "杨建通",
		"realRemarks": "",
		"corpanyId": 1970325985991058,
		"name": "小杨总",
		"wechatImgUrl": "https://wx.qlogo.cn/mmhead/04LrpEqAf4sWEsGTzjexncqJsOicGgibPwfFOLZyXZnIsjTYcIM1gXFOfHanAPk9AFymkNibjSmc5U/0",
		"position": "",
		"avatorUrl": "https://wx.qlogo.cn/mmhead/04LrpEqAf4sWEsGTzjexncqJsOicGgibPwfFOLZyXZnIsjTYcIM1gXFOfHanAPk9AFymkNibjSmc5U/0",
		"remarks": "",
		"depts": {
			"departmentName": "****有限公司",
			"departmentId": 1688858104495219
		}
	}, {
		"corpWxid": "wjtan",
		"gender": 2,
		"mobile": "",
		"userId": 1688854987563192,
		"realName": "aaa",
		"realRemarks": "",
		"corpanyId": 1970325985991058,
		"name": "wjtan",
		"wechatImgUrl": "https://wework.qpic.cn/wwpic3az/829971_s00Ar7HqSMO3_t8_1701577441/0",
		"position": "",
		"avatorUrl": "https://wework.qpic.cn/wwpic3az/829971_s00Ar7HqSMO3_t8_1701577441/0",
		"remarks": "",
		"depts": {
			"departmentName": "研发部门",
			"parentDepartmentId": 1688858104495219,
			"parentDepartmentName": "******有限公司",
			"departmentId": 1688854987563193
		}
...
	}],
	"sendTime": "2024-03-14 18:17:49",
	"robotKey": "aa654861f84345d2bf89cfba36c04bca",
	"currentCount": 4
}

参数说明:#

名称类型必须描述
pageNuminteger否当前叶
currentCountInteger否当前页数量
totalCountInteger否总数量
totalPageInteger否总分页数量
usersobject array否企业成员数组
企业成员对象
名称类型必须描述
userldstring否企业成员vid
avatorUrlstring否头像url
corpanyldlong否所属企业vid
positionstring否职位
mobilestring否手机号
namestring否昵称
realNamestring否真实姓名
corpWxidstring否官方用户id即(userid)
realRemarksstring否备注
wechatImgUrlstring否对应微信的头像
remarksstring否描述
genderstring否性别1男2女0未注册
deptsobject数组否所属部门和上级部门
departmentIdlong否部门id
departmentNamestring否部门名称
parentDepartmentIdlong否上级部门id(不存在上级部门则无数据)
parentDepartmentNamestring否上级部门名称(不存在上级部门则无数据)

请求参数

Authorization
Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.example.com/wxworkapi/message/exchange?acttype=memberlist' \
--header 'type: memberlist'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-01-14 08:21:45
上一页
同步标签
下一页
给客户打标签
Built with