↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak podłączyć RingCentral do Elbuz: aplikacja API z JWT i subskrypcja zdarzeń bez webhooka

    6 min czytaniaZaktualizowano

    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

    1. Zaloguj się do RingCentral Developer Console (developers.ringcentral.com) danymi swojego konta RingCentral → Apps → Create App.
    2. Typ aplikacji — REST API App → Next.
    3. W bloku Authentication wybierz JWT auth flow.
    4. 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”.
    5. Utwórz aplikację i skopiuj z jej strony Client ID i Client Secret.
    Uprawnienie w RingCentralDo czego Elbuz
    Read Accounts (ReadAccounts)lista numerów wewnętrznych dla „Sprawdź połączenie”
    Read Call Log (ReadCallLog)cogodzinne uzgadnianie dziennika
    RingOutprzycisk „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

    1. W Developer Console najedź na swoje imię w prawym górnym rogu → Credentials → Create JWT.
    2. 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.
    3. 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 formularzuCo 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
    Karta „Podłączenie telefonii” formularza RingCentral z polami Client ID, Client Secret, linii wychodzącej i klucza JWT
    1Client ID
    2Client Secret
    3Linia dla połączeń wychodzących
    4Klucz JWT
    1. Client ID — identyfikator Twojej aplikacji z RingCentral Developer Console.
    2. Client Secret — sekret aplikacji; jest przechowywany ukryty.
    3. Linia dla połączeń wychodzących — numer, który klient widzi, gdy dzwonisz.
    4. 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.

    Karta „Adres webhooka centrali” z podpowiedzią o automatycznej subskrypcji i zamaskowanym kluczem
    1Podpowiedź o automatycznej subskrypcji
    2Adres webhooka z zamaskowanym kluczem
    3Kopiuj
    1. Podpowiedź mówi, że subskrypcja zdarzeń tworzy się automatycznie po „Sprawdź połączenie”, więc w RingCentral nie trzeba niczego wklejać.
    2. Adres webhooka; klucz na końcu jest zamaskowany.
    3. „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

    FunkcjaJak 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 dziennikutak: 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 telefontak: 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 rozmowytak, 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ącegonie: w karcie nie ma przycisku „Rozłącz”
    Czas oczekiwania osobno od rozmowynie: kolumna oczekiwania dla RingCentral jest zawsze zerowa
    Głosowy pracownik AInie: 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.
    Jak zdarzenie RingCentral staje się wynikiem w dzienniku
    Co się stało w RingCentral„Wynik” w dzienniku
    zajęte lub odrzuconeZajęte
    klient się rozłączyłAnulowane
    poczta głosowaPoczta głosowa
    brak odpowiedzi lub nieodebraneNieodebrane
    przekierowanePrzekierowane
    błąd wewnętrzny, błędny lub zablokowany numer, zakaz połączeń międzynarodowych, brak środkówBłąd połączenia
    w pozostałych przypadkachOdebrane

    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 mówi program i co z tym zrobić
    Co widziszDlaczego tak jestCo 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

    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