添加外呼号码

请求URL:

POST/vcs_api/openapi/pustPhones.php

参数:

参数名 是否必须 类型 说明
access string 公司账号
token string 分配的唯一调用秘钥
task_id string 任务id
voice string 声音名称 取值见下方声音对照表
volume string 音量 取值 0 到 100
speech_rate string 语速 取值 -500 到 500
phones array 号码集合,每次请求最多传递 1000 个号码
∟ phone string 外呼的手机号码
∟ busines string 业务区分标识,原样返回,如果没有可为空
∟ variable object 外呼变量值,格式为 { "变量名称1":"变量值1","变量名称2":"变量值2" };例如:{ "企业名称":"某某公司", "客户姓名":"张三", "性别":"先生" } ,备注:其中‘变量名称’与 变量数量 根据机器人话术填写

请求示例:

Accept: application/json
Content-Type: application/josn;charset=utf-8
{
    "access": "test",
    "token": "test",
    "task_id": 980,
    "phones": [
     {
        "phone": "13800138000",
        "busines":"bc_101",
        "variable": {
            "企业名称": "某某公司",
            "客户姓名": "张三",
            "性别": "先生"
        }
    },
    {
        "phone": "13800138002",
        "busines":"bc_102",
        "variable": {
            "企业名称": "某某公司",
            "客户姓名": "李四",
            "性别": "女士"
        }
    }
    ]
}

返回示例:

正确时返回:

{
    "info": "号码提交保存成功",
    "code": 0,
    "data": [
        {
            "phone": "13800138000",
            "busines":"bc_101",
            "uniqueid": "tEVDgTEAXqBUwGvnxDeaDYZULVRkvNfo"
        },
        {
            "phone": "13800138002",
            "busines":"bc_102",
            "uniqueid": "RBrxUwyrmzMiGGVDLAeOYEijZzUUNzJd"
        }
    ],
}

错误时返回:

{
    "code": "1",
    "info": "公司账号错误"
}

返回参数说明:

参数名 类型 说明
code string 返回码,0为正常,非0为请求失败
info string 接口请求中文说明
data object 返回的数据集
∟ phone string 外呼号码原样返回
∟ busines string 业务标识原样返回
∟ uniqueid string 该外呼号码生成的唯一值

voice 声音对照表:

voice参数值 名称 类型 性别 试听
aiqi 艾琪 温柔女声
aicheng 艾诚 标准男声
aida 艾达 标准男声
aijia 艾佳 标准女声
siqi 思琪 温柔女声
sijia 思佳 标准女声
sicheng 思诚 标准男声
ruoxi 若兮 温柔女声
ninger 宁儿 温柔女声
ruilin 瑞琳 标准女声
xiaomeng 小梦 标准女声
xiaowei 小威 标准男生
xiaoyun 小云 标准女声
xiaogang 小刚 标准男生
aimei 艾美 甜美女声
aijing 艾婧 严厉女声
aiyue 艾悦 温柔女声
aixia 艾夏 自然女声
aiyu 艾雨 自然女声
siyue 思悦 温柔女声
xiaomei 小美 甜美女声
yina 伊娜 浙普女声
sijing 思婧 严厉女声
xiaoxue 小雪 温柔女声
amei 阿美 甜美女声

备注:

  • 更多返回错误代码请看首页的错误代码描述