调用PickGlobalOutboundNumbers按照被叫归属地自主选择号码。

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

此功能对于业务开展在多个地区的公司非常适合使用,可以通过将购买号码时提交的企业资质,采用拓展地区的方式进行拓展,购买诸多城市的号码做外呼使用。然后将所有号码绑定到相同的技能组中,每次外呼时不需要坐席关系使用哪个号码外呼,该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": "福建"
            }
        }
    }
}

错误码

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