调用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 |
是否允许外呼,结果取决于:
说明 电话号码一般都允许内呼,如果不允许内呼,可以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定义。 该值的结果取决于:
说明 电话号码一般都允许内呼,如果不允许内呼,可以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":[
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交