Личный кабинет
Интернет-магазин
4.6.7 Добавление нескольких заданий в кампанию (асинхронный метод)
POST /vpbx/tasks/push
Асинхронный метод. Позволяет добавлять задания кампании исходящего обзвона. На вход принимает несколько заданий. Не возвращает в ответе ID заданий.
Важно. Добавлять задания можно во всех статусах кампании исходящего обзвона, кроме статуса "Завершена".
Параметры:
| № | Параметры | Параметры | Параметры | Тип | Обяза-тель-ный | Описание |
|---|---|---|---|---|---|---|
| № | 1 уровень | 2 уровень | 3 уровень | Тип | Обяза-тель-ный | Описание |
| 1 | campaign_id | Число | Да | ID кампании | ||
| 2 | tasks [] | Массив | Да | Список задач для кампании, массив JSON-объектов | ||
| 2.1 | name | Строка | Нет | Имя клиента, которому адресован звонок. Ограничение - 255 символов | ||
| 2.2 | number | Строка | Да | Номер для выполнения звонка. Ограничение - 64 символа | ||
| 2.3 | priority | integer | Приоритет выполнения звонка. Может иметь значение от 1 до 1000 | |||
| 2.4 | organization | Строка | Нет | Название организации, которой адресован звонок. Ограничение - 255 символов | ||
| 2.5 | position | Строка | Нет | Должность человека, которому адресован звонок. Ограничение - 255 символов | ||
| 2.6 | comment | Строка | Нет | Комментарий. Ограничение - 1024 символов | ||
| 2.7 | due_date | Число | Нет | Дата и время, до которого необходимо произвести попытку выполнения задачи в формате "YYYY-MM-DD HH:MM:SS" (UTC) | ||
| 2.8 | blocked_until | Строка | Нет | Заблокировано до (какого-то времени) в формате "YYYY-MM-DD HH:MM:SS" (UTC) | ||
| 2.9 | custom_fields | Объект - ключ-значение | Нет | Значение пользовательских полей. Для получения списка пользовательских полей, используется метод "Получение списка пользовательских полей". Обязательность заполнения пользовательского поля зависит от настройки | ||
| 2.9.1 | subtasks [] | Массив | Нет | Массив подзадач (JSON-объектов) с альтернативными номерами клиента, необходимый для того, чтобы в кампанию Исходящего Обзвона можно было добавить информацию о нескольких номерах клиента. В процессе обзвона, в случае дозвона по хотя бы одному из номеров клиентов - обзвон будет остановлен | ||
| 2.9.2 | number | Строка | Да | Номер для выполнения звонка. Ограничение - 64 символа | ||
| 2.9.3 | priority | Число | Приоритет выполнения звонка. Допустимые значения: от 1 до 999. По умолчанию - 1000. | |||
| 2.9.4 | order | Число | Да | Порядковый номер исполнения подзадачи, номера в запросе могут идти в любом порядке, отсчет нумерации всегда начинается с нуля (0) | ||
| 2.9.5 | type | Число | Да | Фиксированное значение поля - ноль (0), другие значения не принимаются. Ограничение - 255 символов |
Пример запроса:
POST https://app.mango-office.ru/vpbx/tasks/push
vpbx_api_key = 1234567890qwerty,
sign = 1234567890qwerty,
json = {
"campaign_id": 56919,
"tasks":
{
"name": "Евгеньев Евгений Евгеньевич",
"number": "+375291111111",
"priority": 1,
"organization": "АБВ",
"position": "Руководитель",
"due_date": "2021-07-20 19:50:00",
"custom_fields":
{
"5781": "Салют"
},
"subtasks": [
{
"number": "+7007372527954818",
"order": 1,
"type": 0
},
{
"number": "+72527954828",
"order": 0,
"type": 0
},
{
"number": "sip:admin@test.mangosip.ru",
"order": 2,
"type": 0
}
}
]
}
В результате обработки запроса, формируются и передаются JSON-данные, содержащие следующие параметры:
| № | Параметры | Тип | Обяза-тель-ный | Описание |
|---|---|---|---|---|
| 1 | result | Да | Код результата |
Пример ответа:
{
"result": 1000
}
