2

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

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

在此处输入图像描述

环组如下所示：

在此处输入图像描述

4

1 回答 1

2

在 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

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

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

1. 创建转发号码

如果您还没有要添加的电话号码的 RingCentral 转接号码，请调用POST extension/forwarding-numberAPI 以创建新的转接号码。

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

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

2.更新回答规则

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

2.1。获取现有的回答规则

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

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

您将获得一个带有许多属性的 JSON 对象。要更新环组，我们只需要使用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"
        }
      ]
    }
  ]
},

2.2 更新应答规则

以下是添加电话号码作为转发规则 id 的示例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 端点将显示一个转发号码数组，并且在线帐户门户将显示一个响铃组。在线帐户门户网站位于：

于 2018-03-27T05:23:50.823 回答