微伴助手OpenAPI
  1. 客户标签管理
微伴助手OpenAPI
  • OpenAPI基本介绍
  • 错误码参考表
  • 访问频率和并发限制
  • 消息订阅
    • 订阅消息加解密指南
    • 回调应用配置指南
    • 工单变更消息
      • 工单变更消息回调
      • 创建工单回调
      • 流转工单回调
      • 关闭工单回调
      • 重新打开工单回调
      • 评论工单回调
  • 获取访问凭据
    • 获取访问凭据
      POST
  • 员工管理
    • 获取员工列表
      GET
    • 获取员工详情
      GET
    • 发送员工通知
      POST
  • 自定义订单管理
    • 订单信息删除
      GET
    • 获取订单信息列表
      GET
    • 批量同步店铺信息
      POST
    • 批量同步商品信息
      POST
    • 批量同步订单信息v2
      POST
    • 批量删除商品信息
      POST
    • 删除店铺信息
      GET
    • 批量删除订单信息
      POST
    • 获取店铺信息详情
      POST
    • 获取店铺信息列表
      GET
    • 获取商品信息详情
      POST
    • 获取商品信息列表
      GET
  • 客户管理
    • 获取客户列表
    • 根据更新时间获取客户列表
    • 获取客户详情
    • 获取流失提醒客户列表
    • 导入客户信息
    • 添加客户评分
    • 添加自定义字段
    • 批量预设客户属性
    • 批量修改自定义字段的值
    • 创建批量加好友任务(批量创建添加客户任务)
    • 批量unionid&openid换external_user_id
    • external_user_id换unionid
    • unionid&openid换客户id
    • 获取客户自定义字段值列表
    • 批量获取客户详情
    • 获取批量加好友待添加列表
  • 客户积分管理
    • 批量增减客户积分
    • 批量获取客户积分
    • 获取单个客户积分明细记录
    • 获取全部客户积分明细记录
  • 客户标签管理
    • 获取标签列表
      GET
    • 批量更新客户企业标签
      POST
    • 给客户添加企业标签
      POST
    • 删除客户的企业标签
      POST
    • 给客户添加微伴个人标签
      POST
    • 删除客户的微伴个人标签
      POST
    • 获取预打标签信息
      GET
    • 批量预打企业标签
      POST
    • 根据手机号删除预打标签任务
      GET
    • 根据unionid删除预打标签任务
      GET
    • 获取指定用户预打标签任务详情
      GET
    • 获取预打标签任务列表
      GET
    • 添加预打标签任务
      POST
  • 客户画像管理
    • 获取客户事件列表
    • 创建自定义客户事件
    • 获取自定义客户事件类型列表
    • 获取自定义客户事件类型详情
    • 添加自定义客户事件类型
    • 删除自定义客户事件类型
    • 更新自定义客户事件类型
    • 获取客户阶段状态
  • 标签库管理
    • 获取标签列表V2
    • 获取指定标签信息
    • 新增企业标签组
    • 新增企业标签
    • 删除企业标签
    • 更新企业标签
    • 同步企业微信标签
  • 群聊管理
    • 获取群聊列表
    • 获取群聊成员列表
    • 获取客户所在群聊
    • 查看客户是否在群聊中
    • 获取群聊详情
  • 工单管理
    • 工单模块OpenAPI开发必读
    • 获取工单列表
    • 获取工单详情
    • 获取工单流内处理人
    • 获取工单模板列表
    • 获取工单模板详情
    • 新建工单
    • 修改工单
    • 流转工单
    • 评论工单
    • 关闭工单
  • 销售过程管理
    • 获取商机列表
    • 获取商机详情
    • 修改商机阶段
    • 获取线索公海列表
    • 批量导入线索
    • 修改线索
    • 获取线索列表
    • 员工单条/批量领取线索
    • 获取线索客户列表
  • 聊天记录管理
    • 获取会话消息
    • 获取会话消息2(按照消息时间逆序)
    • 获取员工会话
  • 拉新排行榜
    • 获取拉新排行榜列表
  • 群裂变
    • 获取群裂变活动列表
    • 获取群裂变任务详情
    • 获取群裂变客户详情列表
  • 群打卡
    • 获取群打卡活动列表
    • 获取群打卡任务详情
  • 企微任务宝
    • 获取企微任务宝活动列表
    • 获取企微任务宝任务详情
    • 获取企微任务宝对应的客户数据列表
    • 获取客户对应的企微任务宝数据列表
  • 拉新排行榜
    • 获取拉新排行榜活动列表
  • 自定义表单
    • 获取自定义表单列表
    • 自定义表单用户与表单关系列表
    • 自定义表单提交数据详情列表
    • 获取自定义表单分组列表
  • 客户转化
    • 批量新增手机线索转化
  • 员工个人群发记录管理
    • 获取员工个人群发记录列表
    • 获取员工个人群发记录结果列表
  • 渠道码管理
    • 获取渠道码列表
    • 获取渠道码加人数据
  • 素材库管理
    • 获取素材库列表
    • 获取素材库标签列表
    • 新增素材
    • 更新素材
    • 删除素材
    • 新建素材分组
    • 修改素材分组
    • 添加素材库标签
    • 删除素材库标签
    • 删除素材分组
    • 素材分组列表
  • 互动雷达管理
    • 获取雷达列表
    • 获取雷达详情
    • 添加雷达
    • 修改雷达
    • 删除雷达
    • 上传file
    • 获取雷达分组列表
    • 获取雷达客户访问记录
  • 自定义侧边栏身份校验
    • 侧边栏模块化-自定义卡片功能说明
    • 自定义侧边栏Code校验
  • 有赞订单管理
    • 获取有赞订单
    • 获取有赞订单列表
  • 小鹅通订单管理
    • 获取小鹅通TOKEN
  • 项目管理
    • 项目列表
  • 门店信息
    • 批量导入门店
    • 批量更新门店
    • 门店列表
  • 人群包
    • 人群包列表获取
    • 创建人群包
    • 更新人群包
    • 创建的人群包中添加数据
    • 获取人群包数据详情
  • 客户群发
    • 客户群发创建
    • 群发任务列表
    • 群群发详情获取
    • 员工群发结果
    • 客户群群发创建
    • 员工-群群发结果
    • 获取群发错误unionid/extid
  • 企微朋友圈
    • 企微朋友圈创建
    • 企微朋友圈任务列表
    • 企微朋友圈任务发表详情
  • 个人SOP
    • 个人SOP列表
    • 个人SOP详情-规则列表
    • 个人SOP详情-执行记录
  • 部门管理
    • 获取部门列表
  • 群标签管理
    • 获取群聊标签分组及其子列表
    • 群聊批量打标签
  • 话术库
    • 企业话术分组列表
    • 企业话术列表
  • 企微数据专区
    • 获取会话消息(企微数据专区)
  1. 客户标签管理

