RU
EN
KZ
RU
EN
KZ

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

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

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.content
displayOptions.keyword

string

Нет

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

redirectOptions

object

Да

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

redirectOptions.redirectType

object

Да

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

redirectOptions.ptsnOptions.redirectNumber

string

Да

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

Формат: 7xxxxxxxxxx

reserveRedirect

object

Нет

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

reserveRedirect.reserveNumber

string

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

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

Формат: 7xxxxxxxxxx

reserveRedirect.reserveTimeOut

string

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

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

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

reserveRedirect.ignoreEarlyMedia

string

Нет

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

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

  • true
  • false

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

poolName

string

Да

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


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


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