获取预打标签信息 - 微伴助手OpenAPI

获取与客服有关的预打标签计划任务的信息。

预打标签计划任务为在客服未添加指定客户时给该客服指派预打标签的任务，在添加好友时会自动执行该打标签任务。

注意：返回值tag_tasks列表中的id就是删除预打标签接口参数中的task_id。
调用此接口需购买营销席位。

请求参数

Query 参数

type

string

可选

预打标签类型。corp-企业标签，internal-个人标签

示例值:

corp

limit

string

可选

列表返回长度。默认值为30，最大值为100

示例值:

offset

string

可选

表偏移。用于迭代获取所有数据，默认值为0

示例值:

unionid

string

可选

客户的unionid

示例值:

oz9xvw_jfkmHMGWVSn5CatKSTOMU

access_token

string

调用接口凭证

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

task_info

array[object (TagTask) {6}]

必需

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正常返回