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:
- „Налаштування” (Ustawienia) → „Інтеграція” (Integracja) → „Ringostat API”.
- 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:
- Ringostat: konfiguracja integracji za pomocą metod API (Auth-key)
- Ringostat: zapytanie API o połączenie dwóch numerów (callback)
- Ringostat: Webhooks — tworzenie zapytania webhook
- Ringostat: tworzenie profilu pracownika — numer wewnętrzny, zewnętrzne konto SIP
- Ringostat: konfiguracja programu MicroSIP — „Віртуальна АТС” → „SIP акаунти” (wirtualna centrala → konta SIP), login i hasło
- Ringostat: instalacja i konfiguracja Phonerlite — serwer sip.ringostat.com
- Ringostat: schematy przekierowań, kierunek „зовнішній sip аккаунт” (zewnętrzne konto SIP)
- Ringostat: typowa konfiguracja SIP — serwer, port, kodeki
- Ringostat: koszt usług telekomunikacyjnych
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 formularzu | Co 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) |
1
Link do instrukcji2
Przełącznik aktywności3
Klucz projektu (Auth-key)4
Linia dla połączeń wychodzących5
Sprawdź połączenie- Link „Gdzie dokładnie — krok po kroku w instrukcji dla Twojego operatora” prowadzi na tę stronę.
- Przełącznik „Aktywność” — integracja jest włączona.
- Pole „Klucz projektu (Auth-key)” — jedyny klucz; Ringostat nie potrzebuje loginu.
- Pole „Linia dla połączeń wychodzących” — w Ringostat obowiązkowe: numer projektu podłączony jako przychodzący.
- 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:
- Panel Ringostat → sekcja „Інтеграція” (Integracja) → strona „Webhooks”.
- Kliknij „Додати подію” (Dodaj zdarzenie).
- W „Назва” (Nazwa) wpisz nazwę, z listy wybierz zdarzenie: połączenie przychodzące (przed połączeniem i po połączeniu) i połączenie wychodzące.
- 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.
1
Adres dla operatora2
Kopiuj- Adres, który przekazujesz operatorowi; tajny klucz na końcu jest na zrzucie zamaskowany.
- 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.
| Funkcja | Jak 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 dzienniku | tak, na podstawie zdarzeń webhooka i cogodzinnego uzgadniania |
| Nagranie rozmowy | tak: 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ącego | tak, gdy zdarzenie przed zakończeniem połączenia zawiera krótki numer wewnętrzny, na który idzie połączenie |
| Cogodzinne uzgadnianie dziennika | tak, w 25. minucie każdej godziny, za ostatnią dobę |
| Rozłączenie połączenia z karty przychodzącego | nie: Ringostat nie ma takiej metody |
| Imię klienta na ekranie telefonu | nie: Ringostat nie czeka na odpowiedź |
| Głosowy pracownik AI | przychodzą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:
- „Віртуальна АТС” (Wirtualna centrala) → „Переадресація” (Przekierowanie): otwórz schemat numeru albo utwórz nowy.
- „Додати напрямок” (Dodaj kierunek) → typ „зовнішній sip аккаунт” (zewnętrzne konto SIP) → wklej adres z sekcji „Głos”.
- Ż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
- Wpisz numer projektu w „Linia dla połączeń wychodzących” (krok pierwszy).
- Handlowiec otwiera kartę klienta i klika „Zadzwoń” — Ringostat uruchamia oddzwanianie z numeru projektu.
- 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
- Włącz „Odbieraj połączenia” w sekcji „Głos przez telefon” i skopiuj adres SIP (przychodzące na AI).
- W schemacie przekierowań Ringostat ustaw kierunek „зовнішній sip аккаунт” (zewnętrzne konto SIP) po handlowcach.
- 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 widzisz | Dlaczego tak jest | Co 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
- Jeśli potrzebujesz ogólnego obrazu telefonii i porównania operatorów — Telefonia w Elbuz.
- Jeśli połączenie jest już w dzienniku i chcesz zrozumieć kolumny lub „Wynik” — Dziennik połączeń.
- Jeśli chcesz, żeby AI samo odbierało i dzwoniło do klientów, — Głosowy pracownik AI.
- Jeśli połączenia nie przypisują się do handlowca — Użytkownicy (pracownicy), pole „Telefon wewnętrzny”.
- Jeśli chcesz znaleźć rozmowę w historii klienta — Karta kontrahenta.
