Centrum Programisty

Zrób z centrali część swojego oprogramowania.

Jeden klucz API, czysty HTTP, odpowiedzi JSON. Od click-to-call i sterowania połączeniami po kampanie automatycznych połączeń, zadania asystenta głosowego i głosowy kod weryfikacyjny — wszystko to REST; wyniki wracają przez podpisane HMAC webhooki.

Szybki start

Twoje pierwsze żądanie za 2 minut

Pobierz klucz z zakładki Panel > Automatyczne połączenia > API (lub z Ustawień centrali); wyślij nagłówkiem Bearer, X-Api-Key lub ?key=.

Klucz jest powiązany z Twoim kontem klienta; nie ma dostępu do danych innego klienta.
Operacje odczytu to GET, operacje zmieniające to POST; treść JSON lub formularz.
Odpowiedź z błędem zawsze {"ok":false,"error":"…","code":"…"} ma postać.
Limit zapytań: 120 na minutę na klucz; przy przekroczeniu 429.

Przeczytaj przegląd Złóż wniosek

# click-to-call: najpierw dzwoni numer wewnętrzny 1001, po odebraniu wybierany jest cel curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # utwórz kampanię 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"}}' # wyślij głosowy kod weryfikacyjny 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}

Dokumentacja

Nagłówki API

Przy każdym nagłówku adres punktu końcowego, parametry, przykładowe żądanie i odpowiedź.

Przegląd

Uwierzytelnianie, format żądań, kody błędów, limity zapytań

Odczyt

Bezpieczeństwo API

Klucze i zakresy, dozwolone IP, podpisywanie żądań HMAC, odnawianie kluczy, dziennik żądań

Odczyt

Zarządzanie połączeniami

Click-to-call, zakończ, przełącz, wycisz

Odczyt

Kolejki

Lista kolejek, oczekujący, dodaj/usuń członka

Odczyt

Statusy konsultantów

Statusy numerów wewnętrznych i członkostwo w kolejkach

Odczyt

Czarna lista

Lista zablokowanych numerów, dodawanie, usuwanie

Odczyt

Pliki audio

Lista komunikatów, przesyłanie, aktualizacja, usuwanie

Odczyt

Automatyczne połączenia

Utwórz kampanię, dodaj numery, pobierz wyniki, webhook

Odczyt

Asystent Głosowy

Rozmowy, notatki, terminy, zadania dzwoniące, osadzanie

Odczyt

Głosowa weryfikacja (OTP)

Wyślij kod, zweryfikuj, status, webhook

Odczyt

API SMS

Masowe / spersonalizowane SMS-y, SMS OTP, raport dostarczenia, przychodzące SMS-y, czarna lista

Odczyt

Webhooki

Weryfikacja podpisu, polityka ponawiania, schematy zdarzeń

Odczyt

Osadzenie (iframe CRM)

Na ekranach centrali i w oprogramowaniu WebPhone: kod, podpisany link, zdarzenia JavaScript

Odczyt

Webhooki

Niech wyniki przychodzą do Ciebie, nie musisz pytać.

Wynik automatycznych połączeń, podsumowanie rozmowy asystenta głosowego, status kodu weryfikacyjnego — każde zdarzenie jest wysyłane jako JSON metodą POST na Twój adres; nagłówek X-Buluthat-Signature to podpis HMAC-SHA256. Nieudane dostarczenia są ponawiane w odstępach 1 min → 6 godz.

Dokumentacja webhooków

// PHP: weryfikacja podpisu $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' …

Most Byfix CRM

Asystent głosowy znajduje klienta w CRM, zakłada zgłoszenie serwisowe, dopisuje notatkę; „zadzwoń asystentem” uruchamia się z CRM. Gotowe, jeden klucz.

Szczegół

Klient PHP

Gotowa klasa PHP do głosowego kodu weryfikacyjnego; wyślij/zweryfikuj dwiema linijkami. Pozostałe punkty końcowe to czysty HTTP, więc można je wywoływać z każdego języka.

Przykład

Osadzalny ekran na żywo

Transkrypcja rozmowy asystenta na żywo w iframe wewnątrz CRM; z podpisanym tokenem o ograniczonym czasie ważności, bez sesji panelu.

embed_url