Добавить номер телефона в существующую группу переадресации звонков RingCentral

Как можно добавить номер в существующую RingCentral Ring Group, используя REST API? Кажется, я не могу найти способ добавить номер в группу переадресации звонков. Я могу добавить его в качестве другого правила переадресации, но я бы хотел добавить его в существующую группу RingGroup.

На портале онлайн-аккаунта ( https://service.ringcentral.com/) создание группы звонков выполняется путем выбора двух или более номеров переадресации и нажатия "Создать группу звонков", как показано ниже.

Кольцевая группа выглядит следующим образом:

Источник

1 ответ

Решение

В RingCentral API кольцевая группа - это просто массив из более чем одного номера переадресации в интересующем правиле ответа. Каждое правило ответа имеет forwarding свойство с массивом forwarding.rules где каждое правило имеет массив forwardingNumbers, Правила упорядочены по 1 index имущество. Правило с более чем одним forwardingNumbers является кольцевой группой

Чтобы добавить номер, извлеките текущие номера переадресации из интересующего правила и добавьте идентификатор номера переадресации для номера телефона, который вы хотите добавить в правило ответа.

Вы можете получить список ваших правил ответа из extension/answering-rule конечная точка. Ниже приведены идентификаторы правил ответа по умолчанию, и вы также можете иметь собственные правила ответа.

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

Они оба в конечной точке списка правил ответов:

Чтобы добавить номер в группу звонков, сначала зарегистрируйте его в качестве номера переадресации, а затем добавьте идентификатор номера переадресации в группу звонков. Они описаны в шагах ниже.

1. Создание номера пересылки

Если у вас еще нет номера переадресации RingCentral для номера телефона, который вы хотите добавить, позвоните в POST extension/forwarding-number API для создания нового номера переадресации.

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 Обновление правила ответа

Ниже приведен пример добавления номера телефона в качестве идентификатора правила переадресации. 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 правила ответа отобразится массив номеров переадресации, а на портале онлайн-аккаунта будет показана группа звонков. Портал онлайн-аккаунта доступен по адресу:

Источник
Другие вопросы по тегам