Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 23 Следующий »

API. Создание задания на обзвон.

 

Метод: POST

Authorization: Bearer Token

URL: https://tcl.twin24.ai/api/cis/beta/tasks

Тело запроса в формате Json
{

    "name": "02.02 тестирование на номер Никиты",

    "botId": "44e62ac6-6c08-4ad1-923d-5ee3299dd737",

    "dialplanId": "d71c9c44-e942-4c6c-9ccc-ea5a043efb75",

    "backgroundNoise": "/background/office.wav",




    "amd": {

        "enabled": true,

        "mode": "BACK",

        "file": null

    },




    "defaultCallerId": {

        "type": "Custom ",

        "data": "79133912047",

        "additional": null

    },

   

    "defaultRedirect": {

        "type": "hangup",

        "data": null,

        "additional": null

    },




    "scheduledAt": null,

    "intensity": 1,




    "allowedTimeRange": {

        "from": 32500,

        "to": 79000

    },




    "phoneNormalization": "ru",

    "detectGenderByVoice": true,

    "isTest": false,

   

    "recallRules": {

        "BUSY": {

            "enabled": true,

            "tries": 3,

            "interval": 900

        },

        "NO_ANSWER": {

            "enabled": true,

            "tries": 3,

            "interval": 1800

        },

        "MACHINE": {

            "enabled": true,

            "tries": 2,

            "interval": 1800

        },

        "CONGESTION": {

            "enabled": true,

            "tries": 3,

            "interval": 900

        },

        "NOT_SUCCESSFUL": {

            "enabled": false,

            "tries": null,

            "interval": null,

            "duration": 0

        }

    }

}

Значения параметров передаются в блоке Запрос к серверу как JSON-объект в следующем виде:

Тип значенияПримерЗначение параметра
Значение true

{

"isTest": true

}

1
Значение false

{

"detectGenderByVoice": false

}

0
Значение null

{

"backgroundNoise": null

}



         

Если параметр представляет собой пару «ключ/значение» JSON-объекта, то название этого параметра нужно указывать в следующем виде: <имя объекта>.<название параметра>.

Описание полей метода:

Поле

Тип

Обязательно

Значение по умолчанию

Описание

name

string

Да


Имя задания. Задается в любом формате, который поможет отличить одно задание от другого и понять, кому звонили, и когда был обзвон.

botId

string

Да


Идентификатор сценария, по которому бот должен вести диалог с клиентом в рамках задания на обзвон.


dialplanId


string


Да


Идентификатор плана набора подключенной телефонии.

Уникален для каждого аккаунта. Указан в настройках телефонии в личном кабинете.

backgroundNoise

string

Нет

null

Настройка фонового шума для создания ощущения естественности. Фоновый шум воспроизводится системой во время работы бота. Названия файлов отображаются в списке значений параметра Фоновый шум в окне Добавление нового задания на обзвон в кабинете администратора.

Например: /background/office.wav – шум офиса.

Null - если фоновый шум не используется.

amd

amdInfo {
}

Нет


Перечень настроек модуля определения автоответчиков.

enabled

boolean

Нет

0

Поле, отвечающее за включение/отключение модуля определения автоответчиков.

  • true – модуль определения автоответчиков включен и работает
  • false – модуль определения автоответчиков отключен и не работает

mode

string

Нет

null

Режим работы модуля определения автоответчиков. Существует два режима работы:

  • back – модуль определения автоответчиков работает параллельно с работой бота в синхронном режиме
    block – модуль определения автоответчиков блокирует работу бота и не дает начать диалог, пока не примет однозначного решения, что боту отвечает человек

file

string

Нет

null

Содержит путь к аудиофайлу приветствия для режима работы модуля определения автоответчиков BLOCK.

Для режима BACK используйте значение null.

defaultCallerId

defaultCallerIdInfo{

}

Нет


Настройка параметров номера телефона (АОН), который отображается на телефоне клиента во время звонка от бота.

type


Нет

default

Тип АОН:

  • Default – использовать номер телефона, указанный в настройках канала связи
  • Custom – использовать номер телефона, указанный в поле data
  • groupAON – использовать настроенную в личном кабинете группу АОН

data


Нет

null

Первичный параметр настройки для типов:

  • Custom – определяет номер телефона, который используется в качестве АОН, в формате 7хххххххххх
  • groupAON – определяет ID группы АОН, настроенной в кабинете администратора

additional


Нет

null

Дополнительная информация.

Всегда null.

defaultRedirect

defaultRedirectInfo{

}

Нет


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

type

string

Нет

hangup

Тип переадресации по умолчанию:

  • Hangup – завершить диалог
  • Dialplan – план набора
  • Transfer – направление перевода
  • Custom – произвольный перевод
  • Twin – другой сценарий

data

string

Нет

null

Первичный параметр настройки для типов:

  • Dialplan – план набора
  • Transfer – направление перевода
  • Custom – произвольный перевод
  • Twin – другой сценарий

