探马OpenAPI

转移客户

POST

/api/v3/customer-transfer

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

handoverToUserid

string

转移后的目标员工

必需

企微员工ID

customers

array [object {2}]

转移客户

必需

要转移的员工客户跟进关系数量，最少1组，最多50组。

qwUserId

string

主负责人

必需

企微员工ID

customerId

number

客户

必需

探马客户ID

示例

{
  "handoverToUserid": "lisi",
  "customers": [
    {
      "qwUserId": "lisi",
      "customerId": 536613231830976
    },
    {
      "sales_id": "lisi2",
      "customerId": 536613231830976
    },
    {
      "qwUserId": "lisi3",
      "customerId": 536613231830976
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer-transfer' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "handoverToUserid": "lisi",
    "customers": [
        {
            "qwUserId": "lisi",
            "customerId": 536613231830976
        },
        {
            "sales_id": "lisi2",
            "customerId": 536613231830976
        },
        {
            "qwUserId": "lisi3",
            "customerId": 536613231830976
        }
    ]
}'

返回响应

🟢200异常

application/json

Body

code

integer

状态码

必需

message

string

结果说明

必需

data

object

必需

errors

array [object {5}]

转移失败结果

必需

记录本次转移失败的记录和失败原因

示例

{
  "code": 400,
  "message": "请求参数验证失败：[handoverToUserid] 员工不存在"
}

修改于 2023-05-06 06:08:48

合并客户

变更跟进人