云蝠智能 AI知识中心
所有文章
完整版
完整版
客户端
API文档
升级日志
合作伙伴
基础知识
产品介绍
帮助中心
API文档
数字人
AI客户联络
开发指引
API接口
【新】云节点列表
用户
子账户
任务
线路
话术分组
客户公海
合同管理
通话记录
呼叫时间
用户凭证
回调黑名单
对话接口
系统账单
其他
iFrame嵌套
回调
AI语音质检
白标接口及地址
AI客户联络中心 升级日志
数字人升级日志
线索挖掘 升级日志
业务常见问题QA
其他文档
行业案例
批量添加号码
最后更新于 2023/07/05   阅读数 1407

批量添加号码


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

  • 请求方式 POST

  • 请求说明

    此接口表示同步接口

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

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

    每次最多导入100条数据

    不可导入重复号码

  • 路由参数

    参数

    类型

    示例

    解释

    是否必填

    user_id

    string

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

    用户id

    task_id

    string

    b15b7392-a83f-4e0e-9570-31dd2ec8f85c

    任务id

  • 请求参数

    参数

    类型

    示例

    解释

    是否必填

    ignore_crm

    bool

    true

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

    skip_error

    bool

    true

    该值表示是否跳过验证错误(true表示在验证数据出现错误时跳过错误号码,继续添加,false表示出现错误验证会终止请求,返回错误信息。默认为false)

    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

    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,
    "skip_error": true,
    "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": {
		"taskNumberCount": 1,
		"crmCustomerCount": 1,
		"fail_datas": [{      //此值为skip_error为true的情况下会出现
				"fail_data": "911***8179",
				"fail_cause": "格式不正确。"
			},
			{
				"fail_data": "280f5b43-0777-479d-b735-7270790aee921",
				"fail_cause": "组件不存在"
			}
		]
	}
} 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
plaintext
  • taskNumberCount 表示成功写入任务的号码数量,如果任务中号码已存在,则此处不会写入

  • crmCustomerCount 表示成功写入CRM公海的号码数量,如果公海中号码已存在,则此处不会写入

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

批量添加号码