Для Hangup - null.

additional

string

Нет

null

Вторичный параметр настройки для типов:

  • Dialplan – план набора
  • Custom – произвольный перевод

Для остальных - null.

scheduledAt

Date

Нет

null

Режим запуска задания.

Если задание должно запуститься автоматически в определенную дату и время, их необходимо указать в формате ГГГГ-ММ-ДДTчч:мм:сс+чч:мм

(год-месяц-деньTчасы:минуты:секунды+часовой пояс)

Например: 2022-10-13T09:00:00+00:00.

Если задание должно запуститься при загрузке реестра номеров, укажите null.


intensity

Int

Да

1

Интенсивность обзвона. Указывает, какое количество вызовов система будет совершать в секунду. Например, при значении 1 система будет набирать один номер каждую секунду, 60 номеров в минуту и 3 600 номеров за час работы задания.

Задается в виде целого числа в диапазоне от 1 до 5.

allowedTimeRange

allowedTimeRangeInfo{
}

Нет


Указание самого раннего и самого позднего времени, в которое можно позвонить клиенту в рамках задания.
Время указывается без учета часового пояса клиента. Сам часовой пояс система определяет самостоятельно по номеру телефона.

from

Int

Нет
0

Самое ранее время, в которое можно позвонить клиенту. Указывается в секундах с отсчетом от 00:00.

to

Int

Нет

86399

Самое позднее время, в которое можно позвонить клиенту. Указывается в секундах с отсчетом от 00:00.

phoneNormalization

string

Нет


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

  • ru – номера приводятся к российскому формату
  • null – номера передаются в неизменном виде

detectGenderByVoice

boolean

Нет

false

Поле, отвечающее за включение/отключение работы модуля определения половой принадлежности клиента по его голосу:

  • true – модуль определения гендера включен и работает
  • false – модуль определения гендера отключен и не работает

isTest

boolean

Нет
false

Признак для отключения у задания механизмов ограничений ФЗ-230 и отключение любых сдерживающих механизмов платформы:

  • true – задание считается тестовым, и для него отключаются механизмы соблюдения ФЗ и прочее.
  • false – для задания работают ограничения и механизмы безопасности

recallRules

recallRulesInfo {
}

Нет


Перечень настроек стратегии перезвонов. Перезвон на каждый статус попытки дозвона настраивается отдельно.

BUSY

busyInfo {
}

Нет


Настройки стратегии перезвонов на номера, которые при попытке дозвона получили от оператора связи статус «Занято».

enabled

boolean

Нет

false

Поле, отвечающее за необходимость перезвона на статус:

  • true – нужно перезванивать
  • false – не нужно перезванивать

tries

Int

Нет

null

Количество попыток дозвона на статус.

interval

Int

Нет

null

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

NO_ANSWER

no_answerInfo {
}

Нет


Настройки стратегии перезвонов на номера, которые при попытке дозвона получили от оператора связи статус «Нет ответа».

enabled

boolean

Нет

false

Поле, отвечающее за необходимость перезвона на статус:

  • true – нужно перезванивать
  • false – не нужно перезванивать

tries

Int

Нет

null

Количество попыток дозвона на статус.

interval

Int

Нет

null

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

MACHINE

machineInfo {
}

Нет


Настройки стратегии перезвонов на номера, которые при попытке дозвона получили от модуля определения автоответчиков (при условии его работы) статус «Атоответчик».

enabled

boolean

Нет

false

Поле, отвечающее за необходимость перезвона на статус:

  • true – нужно перезванивать
  • false – не нужно перезванивать

tries

Int

Нет

null

Количество попыток дозвона на статус.

interval

Int

Нет

null

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

CONGESTION

congestionInfo {
}

Нет


Настройки стратегии перезвонов на номера, которые при попытке дозвона получили от оператора связи статус «Ошибка дозвона».

enabled

boolean

Нет

false

Поле, отвечающее за необходимость перезвона на статус:

  • true – нужно перезванивать
  • false – не нужно перезванивать

tries

Int

Нет

null

Количество попыток дозвона на статус.

interval

Int

Нет

null

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

NOT_SUCCESSFUL

not_SuccessFulInfo {
}

Нет


Настройки стратегии перезвонов на номера, для которых время диалога бота было меньше или равно указанному в настройках этого параметра

enabled

boolean

Нет

false

Поле, отвечающее за необходимость перезвона на статус:

  • true – нужно перезванивать
  • false – не нужно перезванивать

tries

Int

Нет

null

Количество попыток дозвона на статус.

interval

Int

Нет

null

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

duration

Int

Нет

null

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


Ответ в формате Json
{

    "id": "ce68bf14-2d76-4bf3-b718-3df2d36b7698"

}

 

Описание полей ответа:

Поле

Тип

Обязательно

Описание

id

string

Да

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

 


  • Нет меток