探马OpenAPI

合并客户

POST

/api/v3/customer/merge

手机号重复客户才允许合并

合并规则如图所示

主客户：已添加微信的客户与未添加微信的客户合并时，会将已添加微信的客户作为合并后的主客户

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

phone

string

手机号

必需

customerRelations

array [object {3}]

客户关系

必需

customerId

integer

客户ID

必需

finalRelation为true时，当前客户作为合并后的主客户

salesId

integer

员工ID

必需

finalRelation为true时，当前负责人作为合并后的主负责人

finalRelation

boolean

合并后最终的客户关系

必需

true 当前客户关系作为合并后的客户关系；
false 当前客户关系不作为合并后的客户关系；
有且仅有一组关系允许标记为true

注：已添加微信的客户与未添加微信的客户合并,主客户只能是已添加微信的客户

cooperationSalesIds

array[string]

合并后的协作人

可选

示例

{
  "phone": "19805518516",
  "customerRelations": [
    {
      "customerId": 39,
      "salesId": 93,
      "finalRelation": false
    }
  ],
  "cooperationSalesIds": [
    1111,
    2222,
    3333
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer/merge' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": "19805518516",
    "customerRelations": [
        {
            "customerId": 39,
            "salesId": 93,
            "finalRelation": false
        }
    ],
    "cooperationSalesIds":[1111,2222,3333]
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码 0为成功

必需

示例：0

message

string

必需

响应信息 "success"为成功

示例

{
  "code": 0,
  "message": "string"
}

修改于 2022-11-14 06:44:55

修改客户

转移客户