云蝠智能 AI知识中心
所有文章
完整版
完整版
客户端
API文档
升级日志
合作伙伴
基础知识
产品介绍
帮助中心
API文档
数字人
AI客户联络
开发指引
API接口
iFrame嵌套
回调
AI语音质检
白标接口及地址
AI客户联络中心 升级日志
数字人升级日志
线索挖掘 升级日志
业务常见问题QA
其他文档
行业案例
批量添加号码(异步接口)
最后更新于 2023/07/05   阅读数 989

批量添加号码(异步接口)(兼容2.0任务批量增加号码)


  • 请求接口 agent-api/user/{user_id}/task/{task_id}/async_number

  • 请求方式 POST

  • 请求说明

    此接口表示异步接口

    写入任务的号码会先写入公海中,所以此接口会先导入CRM公海,然后再导入对应任务中

    components中的id为组件的id,value为对应的值,id的值可以去创建公海模板的接口中获取

    每次最多导入200条数据

    不可导入重复号码

  • 路由参数

参数

类型

示例

解释

是否必填

user_id

string

4d99d91c-f5d9-49da-88da-758977cc58a9

用户id

task_id

string

b15b7392-a83f-4e0e-9570-31dd2ec8f85c

任务id

  • 注意:如果使用2.0 任务id ,需暂停任务才可以导入号码 否则 会出现以下报错

{
    "code": 6007,
    "status": "error",
    "message": "2.0任务启动中,请先停止任务",
    "data": []
}
1
2
3
4
5
6
plaintext
  • 请求参数

参数

类型

示例

解释

是否必填

name

string

联系人1

联系人名称

phone

string

13012121211

号码 可开启加密

email

string

12345@qq.com

邮箱

company

string

xxx公司

公司 可开启加密

sex

int

0

姓名(0:未知,1:男,2:女)

sort

int

0

排序

source_id

int

0

信息来源ID

industry_id

int

0

信息行业ID

grade_id

int

0

客户等级ID

ignore_crm

bool

true

号码是否进入客户公海(true代表不进入客户公海,false代表进入客户公海,默认不传则进入客户公海)

components

array

[]

组件数据

extra

string

0c51fc89-f6cf-405b-bb36-2c06900c3b5e

额外数据,可用于标识第三方数据,可以不携带

sub_user_id

string

91f9254f-ca58-49af-be34-8370d7549d73

子账户id(传递此参数则是对子账户操作)

encryption

bool

false

是否加密号码和公司(开启接口加密后有效)

  • 请求数据案例

{
    "ignore_crm": true, //默认可不传
    "encryption": false,
    "sub_user_id":"91f9254f-ca58-49af-be34-8370d7549d73",
    "data": [
        {
            "name": "联系人1",
            "phone": "13012121211", // 手机号码
            "email": "12345@qq.com", // 邮箱
            "company": "xxx公司", // 公司
            "sex": 0,
            "sort": 0, // 排序,暂无用处,都传0,
            "source_id": 1,
            "industry_id": 2,
            "grade_id": 1,
            "extra": "0c51fc89-f6cf-405b-bb36-2c06900c3b5e", //额外数据,可用于标识第三方数据,可以不携带
            "components": [
                {
                    "id": "2a87347c-6dd5-4e22-97fe-9b8001dbcd17", // 自定义组件id
                    "value": "小牛" // 自定义组件要传入的值
                },
                {
                    "id": "3535fa11-d1fc-468b-943c-8850c4e5514e",
                    "value": "17"
                }
            ]
        },
        {
            "phone": "13012121212",
            "sort": 0,
            "components": [
                {
                    "id": "2a87347c-6dd5-4e22-97fe-9b8001dbcd17",
                    "value": "小张"
                }
            ]
        },
        {
            "phone": "13012121213",
            "sort": 0
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
plaintext
  • 返回结果

    {
        "code": 200,
        "status": "success",
        "message": "号码导入任务信息请在回调中查收",
        "data": {
            "unique_id": "f2c7aa27-55be-4b96-835b-18cf38edd29e"
        }
    }
    
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    plaintext
  • unique_id表示本次回调的批次号,可使用 查看回调数据 去查询

未能解决您的问题?请联系
本篇目录

批量添加号码(异步接口)(兼容2.0任务批量增加号码)