Question

如何使用REST API将数字附加到现有的RingCentral Ring Group？我似乎无法找到一种方法来向呼叫转发RingGroup添加号码。我可以将其添加为另一个转发规则，但我真正想要做的是将其附加到现有的RingGroup。

在在线帐户门户（https://service.ringcentral.com）中，通过选择两个或多个转发号码并单击“创建环组”来创建一个响铃组，如下所示。

Ring Group如下所示：

Answer 1

在RingCentral API中，响铃组只是一个在感兴趣的应答规则中包含多个转发号码的数组。每个应答规则都有一个forwarding属性，其数组为forwarding.rules，其中每个规则都有一个forwardingNumbers数组。规则由基于1的index属性排序。具有多个forwardingNumbers的规则是一个环组。

要添加号码，请从感兴趣的规则中检索当前转发号码，并将要添加的电话号码的转发号码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

要向Ring Group添加号码，请先将其注册为转发号码，然后将转发号码id添加到Ring Group。这些在以下步骤中描述。

<强> 1。创建转发号码

如果您还没有要添加的电话号码的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。更新答案规则

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

<强> 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更新应答规则

以下是将电话号码添加为转发规则标识44444444的示例。您还可以更新其他属性。可以更新的其他转发属性包括以上响应中的以下内容：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

将电话号码添加到现有的RingCentral呼叫转移振铃组

1 个答案: