Elbuz łączy RingCentral API z CRM: handlowiec widzi kartę klienta, zanim odbierze telefon, dzwoni z karty jednym przyciskiem, a każda rozmowa trafia do dziennika i do historii klienta.
Kiedy to się przyda:
- Dzwoni klient — pracownikowi wyskakuje karta z imieniem, miastem i ostatnimi zamówieniami klienta.
- Nikt nie odebrał połączenia na grupę — w „Pulsie” pojawia się zadanie „Oddzwoń”.
- Trzeba oddzwonić — „Zadzwoń” w karcie: RingCentral najpierw dzwoni do handlowca, potem do klienta.
- Kierownik chce słuchać rozmów — nagranie i podsumowanie AI pojawiają się w dzienniku po cogodzinnym uzgadnianiu.
Od czego zacząć: utwórz aplikację REST API w RingCentral Developer Console.
Co potrafi integracja z RingCentral
Przez aplikację serwerową z JWT Elbuz uruchamia połączenia RingOut, co godzinę uzgadnia dziennik konta, udostępnia nagrania rozmów i odbiera zdarzenia o połączeniach. Adresu dla zdarzeń nie trzeba wpisywać w RingCentral: subskrypcję Elbuz tworzy i przedłuża sam.
- Karta osoby, która dzwoni. „Połączenie przychodzące” z imieniem klienta, miastem i zamówieniami wyskakuje u pracownika, do którego ktoś dzwoni (karta połączenia).
- Nieodebrane staje się zadaniem. Handlowcowi wyskakuje „Nieodebrane połączenie” z przyciskiem „Oddzwoń”, a w „Pulsie” — zadanie z wysokim priorytetem; po rozmowie z tym numerem znika samo.
- Połączenie z karty klienta. Przez RingOut: najpierw na numer wewnętrzny handlowca, potem do klienta (jak przebiega połączenie).
- Nagranie, tekst i podsumowanie. Po uzgadnianiu nagrania można słuchać z dziennika, a analiza przez AI zapisuje podsumowanie na osi czasu klienta (analiza połączeń przez AI).
- Wszystkie rozmowy konta w jednym dzienniku. Przychodzące i wychodzące z wynikiem; czas trwania uzupełnia uzgadnianie (dziennik połączeń).
Czego potrzebujesz od RingCentral
- Aplikacja z JWT auth flow w Developer Console — z niej pochodzą Client i Client Secret.
- Sześć uprawnień aplikacji — tabela w kroku pierwszym.
- JWT administratora (Super Admin) — inaczej Elbuz nie zobaczy numerów i połączeń całego konta.
- Konto produkcyjne (production) — klucze piaskownicy (sandbox) się nie nadadzą.
Nazwy pozycji konsoli są po angielsku, jak w interfejsie RingCentral. Ścieżki pochodzą z dokumentacji RingCentral; jeśli pozycja nazywa się inaczej — kieruj się tymi stronami albo zapytaj wsparcie RingCentral:
Jak podłączyć RingCentral
Cztery kroki: aplikacja w Developer Console, JWT, klucze w Elbuz i numery wewnętrzne.
Krok pierwszy: aplikacja w Developer Console
- Zaloguj się do RingCentral Developer Console (developers.ringcentral.com) danymi swojego konta RingCentral → Apps → Create App.
- Typ aplikacji — REST API App → Next.
- W bloku Authentication wybierz JWT auth flow.
- W bloku Security dodaj uprawnienia (permissions) wymienione w tabeli poniżej i wybierz wariant „This app is private and will only be callable using credentials from the same RingCentral account”.
- Utwórz aplikację i skopiuj z jej strony Client ID i Client Secret.
| Uprawnienie w RingCentral | Do czego Elbuz |
|---|---|
| Read Accounts (ReadAccounts) | lista numerów wewnętrznych dla „Sprawdź połączenie” |
| Read Call Log (ReadCallLog) | cogodzinne uzgadnianie dziennika |
| RingOut | przycisk „Zadzwoń” |
| Call Control (CallControl) | zdarzenia o połączeniach — bez niego RingCentral nie pozwoli się zasubskrybować |
| Webhook Subscriptions (WebhookSubscriptions) | sama subskrypcja zdarzeń na adres Elbuz |
| Read Call Recording (ReadCallRecording) | odsłuchiwanie nagrań rozmów |
Krok drugi: JWT
- W Developer Console najedź na swoje imię w prawym górnym rogu → Credentials → Create JWT.
- W „What apps are permitted to use this credential?” wybierz „Only specific apps of my choice”, wklej Client ID aplikacji z pierwszego kroku → Add app.
- Kliknij Create i skopiuj JWT.
JWT należy do użytkownika, który go utworzył, i wszystkie zapytania Elbuz idą z jego uprawnieniami. Twórz JWT na koncie administratora (Super Admin). Na tego samego użytkownika w dzienniku RingCentral zapisują się połączenia z przycisku „Zadzwoń”.
Elbuz działa tylko z produkcyjnym (production) serwerem RingCentral, platform.ringcentral.com. Klucze i JWT piaskownicy (sandbox) się nie nadadzą: „Sprawdź połączenie” odpowie błędem autoryzacji.
Krok trzeci i czwarty: jak wpisać klucze i numery w Elbuz
Otwórz wiersz RingCentral w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak. Pola:
| Pole w formularzu | Co wpisać |
|---|---|
| „Client ID” | Client ID aplikacji |
| „Client Secret” | Client Secret tej samej aplikacji |
| „Klucz JWT” | JWT z drugiego kroku |
| „Linia dla połączeń wychodzących” | numer firmy w RingCentral, który klient zobaczy przy połączeniu z Elbuz. Puste — numer domyślny, zwykle główny numer firmy |
1
Client ID2
Client Secret3
Linia dla połączeń wychodzących4
Klucz JWT- Client ID — identyfikator Twojej aplikacji z RingCentral Developer Console.
- Client Secret — sekret aplikacji; jest przechowywany ukryty.
- Linia dla połączeń wychodzących — numer, który klient widzi, gdy dzwonisz.
- Klucz JWT — dane logowania administratora; połączenia idą w jego imieniu.
Formularz zapisuje się sam mniej więcej sekundę po zmianie: na dole widać „Zapisywanie...”, potem „Zapisano”. Następnie kliknij „Sprawdź połączenie”. Elbuz pobierze token, odczyta listę aktywnych użytkowników RingCentral z numerami wewnętrznymi i odpowie „Połączono z centralą. Pracowników w centrali: ‹liczba›”. Tym samym kliknięciem Elbuz tworzy w RingCentral subskrypcję zdarzeń o połączeniach.
Zdarzenia: adresu nie trzeba wpisywać
W formularzu jest karta „Adres webhooka centrali”, ale dla RingCentral adresu nigdzie nie trzeba wklejać — mówi o tym podpowiedź w karcie. Elbuz sam rejestruje ten adres w RingCentral, a RingCentral przy rejestracji sprawdza, czy odpowiada. Dalej subskrypcję przedłuża cogodzinne uzgadnianie.
Adres powstaje z domeny, na której w tej chwili działa Elbuz: po kliknięciu „Sprawdź połączenie” z innej domeny Elbuz usuwa starą subskrypcję i tworzy nową. Dlatego sprawdzaj połączenie z domeny, której używasz na stałe.
1
Podpowiedź o automatycznej subskrypcji2
Adres webhooka z zamaskowanym kluczem3
Kopiuj- Podpowiedź mówi, że subskrypcja zdarzeń tworzy się automatycznie po „Sprawdź połączenie”, więc w RingCentral nie trzeba niczego wklejać.
- Adres webhooka; klucz na końcu jest zamaskowany.
- „Kopiuj” — kopiuje adres do schowka.
Klucze mogą być poprawne, a subskrypcja się nie utworzy: aplikacja nie ma uprawnienia Call Control lub Webhook Subscriptions. Wtedy „Sprawdź połączenie” odpowiada „Połączono z centralą…”, ale na końcu dopisuje „webhook subscription:” i tekst błędu RingCentral.
Dopóki subskrypcji nie ma, karta przychodzącego nie wyskakuje, a połączenia pojawiają się w dzienniku dopiero po uzgadnianiu. Dodaj uprawnienia i kliknij „Sprawdź połączenie” jeszcze raz — albo poczekaj na uzgadnianie, ono też tworzy subskrypcję.
Krok czwarty: numery wewnętrzne
W pole „Telefon wewnętrzny” karty pracownika Elbuz wpisz jego numer wewnętrzny (extension number) w RingCentral — krótki numer w rodzaju 101. Wiersz „Numery centrali bez pracownika Elbuz” po sprawdzeniu pokaże numery i imiona użytkowników RingCentral, których nie przypisano jeszcze żadnemu pracownikowi.
Po tym numerze Elbuz wie, komu pokazać kartę przychodzącego, czyje imię wstawić w kolumnę „Menedżer” przy przychodzących i na który numer RingCentral ma zadzwonić najpierw, gdy handlowiec klika „Zadzwoń”.
Żeby RingCentral zadziałał z Elbuz
Co trafia do Elbuz
| Funkcja | Jak to działa z RingCentral |
|---|---|
| Połączenie z karty i dziennika („Zadzwoń”) | tak, przez RingOut w imieniu użytkownika, którego JWT wpisano w Elbuz |
| Przychodzące i wychodzące w dzienniku | tak: na podstawie zdarzenia o zakończeniu połączenia, a czas trwania i godzinę rozpoczęcia uzupełnia cogodzinne uzgadnianie |
| Karta przychodzącego w Elbuz, gdy dzwoni telefon | tak: widzi ją pracownik, który ma w „Telefon wewnętrzny” numer wewnętrzny, na który ktoś dzwoni |
| Subskrypcja zdarzeń | automatycznie: adresu nie trzeba wpisywać w RingCentral |
| Nagranie rozmowy | tak, po cogodzinnym uzgadnianiu: Elbuz sam pobiera nagranie i przekazuje je do odtwarzacza, token administratora nie trafia do przeglądarki. Działają „Odsłuchaj nagranie” i analiza przez AI. Przewijać można, gdy nagranie wczyta się w całości; plik większy niż 25 MB się nie odtworzy |
| Rozłączenie połączenia z karty przychodzącego | nie: w karcie nie ma przycisku „Rozłącz” |
| Czas oczekiwania osobno od rozmowy | nie: kolumna oczekiwania dla RingCentral jest zawsze zerowa |
| Głosowy pracownik AI | nie: RingCentral nie ma wśród operatorów sekcji „Głos przez telefon” |
Specyfika RingCentral
Jak przebiega połączenie z przycisku „Zadzwoń”
Elbuz prosi RingCentral o połączenie RingOut: najpierw RingCentral dzwoni na numer wewnętrzny handlowca, a gdy ten odbierze — do klienta. RingCentral pozwala uruchamiać RingOut tylko w imieniu użytkownika, którego JWT wpisano w Elbuz. Dlatego w dzienniku samego RingCentral takie połączenie jest zapisane na tego użytkownika, a klient widzi numer z „Linia dla połączeń wychodzących” albo numer domyślny.
Elbuz od razu zapisuje próbę w dzienniku w imieniu handlowca. Gdy w ciągu 30 minut przyjdzie zdarzenie o tym samym numerze, Elbuz dopisze do tego wiersza dane RingCentral — a razem z nimi właściciela JWT w kolumnie „Menedżer”: RingCentral widzi połączenie jako jego. Bez zdarzenia uzgadnianie doda o tym połączeniu osobny wiersz.
Jakie zdarzenia Elbuz bierze
Elbuz subskrybuje wszystkie połączenia konta i patrzy na tę stronę połączenia, po której jest Twój pracownik i numer zewnętrzny. Połączenia między pracownikami nie trafiają do dziennika.
- Przychodzące dzwoni u pracownika — Elbuz szuka klienta po numerze i pokazuje kartę „Połączenie przychodzące”. Dopóki połączenie jest w menu głosowym lub w kolejce, karty nie ma: nie ma jeszcze komu jej pokazać.
- Połączenie się zakończyło — wiersz w dzienniku z wynikiem. W zdarzeniu nie ma czasu trwania, więc rozmowa dostaje go po cogodzinnym uzgadnianiu.
- Połączenie na grupę — jeśli odebrał jeden pracownik, pozostałym „nieodebrane” się nie zapisuje i karta nieodebranego nie wyskakuje.
| Co się stało w RingCentral | „Wynik” w dzienniku |
|---|---|
| zajęte lub odrzucone | Zajęte |
| klient się rozłączył | Anulowane |
| poczta głosowa | Poczta głosowa |
| brak odpowiedzi lub nieodebrane | Nieodebrane |
| przekierowane | Przekierowane |
| błąd wewnętrzny, błędny lub zablokowany numer, zakaz połączeń międzynarodowych, brak środków | Błąd połączenia |
| w pozostałych przypadkach | Odebrane |
Cogodzinne uzgadnianie poprawia wynik według dziennika RingCentral: na przykład przychodzące, przy którym klient się rozłączył, staje się tam „Nieodebrane”.
Cogodzinne uzgadnianie
W 25. minucie każdej godziny Elbuz pobiera dziennik połączeń konta RingCentral z ostatniej doby: uzupełnia czas trwania, dopisuje to, czego nie przyniosły zdarzenia, raz na dobę odświeża listę numerów wewnętrznych i przedłuża subskrypcję zdarzeń.
Scenariusze
Przychodzące trafiają na grupę handlowców
Wpisz każdemu handlowcowi extension number w „Telefon wewnętrzny”. Karta przychodzącego wyskakuje pracownikowi, u którego dzwoni telefon. Jeśli odebrał jeden, pozostałym „nieodebrane” się nie zapisuje i karta nieodebranego nie wyskakuje.
Klient ma widzieć główny numer firmy
Zostaw „Linia dla połączeń wychodzących” puste — RingOut pójdzie z numeru domyślnego, zwykle głównego. Potrzebny inny numer firmy — wpisz go w to pole.
Elbuz przeniósł się na inną domenę
Otwórz wiersz RingCentral z nowej domeny i kliknij „Sprawdź połączenie”. Elbuz usunie starą subskrypcję i utworzy nową na nowy adres (zdarzenia).
Co zrobić, gdy RingCentral się nie łączy
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Centrala odrzuciła żądanie: authorization failed (check Client ID, Client Secret and JWT)” | Jedno z trzech pól jest puste, klucze są z piaskownicy, JWT nie jest dozwolony dla tej aplikacji albo został odwołany (jeśli odwołano go już po podłączeniu, komunikat będzie „HTTP 401”) | Sprawdź wszystkie trzy pola; w Credentials zezwól na JWT dla Client ID aplikacji albo utwórz nowy |
| „Połączono z centralą…” z dopiskiem „webhook subscription: …”; karta przychodzącego nie wyskakuje, połączenia trafiają do dziennika raz na godzinę | Subskrypcja zdarzeń nie została utworzona: aplikacja nie ma Call Control lub Webhook Subscriptions | Dodaj uprawnienia aplikacji i kliknij „Sprawdź połączenie” jeszcze raz |
| „Centrala odrzuciła żądanie: HTTP 403: …” przy „Sprawdź połączenie” lub „Zadzwoń” | Brakuje uprawnienia (Read Accounts lub RingOut) albo JWT nie utworzył administrator | Dodaj uprawnienie w aplikacji; JWT utwórz na koncie administratora |
| „W Twojej karcie pracownika nie podano wewnętrznego numeru telefonu” | Pole „Telefon wewnętrzny” jest puste: RingCentral nie ma dokąd zadzwonić najpierw | Wpisz extension number handlowca (krok czwarty) |
| Połączenie w dzienniku bez czasu trwania | Zdarzenie o zakończeniu nie zawiera czasu trwania | Nic: czas trwania pojawi się po najbliższym uzgadnianiu, w 25. minucie godziny |
Pozostałe przypadki, gdy połączenie się nie pojawiło, — w ogólnym omówieniu Telefonia w Elbuz.
Najczęstsze pytania
Skąd wziąć Client ID, Client Secret i JWT dla RingCentral?
Client ID i Client Secret — na stronie aplikacji REST API z JWT auth flow w Developer Console (Apps → Create App). JWT — tam samo: imię w prawym górnym rogu → Credentials → Create JWT, dozwolony dla Client ID tej aplikacji, na koncie administratora konta.
Jakie uprawnienia nadać aplikacji RingCentral?
Read Accounts, Read Call Log, RingOut, Call Control, Webhook Subscriptions i Read Call Recording. Bez Call Control RingCentral nie pozwoli zasubskrybować zdarzeń o połączeniach, bez RingOut nie zadziała „Zadzwoń”, bez Read Call Recording — nagrania rozmów.
Gdzie w RingCentral wkleić adres webhooka?
Nigdzie. Elbuz sam tworzy subskrypcję zdarzeń, gdy klikasz „Sprawdź połączenie”, i przedłuża ją cogodzinnym uzgadnianiem.
Dlaczego w dzienniku RingCentral połączenia z Elbuz są zapisane na jednego użytkownika?
RingCentral pozwala uruchamiać RingOut tylko w imieniu użytkownika, którego JWT wpisano w Elbuz. Najpierw RingCentral dzwoni na numer wewnętrzny handlowca, potem do klienta, ale w dzienniku RingCentral połączenie należy do właściciela JWT.
Czy można odsłuchać nagranie rozmowy RingCentral z Elbuz?
Tak, po cogodzinnym uzgadnianiu. Elbuz sam pobiera nagranie i przekazuje je do odtwarzacza, token nie trafia do przeglądarki. Aplikacja potrzebuje uprawnienia Read Call Recording.
Czy można rozłączyć połączenie RingCentral z Elbuz?
Nie, dla RingCentral w karcie przychodzącego nie ma przycisku „Rozłącz”.
Czy można postawić głosowego pracownika AI na numerze RingCentral?
Nie: RingCentral nie ma wśród operatorów sekcji „Głos przez telefon”. Którzy operatorzy są obsługiwani — w artykule Głosowy pracownik AI.
Gdzie to jest i kto ma dostęp
- Menu
- „Panel klienta” → „Ustawienia systemu” → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → „Telefonia” → RingCentral
- Numer wewnętrzny
- „Użytkownicy (pracownicy)” → karta pracownika → „Telefon wewnętrzny”
- Dziennik połączeń
- „Słowniki” → „Kontakty” → „Dziennik połączeń”
- Uprawnienia
- ustawienia systemu i okno „Dziennik połączeń”; żeby po prostu dzwonić, uprawnienia nie są potrzebne
- Przygotuj
- logowanie do RingCentral Developer Console jako administrator konta
Okno z wiersza operatora nazywa się „Ustawienia dostępu do API usług zewnętrznych”; dla RingCentral pierwsza karta ma trzy klucze zamiast dwóch. Bez uprawnienia do „Dziennik połączeń” nie działa „Sprawdź połączenie”, a więc i subskrypcja zdarzeń. Ogólna mechanika — dziennik, karta połączenia, uprawnienia — w artykule Telefonia w Elbuz.
Powiązane tematy
- Jeśli chcesz zrozumieć dziennik, kartę połączenia lub kto co widzi — Telefonia w Elbuz.
- Jeśli handlowcowi trzeba wpisać „Telefon wewnętrzny” — Karta pracownika.
- Jeśli chcesz znaleźć rozmowę w historii klienta — Karta kontrahenta.
- Jeśli wybierasz spośród operatorów chmurowych — Aircall i Elbuz.
