Параметры факса "от" и "callerId" отсутствуют в API факса RingCentral

Question

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

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

Answer 1

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

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

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

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

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

Чтобы обновить идентификатор вызывающего абонента факса, позвоните в PUT extension/caller-id конечная точка и обновить callerId для FaxNumber функция с использованием номера телефона ID номера, который вы хотите использовать. Вы можете получить список этого, позвонив 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.

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": "[phone]",
      "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

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": "[phone]"
        }
      }
    }
  ]
}

См. Справочник по API для получения дополнительной информации: https://developer.ringcentral.com/api-docs/latest/index.html

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

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

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

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

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

Answer 2

У меня это сработало при работе с RingCentral Java SDK.

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

RestClient rc = new RestClient(RINGCENTRAL_CLIENTID, RINGCENTRAL_CLIENTSECRET, RINGCENTRAL_SERVER);
rc.authorize(RINGCENTRAL_USERNAME, RINGCENTRAL_EXTENSION, RINGCENTRAL_PASSWORD);

GetExtensionPhoneNumbersResponse numbers = rc.restapi().account().extension().phonenumber().get();

2. Чтобы обновить номер отправителя / звонящего

RestClient rc = new RestClient(RINGCENTRAL_CLIENTID, RINGCENTRAL_CLIENTSECRET, RINGCENTRAL_SERVER);
rc.authorize(RINGCENTRAL_USERNAME, RINGCENTRAL_EXTENSION, RINGCENTRAL_PASSWORD);
          
ExtensionCallerIdInfo resp = rc.restapi().account().extension().callerid().get();

for (CallerIdByFeature e : resp.byFeature) {
    if (e.callerId.phoneInfo != null) {
        e.callerId.phoneInfo.phoneNumber("**********");
    }
}
resp = rc.restapi().account().extension().callerid().put(resp);