↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak podłączyć wirtualną centralę do Elbuz

    Jak podłączyć UniTalk do Elbuz: połączenia z karty, dziennik i nagrania

    6 min czytaniaZaktualizowano

    Elbuz łączy się z UniTalk jednym kluczem API: handlowiec dzwoni do klienta z karty jednym przyciskiem, a połączenia z nagraniami same trafiają do dziennika i historii klienta.

    Kiedy to się przyda:

    • Handlowiec nie wie, kto dzwoni — na ekranie Elbuz wyskakuje karta połączenia przychodzącego z imieniem klienta i ostatnimi zamówieniami.
    • Numer trzeba wybierać ręcznie — przycisk „Zadzwoń” w karcie: UniTalk łączy najpierw handlowca, potem klienta.
    • Nieodebrane połączenia giną — nieodebrane staje się zadaniem „Oddzwoń” w „Pulsie”.

    Od czego zacząć: wygeneruj klucz API w panelu UniTalk (gdzie dokładnie).

    Co Elbuz potrafi z UniTalk

    • Połączenie z karty klienta jednym przyciskiem — z linii wewnętrznej handlowca (numery wewnętrzne).
    • Dziennik i nagrania rozmów — stały link do nagrania zapisuje się w dzienniku (co trafia do Elbuz).
    • Czytelny wynik połączenia — stany UniTalk sprowadzone do kilku znanych (statusy).
    • Karta połączenia przychodzącego i nieodebranego — imię, ostatnie zamówienia, zadanie „Oddzwoń” (karta połączenia).
    • Podsumowanie rozmowy w historii klienta — analiza AI i następny krok (analiza połączeń AI).

    Czego potrzeba od UniTalk

    Klucz API tworzy się w panelu UniTalk (według bazy wiedzy UniTalk):

    1. Panel UniTalk → sekcja „Integracje – API” (Інтеграції – API).
    2. Kliknij przycisk tworzenia klucza — klucz pojawi się w oknie; skopiuj go.

    Loginu UniTalk nie wymaga — w formularzu Elbuz jest jedno pole na klucz. Linie wewnętrzne (SIP) pracowników są widoczne w „Ustawieniach” (Налаштування) → zakładka „Użytkownicy” (Користувачі).

    Ścieżki w panelu UniTalk pochodzą z oficjalnej dokumentacji operatora. Jeśli pozycja nazywa się inaczej, kieruj się tymi stronami lub zapytaj wsparcie UniTalk:

    Jak podłączyć UniTalk do Elbuz

    Trzy kroki po kolei: klucz, numery wewnętrzne i webhooki. Bez numerów wewnętrznych nie działa przycisk „Zadzwoń”. Bez webhooków dziennik zapełnia tylko cogodzinna synchronizacja — z opóźnieniem do godziny.

    Krok pierwszy: klucze UniTalk

    Otwórz wiersz UniTalk w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak. W pole „Klucz API” wpisz klucz z sekcji „Integracje – API”.

    Karta „Podłączenie telefonii” w formularzu UniTalk
    1Link do instrukcji
    2Przełącznik „Aktywność”
    3Pole „Klucz API”
    4Przycisk „Sprawdź połączenie”
    1. Link „Gdzie dokładnie — krok po kroku w instrukcji dla Twojego operatora” prowadzi na tę stronę.
    2. Przełącznik „Aktywność” — integracja jest włączona.
    3. Pole „Klucz API” — klucz z sekcji „Integracje – API”.
    4. Przycisk „Sprawdź połączenie” — zapytanie do operatora tylko do odczytu; niczego nie zmienia na koncie.

    Formularz zapisuje się sam mniej więcej sekundę po zmianie: na dole widać „Zapisywanie...”, potem „Zapisano”. Przycisku „Zapisz” nie ma.

    Na koniec kliknij „Sprawdź połączenie”. W UniTalk nie ma osobnej listy pracowników, więc Elbuz sprawdza klucz zapytaniem o dziennik połączeń z ostatniej godziny. Odpowiedź brzmi „Połączono z centralą. Pracowników w centrali: 0”, a wiersza „Numery centrali bez pracownika Elbuz” nie będzie. Nieprawidłowy klucz Elbuz rozpoznaje jako odmowę, a nie jako brak połączeń.

    Krok drugi: numery wewnętrzne

    Gdy handlowiec kliknie „Zadzwoń”, UniTalk najpierw dzwoni na jego numer wewnętrzny i dopiero po odebraniu wybiera numer klienta. Ten sam numer przypisuje połączenia w dzienniku do handlowca.

    Gdzie: karta pracownika („Użytkownicy (pracownicy)”) → pole „Telefon wewnętrzny”.

    Dla UniTalk w „Telefon wewnętrzny” wpisuje się numer wewnętrzny (linię SIP) pracownika z panelu UniTalk. Właśnie ten numer Elbuz przekazuje do UniTalk jako „skąd” dzwonić. Za numer wewnętrzny Elbuz uznaje tylko krótką wartość, do sześciu cyfr.

    Pod formularzem podłączenia jest karta „Numery wewnętrzne pracowników” — tabela „Menedżer” / „Numer wewnętrzny” ze wszystkimi aktywnymi pracownikami. Wiersze z kreską to osoby, którym numeru jeszcze nie wpisano.

    Krok trzeci: webhooki na adres Elbuz

    W formularzu jest karta „Adres webhooka centrali” z adresem i przyciskiem „Kopiuj”. Webhooki w UniTalk tworzysz sam (według bazy wiedzy UniTalk):

    1. Panel UniTalk → „Integracje – API” → przycisk „Dodaj” (Додати) — otworzy się formularz webhooka.
    2. „Akcja” (Дія) — „Wyślij webhook” (Надіслати вебхук), „Nazwa” — np. „Nowe połączenie”, „URL” — adres z Elbuz, metoda — POST. Nagłówek z kluczem dla Elbuz nie jest potrzebny: adres potwierdza zawarty w nim sekret.
    3. Treść zapytania — ze zdarzeniem CALL_NEW (które pola czyta Elbuz). Zapisz.
    4. Tak samo utwórz drugi webhook — „Zakończone połączenie” ze zdarzeniem CALL_END.
    5. Dodaj oba webhooki do podsekcji „Obsługa zdarzeń połączenia (Webhooki wychodzące)” (Обробка подій дзвінка (Вихідні вебхуки)) w sekcji „Integracje – API”.
    Karta „Adres webhooka centrali” w formularzu UniTalk
    1Adres dla operatora
    2Przycisk „Kopiuj”
    1. Adres, który podajesz operatorowi; tajny klucz na końcu jest na zrzucie ukryty.
    2. Przycisk „Kopiuj” — kopiuje adres do schowka.

    Aby UniTalk zaczął działać z Elbuz

    Co trafia do Elbuz

    Wszystko poniżej sprawdzono w module integracji UniTalk w Elbuz, napisanym według dokumentacji API operatora.

    FunkcjaJak to działa z UniTalk
    Połączenie z karty i dziennika („Zadzwoń”)tak: połączenie z linii wewnętrznej handlowca na numer klienta
    Przychodzące i wychodzące w dziennikutak, po zdarzeniu CALL_END; połączenia wewnętrzne (INNER) nie są zapisywane
    Karta połączenia przychodzącegotak, ze zdarzeń CALL_NEW, CALL_REDIRECT, CALL_ANSWER, jeśli jest w nich linia wewnętrzna
    Nagranie rozmowytak: stały link przychodzi w zdarzeniu; jest tylko przy rozmowach, które się odbyły
    Cogodzinna synchronizacja dziennikatak, w 25. minucie każdej godziny, za ostatnią dobę
    Imię klienta na ekranie telefonunie: UniTalk nie czeka na żadną odpowiedź
    Rozłączenie połączenia z karty przychodzącegotak: przycisk „Rozłącz” w karcie „Połączenie przychodzące”
    Głosowy pracownik AIniepotwierdzone (poniżej)

    Elbuz czyta z treści webhooka pole event i obiekt call w strukturze zdarzenia UniTalk: id, direction, from, to, state, secondsTalk, secondsFullTime, link, date, outerNumber. Jak wstawić te pola do szablonu treści zapytania, baza wiedzy UniTalk nie wyjaśnia — zapytaj wsparcie UniTalk, jeśli formularz nie wypełnia treści sam.

    Cechy UniTalk

    Limity zapytań UniTalk

    UniTalk ostro ogranicza częstotliwość zapytań: ponad 30 w ciągu 10 sekund — tymczasowa blokada, ponad 100 — stała. Dlatego cogodzinna synchronizacja pobiera dziennik największymi stronami, po 1000 połączeń, robi sekundową przerwę między stronami i zatrzymuje się na dwudziestej.

    Nie pokazuj adresu webhooka osobom postronnym

    Zdarzenia UniTalk nie mają podpisu, a operator nie publikuje adresów swoich serwerów, więc jedyną ochroną jest tajny klucz w adresie.

    Nagrania rozmów

    Link do nagrania UniTalk przekazuje w polu zdarzenia i jest on stały. Ma go tylko połączenie, które się odbyło: nieodebrane czy anulowane nagrania nie ma.

    Jak odczytywane są statusy

    Stanów połączenia w UniTalk jest więcej niż u innych operatorów. Elbuz sprowadza je tak:

    Stan w UniTalk„Wynik” w dzienniku Elbuz
    „Brak środków”, „zajęte linie zewnętrzne”, „numer nie istnieje”, „niedostępny”, błąd kierunku„Błąd połączenia”
    zablokowany„Anulowane”
    „zajęte”„Zajęte”
    stan nie przyszedł, był czas trwania„Odebrane”
    stan nie przyszedł, brak czasu trwania„Nieodebrane”

    Numer klienta i komentarze

    W UniTalk numer klienta jest przekazywany tylko cyframi, bez „+” i spacji — Elbuz usuwa je sam. Komentarze do połączenia z UniTalk nie są przenoszone do dziennika: pole komentarza w dzienniku należy do handlowca i synchronizacja nie nadpisuje tego, co napisał.

    Głosowy pracownik AI na numerze UniTalk

    Pracownik AI Elbuz potrafi sam odbierać połączenia i sam dzwonić do klientów. Rozmowę prowadzi nie Twoja centrala, lecz platforma głosowa Elbuz, i numer trzeba na nią skierować. Ustawienia sekcji „Głos przez telefon” — w artykule Głosowy pracownik AI.

    Przychodzące: jak skierować numer na AI

    W polu „Operator” sekcji „Głos przez telefon” wybierz „Inny operator”. W pole „Adresy operatora” wpisz po przecinku , podsieci lub domenę centrali, z których operator będzie wysyłał połączenia na adres SIP — poda je wsparcie operatora. Puste pole — Elbuz będzie przyjmować połączenia na Twój adres SIP z dowolnego adresu.

    Domenę Elbuz sam zamienia na adresy IP przy zapisie sekcji. Jeśli IP centrali się zmieni, zmień dowolne pole sekcji „Głos”, aby zapisała się ponownie.

    Sekcja pokaże adres w postaci <numer>@<domena SIP>. Według bazy wiedzy UniTalk scenariusze połączeń przychodzących ustawia się w „Połączenia” (Дзвінки) → „Ustawienia” → „Scenariusze przychodzące” (Вхідні сценарії) → „Dodaj scenariusz” (Додати сценарій), a wśród kierunków przekierowania jest „zewnętrzne konto SIP lub inna telefonia” (зовнішній SIP-акаунт або інша телефонія). Czy można wpisać tam adres w postaci numer@domena — zapytaj wsparcie UniTalk: baza wiedzy nie mówi tego wprost.

    Wychodzące: linia SIP dla połączeń AI

    Login i hasło linii znajdziesz w panelu UniTalk (według instrukcji UniTalk dla telefonów programowych):

    1. „Ustawienia” → zakładka „Użytkownicy”.
    2. Login — numer wewnętrzny; hasło — przycisk „Pokaż hasło” (Показати пароль).
    3. Serwer SIP — sip.unitalk.cloud lub ten, który podano w ustawieniach linii SIP na zakładce „Użytkownicy”.

    Wpisuje się je w „Login linii”, „Hasło linii” i „Serwer SIP” bloku „Połączenia wychodzące”. Dla AI lepiej założyć osobnego użytkownika. Czy UniTalk pozwala dzwonić do klientów z takiej linii z zewnętrznej platformy — zapytaj wsparcie UniTalk.

    Połączenia wychodzące działają tylko wtedy, gdy włączone jest „Odbieraj połączenia”: inaczej połączenie testowe zwróci „Połączenia wychodzące nie są skonfigurowane: podaj login i hasło linii oraz włącz odbieranie połączeń”. Domyślnie AI dzwoni od 9:00 do 20:00 według czasu konta — pole „Dzwonić w godzinach”.

    Scenariusze

    Handlowiec oddzwania do klienta z karty

    1. Wpisz handlowcowi jego linię SIP UniTalk w „Telefon wewnętrzny” (krok drugi).
    2. Handlowiec klika „Zadzwoń” w karcie klienta — UniTalk dzwoni do niego, a po odebraniu wybiera numer klienta.
    3. Po rozmowie webhook CALL_END zapisuje połączenie w dzienniku z nagraniem i wynikiem.

    Nieodebrane połączenie nie ginie

    Handlowiec nie odebrał — wyskakuje karta „Nieodebrane połączenie”, a w „Pulsie” pojawia się zadanie „Oddzwoń”. Gdy z tym numerem odbędzie się rozmowa, zadanie znika samo. Więcej: nieodebrane połączenia.

    Sprawdzić, dlaczego połączenie się nie odbyło

    Przefiltruj dziennik po „Wyniku” „Błąd połączenia”: trafiają tam połączenia, których UniTalk nie zrealizował z powodu salda, zajętych linii lub nieistniejącego numeru (jak odczytywane są statusy).

    Co zrobić, gdy UniTalk nie współpracuje z Elbuz

    Ogólne problemy telefonii — brak przycisku połączenia, pusty dziennik, brak nagrania — opisuje artykuł Telefonia w Elbuz. Tutaj — to, co dotyczy UniTalk.

    Co mówi program i co z tym zrobić
    Co widziszDlaczego tak jestCo zrobić
    Przycisku „Zadzwoń” nie ma ani na liście kontaktów, ani w karcie Klucze nie są wpisane lub przełącznik „Aktywność” jest wyłączony — wtedy przyciski połączeń w ogóle się nie pojawiają Sprawdź pola i przełącznik w formularzu podłączenia (krok pierwszy)
    „W Twojej karcie pracownika nie podano wewnętrznego numeru telefonu” Pole „Telefon wewnętrzny” w Twojej karcie jest puste: centrala nie ma dokąd zadzwonić w pierwszym kroku Wpisz numer w karcie pracownika (krok drugi)
    „Sprawdź połączenie” zwraca błąd autoryzacji Nieprawidłowy lub usunięty klucz API Wygeneruj klucz w „Integracje – API” ponownie i wpisz go jeszcze raz
    Połączenia pojawiają się tylko raz na godzinę Webhooki nie zostały utworzone, nie dodano ich do obsługi zdarzeń połączenia lub w adresie jest stara domena Sprawdź webhooki CALL_NEW i CALL_END w panelu UniTalk i adres w nich
    UniTalk tymczasowo zablokował klucz Przekroczono limit 30 zapytań w ciągu 10 sekund — łącznie z innymi integracjami korzystającymi z tego samego klucza Poczekaj na odblokowanie i nie używaj tego samego klucza w kilku integracjach jednocześnie
    „Centrala nie odpowiedziała na czas. Jeśli połączenie jednak się rozpoczęło, pojawi się w dzienniku połączeń — sprawdź go przed ponownym wybraniem” Operator nie odpowiedział w ciągu 15 sekund. Zapytanie mogło zostać przyjęte — wtedy Twój telefon zadzwoni chwilę później Nie wybieraj numeru od razu drugi raz: odczekaj minutę. Jeśli centrala przyjęła zapytanie, Twój telefon zadzwoni, a po rozmowie połączenie pojawi się w dzienniku

    Najczęstsze pytania

    Skąd w UniTalk wziąć klucz API dla Elbuz?

    W panelu UniTalk, sekcja „Integracje – API”, przycisk generowania klucza. Klucz wpisuje się w pole „Klucz API” wiersza UniTalk w grupie „Telefonia” w Elbuz.

    Jakich webhooków UniTalk potrzebuje Elbuz?

    Dwóch wychodzących webhooków metodą POST na adres z karty „Adres webhooka centrali”: dla nowego połączenia (CALL_NEW) i dla zakończonego (CALL_END). Dodaje się je do obsługi zdarzeń połączenia w sekcji „Integracje – API”.

    Czy Elbuz może zablokować mój klucz UniTalk częstymi zapytaniami?

    Elbuz uwzględnia limity UniTalk: synchronizacja pobiera dziennik stronami po 1000 połączeń z przerwą między nimi. Ryzyko pojawia się, jeśli ten sam klucz jednocześnie wykorzystują inne integracje.

    Dlaczego sprawdzenie pokazuje „Pracowników w centrali: 0”?

    API UniTalk nie ma osobnej listy pracowników, więc Elbuz sprawdza klucz zapytaniem o dziennik połączeń z ostatniej godziny. Zero to dla UniTalk normalna odpowiedź.

    Czy UniTalk pokaże imię klienta na telefonie handlowca?

    Nie: UniTalk nie czeka na odpowiedź z imieniem od . Kto dzwoni, handlowiec widzi w karcie połączenia przychodzącego na ekranie Elbuz (karta połączenia).

    Czy można wybrać numer, z którego UniTalk dzwoni do klienta?

    Nie. API połączeń UniTalk nie przyjmuje numeru linii, dlatego w formularzu UniTalk nie ma pola „Linia dla połączeń wychodzących”.

    Czy można skierować numer UniTalk na głosowego AI?

    Gotowej instrukcji nie ma. Zapytaj wsparcie UniTalk, czy można przekierować numer na zewnętrzny adres SIP z sekcji „Głos przez telefon” (co już wiadomo).

    Gdzie to jest i kto ma dostęp

    Podłączenie UniTalk znajduje się wśród innych integracji, a nie w dzienniku połączeń. Okno z wiersza operatora nazywa się „Ustawienia dostępu do API usług zewnętrznych”.

    Menu
    Panel klienta → Ustawienia systemu → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → „Telefonia” → UniTalk
    Inne wejścia
    „Dziennik połączeń” → menu → „Podłączenie telefonii”
    Uprawnienia
    ustawienia systemu i okno „Dziennik połączeń”; do dzwonienia uprawnienia nie są potrzebne
    Przygotuj
    klucz API UniTalk, linie wewnętrzne () pracowników

    Bez uprawnienia do „Dziennika połączeń” nie działają „Sprawdź połączenie”, adres webhooka ani plik konfiguracyjny.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo