Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleДобавить задачу или несколько задач в task_scheduler

Добавить задачи (может быть добавлена одна)

POST /client/{client_id}/task_scheduler/{scheduler_id}/tasks/

Параметры URL

Название

Тип

Описание

scheduler_id

string

Обязательный

client_id

string

Обязательный

Параметры запроса (JSON)

Название

Тип

Описание

tasks

array of tasks

Массив задач - обязательный параметр

Должен содержать одну задачу или более

Массив задач JSON:

Name

Type

Description

name

string

Имя задачи

a_number

string

Номер, который будет вызван первым

b_number

string

Номер, который будет вызван вторым

callback_params

object

Набор необязательных параметров callback + extended_a_numbers, за исключением a_number, b_number, variables

extended_a_numbers - список дополнительных номеров a_number
Формат:

{“caller_id_name”: "string",
“caller_id_number“: "string",
“extended_a_numbers”: list}

extension_id

integer

Id добавочного, за счет которого будет совершаться вызов

global_expires

integer

Период времени в секундах, когда задача акутуальна. C момента начала выполнения.

try_count

integer

Максимальное количество попыток callback. По умолчанию: 1 максимум: 50

try_again_pause

string

Пауза перед следующей попыткой обзвона (в секундах). Максимальное значение - 864000

url_before

string

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

url_before_again

string

URL, куда уйдет событие перед повторной попыткой обзвона

url_success

string

URL, куда уйдет событие в случае успеха задачи (успешное соединение А и Б номеров)

url_after

string

URL, куда уйдет событие по результату задачи

start_time_utc

string

Время начала старта задачи по utc в форматеYYYY-MM-DD HH:MM:SS

(может быть указано кол-во секунд, через это время будет старт задачи)

variables

object

Переменные для callback. Максимальный размер значения каждой переменной - 200 символов

attempts_src_ani_numbers

list

Упорядоченный список src_ani для callback по попыткам задачи. Берется по порядку попыток.

attempts_dst_ani_numbers

list

Упорядоченный список dst_ani для callback по попыткам задачи. Берется по порядку попыток.

interval_timezone

string

Тайм зона для интервала из планировщика конкретного таска.

Поля ответа

Название

Тип

Описание

status

string

Одно из 'scheduled', 'executed', 'delayed', 'finished', 'delayed_concurrent_task'

'finished' - выполненная задача

'delayed' - отложена после неуспешной попытки соединения на try_again_pause'delayed_concurrent_task' - отложена по причине установленного лимита на очереди concurrent_task_limit

'executed' - задача была запущена

По умолчанию, еще не выполненные со статусом: 'scheduled'

a_number

string

Номер, который будет вызван первым

b_number

string

Номер, который будет вызван вторым

callback_params

object

Набор необязательных параметров callback. На данный момент доступны: extended_a_numbers, caller_id_name и caller_id_number.

extended_a_numbers - список дополнительных номеров a_number

extension_id

integer

Id добавочного, за счет которого будет совершаться вызов

global_expires

integer

Период времени в секундах, когда задача акутуальна. C момента начала выполнения.

scheduler_id

integer

id очереди

finish_result

string

Либо успех: 'success', либо неуспех: 'failed'.

cdr

string

uuid звонка, до обвзона это поле пустое, далее, по результату обзвона (status= ‘executed’ ) uuid можно использовать в ресурсе /client/{client_id}/call_history/{call_uuid}

try_count

integer

Максимальное количество попыток callback

try_again_pause

string

Пауза перед следующей попыткой обзвона (в секундах)

start_time_utc

string

Время начала старта задачи по utc в форматеYYYY-MM-DD HH:MM:SS

url_before

string

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

url_before_again

string

URL, куда уйдет событие перед повторной попыткой обзвона

url_after

string

URL, куда уйдет событие по результату задачи

url_success

string

URL, куда уйдет событие в случае успеха задачи (успешное соединение А и Б номеров)

create_date_utc

string

Время создания задачи по utc в форматеYYYY-MM-DD HH:MM:SS

id

integer

id задачи

name

string

имя задачи

finish_comment

string

Тут может быть уточнена причина неуспеха

variables

object

Переменные для callback

attempts_src_ani_numbers

list

Упорядоченный список src_ani для callback по попыткам задачи. Берется по порядку попыток.

attempts_dst_ani_numbers

list

Упорядоченный список dst_ani для callback по попыткам задачи. Берется по порядку попыток.

interval_timezone

string

Тайм зона для интервала из планировщика конкретного таска.

...