获取预打标签任务列表 - 微伴助手OpenAPI

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

预打标签计划任务为在客服未添加指定客户时给该客服指派预打标签的任务，在添加好友时会自动执行该打标签任务。
调用此接口需购买营销席位。

请求参数

Query 参数

start_time

string

可选

更新时间筛选开始时间

示例值:

1592576435

end_time

string

可选

更新时间筛选结束时间

示例值:

1592576420

limit

string

可选

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

示例值:

offset

string

可选

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

示例值:

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'，错误时会以中文方式显示错误原因

tag_tasks

array [object {6}]

必需

预打标签任务信息列表

unionid

string

可选

客户unionid，mobile|unionid只存在其一，按照任务类型决定

tag_ids

array[string]

标签id列表

必需

create_at

integer

任务创建时间

必需

has_marked

boolean

是否已打标签

必需

source

string

来源

必需

mobile

string

可选

客户手机号，mobile|unionid只存在其一，按照任务类型决定

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "tag_tasks": [
        {
            "unionid": "oz9xvxxxxxxxCatKSTOMU",
            "tag_ids": [
                "etqgMmBgxxxxxxxxMLK9gUcVEcQ"
            ],
            "create_at": 1579243948,
            "has_marked": true,
            "source": "openapi"
        },
        {
            "mobile": "13344445555",
            "tag_ids": [
                "etqgxxxxxxxxLK9gUcVEcQ"
            ],
            "create_at": 1579243948,
            "has_marked": true,
            "source": "openapi"
        }
    ]
}

🟢200正常返回