Методы для запуска и настройки автообзвонов по 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"]