# Методы для запуска и настройки автообзвонов по API

## [](#%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F)Авторизация

Все методы проходят авторизация по методы `Authorization: Bearer token` в хедере каждого метода

## [](#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D1%82%D1%8C-%D0%B0%D0%B2%D1%82%D0%BE%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD)Создать автообзвон

##### [](#%D0%BC%D0%B5%D1%82%D0%BE%D0%B4-post-1)Метод `POST`

```
https://cld.alovoice.uz/mapi/addAutorule
```

#### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-multipartform-data)Параметры `multipart/form-data`

`record` - .mp3 файл (обязательно)

`recipients` - .csv файл (обязательно)

`name` - Название (обязательно)

`from` - Дата начало промежутка обзвона формат:YYYY.MM.DD \[2025.04.25\] (обязательно)

`to` - Дата конца промежутка обзвона формат:YYYY.MM.DD \[2025.04.25\] (обязательно)

`fromtime` - Начало времени промежутка обзвона формат: HH:MM \[18:10\] (обязательно)

`totime` - Конец времени промежутка обзвона формат: HH:MM \[20:59\] (обязательно)

`trunks` - Номера линий (транков) для звонка, несколько транков разделяются запятыями: "712037006" (обязательно)

`maxline` - Максимум одновременных линия для звонков, цифра Пример: 2 (по умолчанию 1)

`goodtime` - Максимум секунд после поднятия трубки клиентом, чтобы считать звонок успешным, цифра Пример: 5 (по умолчанию 3)

`tryes` - Количество попыток для дозвона: цифра Пример: 5 (по умолчанию 2)

`paused` - 0 или 1, если 0 - при наступлении времени в параметрах запуститься обзвон иначе нет

`timezone` - Временная зона в формате utc +5 (по умолчанию "utc +5")

##### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%B0-%D0%BD%D0%B0-curl)Пример вызова на cURL

```
curl --location --request POST 'https://cld.alovoice.uz/mapi/addAutorule' \
--header 'Authorization: Bearer 22dfbb22-d073-4422-b322-22949d14a022' \
--form 'record=@"/C:/Users/Tug/Music/001_ChooseLang_Uz_Ru.mp3"' \
--form 'recipients=@"/C:/Users/Tug/Downloads/recipients.csv"' \
--form 'name="TestAutocalls1"' \
--form 'from="2025.04.25"' \
--form 'to="2025.04.25"' \
--form 'fromtime="18:00"' \
--form 'totime="20:59"' \
--form 'trunks="712037006"' \
--form 'maxline="3"' \
--form 'goodtime="4"' \
--form 'tryes="5"' \
--form 'paused="0"' \
--form 'timezone="utc +5"'
```

##### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0)Пример ответа сервера

```
{
    "id": 123,
    "name": "TestAutocalls1",
    "from": "2025-04-25",
    "to": "2025-04-25",
    "fromtime": "18:00:00",
    "totime": "20:59:59",
    "trunks": [ "253" ],
    "record": "/play/1231238fba81bfa19c254df73b123123",
    "recipients": 0,
    "maxline": "3",
    "goodtime": "4",
    "tryes": "5",
    "paused": "0",
    "status": "new",
    "timezone": 18000,
    "updatedAt": "2025-04-25T09:14:24.747Z",
    "createdAt": "2025-04-25T09:14:24.747Z"
}
```

## [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D0%B0%D0%B2%D1%82%D0%BE%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD)Получить автообзвон

#### [](#%D0%BC%D0%B5%D1%82%D0%BE%D0%B4-get)Метод `GET`

```
https://cld.alovoice.uz/mapi/getAutorule/123
```

#### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-multipartform-data-1)Параметры `multipart/form-data`

`id` - индентификатор сохранённого прежде на сервере автообзвона

#### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%B0-%D0%BD%D0%B0-curl-1)Пример вызова на cURL

```
curl --location --request GET 'https://cld.alovoice.uz/mapi/getAutorule/40' \
--header 'Authorization: Bearer 22dfbb22-d073-4422-b322-22949d14a022' \
```

#### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0-1)Пример ответа сервера

```
{
    "id": 123,
    "name": "TestAutocalls1",
    "from": "2025-04-25",
    "to": "2025-04-25",
    "fromtime": "18:00:00",
    "totime": "20:59:59",
    "trunks": [ "253" ],
    "record": "/play/123458fba81bfa19c254df73b07123123",
    "recipients": 0,
    "maxline": "3",
    "goodtime": "4",
    "tryes": "5",
    "paused": "0",
    "status": "new",
    "timezone": 18000,
    "updatedAt": "2025-04-25T09:14:24.747Z",
    "createdAt": "2025-04-25T09:14:24.747Z"
}
```

---

## [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D1%8B%D0%B5-%D0%BB%D0%B8%D0%BD%D0%B8%D0%B8-trunks)Получить доступные линии (trunks)

#### [](#%D0%BC%D0%B5%D1%82%D0%BE%D0%B4-get-1)Метод `GET`

```
https://cld.alovoice.uz/mapi/getMyTrunks
```

#### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-multipartform-data-2)Параметры `multipart/form-data`

`id` - индентификатор сохранённого прежде на сервере автообзвона

#### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%B0-%D0%BD%D0%B0-curl-2)Пример вызова на cURL

```
curl --location --request GET 'https://cld.alovoice.uz/mapi/getMyTrunks' \
--header 'Authorization: Bearer 22dfbb22-d073-4422-b322-22949d14a022' \
```

#### [](#%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0-2)Пример ответа сервера

```
["551234567","712345678"]
```