REST API v1

Интегрируйте автообзвон в свой продукт

Запускайте звонки и рассылки прямо из своей CRM, ERP или приложения.
JSON, Bearer-токен, webhooks. Один запрос — и система начинает звонить.

Документация → Зарегистрироваться
quick start
# Запустить автообзвон
POST https://autocall.kz/api/v1/autocalls
Authorization: Bearer {your_token}
Accept: application/json

{
  "name": "Акция: скидка 20%",
  "type": "regular",
  "list_id": [1234],
  "audio_id": [5678],
  "time_from": "09:00",
  "time_to": "21:00"
}

← 201 Created { "id": 99012 }
REST
JSON API
Bearer
токен-авторизация
Webhook
результаты в реальном времени
5 мин
до первого звонка через API

Что можно делать через API

Полный контроль над всеми сервисами AutoCall.kz

📞

Автообзвоны

Создавайте, запускайте, останавливайте и перезапускайте кампании. Получайте результаты по каждому звонку.

/api/v1/autocalls
GET POST PUT DEL
👥

Контакты и базы

Управляйте списками контактов. Загружайте до 10 000 номеров за один запрос, добавляйте порциями.

/api/v1/lists
GET POST DEL
💬

SMS-рассылки

Запускайте массовые SMS-кампании, рассчитывайте стоимость, отслеживайте статусы доставки.

/api/v1/bulks
GET POST PUT DEL
🔀

Сценарии IVR

Создавайте интерактивные сценарии с ветвлением, распознаванием речи и нажатием клавиш.

/api/v1/scenarios
GET POST PUT DEL
🎵

Аудиозаписи

Загружайте MP3/WAV/OGG-файлы, BASE64 или синтезируйте речь из текста.

/api/v1/sounds
GET POST DEL
⚡

Flash Call

Верификация через входящий звонок. Авто-код или свой код. Результат за 3–10 секунд.

/api/v1/flash-calls
POST
📊

Баланс и статистика

Проверяйте текущий баланс, историю платежей и детализацию расходов.

/api/v1/balance
GET
🔔

Webhook / Callback

Получайте уведомления о каждом звонке и изменении статуса рассылки на ваш сервер в реальном времени.

callback_url
CB

Аутентификация

Все запросы требуют Bearer-токен. Получите его в личном кабинете: Настройки → API интеграция.

Храните токен в защищённом месте — он даёт полный доступ к вашему аккаунту.

AUTH
headers
Authorization: Bearer eyJ0eXAiOiJKV...
Content-Type: application/json
Accept: application/json

Базовый URL

https://autocall.kz/api/v1/

Три шага за 5 минут

Шаг 1 — Создайте базу контактов
POST
/api/v1/lists
{
  "name": "Клиенты май 2025",
  "numbers": ["+77001234567", "+77089876543"]
}
← 201 { "id": 1234, "count": 2 }
Шаг 2 — Запустите автообзвон
POST
/api/v1/autocalls
{
  "name": "Акция: скидка 20%",
  "type": "regular",
  "list_id": [1234],
  "audio_id": [5678],
  "time_from": "09:00",
  "time_to": "21:00",
  "max_tries": 2,
  "callback_url": "https://your.app/webhook"
}
← 201 { "id": 9999012, "status": "awaiting" }
Шаг 3 — Получите результаты
GET
/api/v1/autocalls/9999012
← 200 OK
{
  "id": 99012,
  "status": "completed",
  "processed_percentage": 100,
  "success": 612,
  "no_answer": 312,
  "recalled": 47,
  "busy": 29
}

Webhooks — результаты в реальном времени

Укажите callback_url при создании обзвона или SMS-рассылки — и после завершения каждой кампании система отправит POST-запрос с полными данными на ваш сервер.

Также доступен mid-call webhook: нода request в сценарии IVR делает HTTP POST прямо во время звонка — удобно для динамических данных из вашей CRM.

