Integracja 3CX z CRM Elbuz przenosi połączenia Twojej centrali do CRM: menedżer dzwoni do klienta z karty jednym przyciskiem, a przychodzące i wychodzące same trafiają do dziennika i historii klienta. Działa z 3CX V20 i nowszymi.
Kiedy to się przyda:
- Menedżer nie wie, kto dzwoni — 3CX pobiera nazwę klienta z Elbuz i pokazuje ją na telefonie i w kliencie 3CX.
- Numer trzeba wybierać ręcznie — przycisk „Zadzwoń” w karcie: 3CX dzwoni z numeru wewnętrznego menedżera.
- Nieodebrane połączenia giną — nieodebrane staje się zadaniem „Oddzwoń” w „Pulsie”.
Od czego zacząć: utwórz aplikację API w konsoli 3CX (jak dokładnie).
Co potrafi Elbuz z 3CX
- Nazwa klienta na telefonie — 3CX pyta o nią Elbuz po numerze (nazwa na telefonie).
- Połączenie z karty klienta jednym przyciskiem — z numeru wewnętrznego menedżera (numery wewnętrzne).
- Wszystkie połączenia w jednym dzienniku — czego nie przekazał szablon, dociąga cogodzinne uzgodnienie (uzgodnienie).
- Karta połączenia przychodzącego i nieodebranego — miasto klienta, ostatnie zamówienia, zadanie „Oddzwoń” (karta połączenia).
- Pracownik AI na numerze — przekierowanie konfiguruje administrator 3CX (głosowy AI).
Czego potrzeba od 3CX
Client ID i klucz tworzy się w konsoli administratora 3CX (według dokumentacji 3CX):
- 3CX Admin Console → „Integrations” → „API”.
- Kliknij „Add” — utworzy się nowa aplikacja kliencka.
- W „Client ID” podaj numer (DN) punktu routingu — jest on też identyfikatorem do autoryzacji. Numer musi być wolny, nieprzypisany do pracownika.
- Zaznacz „3CX Call Control API Access”.
- Zapisz: 3CX pokaże klucz API tylko raz — od razu go skopiuj.
Według dokumentacji 3CX Call Control wymaga licencji 8SC+ AI. Bez niej przycisk „Zadzwoń” i sprawdzenie połączenia z 3CX nie zadziałają.
3CX musi być dostępna z internetu pod publicznym adresem. Do adresów sieci lokalnej Elbuz się nie łączy: program sprawdza adres centrali i odrzuca zakresy prywatne. Jeśli 3CX stoi w biurze bez dostępu z zewnątrz, nie zadziała ani „Zadzwoń”, ani uzgodnienie.
Ścieżki w konsoli 3CX pochodzą z oficjalnej dokumentacji. Jeśli pozycja nazywa się inaczej — kieruj się tymi stronami lub zapytaj dostawcę 3CX:
Jak podłączyć 3CX do Elbuz
Trzy kroki po kolei: klucze, numery wewnętrzne i szablon XML w konsoli 3CX. Bez numerów wewnętrznych nie działa przycisk „Zadzwoń”. Bez szablonu dziennik zasila tylko cogodzinne uzgodnienie, a nazwa klienta nie pojawia się na telefonie.
Krok pierwszy: klucze 3CX
Otwórz wiersz 3CX w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak. Pola do wpisania:
| Pole w formularzu | Co wpisać |
|---|---|
| „Adres centrali” | publiczny adres Twojej 3CX, na przykład pbx.company.com, bez https:// |
| „Client ID i Secret” | rozdzielone dwukropkiem: 200:AbCdEf123 — identyfikator i sekret aplikacji z konsoli 3CX |
1
Link do instrukcji2
Przełącznik „Aktywność”3
Pole „Adres centrali”4
Pole „Client ID i Secret”5
Przycisk „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 „Adres centrali” — publiczny adres Twojej 3CX.
- Pole „Client ID i Secret” — rozdzielone dwukropkiem, na przykład 200:AbCdEf123.
- Przycisk „Sprawdź połączenie” — zapytanie tylko do odczytu, niczego nie zmienia na koncie operatora.
Formularz zapisuje się sam mniej więcej sekundę po zmianie: na dole widać „Zapisywanie...”, a potem „Zapisano”. Przycisku „Zapisz” nie ma.
Na koniec kliknij „Sprawdź połączenie”. Program odpowie „Połączono z centralą. Pracowników w centrali: ‹liczba›”. Elbuz otrzymuje token dostępu (ważny 60 minut, odnawia się sam) i odczytuje listę numerów wewnętrznych 3CX z imionami. Wiersz „Numery centrali bez pracownika Elbuz” pokaże, komu w Elbuz nie wpisano jeszcze numeru.
Krok drugi: numery wewnętrzne
Gdy menedżer kliknie „Zadzwoń”, 3CX najpierw dzwoni na jego numer wewnętrzny i dopiero po odebraniu wybiera numer klienta. Ten sam numer przypisuje połączenia w dzienniku do menedżera. W 3CX jest to numer rozszerzenia (extension) pracownika.
Gdzie: karta pracownika („Użytkownicy (pracownicy)”) → pole „Telefon wewnętrzny”.
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: szablon XML w konsoli 3CX
Zamiast adresu webhooka formularz ma kartę „Plik konfiguracyjny dla centrali” z przyciskiem „Pobierz plik konfiguracyjny”. Plik to szablon XML integracji CRM z wpisanym już adresem Elbuz i tajnym kluczem, niczego nie trzeba w nim uzupełniać. Wgraj go do 3CX (według dokumentacji 3CX):
- 3CX Admin Console → „Integrations” → „CRM”.
- Kliknij „Add Template” i wybierz pobrany plik.
1
Przycisk „Pobierz plik konfiguracyjny”- Przycisk „Pobierz plik konfiguracyjny” — gotowy plik z adresem i kluczem w środku.
W pliku zapisany jest adres Elbuz z tajnym kluczem i host, z którego otwarto formularz. Po zmianie domeny lub ponownym utworzeniu usługi na liście pobierz plik jeszcze raz i podmień szablon w 3CX.
Aby 3CX zadziałała z Elbuz
Co trafia do Elbuz
Wszystko poniżej sprawdzono z modułem integracji 3CX w Elbuz, napisanym według dokumentacji Call Control API i XAPI 3CX V20.
| Funkcja | Jak to działa z 3CX |
|---|---|
| Połączenie z karty i dziennika („Zadzwoń”) | tak: 3CX dzwoni z numeru wewnętrznego menedżera na numer klienta i czeka na odebranie 30 sekund |
| Przychodzące i wychodzące w dzienniku | tak, z raportu szablonu po zakończeniu połączenia i z cogodzinnego uzgodnienia |
| Nazwa klienta na ekranie telefonu | tak: 3CX pyta o nazwę po numerze w chwili połączenia i pokazuje ją na telefonie i w kliencie 3CX |
| Karta połączenia przychodzącego w Elbuz w chwili połączenia | tak: w zapytaniu o nazwę 3CX przekazuje rozszerzenie agenta (karta przychodzącego) |
| Nagranie rozmowy | nie: 3CX udostępnia nagrania tylko z osobną autoryzacją do swojego magazynu; analizy AI też nie ma |
| Wynik połączenia | tylko „Odebrane” lub „Nieodebrane” (dlaczego) |
| Cogodzinne uzgodnienie dziennika | tak, w 25. minucie każdej godziny za ostatnią dobę |
| Głosowy pracownik AI | konfiguruje administrator centrali (poniżej) |
| Rozłączenie połączenia z karty przychodzącego | nie: karta przychodzącego dla 3CX nie jest powiązana z wierszem dziennika, dlatego nie ma w niej przycisku „Rozłącz” |
Szablon ma dwa scenariusze:
- Wyszukanie kontaktu — w chwili połączenia 3CX przekazuje numer, kierunek i rozszerzenie agenta. Elbuz odpowiada nazwą, linkiem do karty i tym samym numerem (bez niego 3CX nie uzna dopasowania).
- Raport o połączeniu — po zakończeniu 3CX przekazuje numer, typ połączenia, rozszerzenie i imię agenta, czas trwania, godzinę rozpoczęcia i kolejkę.
Specyfika 3CX
Nazwa klienta na telefonie
Gdy numer znajdzie się wśród kontrahentów, Elbuz przekazuje 3CX nazwę, link do karty i numer. Nieznany numer dostaje pustą odpowiedź — i 3CX pokazuje po prostu numer, a nie bezimienny wpis.
Karta połączenia przychodzącego
Kartę „Połączenie przychodzące” Elbuz pokazuje menedżerowi, na którego numer wewnętrzny idzie połączenie. Ten numer 3CX przekazuje w zapytaniu o nazwę jako rozszerzenie agenta — tak działa aktualny plik konfiguracyjny.
Jeśli 3CX była podłączona wcześniej, w Twojej centrali jest stara wersja szablonu — w niej zapytanie o nazwę nie przekazuje rozszerzenia agenta i karta przychodzącego w Elbuz nie wyskakuje. Pobierz plik konfiguracyjny ponownie i podmień szablon w 3CX.
Wynik połączenia
Z raportu szablonu Elbuz zna typ połączenia (przychodzące, wychodzące, nieodebrane, bez odpowiedzi) i czas trwania. Połączenie z czasem trwania, które nie jest oznaczone jako nieodebrane, to „Odebrane”, pozostałe — „Nieodebrane”. Rozróżnić „Zajęte” i „Błąd połączenia” dla 3CX się nie da, a czas oczekiwania nie jest przekazywany osobno.
Cogodzinne uzgodnienie
Co godzinę Elbuz pobiera dziennik połączeń 3CX za ostatnią dobę przez XAPI. Nazwy pól zmieniały się między wersjami V20, dlatego program szuka wartości pod kilkoma znanymi nazwami.
Jeśli nie ma identyfikatora połączenia, Elbuz składa go z czasu (z dokładnością do minuty), numeru klienta i rozszerzenia. Raport szablonu buduje klucz tak samo, więc jedno połączenie nie trafi do dziennika jako dwa wiersze; wyjątek — połączenie dokładnie na przełomie minut.
Głosowy pracownik AI na numerze 3CX
Pracownik AI Elbuz potrafi sam odbierać połączenia i sam dzwonić do klientów. Rozmowę prowadzi nie Twoja centrala, lecz platforma głosowa Elbuz, i trzeba na nią skierować numer. Konfiguracja sekcji „Głos przez telefon” — w artykule Głosowy pracownik AI.
3CX to Twoja własna centrala, dlatego skierowanie numeru na AI konfiguruje jej administrator. W sekcji „Głos przez telefon” podaj numer, wybierz operatora „Inny operator” i skopiuj adres w postaci <numer>@<domena SIP>.
Czy w Twojej 3CX można skierować połączenia numeru na zewnętrzny adres SIP i jak to zrobić, dokumentacja 3CX nie opisuje — zapytaj dostawcę lub integratora 3CX.
W polu „Adresy operatora” wpisz publiczny adres IP lub domenę Twojej 3CX — wtedy Elbuz będzie przyjmować połączenia na adres SIP tylko z niej. Domenę Elbuz zamienia na przy zapisie sekcji; jeśli IP Twojej 3CX się zmieni, zmień dowolne pole sekcji „Głos”, aby zapisała się ponownie. Puste pole — połączenia są przyjmowane z dowolnego adresu.
Do połączeń wychodzących AI w bloku „Połączenia wychodzące” potrzebne są „Serwer SIP”, „Login linii” i „Hasło linii” — dane konta SIP, na którym AI zarejestruje się jako telefon. Dla „Innego operatora” serwer SIP jest obowiązkowy. Skąd wziąć takie dane dla rozszerzenia 3CX i czy można je rejestrować z zewnętrznej platformy — zapytaj dostawcę 3CX.
Połączenia wychodzące działają tylko wtedy, gdy włączone jest „Odbieraj połączenia”: inaczej połączenie próbne odpowie „Połączenia wychodzące nie są skonfigurowane: podaj login i hasło linii oraz włącz odbieranie połączeń”. Domyślnie AI dzwoni od 9 do 20 według czasu konta — pole „Dzwonić w godzinach”.
Scenariusze
Menedżer widzi, kto dzwoni, jeszcze przed odebraniem
- Wgraj aktualny plik konfiguracyjny do 3CX (krok trzeci).
- Klient dzwoni — 3CX pokazuje jego nazwę na telefonie, a w Elbuz menedżerowi z tym rozszerzeniem wyskakuje karta „Połączenie przychodzące”.
- Po rozmowie raport szablonu dodaje połączenie do dziennika i na oś zdarzeń klienta.
Aktualizacja starego szablonu
Karta przychodzącego nie wyskakuje, choć nazwa na telefonie jest — w 3CX jest szablon wgrany przed aktualizacją. Pobierz plik konfiguracyjny z formularza ponownie i podmień nim szablon w „Integrations” → „CRM” (karta przychodzącego).
Nieodebrane połączenie nie ginie
Menedżer nie odebrał — wyskakuje karta „Nieodebrane połączenie”, a w „Pulsie” pojawia się zadanie „Oddzwoń”. W dzienniku takie połączenia pokazuje „Tylko nieodebrane”. Szczegóły: nieodebrane połączenia.
Co zrobić, gdy 3CX nie działa z Elbuz
Ogólne problemy telefonii — brak przycisku połączenia, pusty dziennik — omówiono w artykule Telefonia w Elbuz. Tutaj — to, co dotyczy 3CX.
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Przycisku „Zadzwoń” nie ma ani na liście kontaktów, ani w karcie | Klucze nie są wpisane lub przełącznik „Aktywność” jest wyłączony — przyciski połączenia w ogóle się wtedy nie rysują | Sprawdź pola i przełącznik w formularzu podłączenia (krok pierwszy) |
| „W Twojej karcie pracownika nie podano wewnętrznego numeru telefonu” | Puste pole „Telefon wewnętrzny” w Twojej karcie: centrala nie ma dokąd zadzwonić w pierwszym kroku | Wpisz numer w kartę pracownika (krok drugi) |
| „Sprawdź połączenie” zwraca błąd, choć dane są wpisane | Client ID i Secret nie są rozdzielone dwukropkiem, aplikacja nie ma dostępu do Call Control API albo adres centrali jest niedostępny z internetu lub prowadzi do sieci lokalnej | Sprawdź format identyfikator:sekret, uprawnienia aplikacji w konsoli 3CX i publiczność adresu |
| Na telefonie nie ma nazwy klienta, a połączenia pojawiają się w dzienniku tylko raz na godzinę | Szablon integracji CRM nie został wgrany do 3CX albo jest w nim stary adres | Pobierz plik konfiguracyjny ponownie i podmień szablon w konsoli 3CX |
| Nieznany numer wyświetla się na telefonie jako numer, bez nazwy | Tak ma być: dla numeru, którego nie ma wśród kontrahentów, Elbuz zwraca pustą odpowiedź | Dodaj klienta — następnym razem 3CX pokaże nazwę |
| „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. Żądanie mogło zostać przyjęte — wtedy Twój telefon zadzwoni trochę później | Nie wybieraj od razu ponownie: odczekaj minutę. Jeśli centrala przyjęła żądanie, Twój telefon zadzwoni, a po rozmowie połączenie pojawi się w dzienniku |
Najczęstsze pytania
Jaka wersja 3CX jest potrzebna do integracji z Elbuz?
3CX V20 i nowsze: Elbuz działa przez Call Control API i XAPI tej wersji oraz szablon XML integracji CRM.
Gdzie w 3CX wziąć Client ID i Secret?
3CX Admin Console → „Integrations” → „API” → „Add”: wolny numer jako Client ID i zaznaczone „3CX Call Control API Access”; klucz 3CX pokazuje tylko raz. Potrzebna jest licencja 8SC+ AI (krok po kroku).
Gdzie wgrać plik konfiguracyjny z Elbuz?
W 3CX Admin Console: „Integrations” → „CRM” → „Add Template”. Adres Elbuz i klucz są już w pliku, niczego nie trzeba uzupełniać.
Czy można odsłuchać nagranie rozmowy 3CX z Elbuz?
Nie. 3CX udostępnia nagrania tylko z osobną autoryzacją do swojego magazynu, dlatego w dzienniku nie ma dla 3CX przycisku odsłuchu ani analizy AI.
Czy integracja działa, jeśli 3CX stoi w biurze?
Tylko jeśli 3CX jest dostępna z internetu pod publicznym adresem. Do adresów sieci lokalnej Elbuz się nie łączy.
Czy można skierować numer 3CX na głosowego AI?
Konfiguruje to administrator Twojej 3CX: w sekcji „Głos przez telefon” wybierz „Inny operator” i skopiuj adres SIP. Czy w Twojej 3CX można skierować na niego numer, zapytaj dostawcę lub integratora 3CX.
Gdzie to jest i kto ma dostęp
Podłączenie 3CX znajduje się 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” → 3CX
- Inne wejścia
- „Dziennik połączeń” → menu → „Podłączenie telefonii”
- Uprawnienia
- ustawienia systemu i okno „Dziennik połączeń”; do dzwonienia uprawnienia nie są potrzebne
- Przygotuj
- publiczny adres 3CX (V20+), Client i Secret, dostęp do konsoli 3CX
Bez uprawnienia do „Dziennika połączeń” nie działają „Sprawdź połączenie” 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 trzeba zrozumieć kolumny lub „Wynik” — Dziennik połączeń.
- Jeśli chcesz, aby AI sam odbierał i dzwonił do klientów — Głosowy pracownik AI.
- Jeśli połączenia nie przypisują się do menedżera — Użytkownicy (pracownicy), pole „Telefon wewnętrzny”.
- Jeśli trzeba znaleźć rozmowę w historii klienta — Karta kontrahenta.
