卫瓴API文档

4.1 创建手机号线索

POST

https://openapi.weiling.cn/openapi/clue/create

请求参数

Query 参数

access_token

string

必需

获取到的凭证，最长为512字节

Body 参数application/json

clue_list

array [object {25}]

必需

线索列表（长度<=100）

user_name

string

姓名

必需

mobile

string

电话

必需

create_user_id

string

创建人id

必需

create_time

number

可选

线索创建时间，13位时间戳，精确到秒

status

integer

必需

线索状态（0-公海，1-已领取，4-线索池，未分配）

corp_address

string

公司地址

可选

age

integer

年龄

可选

corp_name

string

公司名称

可选

string

邮箱

可选

group_name

string

推广组

可选

keyword

string

关键词

可选

legal_person

string

公司法人

可选

owner_id

string

可选

status=1时必填，线索归属人id（员工id, 见4.1 获取员工列表），当线索已经被分配该字段需被填写

plan_name

string

推广计划

可选

corp_founded_time

string

公司成立时间

可选

string

QQ号

可选

region

string

地域

可选

register_address

string

公司注册地址

可选

searchword

string

搜索词

可选

gender

integer

可选

0 未选择 1 男 2 女

url

string

访问页面

可选

from_channel_id

number

渠道id

可选

wx_id

string

微信号

可选

sea_id

string

可选

status=0 时，填写公海id(见接口4.4公海信息查询)，不传则为系统默认公海

clue_custom_field

object

可选

自定义字段（⚠️如果系统中有字段设置了必填，则需要传此参数）
(key为apiName , value为传参 ;
是日期类型: 13位时间戳 ;
是单选类型: 选项的label值（number） ;
是多选类型: 选项的label值的集合（Array of number） )；
apiName通过https://www.apifox.cn/apidoc/shared/19699d3b-8e70-434a-b516-ce35107d2094/api-249167310 接口获取；
如没有，请联系小微配置。

示例

{
  "clue_list": [
    {
      "user_name": "string",
      "mobile": "string",
      "create_user_id": "string",
      "create_time": 0,
      "status": 0,
      "corp_address": "string",
      "age": 0,
      "corp_name": "string",
      "email": "string",
      "group_name": "string",
      "keyword": "string",
      "legal_person": "string",
      "owner_id": "string",
      "plan_name": "string",
      "corp_founded_time": "string",
      "qq": "string",
      "region": "string",
      "register_address": "string",
      "searchword": "string",
      "gender": 0,
      "url": "string",
      "from_channel_id": 0,
      "wx_id": "string",
      "sea_id": "string",
      "clue_custom_field": {}
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/clue/create?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clue_list": [
        {
            "user_name": "string",
            "mobile": "string",
            "create_user_id": "string",
            "create_time": 0,
            "status": 0,
            "corp_address": "string",
            "age": 0,
            "corp_name": "string",
            "email": "string",
            "group_name": "string",
            "keyword": "string",
            "legal_person": "string",
            "owner_id": "string",
            "plan_name": "string",
            "corp_founded_time": "string",
            "qq": "string",
            "region": "string",
            "register_address": "string",
            "searchword": "string",
            "gender": 0,
            "url": "string",
            "from_channel_id": 0,
            "wx_id": "string",
            "sea_id": "string",
            "clue_custom_field": {}
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

msg

string

返回结果信息

可选

code

integer

可选

返回结果码值-0:请求成功 500 系统错误

data

object

可选

fail_list

array [object {4}]

失败线索列表

可选

success_list

array [object {3}]

创建成功线索列表

可选

示例

{
  "msg": "success",
  "code": 0,
  "data": {
    "fail_list": [
      {
        "username": "test1",
        "mobile": "138991009",
        "error_code": 1001,
        "error_msg": "mobile格式不正确"
      }
    ],
    "success_list": [
      {
        "username": "test1",
        "mobile": "138991009",
        "clue_id": "SY5dc7s06i1Ll9cpmYvMh-ujPoYiIIYP4kprhnFBoYk"
      }
    ]
  }
}

修改于 2025-04-25 07:27:45

3.6 批量获取企微好友详情

4.2 获取手机号线索列表