获取意向用户列表

Scope: enterprise.data 需要申请权限需要用户授权意向用户指在抖音 app 内与企业主发生互动（包括私信，留资等）的用户。

当前能力内测名额已满，已暂停申请

意向动作类型（action_type）对应含义

action_type	含义
1	私信
2	预约组件
3	个人主页

意向动作子类型（action_flag）对应含义，未标明即暂不公开

action_type	action_flag	含义
1	1	私信留电话
2	52	转化页留资
2	53	主页商家tab留资
3	101	智能电话拨打

请求地址

GET /enterprise/leads/user/list/

请求头

Content-Type: application/json
access-token: 调用/oauth/access_token/生成的 token，此 token 需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

请求参数

URL 请求

参数名称	参数类型	参数描述	参数示例	是否必填

暂无数据

响应参数

参数名称	参数类型	参数描述	参数示例	是否必填

暂无数据

响应样例

{
  "data": {
    "cursor": "<nil>",
    "description": "",
    "error_code": "0",
    "has_more": "<nil>",
    "list": ["<nil>"],
    "users": [
      {
        "age": "<nil>",
        "avatar": "url",
        "city": "<nil>",
        "gender": "<nil>",
        "is_follow": "true",
        "leads_level": "<nil>",
        "nickname": "jack",
        "open_id": "15674132978",
        "tag_list": [
          {
            "tag_id": "<nil>",
            "tag_name": "<nil>"
          }
        ],
        "telephone": "<nil>",
        "wechat": "<nil>"
      }
    ]
  },
  "extra": {
    "description": "",
    "error_code": "0",
    "logid": "202008121419360101980821035705926A",
    "now": "1597213176393",
    "sub_description": "",
    "sub_error_code": "0"
  }
}

响应错误样例

{
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}

诚邀您对本文档易读易用性进行评价

好用

不好用