调用AddBulkPhoneNumbers批量新增号码。

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

调试

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

请求参数

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

系统规定参数。取值：AddBulkPhoneNumbers。

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

待添加电话号码的呼叫中心实例ID。
PhoneNumber.N RepeatList 是 02160664656

待添加电话号码。

参数名称为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 17888888888

电话号码。
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)://ccc.cn-hangzhou.aliyuncs.com/?Action=AddBulkPhoneNumbers
&InstanceId=d278629c-c687-4aa3-b044-4fe9b012e7ef
&PhoneNumber.1=02160664656
&PhoneNumber.2=01086394552
&Usage=Bidirection
&<公共请求参数>

正常返回示例

XML 格式 

<AddBulkPhoneNumbersResponse>
      <FailedPhoneNumbers></FailedPhoneNumbers>
      <HttpStatusCode>200</HttpStatusCode>
      <UserdPhoneNumbers></UserdPhoneNumbers>
      <RequestId>943D8EF3-3321-471F-A104-51C96FCA94D6</RequestId>
      <PhoneNumbers>
            <PhoneNumber>
                  <PhoneNumberId>cc583e96-6bae-437e-9aeb-bffd5aeddb73</PhoneNumberId>
                  <Trunks>1</Trunks>
                  <ContactFlow>
                        <ContactFlowName>Welcome</ContactFlowName>
                        <ContactFlowDescription>Welcome</ContactFlowDescription>
                        <ContactFlowId>2932</ContactFlowId>
                        <Type>0</Type>
                        <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
                  </ContactFlow>
                  <AllowOutbound>true</AllowOutbound>
                  <Number>02160664656</Number>
                  <SkillGroups>
                        <SkillGroup>
                              <SkillGroupName>预测试外呼技能组</SkillGroupName>
                              <SkillGroupId>3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0</SkillGroupId>
                        </SkillGroup>
                        <SkillGroup>
                              <SkillGroupName>Default</SkillGroupName>
                              <SkillGroupId>014a9696-931d-49db-ae96-111d2098a548</SkillGroupId>
                        </SkillGroup>
                  </SkillGroups>
                  <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
                  <TestOnly>false</TestOnly>
                  <PhoneNumberDescription>Ali Telecom</PhoneNumberDescription>
                  <Usage>Bidirection</Usage>
                  <RemainingTime>0</RemainingTime>
            </PhoneNumber>
            <PhoneNumber>
                  <PhoneNumberId>1e636be9-7b45-4016-a0d4-fab6f2a1c88c</PhoneNumberId>
                  <Trunks>1</Trunks>
                  <ContactFlow>
                        <ContactFlowName>Welcome</ContactFlowName>
                        <ContactFlowDescription>Welcome</ContactFlowDescription>
                        <ContactFlowId>2932</ContactFlowId>
                        <Type>0</Type>
                        <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
                  </ContactFlow>
                  <AllowOutbound>true</AllowOutbound>
                  <Number>01086394552</Number>
                  <SkillGroups>
                        <SkillGroup>
                              <SkillGroupName>预测试外呼技能组</SkillGroupName>
                              <SkillGroupId>3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0</SkillGroupId>
                        </SkillGroup>
                        <SkillGroup>
                              <SkillGroupName>Default</SkillGroupName>
                              <SkillGroupId>014a9696-931d-49db-ae96-111d2098a548</SkillGroupId>
                        </SkillGroup>
                  </SkillGroups>
                  <InstanceId>d278629c-c687-4aa3-b044-4fe9b012e7ef</InstanceId>
                  <TestOnly>false</TestOnly>
                  <PhoneNumberDescription>Ali Telecom</PhoneNumberDescription>
                  <Usage>Bidirection</Usage>
                  <RemainingTime>0</RemainingTime>
            </PhoneNumber>
      </PhoneNumbers>
      <Success>true</Success>
      <Code>OK</Code>
      <ArrearagePhoneNumbers></ArrearagePhoneNumbers>
</AddBulkPhoneNumbersResponse>

JSON 格式 

{
    "FailedPhoneNumbers":{
        "FailedPhoneNumber":[
        ]
    },
    "HttpStatusCode":200,
    "UserdPhoneNumbers":{
        "UserdPhoneNumber":[
        ]
    },
    "RequestId":"943D8EF3-3321-471F-A104-51C96FCA94D6",
    "PhoneNumbers":{
        "PhoneNumber":[
            {
                "PhoneNumberId":"cc583e96-6bae-437e-9aeb-bffd5aeddb73",
                "Trunks":1,
                "ContactFlow":{
                    "ContactFlowName":"Welcome",
                    "ContactFlowDescription":"Welcome",
                    "ContactFlowId":"2932",
                    "Type":"0",
                    "InstanceId":"d278629c-c687-4aa3-b044-4fe9b012e7ef"
                },
                "AllowOutbound":true,
                "Number":"02160664656",
                "SkillGroups":{
                    "SkillGroup":[
                        {
                            "SkillGroupName":"预测试外呼技能组",
                            "SkillGroupId":"3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0"
                        },
                        {
                            "SkillGroupName":"Default",
                            "SkillGroupId":"014a9696-931d-49db-ae96-111d2098a548"
                        }
                    ]
                },
                "InstanceId":"d278629c-c687-4aa3-b044-4fe9b012e7ef",
                "TestOnly":false,
                "PhoneNumberDescription":"Ali Telecom",
                "Usage":"Bidirection",
                "RemainingTime":0
            },
            {
                "PhoneNumberId":"1e636be9-7b45-4016-a0d4-fab6f2a1c88c",
                "Trunks":1,
                "ContactFlow":{
                    "ContactFlowName":"Welcome",
                    "ContactFlowDescription":"Welcome",
                    "ContactFlowId":"2932",
                    "Type":"0",
                    "InstanceId":"d278629c-c687-4aa3-b044-4fe9b012e7ef"
                },
                "AllowOutbound":true,
                "Number":"01086394552",
                "SkillGroups":{
                    "SkillGroup":[
                        {
                            "SkillGroupName":"预测试外呼技能组",
                            "SkillGroupId":"3f3ceb0d-d6b6-4c97-af20-f3daf04f90e0"
                        },
                        {
                            "SkillGroupName":"Default",
                            "SkillGroupId":"014a9696-931d-49db-ae96-111d2098a548"
                        }
                    ]
                },
                "InstanceId":"d278629c-c687-4aa3-b044-4fe9b012e7ef",
                "TestOnly":false,
                "PhoneNumberDescription":"Ali Telecom",
                "Usage":"Bidirection",
                "RemainingTime":0
            }
        ]
    },
    "Success":true,
    "Code":"OK",
    "ArrearagePhoneNumbers":{
        "ArrearagePhoneNumber":[
        ]
    }
}

错误码

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