首页 文章

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

提问于
浏览 次
2

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

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

enter image description here

Ring Group如下所示：

enter image description here

rules ringcentral

1 回答

  • 2

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

    要添加号码，请从感兴趣的规则中检索当前转发号码，并将要添加的电话号码的转发号码ID添加到应答规则中 .

    您可以从 extension/answering-rule endpoints 检索应答规则列表 . 默认的应答规则ID位于下方，您还可以使用自定义应答规则 .

    • business-hours-rule ： account/~/extension/~/answering-rule/business-hours-rule

    • after-hours-rule ： account/~/extension/~/answering-rule/after-hours-rule

    这些都在Answering Rules List endpoints 中：

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

    1. Creating a Forwarding Number

    如果您还没有要添加的电话号码的RingCentral转发号码，请拨打 POST extension/forwarding-number API以创建新的转接号码 .

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

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

    2. Updating an Answering Rule

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

    2.1. Getting the Existing Answering Rule

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

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

    您将获得具有许多属性的JSON对象 . 要更新Ring Group，我们只需要使用带有更新的 forwarding 属性的 PUT 方法调用规则 endpoints .

    # 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 Updating the Answering Rule

    以下是将电话号码添加为转发规则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 endpoints 将显示转发号码数组，并且在线帐户门户将显示响铃组 . 在线帐户门户网站位于：

    回复于

相关问题