Zarządzanie połączeniami
Z oprogramowania inicjuj połączenia (click-to-call), kończ trwające, przełączaj lub wyciszaj. Wszystkie punkty końcowe klucz API (zakres call; Authorization: Bearer bt_… w nagłówku, zob. Bezpieczeństwo API) oraz GET wywoływane metodą.
Limit zapytań: 10 na minutę. Identyfikator połączenia (call_uuid)begin_callzwracany w odpowiedzi i w danych połączenia na żywo.
GETInicjowanie połączenia (click-to-call)
Najpierw dzwoni wskazany numer wewnętrzny; po jego odebraniu wybierany jest numer docelowy i obie strony są łączone.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parametr | Wymagane | Opis |
|---|---|---|
Authorization (nagłówek) | tak | Bearer bt_…, zakres call |
extension | tak | Numer wewnętrzny, z którym zostanie połączone połączenie (np. 1001) |
destination | tak | Numer do wybrania. Dla Turcji 905321234567, dla zagranicy 00 + kod kraju |
caller_id | nie | Numer wyświetlany przy połączeniu wychodzącym; jeśli nie podany, domyślny numeru wewnętrznego. Numer nienależący do Twojego konta 400 zwraca |
manual_answer | nie | true jeśli numer wewnętrzny ma ręcznie odebrać; jeśli nie podano, na obsługujących urządzeniach odbiera automatycznie |
timeout | nie | Czas dzwonienia, 10-60 s (domyślnie 30) |
announcement_to_caller | nie | Identyfikator komunikatu odtwarzanego numerowi wewnętrznemu w chwili połączenia |
announcement_to_callee | nie | Identyfikator komunikatu odtwarzanego dzwoniącemu w chwili połączenia |
Odpowiedź pozytywna: 200 OK, w treści identyfikator połączenia.
358c20bc-fd86-11e5-87a2-157d41a07454Przykłady błędnych odpowiedzi:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETZakończ połączenie
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id zamiast tego akceptowana jest także postać ścieżki: /api/hangup/<call_uuid>. Odpowiedź 200 OK.
GETPrzełącz połączenie
Przełącza trwające połączenie na numer wewnętrzny lub numer zewnętrzny.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parametr | Opis |
|---|---|
id | Identyfikator połączenia |
user_number | Docelowy numer wewnętrzny (np. 1002) lub numer zewnętrzny (905321234567) |
GETWycisz / włącz dźwięk
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (wyciszenie) lub off (włącz dźwięk).
Dane połączeń na żywo
Listę trwających połączeń (dzwoniący, odbierający, numer wewnętrzny, status, czas) odczytuje się z punktu końcowego mostu CRM; aby otworzyć kartę klienta przy połączeniu przychodzącym, użyj tych danych lub webhooków. Po szczegóły poproś w Centrum Pomocy o dokument „Most CRM”; dla Byfix CRM most jest gotowy.
Typowy przepływ: click-to-call z CRM
1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir