RU
EN
KZ
RU
EN
KZ

Update –API-метод добавления настроек пула и сценария переадресации для используемого статического номера

Используйте метод для офлайн статических номеров, уже используемых в пулах.
Обратите внимание, если номер свободный (не закреплен ни за одним пулом), используйте метод Create.

Чтобы получить список свободных номеров необходимо выполнить метод List по массиву подменных номеров.

Если в ответе в объекте displayOptions значение null значит номер свободный.

POST: https://api.calltouch.ru/phone-service/v1/api/calltracking/ad-platform/phone/update 

Headers:

  • Access-Token – API-ключ
  • SiteId – ID ЛК Calltouch

Данные параметры вы можете получить в личном кабинете Calltouch в разделе "Интеграции - API и Webhooks"


Тело запроса в формате JSON:

{
 "phoneNumber": "string",
 "displayOptions": {
  "source": "string",
  "medium": "string",
  "campaign": "string",
  "content": "string",
  "keyword": "string"
},
"redirectOptions": {
 "redirectType": "PSTN",
 "ptsnOptions": {
  "redirectNumber": "string"
 },
 "reserveRedirect": {
  "reserveNumber": "string",
  "reserveTimeOut": 0,
  "ignoreEarlyMedia": true
 }
},
"poolName": "string"
}

В случае успешного ответа отдается код 200, тело ответа при этом пустое.

 

Описание 

Параметр

Тип

Обязательно

Описание

phoneNumber

string

Да

Подменный статический офлайн-номер, максимум 1 номер.
Формат: 7xxxxxxxxxx

displayOptions

object

Нет

Условия отображения статического пула в отчетах, который закреплен за этим номером 

displayOptions.source
displayOptions.medium
displayOptions.campaign

string

Да, если указан displayOptions

Значения канала, источника и кампании, которые будут отображаться в отчетах

displayOptions.content
displayOptions.keyword

string

Нет

Значения объявления и ключевого слова, которые будут отображаться в отчетах

redirectOptions

object

Нет

Сценарий переадресации

redirectOptions.redirectType

object

Да, если указан redirectOptions

В API поддерживается пока что один тип сценария переадресации – на номер телефона. Передаваемое значение всегда равно PSTN

redirectOptions.ptsnOptions.redirectNumber

string

Да, если указан redirectOptions

Номер переадресации.

Формат: 7xxxxxxxxxx

reserveRedirect

object

Нет

Резервный сценарий переадресации на случай, если основной сценарий не отвечает

reserveRedirect.reserveNumber

string

Да, если указан reserveRedirect 

Номер резервной переадресации.

Формат: 7xxxxxxxxxx

reserveRedirect.reserveTimeOut

string

Да, если указан reserveRedirect

Время в секундах, через которое звонок с основного сценария будет переадресован на резервный номер

Возможные значения от 10 до 120 (сек)

reserveRedirect.ignoreEarlyMedia

string

Нет

Если опция включена, то при переадресации на резервный номер голосовые оповещения на основном сценарии (мелодии, гудки и т.п.) будут проигнорированы – это поможет корректно определить, что на основном сценарии не ответил реальный человек или он не доступен, и выполнить переадресацию на резервный номер.

 

Возможные значения:

  • true
  • false

Если параметр не передается, то устанавливается значение ignoreEarlyMedia по умолчанию = true.

poolName

string

Нет

Название пула


Для выполнения запроса необходимо указывать хотя бы один object.


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