将 phone 个号码添加到现有的 RingCentral 呼叫转移响铃组

Question

如何使用 REST API 将号码附加到现有的 RingCentral 铃声组？我似乎找不到将号码添加到呼叫转移 RingGroup 的方法。我可以将它添加为另一个转发规则，但我真正想做的是将它附加到现有的 RingGroup。

在在线帐户门户 (https://service.ringcentral.com) 中，通过选择两个或更多转接号码并单击 "Create Ring Group" 来创建响铃组，如下所示。

响铃组如下所示：

Answer 1

在RingCentral API中，一个Ring Group只是感兴趣的接听规则中的一个以上转接号码的数组。每个应答规则都有一个 forwarding 属性和一个 forwarding.rules 的数组，其中每个规则都有一个 forwardingNumbers 的数组。规则按照从1开始的index属性排序。超过一个 forwardingNumbers 的规则是响铃组。

要添加号码，从感兴趣的规则中检索当前转接号码，并将要添加的 phone 号码的转接号码 ID 添加到接听规则中。

您可以从 extension/answering-rule 端点检索您的应答规则列表。默认应答规则 ID 如下，您也可以自定义应答规则。

business-hours-rule: account/~/extension/~/answering-rule/business-hours-rule
after-hours-rule: account/~/extension/~/answering-rule/after-hours-rule

这些都在应答规则列表端点中：

API参考：https://developers.ringcentral.com/api-docs/latest/index.html#!#RefAnsweringRulesList.html

要将号码添加到响铃组，首先将其注册为转接号码，然后将转接号码id添加到响铃组。这些在下面的步骤中进行了描述。

1.创建转接号码

如果您还没有要添加的 phone 号码的 RingCentral 转接号码，请致电 POST extension/forwarding-number API 创建一个新的转接号码。

POST /restapi/v1.0/account/11111111/extension/22222222/forwarding-number

{
  "phoneNumber" : "+12125550100",
  "label" : "Work"
}

API参考：https://developers.ringcentral.com/api-docs/latest/index.html#!#RefCreateForwardingNumber

2。更新应答规则

将转接号码添加到现有振铃组的最简单方法是为您希望为其更新振铃组的规则调用应答规则端点，然后使用 [=13= 中的数据更新规则] 属性加上新的转接号码id。使用 forwarding.rules 数组识别感兴趣的环组，创建现有和新的 forwardingNumberId 数组，然后将其作为更新请求的主体发送，如下所示。

2.1。获取已有的应答规则

获取您感兴趣的 ruleId 然后调用以下端点以获取现有设置：

/restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

您将得到一个具有许多属性的 JSON 对象。要更新 Ring Group，我们只需要使用 PUT 方法和更新后的 forwarding 属性.

调用规则端点

# Get Answering Rule Response

GET /restapi/v1.0/account/11111111/extension/22222222/answering-rule/business-hours-rule

<snip>

"forwarding": {
  "notifyMySoftPhones": true,
  "notifyAdminSoftPhones": false,
  "softPhonesRingCount": 5,
  "ringingMode": "Sequentially",
  "rules": [
    {
      "index": 1,
      "ringCount": 3,
      "forwardingNumbers": [
        {
          "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222/forwarding-number/33333333",
          "id": "33333333",
          "phoneNumber": "+16505550100",
          "label": "My Phone3"
        }
      ]
    }
  ]
},

API参考：https://developers.ringcentral.com/api-docs/latest/index.html#!#RefGetAnsweringRule

2.2 更新答题规则

下面是添加phone号码作为转发规则id44444444的例子。您还可以更新其他属性。可以更新的其他转发属性包括上述响应中的以下内容：notifyMySoftPhones、notifyAdminSoftPhones、softPhonesRingCount 和 ringingMode.

在下面的示例中，~ 用于 accountId 和 extensionId。这里，~表示当前授权用户，也是与访问令牌关联的用户。

# Update Answering Rule Request

PUT /restapi/v1.0/account/~/extension/~/answering-rule/business-hours-rule

{
  "forwarding": {
    "rules": [
      {
        "index": 1,
        "ringCount": 3,
        "forwardingNumbers": [
          {
            "id": "33333333"
          },
          {
            "id": "44444444"
          }
        ]
      }
    ]
  }
}

API参考：https://developers.ringcentral.com/api-docs/latest/index.html#!#RefUpdateAnsweringRule

此后，检索应答规则API端点将显示一组转接号码，在线帐户门户将显示一个响铃组。在线帐户门户位于：

生产 - https://service.ringcentral.com
沙盒 - https://service.devtest.ringcentral.com

将 phone 个号码添加到现有的 RingCentral 呼叫转移响铃组

Add phone number to existing RingCentral call forwarding Ring Group

rules

ringcentral