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.tags.sync

请求示例:#

{
	"robotKey": "bbd4b93912df4dda9ffe3650d22123e4",
	"type": "robot.tags.sync",
	"messageId": "2024037150144548",
	"routing": "SEND",
	"robotType": 2,
	"siteCode": "winnode_chat_2072",
	"nodeServerCode": "node_server_0001",
	"bizType": 5
}

回调通知:#

{
	"robotKey": "bbd4b93912df4dda9ffe3650d22123e4",
	"bizType": 5,
	"robotType": 2,
	"os": "winX",
	"isSendFromMac": 1,
	"code": "0",
	"msg": "OK",
	"sendTime": "2024-03-07 15:01:25",
	"sendTimeTs": 1709794885,
	"dts": 1709794885262,
	"wxid": "1688850230787417",
	"groupLabels": [{
		"isCorpLabel": 1,
		"isGroupLabel": 1,
		"isCustomLabelGroup": 0,
		"labelGroupId": 1,
		"groupName": "",
		"isFakeAddLabel": 0,
		"createTime": "2021-04-23 13:32:32",
		"labelId": "14073749057636360",
		"name": "星吾",
		"fullName": "星吾",
		"subLabelList": [{
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073749057636360",
			"groupName": "星吾",
			"isFakeAddLabel": 0,
			"createTime": "2021-04-23 13:32:32",
			"labelId": "14073749057636361",
			"name": "优秀",
			"fullName": "星吾: 优秀"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073749057636360",
			"groupName": "星吾",
			"isFakeAddLabel": 0,
			"createTime": "2021-04-23 13:58:35",
			"labelId": "14073750822637653",
			"name": "厉害",
			"fullName": "星吾: 厉害"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073749057636360",
			"groupName": "星吾",
			"isFakeAddLabel": 0,
			"createTime": "2021-04-23 14:01:07",
			"labelId": "14073751988636821",
			"name": "漂亮123",
			"fullName": "星吾: 漂亮123"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073749057636360",
			"groupName": "星吾",
			"isFakeAddLabel": 0,
			"createTime": "2021-04-25 14:37:01",
			"labelId": "14073752991636908",
			"name": "888",
			"fullName": "星吾: 888"
		}]
	
	}, {
		"isCorpLabel": 1,
		"isGroupLabel": 1,
		"isCustomLabelGroup": 0,
		"labelGroupId": 1,
		"groupName": "",
		"isFakeAddLabel": 0,
		"createTime": "2022-11-23 12:02:22",
		"labelId": "14073753083726955",
		"name": "孤勇者",
		"fullName": "孤勇者",
		"subLabelList": [{
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073753083726955",
			"groupName": "孤勇者",
			"isFakeAddLabel": 0,
			"createTime": "2022-11-23 12:02:22",
			"labelId": "14073753083726956",
			"name": "雇佣者",
			"fullName": "孤勇者: 雇佣者"
		}]
	}],
	"personLabel": {
		"isCorpLabel": 0,
		"isGroupLabel": 1,
		"isCustomLabelGroup": 1,
		"labelGroupId": 1,
		"groupName": "",
		"isFakeAddLabel": 0,
		"createTime": "2021-03-17 09:05:43",
		"labelId": "14073752073632365",
		"name": "个人标签",
		"fullName": "个人标签",
		"subLabelList": [{
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073751173597622",
			"groupName": "个人标签",
			"isFakeAddLabel": 0,
			"createTime": "2024-01-31 15:21:35",
			"labelId": "14073749542814018",
			"name": "{\"data\":{\"corp_id\":\"1970324971372818\"},\"sendState\":\"sendData1211491380\",\"type\":108021}",
			"fullName": "个人标签: {\"data\":{\"corp_id\":\"1970324971372818\"},\"sendState\":\"sendData1211491380\",\"type\":108021}"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073752073632365",
			"groupName": "个人标签",
			"isFakeAddLabel": 0,
			"createTime": "2022-04-01 15:45:42",
			"labelId": "14073749863708813",
			"name": "123654000888",
			"fullName": "个人标签: 123654000888"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073752073632365",
			"groupName": "个人标签",
			"isFakeAddLabel": 0,
			"createTime": "2021-10-20 15:36:39",
			"labelId": "14073750969697522",
			"name": "个人标签",
			"fullName": "个人标签: 个人标签"
		}, {
			"isCorpLabel": 1,
			"isGroupLabel": 0,
			"isCustomLabelGroup": 0,
			"labelGroupId": "14073751173597622",
			"groupName": "个人标签",
			"isFakeAddLabel": 0,
			"createTime": "2023-12-21 16:07:52",
			"labelId": "14073752185790269",
			"name": "{\"errcode\":0,\"errmsg\":\"ok\"}",
			"fullName": "个人标签: {\"errcode\":0,\"errmsg\":\"ok\"}"
		}]
	},
	"type": "robot.tags.sync",
	"messageId": "2024037150144548",
	"routing": "SEND",
	"siteCode": "winnode_chat_2072",
	"nodeServerCode": "node_server_0001"
}

参数说明:#

groupLabels:企业标签列表
personalLabel:个人标签列表

请求参数

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=tagssync' \
--header 'type: tagssync'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2025-04-02 08:35:46
上一页
查询联系人
下一页
同步企业成员
Built with