阿里云首页

AXN分机复用绑定接口

调用BindAxnExtension进行AXN分机号绑定,通过本文您可以了解调用AXN分机号绑定接口的操作流程。

前提条件

  1. 注册阿里云账号并完成企业实名认证。具体操作请参见注册阿里云账号企业实名认证

  2. 获取阿里云访问密钥。具体操作,请参见获取AccessKey

背景信息

  • 明确您业务场景中的AXN分机号中设备证书(ProductKey、DeviceName、DeviceSecret)中A和N分别对应的业务角色。

  • AXN分机号设备证书中A号码如果是客户的话,X号码就是为A客户分配的隐私号码,其他的任何号码拨打X号码都会转接到A号码,A拨打X的时候回呼叫会转接到绑定时所传入的默认B号码。

下载对应的SDK和DEMO样例程序编写代码

请到SDK&DEMO下载页面获取相应的SDK和DEMO程序,参照代码样例进行接口开发和调试。

参数

入参列表

参数名称

参数类型

必填与否

样例取值

参数说明

PoolKey

String

必须

FC12345

号池Key。

PhoneNoA

String

必须

150****0000

AXN分机号模式中的A号码。

Extension

String

可选

130

1-3位的分机号码。

PhoneNoB

String

必须

150****0000

AXN分机号模式中的B号码。

PhoneNoX

String

可选

150****0000

指定X号码进行绑定。

ExpectCity

String

可选

北京(不需要带地市的后缀)

指定城市进行X号码的选号,如果当前号池中没有该城市的可用号码将随机分配其他城市的号码,也可以配置成严格模式,不存在符合条件的号码时提示分配错误。

Expiration

Date

必须

2017-09-05 12:00:00

绑定关系的过期时间。

IsRecordingEnabled

Boolean

可选

true

是否需要针对该绑定关系产生的所有通话录制通话录音。取值:

  • true

  • false

OutId

String

可选

abcdef

外部业务扩展字段。

出参列表

出参名称

出参类型

样例取值

参数说明

RequestId

String

8906582E-6722

请求ID。

Code

String

OK

状态码。返回OK代表请求成功,其他错误码详见错误码列表。

Message

String

请求成功

状态码的描述。

SecretBindDTO

Object

结构体

绑定成功后返回的结构体,结构体的属性详见Demo和SDK。

技术对接步骤

  1. 使用方法。

    1. 安装@alicloud/pls-sdk,请需要根据官方文档做一些配置。

    2. Node.js版本≥v4.6.0。

    3. 不支持在浏览器上使用。

    4. SDK&DEMO下载地址。请参见SDK&DEMO下载

  2. 编写样例程序。

    /**
     * 云通信基础能力业务-号码隐私保护示例,仅供参考。
     * Created on 2018-07-27
     */
    const PLSClient = require('@alicloud/pls-sdk')
    // ACCESS_KEY_ID/ACCESS_KEY_SECRET 根据实际申请的账号信息进行替换
    const accessKeyId = 'yourAccessKeyId'
    const secretAccessKey = 'yourAccessKeySecret'
    //在云通信页面开通相应业务消息后,就能在页面上获得对应的queueName,不用填最后面一段
    const queueName = 'Alicom-Queue-13635054xxxxxx-'
    //初始化sms_client
    const plsClient = new PLSClient({ accessKeyId, secretAccessKey })
    const PoolKey = 'FC100000xxxxxx'
    // AXN分机复用绑定示例
    plsClient.bindAxnExtension({
      PoolKey,
      PhoneNoA: '18040580000',
      PhoneNoB: '15800000000',
      Extension: '001',
      Expiration: '2018-08-05 12:00:00'
    }).then(function (res) {
      console.log('绑定axn', res)
    }, function (err) {
      console.log('绑定axn失败', err)
    })
                            

错误码列表

Code

描述

OK

请求成功。

isp.RAM_PERMISSION_DENY

RAM权限DENY。

isv.OUT_OF_SERVICE

业务停机。

isv.PRODUCT_UN_SUBSCRIPT

未开通云通信产品的阿里云客户。

isv.PRODUCT_UNSUBSCRIBE

产品未开通。

isv.ACCOUNT_NOT_EXISTS

账户不存在。

isv.ACCOUNT_ABNORMAL

账户异常。

isp.SYSTEM_ERROR

系统错误。

isp.UNKNOWN_ERR_CODE

运营商未知错误。

isv.PARTNER_NOT_EXIST

未知合作伙伴。

isv.NO_NOT_EXIST

号码不存在。

isv.ILLEGAL_ARGUMENT

参数非法。

isp.DAO_EXCEPTION

数据库异常。

isv.NO_AVAILABLE_NUMBER

无可用号码。

isp.VENDOR_UNAVAILABLE

运营商降级。

isv.FLOW_LIMIT

业务流控。

isv.PARTNER_IS_CLOSED

partner被关停。

isv.FORBIDDEN_ACTION

无权操作。

isv.NO_USED_BY_OTHERS

码被其他业务方占用。

isv.VENDOR_BIND_FAILED

运营商绑定失败。

isv.EXPIRE_DATE_ILLEGAL

过期时间非法。

isv.MOBILE_NUMBER_ILLEGAL

号码格式非法。

isv.BIND_CONFLICT

绑定冲突。

首页 AXN分机复用绑定接口