调用AddBulkPhoneNumbers批量新增号码。

将从云呼控制台购买的电话号码绑定到呼叫中心实例中,并且可以和IVR流程以及技能组进行绑定。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddBulkPhoneNumbers

系统规定参数。取值:AddBulkPhoneNumbers

InstanceId String d278629c-c687-4aa3-b044-4fe9b012****

待添加电话号码的呼叫中心实例ID。

PhoneNumber.N RepeatList 0216066****

待添加电话号码。

参数名称为PhoneNumber.1表示只获取1个技能组信息,如果要获取多个技能组信息,则需要有PhoneNumber.1以及PhoneNumber.2,以此类推。

Usage String Bidirection

该电话号码的用途。取值:Inbound(呼入),Outboung(呼出),Bidirection(同时用于呼入和呼出)。

说明 如果传入的号码包含400号码,该值只能传入Inbound
ContactFlowId String 8Cvg_0mcsm6K

和电话号码绑定的联系流ID。

SkillGroupId.N RepeatList 3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0

和电话号码绑定的技能组ID。

参数名称为SkillGroupId.1表示只获取1个技能组信息。如果要获取多个技能组信息,则需要有SkillGroupId.1以及SkillGroupId.2,以此类推。

返回数据

名称 类型 示例值 描述
ArrearagePhoneNumbers List {"ArrearagePhoneNumber":[ ]}

欠费号码的信息。

Code String OK

响应码。

FailedPhoneNumbers List {"FailedPhoneNumber":[ ]}

添加失败号码的信息。

HttpStatusCode Integer 200

HTTP状态码。

Message String

响应信息。

PhoneNumbers Array of PhoneNumber

获取到的呼叫中心实例的所有电话号码列表。

PhoneNumber
AllowOutbound Boolean true

是否允许外呼,结果取决于:

  • 大于的设置,比如400号码不允许外呼
  • 呼叫中心实例的设置
说明 电话号码一般都允许内呼,如果不允许内呼,可以1)由大于做设置,用户拨打该号码时听到提示音 2)该号码不绑定联系流IVR,但是ACC不建议这么做。
ContactFlow Struct

电话号码所连接的联系流IVR。

ContactFlowDescription String Welcome

联系流的简单描述。

ContactFlowId String 2932

联系流唯一ID,系统自动生成的唯一标示符。

ContactFlowName String Welcome

联系流名称,在一个实例内名称不能重复。

InstanceId String d278629c-c687-4aa3-b044-4fe9b012e7ef

联系流所归属的呼叫中心实例。

Type String 0

流程类型, 定义来自于ContactFlowType。

InstanceId String d278629c-c687-4aa3-b044-4fe9b012e7ef

电话号码所归属的呼叫中心实例ID。

Number String 1788888****

电话号码。

PhoneNumberDescription String xxx

电话号码的简单描述。

PhoneNumberId String 125435986

电话号码ID,系统自动生成的唯一标示符。

RemainingTime Integer 60

测试号码剩余的通话时间。单位为分钟。

SkillGroups Array of SkillGroup

电话号码所关联的技能组。

SkillGroup
SkillGroupId String 3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0

技能组ID。

SkillGroupName String 预测试外呼技能组

技能组名称。

TestOnly Boolean true

是否是测试号码。

Trunks Integer 30

电话号码的中继数量,即可同时支持几路通话,数据来源于大于。

Usage String Bidirection

电话号码的用途,呼入(Inbound),呼出(Outbound),已经同时用于呼入和呼出(Bidirection)。上述值由枚举类型PhoneNumberType定义。

该值的结果取决于:

  • 大于的设置,比如400号码不允许外呼
  • 呼叫中心实例的设置
说明 电话号码一般都允许内呼,如果不允许内呼,可以1)由大于做设置,用户拨打该号码时听到提示音。2)该号码不连接人和联系流IVR,但是ACC不建议这么做。
RequestId String 943D8EF3-3321-471F-A104-51C96FCA94D6

