批量新增手机线索转化

已废弃

POST

/open-api/customer_open_sea/clue/add

openapi

批量新建手机线索转化。可以通过调整 body参数满足不同维度的添加需求。如果自定义字段不存在，需要调用添加自定义字段接口进行创建。

错误码	说明
21101	线索添加失败，请重新添加
21102	找不到该员工
21103	线索不存在
21104	自定义字段不存在
21105	手机线索数量超过20的限制
21106	时间格式不正确
21107	电话号码不合法，不合法包括：（字母、文字、特殊字符）
支持最多批量新建20个手机线索，超过数量会报错。

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

clue_list

array [object {8}]

必需

phone

string

可选

手机号，长度必须为11

staff_ext_id

string

可选

线索分配到的员工的id

remark

string

客户备注

可选

batch_add_customer_mission

boolean

可选

是否批量给员工发送添加好友任务，默认true

grade_id

integer

线索等级，默认0

可选

tags

array[string]

线索的标签列表

可选

base_info

object

基本信息

可选

custom_info

object

可选

自定义信息。填写custom_info时，必须添加field_name字段

示例

{
    "clue_list":[
         {
            "phone":"13367278448",
            "staff_ext_id":"ZengDeWei",
            "remark":"大头",
            "batch_add_customer_mission":true,
            "grade_id":0,
            "tags": [],
            "base_info":{
                "state": "来源",
                "description": "描述",
                "age": "年龄",
                "phone_number": "电话",
                "qq": "QQ",
                "weibo": "微博",
                "email": "邮箱",
                "address": "地址",
                "birthday": "生日"
            },
            "custom_info":{
                "field_name":"字段1",
                "field_value":"值1"
            }
        }
    ]
}

{
  "clue_list": [
    {
      "phone": "13367278448",
      "staff_ext_id": "ZengDeWei",
      "remark": "大头",
      "batch_add_customer_mission": true,
      "grade_id": 0,
      "tags": [],
      "base_info": {
        "state": "来源",
        "description": "描述",
        "age": "年龄",
        "phone_number": "电话",
        "qq": "QQ",
        "weibo": "微博",
        "email": "邮箱",
        "address": "地址",
        "birthday": "生日"
      },
      "custom_info": {
        "field_name": "文本字段",
        "field_value": "184cm"
      }
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/customer_open_sea/clue/add?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clue_list":[
         {
            "phone":"13367278448",
            "staff_ext_id":"ZengDeWei",
            "remark":"大头",
            "batch_add_customer_mission":true,
            "grade_id":0,
            "tags": [],
            "base_info":{
                "state": "来源",
                "description": "描述",
                "age": "年龄",
                "phone_number": "电话",
                "qq": "QQ",
                "weibo": "微博",
                "email": "邮箱",
                "address": "地址",
                "birthday": "生日"
            },
            "custom_info":{
                "field_name":"文本字段",
                "field_value":"184cm"
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
  "errcode": 0,
  "errmsg": "ok"
}

🟢200正常返回

修改于 2023-08-10 08:59:11

获取自定义表单分组列表

获取员工个人群发记录列表