# Создание обзвонов
#### Описание API позволяет создавать обзвоны с заданными параметрами. Данная документация описывает API для создания обзвона с указанными параметрами. В случае успешного создания обзвона будет возвращен ID созданного обзвона для последующего получения результатов.
##### POST ##### `https://ai-assistant.is74.ru/api/campaigns`
```json { "campaign": { "project_id": 0, "name": "string", "description": "string", "start_block_id": 0, "schedule": { "date": "string", "start_time": "string", "end_time": "string", "periods": {"id": 1, "title": "Однократно"}, "attempts": {"id": 1, "title": "1"}, "interval": "string"}, "state": "Создано", "phone_id": 0 }, "phones": [ { "phone": "string", "add_data": {} } ] } ```

В **add\_data** передаются json {ключ: значение}, где ключ является параметром из стартового блока сценария

Параметры запроса
CampaignValue RulesDescription
project\_id`required` `integer` ID проекта
name`string` Название обзвона
description`string` Описание обзвона
start\_block\_id`required` `integer`ID стартового блока сценария
schedule`required``json` Расписание обзвона
state`string` Статус обзвона. Всегда выставлять значение: "Создано"
phone\_id`required` `integer`ID номера телефона, с которого звонить
Schedule
ScheduleValue RulesDescription
date`required` `string`Дата начала обзвона (формат: ГГГГ-ММ-ДД)
start\_time`required` `string`Время начала обзвона (формат: ЧЧ:ММ)
end\_time`required` `string`Время окончания обзвона (формат: ЧЧ:ММ)
periods`required``json`Периодичность обзвона
attempts`required``json`Количество попыток дозвона на номер
interval `required` `string`Время в минутах между попытками дозвона
Periods
PeriodsValue RulesDescription
id `required` `integer` Всегда выставлять значение: 1
title`required` `string`Всегда выставлять значение: "Однократно"
Attempts
**Attempts**Value RulesDescription
id `required` `integer` Значения от "1" до "5". Значение в id соответствует значению в title.
title`required` `string`Значения от "1" до "5". Значение в title соответствует значению в id.
Пример запроса ```json {   "campaign": {     "project_id": 1,     "name": "Обзвон клиентов",     "description": "Обзвон клиентов для опроса удовлетворенности",     "start_block_id": 10,     "schedule": {       "date": "2000-01-01",       "start_time": "09:00",       "end_time": "17:00",       "periods": {"id": 1, "title": "Однократно"},       "attempts": {"id": 1, "title": "1"},       "interval": "5"     },     "state": "Создано",     "phone_id": 5   },   "phones": [     {       "phone": "+79999999999",       "add_data": {"name":"Иванов Иван", "time":"10:00", "phone": 123456}     }   ] } ```
Пример ответа **Код: 200** ```json {   "campaign": {     "id": 12345   } } ``` **Ошибки** - В случае ошибки будет возвращен соответствующий HTTP статус код и сообщение об ошибке.