获取客户阶段状态

POST

/open-api/external_user/stage/get

openapi

通过批量传入客户id，以查询不同客服对于客户给出的客户阶段状态，一次最多传入50个客户id。

错误码	说明
20607	external_user_ids不能为空
20608	external_user_ids列表长度超过限制（50）
20609	未查询到任何客户阶段状态,请检查external_user_id是否合法或客户是否存在客户阶段
调用此接口需购买基础席位。

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

external_user_ids

array[string]

客户id列表

必需

示例

{
  "external_user_ids": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/external_user/stage/get?access_token=' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

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

errmsg

string

必需

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

stage_list

array [object {4}]

stage对象列表

必需

external_user_id

string

客户id

必需

staff_id

string

客户对应的客服id

必需

stage_id

integer

客户阶段id

必需

stage_name

string

必需

客户阶段名称，全部客户阶段请查询微伴助手后台。

total

integer

必需

查询到的条目数，即stage_list的长度

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "stage_list": [
    {
      "external_user_id": "wm8xjUCAAA2qxxxxxsjZbK-Qw",
      "staff_id": "Chengxxxx",
      "stage_id": 310,
      "stage_name": "付款客户1"
    },
    {
      "external_user_id": "wm8xjUCAAA2qxxxxxxsjZbK-Qw",
      "staff_id": "Chengxxxx",
      "stage_id": 1956,
      "stage_name": "新客户"
    }
  ],
  "total": 2
}

🟢200正常返回

修改于 2024-03-05 07:11:39

更新自定义客户事件类型

获取标签列表V2