请求ID。

Success Boolean true

是否成功。

UserdPhoneNumbers List {"UserdPhoneNumber":[ ]}

已经被使用号码的信息。

示例

请求示例

http(s)://[Endpoint]/?Action=AddBulkPhoneNumbers
&InstanceId=d278629c-c687-4aa3-b044-4fe9b012****
&PhoneNumber.1=0216066****
&Usage=Bidirection
&<公共请求参数>

正常返回示例

XML格式

<ArrearagePhoneNumbers>
    <ArrearagePhoneNumber>{"ArrearagePhoneNumber":[   ]}</ArrearagePhoneNumber>
</ArrearagePhoneNumbers>
<PhoneNumbers>
    <PhoneNumber>
        <Usage>Bidirection</Usage>
        <AllowOutbound>true</AllowOutbound>
        <TestOnly>true</TestOnly>
        <Number>1788888****</Number>
        <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
        <RemainingTime>60</RemainingTime>
        <Trunks>30</Trunks>
        <PhoneNumberId>125435986</PhoneNumberId>
        <PhoneNumberDescription>xxx</PhoneNumberDescription>
        <SkillGroups>
            <SkillGroup>
                <SkillGroupName>预测试外呼技能组</SkillGroupName>
                <SkillGroupId>3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0</SkillGroupId>
            </SkillGroup>
        </SkillGroups>
        <ContactFlow>
            <Type>0</Type>
            <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
            <ContactFlowId>2932</ContactFlowId>
            <ContactFlowName>Welcome</ContactFlowName>
            <ContactFlowDescription>Welcome</ContactFlowDescription>
        </ContactFlow>
    </PhoneNumber>
</PhoneNumbers>
<Message>无</Message>
<RequestId>943D8EF3-3321-471F-A104-51C96FCA94D6</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<FailedPhoneNumbers>
    <FailedPhoneNumber>{"FailedPhoneNumber":[   ]}</FailedPhoneNumber>
</FailedPhoneNumbers>
<UserdPhoneNumbers>
    <UserdPhoneNumber>{"UserdPhoneNumber":[   ]}</UserdPhoneNumber>
</UserdPhoneNumbers>
<Code>OK</Code>
<Success>true</Success>

JSON格式

{
    "ArrearagePhoneNumbers": {
        "ArrearagePhoneNumber": "{\"ArrearagePhoneNumber\":[   ]}"
    },
    "PhoneNumbers": {
        "PhoneNumber": {
            "Usage": "Bidirection",
            "AllowOutbound": true,
            "TestOnly": true,
            "Number": "1788888****",
            "InstanceId": "d278629c-c687-4aa3-b044-4fe9b012e7ef",
            "RemainingTime": 60,
            "Trunks": 30,
            "PhoneNumberId": 125435986,
            "PhoneNumberDescription": "xxx",
            "SkillGroups": {
                "SkillGroup": {
                    "SkillGroupName": "预测试外呼技能组",
                    "SkillGroupId": "3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0"
                }
            },
            "ContactFlow": {
                "Type": 0,
                "InstanceId": "d278629c-c687-4aa3-b044-4fe9b012e7ef",
                "ContactFlowId": 2932,
                "ContactFlowName": "Welcome",
                "ContactFlowDescription": "Welcome"
            }
        }
    },
    "Message": "无",
    "RequestId": "943D8EF3-3321-471F-A104-51C96FCA94D6",
    "HttpStatusCode": 200,
    "FailedPhoneNumbers": {
        "FailedPhoneNumber": "{\"FailedPhoneNumber\":[   ]}"
    },
    "UserdPhoneNumbers": {
        "UserdPhoneNumber": "{\"UserdPhoneNumber\":[   ]}"
    },
    "Code": "OK",
    "Success": true
}

错误码

访问错误中心查看更多错误码。