Skip to main content

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

Авторизация

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

Создать автообзвон

Метод POST
https://cld.alovoice.uz/mapi/addAutorule

Параметры 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")

Пример вызова на 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"'
Пример ответа сервера
{
    "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"
}

Получить автообзвон

Метод GET

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

Параметры multipart/form-data

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

Пример вызова на cURL

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

Пример ответа сервера

{
    "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"
}

Получить доступные линии (trunks)

Метод GET

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

Параметры multipart/form-data

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

Пример вызова на cURL

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

Пример ответа сервера

["551234567","712345678"]