↑↓ wybierzEnter otwórzEsc zamknij

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

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

    7 min czytaniaZaktualizowano

    Elbuz łączy się z Ringostat API jednym kluczem projektu: 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 uruchamia oddzwanianie Ringostat.
    • Trzeba odróżnić nowych klientów — kolumna „Nowy klient” w dzienniku wypełnia się danymi z Ringostat.
    • Handlowcy nie nadążają z odbieraniem — połączenie przechodzi do pracownika AI.

    Od czego zacząć: skopiuj Auth-key w panelu Ringostat (gdzie dokładnie).

    Co Elbuz potrafi z Ringostat

    • Połączenie z karty klienta jednym przyciskiem — z numeru projektu Ringostat (połączenie z przycisku).
    • Dziennik i nagrania rozmów — stały link do nagrania zapisuje się w dzienniku (co trafia do Elbuz).
    • Oznaczenie „Nowy klient” — pierwsze kontakty widać w dzienniku (nowi klienci).
    • Karta połączenia przychodzącego i nieodebranego — imię, ostatnie zamówienia, zadanie „Oddzwoń” (karta połączenia).
    • Podsumowanie rozmowy w historii klienta — analiza przez AI i następny krok (analiza połączeń przez AI).
    • Pracownik AI na przychodzących — kierunek w schemacie przekierowań Ringostat (głosowe AI).

    Czego potrzebujesz od Ringostat

    Klucz projektu — Auth-key — jest w panelu Ringostat:

    1. „Налаштування” (Ustawienia) → „Інтеграція” (Integracja) → „Ringostat API”.
    2. Skopiuj Auth-key.

    Ringostat nie wymaga loginu, dlatego formularz Elbuz ma jedno pole na klucz. Przydadzą się jeszcze:

    • Numer projektu podłączony w wirtualnej centrali jako przychodzący — od niego Ringostat zaczyna oddzwanianie.
    • Numery wewnętrzne pracowników — w profilu pracownika: „Загальні налаштування” (Ustawienia ogólne) → „Співробітники” (Pracownicy) → pracownik → pole „Додатковий (внутрішній/добавочний) номер” (numer dodatkowy, wewnętrzny; standardowo trzy cyfry, np. 101).

    Ścieżki w panelu Ringostat pochodzą z oficjalnej pomocy operatora. Jeśli pozycja nazywa się inaczej — kieruj się tymi stronami albo zapytaj wsparcie Ringostat:

    Jak podłączyć Ringostat do Elbuz

    Trzy kroki po kolei: klucze, numery wewnętrzne i . Bez numerów wewnętrznych połączenia nie przypisują się do handlowców. Bez webhooka dziennik zapełnia się tylko cogodzinnym uzgadnianiem — z opóźnieniem do godziny.

    Krok pierwszy: klucze Ringostat

    Otwórz wiersz Ringostat w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak. Pola do wpisania:

    Pole w formularzuCo wpisać
    „Klucz projektu (Auth-key)”Auth-key z sekcji „Ringostat API”
    „Linia dla połączeń wychodzących”obowiązkowo dla przycisku „Zadzwoń”: numer projektu podłączony w wirtualnej centrali jako przychodzący (dlaczego)
    Karta „Podłączenie telefonii” w formularzu Ringostat
    1Link do instrukcji
    2Przełącznik aktywności
    3Klucz projektu (Auth-key)
    4Linia dla połączeń wychodzących
    5Sprawdź 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 projektu (Auth-key)” — jedyny klucz; Ringostat nie potrzebuje loginu.
    4. Pole „Linia dla połączeń wychodzących” — w Ringostat obowiązkowe: numer projektu podłączony jako przychodzący.
    5. Przycisk „Sprawdź połączenie” — zapytanie do operatora tylko do odczytu, niczego na koncie nie zmienia.

    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 Ringostat nie ma listy pracowników, więc Elbuz odczytuje dziennik połączeń z ostatniej godziny i od razu pokazuje, czy klucz został przyjęty. Odpowiedź — „Połączono z centralą. Pracowników w centrali: 0”; wiersza „Numery centrali bez pracownika Elbuz” nie będzie: nie ma skąd wziąć numerów.

    Krok drugi: numery wewnętrzne

    Numer z pola „Telefon wewnętrzny” przypisuje połączenia w dzienniku do handlowca: kolumna „Menedżer” pokazuje imię pracownika Elbuz, który ma ten numer. Do którego z pracowników Ringostat zadzwoni najpierw po kliknięciu „Zadzwoń”, decydują ustawienia numeru projektu w wirtualnej centrali Ringostat.

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

    Za numer wewnętrzny Elbuz uznaje tylko krótką wartość — do sześciu cyfr, jak numer dodatkowy (wewnętrzny) w Ringostat. Jeśli w zdarzeniu przychodzącym Ringostat jako kierunek podano pełny numer telefonu, handlowiec nie zostanie ustalony i połączenie trafi do dziennika bez niego.

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

    Krok trzeci: webhook na adres Elbuz

    W formularzu jest karta „Adres webhooka centrali” z adresem i przyciskiem „Kopiuj”. Webhook w Ringostat ustawiasz sam — według pomocy Ringostat:

    1. Panel Ringostat → sekcja „Інтеграція” (Integracja) → strona „Webhooks”.
    2. Kliknij „Додати подію” (Dodaj zdarzenie).
    3. W „Назва” (Nazwa) wpisz nazwę, z listy wybierz zdarzenie: połączenie przychodzące (przed połączeniem i po połączeniu) i połączenie wychodzące.
    4. W „Напрямок” (Kierunek) wklej adres z Elbuz, w „Метод надсилання даних” (metoda wysyłania danych) wybierz GET, POST lub PUT, w „Формат надсилання даних” (format wysyłania danych) — json lub Form. Elbuz przyjmuje każdy z tych wariantów.
    Karta „Adres webhooka centrali” w formularzu Ringostat
    1Adres dla operatora
    2Kopiuj
    1. Adres, który przekazujesz operatorowi; tajny klucz na końcu jest na zrzucie zamaskowany.
    2. Przycisk „Kopiuj” — umieszcza adres w schowku.

    Ringostat wymaga na każde zdarzenie odpowiedzi „200 OK”, inaczej oznacza webhook jako błędny i przestaje wysyłać zdarzenia, dopóki ktoś nie włączy go ręcznie. Elbuz odpowiada 200 na każde zdarzenie, które zdołał rozpoznać. Jeśli adres jest błędny (stara domena, cudzy klucz), Ringostat może wyłączyć webhook — sprawdź jego stan w panelu.

    Żeby Ringostat zadziałał z Elbuz

    Co trafia do Elbuz

    Wszystko poniżej sprawdzono z modułem integracji Ringostat w Elbuz i z pomocą Ringostat.

    FunkcjaJak to działa z Ringostat
    Połączenie z karty i dziennika („Zadzwoń”)tak, przez oddzwanianie Ringostat z numeru projektu z pola „Linia dla połączeń wychodzących”
    Przychodzące i wychodzące w dziennikutak, na podstawie zdarzeń webhooka i cogodzinnego uzgadniania
    Nagranie rozmowytak: stały link przychodzi w zdarzeniu i zapisuje się w dzienniku
    Oznaczenie „Nowy klient”tak: Elbuz odwraca oznaczenie „powtórne” z Ringostat
    Karta połączenia przychodzącegotak, gdy zdarzenie przed zakończeniem połączenia zawiera krótki numer wewnętrzny, na który idzie połączenie
    Cogodzinne uzgadnianie dziennikatak, w 25. minucie każdej godziny, za ostatnią dobę
    Rozłączenie połączenia z karty przychodzącegonie: Ringostat nie ma takiej metody
    Imię klienta na ekranie telefonunie: Ringostat nie czeka na odpowiedź
    Głosowy pracownik AIprzychodzące — tak, przez schemat przekierowań; wychodzące — nie (niżej)

    Jak Elbuz rozróżnia zdarzenia webhooka: jeśli zdarzenie nie ma jeszcze czasu trwania, to „połączenie trwa” — program szuka klienta i pokazuje kartę przychodzącego. Jeśli czas trwania jest — połączenie się zakończyło i trafia do dziennika. Dlatego nazwy zdarzeń w panelu Ringostat nie mają znaczenia.

    Specyfika Ringostat

    Połączenie z przycisku: co trafia do Ringostat

    Dla przycisku „Zadzwoń” Elbuz używa prostej metody oddzwaniania Ringostat: w pole „skąd” (extension) przekazuje „Linia dla połączeń wychodzących”, w pole „dokąd” (destination) — numer klienta. Według dokumentacji Ringostat extension to wyłącznie numer projektu podłączony jako przychodzący w wirtualnej centrali. Dlatego „Linia dla połączeń wychodzących” jest w Ringostat warunkiem działania przycisku.

    Gdy pole „Linia dla połączeń wychodzących” zostanie puste, Elbuz przekaże do Ringostat numer wewnętrzny handlowca, a takie zapytanie według dokumentacji Ringostat nie przejdzie: zobaczysz „Centrala odrzuciła żądanie: …”. Pierwsze połączenie po podłączeniu wykonaj jako próbne.

    Metoda nie zwraca identyfikatora połączenia — przychodzi on później w zdarzeniu webhooka. Wtedy Elbuz znajduje w dzienniku Twoją próbę na ten sam numer z ostatnich 30 minut i ją aktualizuje, zamiast zakładać drugi wiersz.

    Nie pokazuj adresu webhooka osobom postronnym

    Zdarzenia Ringostat nie mają podpisu, a adresów swoich serwerów operator nie publikuje. Jedyna ochrona to tajny klucz w samym adresie, dlatego nie pokazuj go osobom postronnym.

    Nagrania rozmów

    Link do nagrania Ringostat umieszcza bezpośrednio w zdarzeniu i jest on stały. Elbuz zapisuje go w dzienniku razem z połączeniem, a przy odsłuchiwaniu nie ma osobnego zapytania do operatora.

    Oznaczenie „Nowy klient”

    Ringostat oznacza połączenia powtórne, a Elbuz odwraca to oznaczenie: niepowtórne — czyli nowe. Ukryta kolumna „Nowy klient” w dzienniku wypełnia się dla Ringostat i można po niej wyfiltrować pierwsze kontakty.

    Cogodzinne uzgadnianie

    Co godzinę Elbuz pobiera z Ringostat dziennik połączeń z ostatniej doby. Ringostat nie opisuje publicznie formatu odpowiedzi, więc program odczytuje ją po tych samych polach, które przychodzą w webhooku. Jeśli klucz nie zostanie przyjęty, uzgadnianie nie udaje, że „połączeń nie było”, tylko odnotowuje odmowę.

    Głosowy pracownik AI na numerze Ringostat

    Pracownik AI Elbuz potrafi sam odbierać połączenia i sam dzwonić do klientów. Rozmowę prowadzi nie Twoja centrala, lecz platforma głosowa Elbuz, więc 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”. Ringostat nie publikuje adresów IP, z których wysyła połączenia, więc pole „Adresy operatora” zostaw puste albo wpisz adresy, które poda wsparcie. Gdy pole jest puste, Elbuz będzie przyjmować połączenia na Twój adres SIP z dowolnego adresu.

    Sekcja pokaże adres postaci <numer>@<domena SIP>. Ringostat przekierowuje połączenia na zewnętrzne konta SIP, w tym na centrale i usługi SIP innych firm (potwierdziło wsparcie Ringostat). Gdzie go wpisać w panelu Ringostat:

    1. „Віртуальна АТС” (Wirtualna centrala) → „Переадресація” (Przekierowanie): otwórz schemat numeru albo utwórz nowy.
    2. „Додати напрямок” (Dodaj kierunek) → typ „зовнішній sip аккаунт” (zewnętrzne konto SIP) → wklej adres z sekcji „Głos”.
    3. Żeby AI odbierało tylko wtedy, gdy handlowcy nie podnieśli słuchawki, ustaw ten kierunek po handlowcach w przekierowaniu sekwencyjnym. Ringostat zaleca timeout kierunku od 30 sekund.

    Kodeki G.711 A-law i μ-law, które zaleca Ringostat, Elbuz przyjmuje. Połączenia na konta SIP Ringostat są bezpłatne; czy przekierowanie na adres SIP innej usługi jest płatne — zapytaj opiekuna w Ringostat.

    W jakiej postaci Ringostat przekazuje numer abonenta, wsparcie jeszcze nie potwierdziło: po konfiguracji zadzwoń na swój numer i sprawdź, czy w dzienniku połączeń widać Twój numer.

    Wychodzące: przez Ringostat nie działają

    Ringostat przepuszcza połączenia wychodzące tylko z konta SIP zarejestrowanego na serwerze sip.ringostat.com. Platforma głosowa Elbuz dzwoni bez rejestracji, a takiego scenariusza wsparcie Ringostat nie potwierdziło. Dlatego bloku „Połączenia wychodzące” sekcji „Głos” dla Ringostat nie wypełniaj. Żeby AI samo dzwoniło do klientów, potrzebna jest linia SIP innego operatora — które się nadają, opisano w artykule Głosowy pracownik AI.

    Scenariusze

    Handlowiec oddzwania do klienta z karty

    1. Wpisz numer projektu w „Linia dla połączeń wychodzących” (krok pierwszy).
    2. Handlowiec otwiera kartę klienta i klika „Zadzwoń” — Ringostat uruchamia oddzwanianie z numeru projektu.
    3. Po rozmowie zdarzenie webhooka aktualizuje próbę w dzienniku: czas trwania, wynik, link do nagrania.

    Wybrać pierwsze kontakty z tygodnia

    Włącz w dzienniku połączeń ukrytą kolumnę „Nowy klient” i przefiltruj po niej — zostaną połączenia, których Ringostat nie oznaczył jako powtórne. Więcej o kolumnach: dziennik połączeń.

    AI odbiera, gdy handlowcy są zajęci

    1. Włącz „Odbieraj połączenia” w sekcji „Głos przez telefon” i skopiuj adres SIP (przychodzące na AI).
    2. W schemacie przekierowań Ringostat ustaw kierunek „зовнішній sip аккаунт” (zewnętrzne konto SIP) po handlowcach.
    3. Zadzwoń na swój numer i sprawdź, czy AI odbiera, a Twój numer widać w dzienniku.

    Co zrobić, gdy Ringostat nie działa z Elbuz

    Ogólne problemy z telefonią — brak przycisku połączenia, pusty dziennik, brak nagrania — omówiono w artykule Telefonia w Elbuz. Tutaj — to, co dotyczy Ringostat.

    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 albo przełącznik „Aktywność” jest wyłączony — przyciski połączenia nie są wtedy w ogóle wyświetlane 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 Wpisz numer w kartę pracownika (krok drugi)
    „Centrala odrzuciła żądanie: …” po kliknięciu „Zadzwoń” Pole „Linia dla połączeń wychodzących” jest puste lub błędne: oddzwanianie Ringostat zaczyna się tylko od numeru projektu podłączonego jako przychodzący Wpisz w „Linia dla połączeń wychodzących” numer projektu z wirtualnej centrali Ringostat; jeśli nie pomogło — zapytaj wsparcie Ringostat
    Zdarzenia przestały przychodzić, połączenia pojawiają się tylko raz na godzinę Ringostat wyłączył webhook po odpowiedzi innej niż 200 — na przykład gdy adres był nieaktualny Sprawdź adres w webhooku Ringostat i włącz go ponownie
    Połączenie w dzienniku bez handlowca W zdarzeniu Ringostat zamiast krótkiego numeru wewnętrznego jest pełny numer telefonu Sprawdź, dokąd Ringostat przekierowuje połączenia, i wpisz pracownikom odpowiednie numery wewnętrzne
    „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 nieco później Nie wybieraj od razu drugi raz: poczekaj 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 Ringostat wziąć klucz dla Elbuz?

    W panelu Ringostat: „Налаштування” (Ustawienia) → „Інтеграція” (Integracja) → „Ringostat API”. To Auth-key — klucz projektu. Wpisuje się go w pole „Klucz projektu (Auth-key)” wiersza Ringostat grupy „Telefonia” w Elbuz.

    Jak ustawić webhook Ringostat na Elbuz?

    Integracja → „Webhooks” → Dodaj zdarzenie: zdarzenia połączenia przychodzącego i wychodzącego, w polu kierunku — adres z karty „Adres webhooka centrali”. Metoda i format — dowolne: Elbuz przyjmuje i , i formularz.

    Dlaczego Ringostat przestał wysyłać zdarzenia?

    Ringostat wyłącza webhook, jeśli dostał odpowiedź inną niż 200 OK. Przyczyną jest zwykle błędny lub nieaktualny adres. Popraw adres i włącz webhook ponownie.

    Czy nagrania rozmów Ringostat są przechowywane w Elbuz?

    Elbuz przechowuje stały link do nagrania, który Ringostat przekazuje w zdarzeniu. Sam plik audio zostaje w Ringostat.

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

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

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

    Nie: Ringostat 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 skierować numer Ringostat na głosowe AI?

    Tak, przychodzące: w schemacie przekierowań dodaj kierunek „зовнішній sip аккаунт” (zewnętrzne konto SIP) z adresem z sekcji „Głos przez telefon” (krok po kroku). Połączenia wychodzące AI przez Ringostat nie działają.

    Gdzie to jest i kto ma dostęp

    Podłączenie Ringostat jest 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” → Ringostat
    Inne wejścia
    „Dziennik połączeń” → menu okna → „Podłączenie telefonii”
    Uprawnienia
    ustawienia systemu i okno „Dziennik połączeń”; żeby dzwonić, uprawnienia nie są potrzebne
    Przygotuj
    klucz projektu (Auth-key) Ringostat, numer projektu, numery wewnętrzne pracowników

    Bez uprawnienia do „Dziennik 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