如何通过API获取RingCentral Contact Center路由号码列表？

Question

RingCentral has a type of phone number called Contact Center Routing Number (CCRN)，与RingCentral Office和Contact Center一起使用。是否可以通过API获取这些数字的列表？

在在线帐户门户中，这些数字位于：

“电话系统”>“电话号码”>“联系中心”。

我查看了RingCentral API Reference，但没有看到Contact Center的一部分。

Answer 1

https://developers.ringcentral.com/api-reference/Phone-Numbers/listAccountPhoneNumbers

CCRN电话号码将usageType设置为ContactCenterNumber。

查询API时，可以将usageType查询字符串参数设置为过滤结果。在响应中，电话号码记录中存在相同的参数。

为CCRN填充contactCenterProvider属性，如下所示：

这里是一个例子：

GET /restapi/v1.0/account/11111111/phone-number?usageType=ContactCenterNumber&perPage=10

HTTP 200 OK

{
  "uri" : "https://platform.ringcentral.com/restapi/v1.0/account/11111111/phone-number?page=1&perPage=10",
  "records" : [ {
    "uri" : "https://platform.ringcentral.com/restapi/v1.0/account/11111111/phone-number/22222222",
    "id" : 22222222,
    "phoneNumber" : "[phone]",
    "paymentType" : "TollFree",
    "type" : "VoiceOnly",
    "usageType" : "ContactCenterNumber",
    "status" : "Normal",
    "contactCenterProvider": {
      "id": "1",
      "name": "InContact / North America"
    }
  } ]
}

可以如下所示更新电话号码的contactCenterProvider：

PUT /restapi/v1.0/account/11111111/phone-number/22222222

{
  "usageType": "ContactCenterNumber",
  "contactCenterProvider": {
    "id": "3"
  }
}

更新响应：

{
  "uri" : "https://platform.ringcentral.com/restapi/v1.0/account/11111111/phone-number/22222222",
  "id" : 22222222,
  "phoneNumber" : "[phone]",
  "paymentType" : "TollFree",
  "type" : "VoiceOnly",
  "usageType" : "ContactCenterNumber",  
  "status" : "Normal",
  "contactCenterProvider": {
    "id": "3",
    "name": "InContact APAC"
  }
}