Отсутствуют параметры факса «от» и «callerId» в API факса RingCentral - PullRequest
Новая
       70

Отсутствуют параметры факса «от» и «callerId» в API факса RingCentral

0 голосов
/ 30 апреля 2018

Я пытался отправить факс с помощью RingCentral API, но невозможно указать номер телефона факса From для отправки факса. Это только отправка факса с использованием номера факса компании. Я не могу найти возможность использовать факс с номера. Я использую следующую конечную точку для отправки факса:

https://platform.ringcentral.com/restapi/v1.0/account/:accountId/extension/:extensionId/fax

1 Ответ

0 голосов
/ 01 мая 2018

В системе RingCentral номер факса From (или отправляющий) является значением идентификатора вызывающего абонента факса. Вы можете обновить его для своего внутреннего номера, чтобы использовать его с факсами, но значение не доступно в самом API отправки факса. Чтобы изменить это для каждой отправки, вы можете обновлять значение идентификатора вызывающего абонента перед каждым факсимильным запросом.

Вы можете обновить идентификатор вызывающего абонента факса, используя два подхода:

  1. через API или
  2. с использованием портала онлайн-аккаунта (https://service.ringcentral.com),, оба из которых описаны ниже.

Оба описаны ниже. Дайте мне знать, если это работает для вас.

1) Обновление идентификатора вызывающего абонента факса

Чтобы обновить идентификатор вызывающего абонента факса, позвоните на конечную точку PUT extension/caller-id и обновите callerId для функции FaxNumber, используя идентификатор телефонного номера интересующего вас номера. Вы можете получить список этого, позвонив по номеру extension/phone-number, показанному в следующем разделе. 

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "byFeature": [
    {
      "feature": "FaxNumber",
      "callerId": {
        "phoneInfo": {
          "id": 33333333
        }
      }
    }
  ]
}

Подробнее об API см .: https://developer.ringcentral.com/api-docs/latest/index.html#!#RefUpdateCallerId

1.1) Перечисление доступных номеров абонентов

Чтобы получить список номеров, которые вы можете использовать, позвоните в конечную точку GET extension/phone-number: 

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/phone-number
Authorization: Bearer {accessToken}

В вашем ответе JSON у вас будет список телефонных номеров в свойстве records. Числа, которые вы можете использовать, будут иметь следующие значения свойств:

  • features свойство будет иметь CallerId значение
  • type свойство будет установлено на VoiceFax или FaxOnly

Ниже приводится выдержка из ответа JSON, показывающая одно число. У вас должно быть больше чисел и объект paging. 

{
  "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222/phone-number?page=1&perPage=100",
  "records": [
    {
      "id": 33333333,
      "phoneNumber": "+16505550100",
      "paymentType": "Local",
      "location": "Belmont, CA",
      "type": "VoiceFax",
      "usageType": "DirectNumber",
      "status": "Normal",
      "country": {
        "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/country/1",
        "id": "1",
        "name": "United States"
      },
      "features": [
        "SmsSender",
        "CallerId",
        "MmsSender"
      ]
    }
  ]
}

Подробнее об API см. https://developer.ringcentral.com/api-docs/latest/index.html#!#RefUserPhoneNumbers.html

1.2) Чтение значения идентификатора вызывающего абонента факса

RingCentral поддерживает несколько значений идентификатора вызывающего абонента. Чтобы прочитать значение для вашего расширения, выполните следующий вызов API для конечной точки extension/caller-id: 

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id
Authorization: Bearer {accessToken}

Вы получите ответ, подобный следующему, с массивом значений идентификатора вызывающего абонента в свойстве byFeature. Найдите функцию со свойством feature, установленным на FaxNumber. Ниже показан только идентификатор вызывающего абонента FaxNumber, но массив включает в себя следующие функции: CallFlip, FaxNumber, RingMe, RingOut, MobileApp, Alternate. 

{
  "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222/caller-id",
  "byFeature": [
    {
      "feature": "FaxNumber",
      "callerId": {
        "type": "PhoneNumber",
        "phoneInfo": {
          "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/11111111/phone-number/33333333",
          "id": "33333333",
          "phoneNumber": "+16505550100"
        }
      }
    }
  ]
}

Подробнее об API см .: https://developer.ringcentral.com/api-docs/latest/index.html#!#RefGetCallerId

2) Использование портала онлайн-аккаунтов

Вы также можете изменить значение идентификатора вызывающего абонента на портале онлайн-аккаунта:

Settings> Outbound Calls> Caller ID> By Feature> Fax Number

Больше доступно в этой статье базы знаний:

https://success.ringcentral.com/articles/RC_Knowledge_Article/3614

...