Центр разработчиков

Сделайте АТС частью своего ПО.

Один ключ API, обычный HTTP, ответы JSON. От click-to-call и управления вызовами до кампаний автодозвона, заданий голосового ассистента и голосового кода подтверждения — всё через REST; результаты возвращаются через webhook с подписью HMAC.

Быстрый старт

Ваш первый запрос — за 2 мин

Получите ключ на вкладке «Панель > Автодозвон > API» (или в настройках АТС); передавайте его в заголовке Bearer, X-Api-Key или ?key=.

  • Ключ привязан к вашему клиентскому аккаунту; доступа к данным других клиентов нет.
  • Операции чтения — GET, изменяющие операции — POST; тело — JSON или form.
  • Ответ с ошибкой всегда {"ok":false,"error":"…","code":"…"} имеет формат.
  • Лимит запросов: 120 в минуту на ключ; при превышении 429.
# click-to-call: сначала звонит внутренний номер 1001, после ответа набирается целевой номер curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # создать кампанию curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Ödeme hatırlatma","campaign_type":"ivr", "tts_template":"Merhaba {sayin}, {tutar} tutarındaki ödemeniz…", "digit_labels":{"1":"Ödedim","2":"Yetkili"}}' # отправить голосовой код подтверждения curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}
Документация

Заголовки API

В каждом заголовке — адрес метода, параметры, пример запроса и ответа.

Обзор

Аутентификация, формат запросов, коды ошибок, лимиты запросов

Читать
Безопасность API

Ключ и области доступа, разрешённые IP, подпись запросов HMAC, обновление ключа, журнал запросов

Читать
Управление вызовами

Click-to-call, завершение, перевод, отключение микрофона

Читать
Очереди

Список очередей, ожидающие, добавление/удаление участников

Читать
Статусы операторов

Статусы внутренних номеров и участие в очередях

Читать
Чёрный список

Список заблокированных номеров, добавление, удаление

Читать
Аудиофайлы

Список аудиообъявлений, загрузка, обновление, удаление

Читать
Автодозвон

Создание кампании, добавление номеров, получение результатов, webhook

Читать
Голосовой ассистент

Разговоры, заметки, записи на приём, задания-звонки, встраивание

Читать
Голосовое подтверждение (OTP)

Отправка кода, проверка, статус, webhook

Читать
SMS API

Массовая / персонализированная SMS, OTP SMS, отчёт о доставке, входящие SMS, чёрный список

Читать
Webhook

Проверка подписи, политика повторов, схемы событий

Читать
Встраивание (CRM iframe)

На экранах АТС и в вашем веб-телефоне: код, подписанная ссылка, события JavaScript

Читать
Webhook

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

Результат автодозвона, сводка разговора голосового ассистента, статус кода подтверждения — каждое событие отправляется на ваш адрес в виде JSON через POST; заголовок X-Buluthat-Signature — подпись HMAC-SHA256. Неудачная доставка повторяется с интервалами 1 мин → 6 ч.

Документация по webhook
// PHP: проверка подписи $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …
Мост Byfix CRM

Голосовой ассистент находит клиента в CRM, создаёт запись на сервис, делает заметку; из CRM запускается «звонок ассистентом». Готово, один ключ.

Подробности
PHP-клиент

Готовый PHP-класс для голосового кода подтверждения; отправка/проверка в две строки. Остальные методы — обычный HTTP, поэтому вызываются из любого языка.

Пример
Встраиваемый живой экран

Живая расшифровка разговора ассистента в CRM через iframe; с подписанным токеном ограниченного срока, вход в панель не нужен.

embed_url