按照被叫归属地自主选择号码 - 云呼叫中心

优先选择本地号码，当坐席外呼时，系统会优先从技能组所绑定的外呼号码中选择与被叫号码相同归属地的号码进行外呼；如果不存在省市完全一样的号码，优先选择同省号码，若仍不存在，则随机选择一个号码。

此功能对于业务开展在多个地区的公司非常适合使用，可以通过将购买号码时提交的企业资质，采用拓展地区的方式进行拓展，购买诸多城市的号码做外呼使用。然后将所有号码绑定到相同的技能组中，每次外呼时不需要坐席关系使用哪个号码外呼，该API会智能化的选择最合适的号码进行外呼，大大提高外呼接通率。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	PickGlobalOutboundNumbers	系统规定参数。取值：PickGlobalOutboundNumbers。
CalleeNumber	String	是	1599090****	被叫号码
InstanceId	String	是	9cfad875-6260-4a53-ab6e-b13e3fb3****	呼叫中心实例ID
SkillGroupId.N	RepeatList	是	5c412119-9e1c-4304-8484-2b2c8f56f9dc	坐席绑定的技能组。如果该参数需要传多个，SkillGroupId.1、SkillGroupId.2、SkillGroupId.3，以此类推。
Count	Integer	否	2	候选号码个数。可不传，默认为1。
IsVirtual	Boolean	否	true	是否使用虚拟号码外呼

返回数据


名称	类型	示例值	描述
Code	String	OK	响应码
DialNumberPairs	Array of DialNumberPair		包含主叫号码及其归属地，被叫号码及其归属地
DialNumberPair
Callee	Struct		被叫号码
City	String	北京	号码归属地市
Number	String	1880134****	号码
Province	String	北京	号码归属地省
Caller	Struct		主叫号码
City	String	厦门	号码归属地市
Number	String	0592329****	号码
Province	String	福建	号码归属地省
HttpStatusCode	Integer	200	HTTP状态码
Message	String	无	响应信息
RequestId	String	5DA0BD19-066E-426D-B75E-65DF434A1A63	请求ID
Success	Boolean	true	是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=PickGlobalOutboundNumbers
&CalleeNumber=1599090****
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3****
&SkillGroupId.1=5c412119-9e1c-4304-8484-2b2c8f56f9dc
&<公共请求参数>

正常返回示例

XML格式

<Message>无</Message>
<RequestId>5DA0BD19-066E-426D-B75E-65DF434A1A63</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Code>OK</Code>
<Success>true</Success>
<DialNumberPairs>
    <DialNumberPair>
        <Callee>
            <Number>1880134****</Number>
            <City>北京</City>
            <Province>北京</Province>
        </Callee>
        <Caller>
            <Number>0592329****</Number>
            <City>厦门</City>
            <Province>福建</Province>
        </Caller>
    </DialNumberPair>
</DialNumberPairs>

JSON格式

{
    "Message": "无",
    "RequestId": "5DA0BD19-066E-426D-B75E-65DF434A1A63",
    "HttpStatusCode": 200,
    "Code": "OK",
    "Success": true,
    "DialNumberPairs": {
        "DialNumberPair": {
            "Callee": {
                "Number": "1880134****",
                "City": "北京",
                "Province": "北京"
            },
            "Caller": {
                "Number": "0592329****",
                "City": "厦门",
                "Province": "福建"
            }
        }
    }
}

错误码

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