2

REST API を使用して既存の RingCentral Ring Group に番号を追加するにはどうすればよいですか? 電話転送 RingGroup に番号を追加する方法が見つからないようです。別の転送ルールとして追加することもできますが、実際にやりたいのは、既存の RingGroup に追加することです。

オンライン アカウント ポータル ( https://service.ringcentral.com ) では、以下に示すように、2 つ以上の転送番号を選択して [Create Ring Group] をクリックすると、リング グループを作成できます。

ここに画像の説明を入力

リング グループは次のようになります。

ここに画像の説明を入力

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

これらは両方とも Answering Rules List エンドポイントにあります。

着信グループに番号を追加するには、最初にそれを転送番号として登録してから、転送番号 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既存および新規の forwardingNumberIds の配列を作成してから、以下に示すように更新要求の本文としてそれを送信します。

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 に答える