获取预打标签信息

GET
/open-api/pre_tag/list
获取与客服有关的预打标签计划任务的信息。
预打标签计划任务为在客服未添加指定客户时给该客服指派预打标签的任务,在添加好友时会自动执行该打标签任务。
注意:返回值tag_tasks列表中的id就是删除预打标签接口参数中的task_id。
调用此接口需购买营销席位。

请求参数

Query 参数
type
string 
可选
预打标签类型。corp-企业标签,internal-个人标签
示例值:
corp
limit
string 
可选
列表返回长度。默认值为30,最大值为100
示例值:
10
offset
string 
可选
表偏移。用于迭代获取所有数据,默认值为0
示例值:
0
unionid
string 
可选
客户的unionid
示例值:
oz9xvw_jfkmHMGWVSn5CatKSTOMU
access_token
string 
调用接口凭证
必需
默认值:
{{access_token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.weibanzhushou.com/open-api/pre_tag/list?type=corp&limit=10&offset=0&unionid=oz9xvw_jfkmHMGWVSn5CatKSTOMU&access_token='

返回响应

🟢200成功
application/json
Body
errcode
integer 
必需
状态码,0为正常,非0代表错误
errmsg
string 
必需
错误信息,成功时为'ok',错误时会以中文方式显示错误原因
task_info
array[object (TagTask) {6}] 
必需
id
string 
必需
任务id(主键),对应删除预打标签接口中的task_id
type
string 
必需
标签类型。corp-企业标签,internal-个人标签)
unionid
string 
客户id
必需
tag_name
string 
标签名称
必需
tag_group
string 
标签组
必需
create_at
integer 
任务创建时间
必需
示例
{
  "errcode": 0,
  "errmsg": "ok",
  "task_info": [
    {
      "create_at": 1595411673,
      "id": "b99965923fb4e75c8422f81dc7bcd0ae",
      "tag_group": "标签组1",
      "tag_name": "标签1",
      "type": "corp",
      "unionid": "abc"
    },
    {
      "create_at": 1595416669,
      "id": "75687d137b5ecaabedff229d3a1f8510",
      "tag_group": "open-api预打标签2",
      "tag_name": "test4",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595426094,
      "id": "b543ff53c6ed52a652867295be29255d",
      "tag_group": "open-api预打标签5",
      "tag_name": "test4",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595426098,
      "id": "adb9fc489a8a7bff1502649da7c255da",
      "tag_group": "open-api预打标签1",
      "tag_name": "test4",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595426106,
      "id": "6b65dda92fcc03e3ac179a14bb705089",
      "tag_group": "open-api预打标签2",
      "tag_name": "t11",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595426110,
      "id": "6d7d3960784c84189b9c9b4184d2abaa",
      "tag_group": "open-api预打标签2",
      "tag_name": "t342",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595471502,
      "id": "dfc7e32497c903c1458da270eb6f31bf",
      "tag_group": "open-api预打个人标签",
      "tag_name": "123",
      "type": "internal",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595472301,
      "id": "dfe14d48af5c8cd685de732236a556a0",
      "tag_group": "zs企业标签组1",
      "tag_name": "zs企业标签1",
      "type": "corp",
      "unionid": "oz9xvw4Ji-j7X7NH1iNVk4FoBGuU"
    },
    {
      "create_at": 1595472301,
      "id": "3fbf28b98d57fe1c99eb690b6c1c1c5b",
      "tag_group": null,
      "tag_name": "zs个人标签1",
      "type": "internal",
      "unionid": "oz9xvw4Ji-j7X7NH1iNVk4FoBGuU"
    },
    {
      "create_at": 1595497450,
      "id": "1b064b2f6e56f9a5257c2b948b8deb6f",
      "tag_group": null,
      "tag_name": "预打标签1",
      "type": "internal",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595497461,
      "id": "239ab5894ead9eb021dc4ce3beb94ab5",
      "tag_group": "预打个人标签",
      "tag_name": "123",
      "type": "internal",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595497749,
      "id": "aa587aa038e63093f48df3b8c72b622c",
      "tag_group": "预打个人标签",
      "tag_name": "123",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595507971,
      "id": "af73032e463486b570710d636b02cf52",
      "tag_group": "预打个人标签12",
      "tag_name": "12323",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595507980,
      "id": "f929545f0b01e834265fea391fddb58d",
      "tag_group": "预打个人标签132",
      "tag_name": "12323",
      "type": "corp",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595507994,
      "id": "5ec6a2796034e7b3eae875f08a83e4ca",
      "tag_group": "31签",
      "tag_name": "123",
      "type": "internal",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1595508001,
      "id": "890816292ead181ba0dc3b30d004c605",
      "tag_group": "43签",
      "tag_name": "123",
      "type": "internal",
      "unionid": "oz9xvw10LrjB_esK2ckTRMvtSy4M"
    },
    {
      "create_at": 1631500977,
      "id": "375043393dcd3fbe851b11e6f78eef5e",
      "tag_group": "dw测试",
      "tag_name": "预打标签2",
      "type": "corp",
      "unionid": "omefmt5tXF3VdxDU1blM_YgUF1p4"
    },
    {
      "create_at": 1631501563,
      "id": "5864c9b749b573d0523316ab969e7512",
      "tag_group": "dw标签",
      "tag_name": "预打标签2",
      "type": "corp",
      "unionid": "omefmt5tXF3VdxDU1blM_YgUF1p4"
    },
    {
      "create_at": 1634559364,
      "id": "50dbbb20cb0aeae5253d3d5c6475b54e",
      "tag_group": null,
      "tag_name": "zengshifu",
      "type": "internal",
      "unionid": "omefmt07CI-19v0dLmJp9BSQYqnc"
    },
    {
      "create_at": 1634559511,
      "id": "cce96b37a62c237dae5a5f3187edc747",
      "tag_group": "标签组1",
      "tag_name": "标签1",
      "type": "corp",
      "unionid": "omefmt07CI-19v0dLmJp9BSQYqnc"
    },
    {
      "create_at": 1634560498,
      "id": "ca8f0bc783388778f742c5cc3996abe2",
      "tag_group": "标签组1",
      "tag_name": "标签1",
      "type": "corp",
      "unionid": "omefmt5tXF3VdxDU1blM_YgUF1p4"
    },
    {
      "create_at": 1634560740,
      "id": "fc2108591e48b9e5185a4c470a55a0db",
      "tag_group": "open-api预打标签2",
      "tag_name": "t342",
      "type": "corp",
      "unionid": "omefmt5tXF3VdxDU1blM_YgUF1p4"
    },
    {
      "create_at": 1634646370,
      "id": "98a69713b4c9d942dc00134dd2f1fb11",
      "tag_group": "微伴标签组",
      "tag_name": "的法国红酒",
      "type": "corp",
      "unionid": "otrNdt062OdU6V6ttPpl2CpIADsY"
    },
    {
      "create_at": 1637302521,
      "id": "9528fe597844ff5ef447e78deab5abcf",
      "tag_group": "标签组1",
      "tag_name": "标签1",
      "type": "corp",
      "unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU"
    },
    {
      "create_at": 1637304894,
      "id": "a5711ec64ffbe474577a5432fcc35696",
      "tag_group": "标签组1",
      "tag_name": "标签1",
      "type": "corp",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    },
    {
      "create_at": 1637306277,
      "id": "fc9bc3674adfdc610aeb3050167d3180",
      "tag_group": "标签组1",
      "tag_name": "标55",
      "type": "corp",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    },
    {
      "create_at": 1640584522,
      "id": "0ec58a0127bf3deb2a04dccd8ead558f",
      "tag_group": null,
      "tag_name": "标55",
      "type": "internal",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    },
    {
      "create_at": 1640593363,
      "id": "ed5c1248b66b47cff073fd9d853493a9",
      "tag_group": null,
      "tag_name": "标56",
      "type": "internal",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    },
    {
      "create_at": 1640593379,
      "id": "30e7bce55d0f93f042194aa348672e5c",
      "tag_group": null,
      "tag_name": "标58",
      "type": "internal",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    },
    {
      "create_at": 1640593384,
      "id": "6d4a38fdf3557cce4d89aa64ddd2de76",
      "tag_group": null,
      "tag_name": "标57",
      "type": "internal",
      "unionid": "wm8xjUCAAAS4ozkSaSL7WIyxhV3iROJw"
    }
  ]
}
🟢200正常返回
上一页
删除客户的微伴个人标签
下一页
批量预打企业标签
Built with