Elbuz zamienia chmurową centralę sipgate w telefonię CRM: handlowiec dzwoni do klienta z karty jednym przyciskiem, widzi, kto dzwoni, a każda rozmowa z nagraniem trafia do dziennika i do historii klienta.
Kiedy to się przyda:
- Dzwoni klient — handlowcowi wyskakuje karta z imieniem klienta i jego ostatnimi zamówieniami.
- Trzeba oddzwonić do klienta — „Zadzwoń” w karcie: sipgate najpierw dzwoni do handlowca, potem do klienta.
- Połączenie zostało nieodebrane — w „Pulsie” pojawia się zadanie „Oddzwoń”.
- Konto przeniesiono z classic na neo — Elbuz sam rozpoznaje platformę, niczego nie trzeba wiązać od nowa.
Od czego zacząć: utwórz Personal Access Token i wpisz go w wierszu sipgate grupy „Telefonia”.
Co potrafi integracja z sipgate
Połączenie działa dwoma kanałami: przez Elbuz zestawia i rozłącza połączenia oraz co godzinę uzgadnia dziennik, a przez webhooki sipgate.io (Push-API) sipgate sam zgłasza początek i koniec każdego połączenia.
- Karta osoby, która dzwoni. Wyskakuje „Połączenie przychodzące” z imieniem klienta i jego ostatnimi zamówieniami; nieznany numer dodasz przyciskiem „Utwórz kontrahenta” (karta połączenia).
- Połączenie z karty klienta jednym przyciskiem. „Zadzwoń” w karcie kontrahenta lub w dzienniku — numeru nie trzeba wybierać (jak przebiega połączenie).
- Nagranie i podsumowanie w historii klienta. Połączenie trafia na oś czasu klienta, „Odsłuchaj nagranie” otwiera nagranie, a analiza przez AI pisze podsumowanie i proponuje następny krok (analiza połączeń przez AI).
- Nieodebrane połączenie staje się zadaniem. W „Pulsie” pojawia się „Oddzwoń” z wysokim priorytetem i znika samo po rozmowie z tym numerem.
- Classic i neo bez przełączników. Elbuz sam rozpoznaje platformę konta (classic czy neo).
Czego potrzebujesz od sipgate
- Personal Access Token (Token-ID i Token) z pięcioma uprawnieniami — lista w kroku pierwszym.
- Pakiet sipgate.io na classic — bez niego webhooki nie działają; najprostszy, sipgate.io S, jest bezpłatny.
- Użytkownik-właściciel tokena na neo musi należeć do wszystkich kanałów, których połączenia mają być w dzienniku.
sipgate ma dwie platformy: classic (umowy do września 2025) i neo (nowe konta od września 2025, stare są tam przenoszone). Swoją platformę sipgate pokazuje w menu profilu w interfejsie webowym — kliknij awatar w prawym górnym rogu.
Ścieżki w panelu sipgate pochodzą z dokumentacji sipgate według stanu na 20.10.2026. Jeśli pozycja nazywa się inaczej — kieruj się tymi stronami albo zapytaj wsparcie sipgate:
- sipgate: co się zmienia w REST API i sipgate.io w nowym systemie (neo)
- sipgate: zarządzanie klientami API i webhookami (classic)
- sipgate: Personal Access Token
- sipgate.io: Webhooks → URLs, Incoming/Outgoing, sources, pakiet sipgate.io
- sipgate.io: Activate debug log
- sipgate REST API: opis zapytań i uprawnień
Jak podłączyć sipgate
Trzy kroki: token, numery wewnętrzne pracowników i adres dla webhooków. Bez webhooków dziennik będzie zapełniać tylko cogodzinne uzgadnianie, a karta połączenia przychodzącego się nie pojawi.
Krok pierwszy: Personal Access Token
- Otwórz app.sipgate.com/personal-access-token i utwórz token.
- Nadaj mu pięć uprawnień (scopes):
sessions:calls:write— połączenie z Elbuz na classic;rtcm:write— połączenie z Elbuz na neo i przycisk „Rozłącz”;users:read— lista pracowników i urządzenie, na które dzwonić;channels:read— rozpoznanie neo i uzgadnianie dziennika na neo;history:read— uzgadnianie dziennika i nagrania na classic (na neo nagrania pochodzą ze zdarzeń kanału — uprawnieniechannels:read).
- Skopiuj Token-ID i sam token.
Otwórz wiersz sipgate w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak.
| Pole w formularzu | Co wpisać |
|---|---|
| „Token-ID” | Token-ID z Personal Access Token |
| „Token” | sam token |
| „Linia dla połączeń wychodzących” | Twój numer sipgate, który zobaczy klient; puste — sipgate wybierze sam |
1
Token-ID2
Token- Token-ID — identyfikator tokena dostępu z Twojego konta sipgate.
- Token — tajna część klucza; jest wyświetlana jako kropki, nie otwartym tekstem.
Formularz zapisuje się sam mniej więcej sekundę po zmianie: na dole widać „Zapisywanie...”, potem „Zapisano”. Na koniec kliknij „Sprawdź połączenie” — Elbuz tylko odczytuje dane z sipgate, na Twoim koncie niczego nie zmienia. Odpowiedź:
- „Połączono z centralą. Pracowników w centrali: ‹liczba›” i platforma — „sipgate classic” lub „sipgate neo”;
- „Numery centrali bez pracownika Elbuz:” — użytkowników sipgate, którym nie odpowiada jeszcze żadna karta w Elbuz;
- „Pracowników w centrali: 0” i na końcu „users: HTTP 403…” — token nie ma
users:read, połączenia z przycisku nie pójdą.
Na neo uzgadnianie widzi połączenia tylko tych kanałów, do których należy właściciel tokena: rola administratora nie daje do nich dostępu. Twórz token na koncie użytkownika, który należy do wszystkich kanałów, których połączenia mają być w dzienniku.
Krok drugi: numery wewnętrzne
Numer wewnętrzny pracownika dla sipgate to ID użytkownika sipgate: w0, w1 i tak dalej. Właśnie je sipgate wysyła w zdarzeniach połączenia i po nim Elbuz przypisuje połączenie do handlowca. Wpisz ID w pole „Telefon wewnętrzny” karty pracownika; jeszcze nieprzypisane ID razem z imionami pokazuje „Sprawdź połączenie”.
Gdy handlowiec klika „Zadzwoń”, Elbuz pobiera z sipgate domyślne urządzenie tego użytkownika i na nie dzwoni. W pole można wpisać też ID urządzenia (e0) — dzwonić się da, ale połączenia przychodzące nie przypiszą się do tego handlowca. Jak Elbuz w ogóle rozpoznaje handlowca — w sekcji numery wewnętrzne.
Krok trzeci: jak ustawić webhooki sipgate
W formularzu jest karta „Adres webhooka centrali” z adresem i przyciskiem „Kopiuj”. Adres zawsze zaczyna się od https:// — innych sipgate nie przyjmuje.
1
Adres webhooka2
Przycisk „Kopiuj”- Adres webhooka — wklej go w oba pola webhooków sipgate, dla połączeń przychodzących i wychodzących.
- „Kopiuj” — kopiuje adres do schowka.
sipgate classic. Webhooki wymagają pakietu sipgate.io.
- Zaloguj się na console.sipgate.com → w menu po lewej Webhooks → URLs.
- Kliknij koło zębate w wierszu Incoming, wklej adres z Elbuz, zapisz. To samo — dla Outgoing.
- W sekcji sources wybierz linie i grupy, których połączenia mają trafiać do Elbuz. Bez żadnej wybranej linii zdarzeń nie będzie.
sipgate neo. Push-API działa i tutaj, ale webhooki ustawia się dla kanału, w interfejsie webowym sipgate (Appweb — tak nazywa go też podpowiedź w Elbuz). Dokładnej ścieżki do tych ustawień dokumentacja sipgate nie podaje — szukaj ustawień webhooków kanału w Appweb albo zapytaj wsparcie sipgate.
Wklej ten sam adres z Elbuz. Neo wymaga https i nie podąża za przekierowaniami, więc adresu nie można zastąpić skróconym linkiem.
Sprawdzenie. Zadzwoń na swój numer sipgate. Jeśli połączenie nie pojawiło się w Elbuz, w panelu webhooków sipgate kliknij „Activate debug log” i otwórz dziennik zapytań na app.sipgate.com/io/log (pozycja „Debug log”): widać tam każde zapytanie do Elbuz i odpowiedź.
Każde zdarzenie sipgate podpisuje, a Elbuz sprawdza podpis. Zdarzenie bez ważnego podpisu Elbuz po cichu ignoruje — na ekranie nie będzie błędu.
W adresie jest tajny klucz i host, z którego otwarto formularz. Po zmianie domeny lub ponownym utworzeniu usługi na liście adres jest inny i trzeba go jeszcze raz wpisać w sipgate.
Żeby sipgate zadziałał z Elbuz
Co trafia do Elbuz
| Funkcja | sipgate classic | sipgate neo |
|---|---|---|
| Połączenie z karty i dziennika („Zadzwoń”) | tak | tak |
| Karta „Połączenie przychodzące” dla handlowca | tak, na podstawie zdarzenia rozpoczęcia połączenia | tak, na podstawie zdarzenia rozpoczęcia połączenia |
| Połączenia w dzienniku | tak, na podstawie zdarzenia zakończenia; czas trwania uzupełnia uzgadnianie | tak, na podstawie zdarzenia zakończenia; czas trwania uzupełnia uzgadnianie |
| Cogodzinne uzgadnianie dziennika | według historii połączeń sipgate | według zdarzeń kanałów (historia połączeń na neo jest pusta) |
| „Rozłącz” w karcie przychodzącego | tak | tak |
| Nagranie rozmowy („Odsłuchaj nagranie”, analiza przez AI) | tak, z historii połączeń | tak, ze zdarzeń kanału |
| Imię klienta na ekranie telefonu | nie | nie |
| SMS | nie | nie |
Specyfika sipgate
Classic czy neo
Od platformy zależy zapytanie o połączenie z przycisku i to, skąd uzgadnianie bierze połączenia. Elbuz rozpoznaje ją tak:
- pyta sipgate o typ konta;
- jeśli sipgate go nie podaje — sprawdza, czy konto ma kanały: kanały są tylko w neo;
- jeśli lista kanałów została pobrana, ale jest pusta, — uznaje konto za classic.
Dlatego uprawnienie channels:read jest potrzebne nawet do połączeń. Że token go nie ma, powie i „Sprawdź połączenie”, i błąd „Zadzwoń”, jeśli sipgate odrzuci połączenie. Po przeniesieniu konta na neo w Elbuz niczego nie trzeba wiązać od nowa — wystarczą uprawnienia rtcm:write i channels:read w tokenie.
Czas trwania połączenia
W zdarzeniu zakończenia sipgate nie przekazuje ani czasu trwania, ani godziny rozpoczęcia. Elbuz liczy czas trwania od rozpoczęcia połączenia do zakończenia — razem z sygnałami oczekiwania, więc tuż po połączeniu jest on przybliżony. Dokładny czas trwania wstawia cogodzinne uzgadnianie z danych sipgate.
Grupowe połączenie przychodzące
Gdy połączenie idzie na grupę, sipgate wysyła listę użytkowników, a Elbuz zapisuje połączenie na pierwszego z nich. Uzgadnianie wstawia potem handlowca z danych sipgate: na neo — właściciela połączenia, na classic — użytkownika, który odebrał. Jeśli odebrało urządzenie, a nie użytkownik, albo nikt nie odebrał, na classic zostaje pierwszy użytkownik z listy.
Nagrania rozmów
Plik nagrania sipgate udostępnia tylko z tokenem. Gdy klikasz „Odsłuchaj nagranie”, serwer Elbuz sam pobiera plik z sipgate z Twoim tokenem i przekazuje go do odtwarzacza — token nie trafia do przeglądarki. Tak samo plik pobiera analiza połączenia przez AI.
- Nagranie jest wyszukiwane wśród ostatnich połączeń sipgate: na classic — w historii, na neo — w zdarzeniach kanałów.
- Przewijać nagranie w odtwarzaczu można, gdy plik wczyta się w całości.
- Plik większy niż 25 MB nie jest odtwarzany ani analizowany.
Jak przebiega połączenie z przycisku
Elbuz prosi sipgate o połączenie urządzenia handlowca z numerem klienta i nie czeka, aż handlowiec odbierze: sipgate najpierw dzwoni na urządzenie handlowca, po odebraniu — do klienta. Wcześniej Elbuz może wysłać jeszcze kilka zapytań — o platformę i urządzenie handlowca; każde czeka na odpowiedź do 15 sekund.
- Nie odpowiedziało zapytanie o urządzenie — połączenie na pewno się nie rozpoczęło: zobaczysz „Centrala odrzuciła żądanie: …”, można od razu ponowić.
- Nie odpowiedziało samo zapytanie o połączenie — komunikat o przekroczeniu czasu: połączenie mogło się już rozpocząć.
Scenariusze
Konto sipgate przeniesiono na neo
W Elbuz niczego nie zmieniaj. Sprawdź, czy token ma rtcm:write i channels:read, a właściciel tokena należy do wszystkich kanałów. Webhooki ustaw dla kanałów neo w Appweb. „Sprawdź połączenie” powinno pokazać „sipgate neo”.
Przychodzące trafiają na grupę handlowców
Tuż po połączeniu jest ono zapisane na pierwszego użytkownika grupy. W ciągu godziny uzgadnianie wstawi tego, kto odebrał (na neo — właściciela połączenia). Żeby to zadziałało, każdy handlowiec musi mieć w „Telefon wewnętrzny” ID użytkownika w…, a nie urządzenia.
Klient ma widzieć jeden numer firmy
Wpisz ten numer sipgate w „Linia dla połączeń wychodzących”. Wszystkie połączenia z przycisku „Zadzwoń” pójdą z niego, niezależnie od tego, który handlowiec dzwoni.
Co zrobić, gdy połączenia nie docierają
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Centrala odrzuciła żądanie: HTTP 401…” po „Sprawdź połączenie” | Token-ID lub Token są wpisane błędnie albo token został usunięty | Utwórz token od nowa i wpisz ponownie oba pola (krok pierwszy) |
| „Centrala odrzuciła żądanie: HTTP 403…” przy połączeniu z przycisku | Token nie ma uprawnienia do tego zapytania: sessions:calls:write na classic, rtcm:write na neo |
Utwórz token ze wszystkimi pięcioma uprawnieniami |
| „Sprawdź połączenie” albo błąd „Zadzwoń” kończy się słowami „… add channels:read to the Personal Access Token” | Token nie ma uprawnienia channels:read i Elbuz nie zdołał ustalić, czy masz classic, czy neo |
Utwórz token z channels:read i wpisz ponownie „Token-ID” i „Token” (classic czy neo) |
| „Pracowników w centrali: 0”, choć użytkownicy w sipgate są | Token nie ma uprawnienia users:read |
Dodaj uprawnienie — bez niego nie działa też „Zadzwoń” z ID użytkownika |
| „Centrala odrzuciła żądanie: sipgate user w… has no default device” | Użytkownik sipgate nie ma ustawionego urządzenia domyślnego | Ustaw je w sipgate albo wpisz w „Telefon wewnętrzny” ID urządzenia (e0) — wtedy przychodzące nie przypiszą się do handlowca |
| „W Twojej karcie pracownika nie podano wewnętrznego numeru telefonu” | Pole „Telefon wewnętrzny” jest puste | Wpisz swoje ID sipgate (krok drugi) |
| Połączenia pojawiają się w dzienniku z opóźnieniem do godziny, karty przychodzącego nie ma | Webhooki nie docierają: adres nie jest wpisany, w sources nie wybrano linii, na classic nie ma pakietu sipgate.io albo w adresie jest stara domena | Włącz „Activate debug log” i sprawdź odpowiedź Elbuz na app.sipgate.com/io/log (krok trzeci) |
| W dzienniku kolumna „Menedżer” jest pusta | W karcie pracownika jest nie ID użytkownika (w…), lecz ID urządzenia lub numer | Wpisz ID użytkownika z „Numery centrali bez pracownika Elbuz” |
| „Odsłuchaj nagranie” jest, ale odtwarzacz milczy | Serwer Elbuz nie zdołał pobrać pliku z sipgate: token zmieniono lub usunięto, token nie ma history:read (classic) lub channels:read (neo), na neo właściciel tokena nie należy do kanału albo plik jest większy niż 25 MB |
Sprawdź token i uprawnienia przyciskiem „Sprawdź połączenie” (krok pierwszy) |
| „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” | sipgate nie odpowiedział na czas na samo zapytanie o połączenie (do 15 sekund); zapytanie mogło zostać przyjęte | Nie wybieraj od razu drugi raz: poczekaj minutę |
Połączenie w ogóle nie pojawiło się w dzienniku, a webhooki docierają — ogólne omówienie w artykule Telefonia w Elbuz.
Najczęstsze pytania
Jakie uprawnienia nadać tokenowi sipgate dla Elbuz?
Pięć: sessions:calls:write, rtcm:write, users:read, channels:read i history:read. Pierwsze dwa — połączenie z Elbuz na classic i na neo, users:read — pracownicy, channels:read i history:read — uzgadnianie dziennika na neo i na classic.
Co wpisać w „Telefon wewnętrzny” dla sipgate?
ID użytkownika sipgate — w0, w1 i tak dalej. Jeszcze nieprzypisane ID „Sprawdź połączenie” pokazuje w wierszu „Numery centrali bez pracownika Elbuz”. ID urządzenia (e0) też pozwala dzwonić, ale połączenia przychodzące nie przypiszą się wtedy do handlowca.
Dlaczego czas trwania połączenia zmienił się po godzinie?
Tuż po połączeniu Elbuz zna tylko czas od rozpoczęcia do zakończenia razem z sygnałami oczekiwania. Dokładny czas trwania cogodzinne uzgadnianie bierze z danych sipgate.
Czy można wysyłać SMS przez sipgate z Elbuz?
Nie, integracja obsługuje tylko połączenia.
Czy handlowiec zobaczy imię klienta na ekranie telefonu?
Nie. Imię i zamówienia klienta pokazuje karta „Połączenie przychodzące” w Elbuz, na telefon sipgate Elbuz imienia nie przekazuje.
Czy można postawić głosowego pracownika AI na numerze sipgate?
Gotowej instrukcji dla sipgate nie ma: w sekcji „Głos przez telefon” nie ma operatora sipgate. 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” → sipgate
- 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
- Personal Access Token sipgate; na classic — pakiet sipgate.io
Bez uprawnienia do „Dziennik połączeń” nie działają „Sprawdź połączenie”, adres webhooka, „Rozłącz” ani „Odsłuchaj nagranie”. 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.