Статусы звонков
success Дозвонился, прослушал
recalled Перезвонил сам (бесплатно)
no_answer Не ответил
busy Занято
error Ошибка соединения
spam Определён как спам
cancelled Отменён
Пример webhook-payload
POST
→ your.app/webhook
{
  "id": 99012,
  "name": "Акция: скидка 20%",
  "status": "completed",
  "processed_percentage": 100,
  "success": 612,
  "recalled": 47,
  "no_answer": 312,
  "busy": 29,
  "error": 0,
  "spam": 0,
  "cancelled": 0,
  "total_duration": 18453, // секунды
  "date_start": "2025-05-17 09:00:00",
  "date_end": "2025-05-17 11:23:44"
}
Flash Call через API
POST
/api/v1/flash-calls
# Авто-код: система генерирует
{ "number": "+77001234567", "digits": 4 }
← 201 { "code": "3910" }

# Свой код: вы задаёте
{ "number": "+77001234567", "code": "2511" }
← 201 Created

Сценарии IVR — ноды

Интерактивный обзвон строится из нод — блоков логики. Вы собираете сценарий как конструктор и загружаете через API или интерфейс.

Полная документация →
playback

Воспроизведение

Проиграть аудиофайл абоненту

dtmf

Нажатие клавиши

Ждать нажатия 0–9, ветвить сценарий

speech

Распознавание речи

Распознать ответ и передать в следующий блок

talk_detect

Детектор ответа

Определить: живой человек или автоответчик

record

Запись голоса

Записать ответ абонента (5–60 сек)

sms

SMS абоненту

Отправить SMS по ходу звонка

sms_me

SMS оператору

Уведомить ваш номер о результате звонка

request

HTTP-запрос (mid-call)

POST на ваш сервер прямо во время звонка

dial

Перевод звонка

Соединить абонента с подтверждённым номером

Справочник эндпоинтов

Полная таблица всех доступных методов

Метод Эндпоинт Описание
GET /api/v1/autocalls Список автообзвонов
POST /api/v1/autocalls Создать автообзвон
GET /api/v1/autocalls/{id} Результаты обзвона
PUT /api/v1/autocalls/{id} Обновить обзвон
DEL /api/v1/autocalls/{id} Удалить обзвон
GET /api/v1/autocalls/relaunch/{id} Перезапустить обзвон
POST /api/v1/autocalls/calculate Рассчитать стоимость
GET /api/v1/calls/{id} Детали конкретного звонка
GET /api/v1/calls/recordings/{id} Скачать запись разговора
GET /api/v1/lists Список баз контактов
POST /api/v1/lists Создать базу (до 10 000 номеров)
POST /api/v1/lists/append/{id} Добавить номера в базу
DEL /api/v1/contacts/{id} Удалить контакт из базы
GET /api/v1/bulks Список SMS-рассылок
POST /api/v1/bulks Запустить SMS-рассылку
POST /api/v1/bulks/calculate Рассчитать стоимость SMS
GET /api/v1/messages/{id} Статус конкретного SMS
GET /api/v1/scenarios Список сценариев IVR
POST /api/v1/scenarios Создать сценарий
PUT /api/v1/scenarios/{id} Обновить сценарий
DEL /api/v1/scenarios/{id} Удалить сценарий
GET /api/v1/sounds Список аудиозаписей
POST /api/v1/sounds Загрузить аудиофайл
DEL /api/v1/sounds/{id} Удалить аудиофайл
POST /api/v1/flash-calls Flash Call верификация
GET /api/v1/balance Текущий баланс
GET /api/v1/payments История платежей
GET /api/v1/settings Настройки и тарифы

Лимиты и ограничения

Контактов за один запрос до 10 000
Попытки дозвона (max_tries) 1–4
Интервал между попытками 3–120 минут
Длина SMS (кириллица) 70 символов / часть
Длина SMS (латиница) 160 символов / часть
Запись голоса (нода record) 5–60 секунд
Время тишины для записи 2–5 секунд
Flash Call код 3 или 4 цифры
Номера только Казахстан (+7)
API-токен Bearer, не истекает

Готовы интегрировать?

API-ключ доступен в личном кабинете сразу после регистрации.
После регистрации вам будут предоставлены бонусные средства на баланс, которых хватит для интеграции.

Документация → Зарегистрироваться бесплатно
Главная Автообзвон SMS-рассылки Голосовые рассылки Тарифы Flash Call AI-агенты Как это работает Интеграции FAQ Блог Для интернет-магазинов Для клиник и медцентров Для логистики и доставки Для банков и МФО Для онлайн-школ и инфобизнеса Контакты Техподдержка История обновлений Пожаловаться Пользовательское соглашение API документация