Integracja Asterisk CRM z Elbuz działa na Twoim serwerze: Elbuz inicjuje połączenia z karty klienta przez AMI, a gotowy fragment dialplanu sam przekazuje do Elbuz każde połączenie. Nadaje się do Asterisk, FreePBX i Issabel.
Kiedy to się przyda:
- Handlowiec nie wie, kto dzwoni — dialplan pobiera nazwę klienta z Elbuz i wyświetla ją na telefonie.
- Numer trzeba wybierać ręcznie — przycisk „Zadzwoń” w karcie: Asterisk łączy najpierw handlowca, potem klienta.
- Nieodebrane połączenia giną — nieodebrane staje się zadaniem „Oddzwoń” w „Pulsie”.
- Handlowcy są zajęci — administrator kieruje numer na głosowego pracownika AI.
Od czego zacząć: poproś administratora serwera o utworzenie użytkownika AMI (co dokładnie).
Co Elbuz potrafi z Asterisk
- Nazwa klienta na telefonie — dialplan pyta o nią Elbuz po numerze (co trafia do Elbuz).
- Połączenie z karty klienta jednym przyciskiem — przez AMI, z wybranego numeru (jak przebiega połączenie).
- Dziennik połączeń — przychodzące i wychodzące z dialplanu, z handlowcem, który faktycznie rozmawiał (jak ustalany jest handlowiec).
- Karta połączenia przychodzącego i nieodebranego — miasto klienta, ostatnie zamówienia, zadanie „Oddzwoń” (karta połączenia).
- Pracownik AI na numerze — przekierowanie konfiguruje administrator serwera (głosowy AI).
Czego potrzeba od Asterisk
Użytkownika AMI tworzy administrator serwera. Według dokumentacji Asterisk AMI konfiguruje się w pliku manager.conf:
- W sekcji
[general]—enabled = yes; port domyślny to5038(parametrport). - Osobna sekcja użytkownika, np.
[elbuz], z hasłemsecret. - W
writetego użytkownika musi być klasaoriginate— bez niej Asterisk nie pozwoli zainicjować połączenia. - Wczytaj ponownie konfigurację menedżera na serwerze.
Dostęp do AMI ogranicza się parametrami permit / deny; dokumentacja Asterisk zaleca nie wystawiać AMI do internetu bez zabezpieczeń. Adresów serwerów Elbuz do takiej listy w dokumentacji Elbuz nie ma — zapytaj o nie wsparcie Elbuz.
We FreePBX użytkowników AMI zwykle tworzy się w interfejsie webowym; dokładną pozycję menu w Twojej wersji sprawdź w dokumentacji FreePBX.
Serwer musi być dostępny z internetu: na adresy sieci lokalnej Elbuz się nie łączy — program sprawdza adres AMI i odrzuca zakresy prywatne. Sam Asterisk musi też docierać do adresu Elbuz przez HTTPS — inaczej CURL() w dialplanie będzie zwracać pustą odpowiedź.
Źródła — oficjalna dokumentacja Asterisk:
Jak podłączyć Asterisk do Elbuz
Trzy kroki po kolei: klucze, numery wewnętrzne i fragment dialplanu. Bez numerów wewnętrznych nie działa przycisk „Zadzwoń”. Bez fragmentu dziennik pozostanie pusty: dla Asterisk nie ma cogodzinnej synchronizacji.
Krok pierwszy: klucze Asterisk
Otwórz wiersz „Asterisk / FreePBX” w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony. Pola do wypełnienia:
| Pole w formularzu | Co wpisać |
|---|---|
| „Adres AMI (host:port)” | publiczny adres serwera i port, np. pbx.company.com:5038; bez portu używany jest 5038 |
| „Użytkownik i sekret AMI” | rozdzielone dwukropkiem: elbuz:sekret |
| „Linia dla połączeń wychodzących” | numer, który zobaczy klient (Caller ); puste — decyduje dialplan |
| „Kanał pracownika” | jak wybierać numer wewnętrzny; domyślnie Local/{ext}@from-internal, inne przykłady z podpowiedzi — PJSIP/{ext}, SIP/{ext} |
| „Kontekst dialplanu” | kontekst, z którego dozwolone są połączenia wychodzące; domyślnie from-internal, jak we FreePBX |
1
Link do instrukcji2
Przełącznik „Aktywność”3
Adres AMI4
Użytkownik i sekret AMI5
Kanał pracownika6
Kontekst dialplanu7
Linia dla połączeń wychodzących8
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 AMI (host:port)” — publiczny adres serwera; bez portu używany jest 5038.
- Pole „Użytkownik i sekret AMI” — rozdzielone dwukropkiem.
- Pole „Kanał pracownika” — domyślnie
Local/{ext}@from-internal. - Pole „Kontekst dialplanu” — domyślnie from-internal.
- Pole „Linia dla połączeń wychodzących” — staje się Caller ID widocznym dla klienta.
- Przycisk „Sprawdź połączenie” — zapytanie do operatora tylko do odczytu; niczego nie zmienia na koncie.
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”. Elbuz tylko loguje się do AMI, nie wykonując żadnej akcji. Listy numerów wewnętrznych z Asterisk nie pobiera, więc odpowiedź brzmi „Połączono z centralą. Pracowników w centrali: 0”. Błędy portu i loginu — w rozwiązywaniu problemów.
Krok drugi: numery wewnętrzne
Gdy handlowiec kliknie „Zadzwoń”, Asterisk najpierw dzwoni na jego numer wewnętrzny i dopiero po odebraniu wybiera numer klienta. Ten sam numer przypisuje połączenia w dzienniku do handlowca.
Gdzie: karta pracownika („Użytkownicy (pracownicy)”) → pole „Telefon wewnętrzny”.
Elbuz wstawia numer w miejsce {ext} w „Kanale pracownika”. Przy kanale domyślnym numer 101 zamieni się w Local/101@from-internal. Pod formularzem podłączenia karta „Numery wewnętrzne pracowników” pokazuje, komu numeru jeszcze nie wpisano.
Krok trzeci: fragment dialplanu na serwerze
Zamiast adresu webhooka formularz ma kartę „Plik konfiguracyjny dla centrali” z przyciskiem „Pobierz plik konfiguracyjny”. Plik elbuz-asterisk.conf to gotowy fragment dialplanu z adresem Elbuz i tajnym kluczem w środku. Instrukcja jest zapisana w nim samym:
- Wklej blok do
/etc/asterisk/extensions_custom.conf. - W kontekście połączeń przychodzących przed Dial dodaj
same => n,Gosub(elbuz-lookup,s,1(${CALLERID(num)},in,<numer wewnętrzny, na który idzie połączenie>)), a w jego rozszerzeniu h —exten => h,1,Gosub(elbuz-report,s,1(${CALLERID(num)},in,)). - W kontekście połączeń wychodzących przed Dial —
same => n,Gosub(elbuz-lookup,s,1(${EXTEN},out,${CALLERID(num)})), w rozszerzeniu h —exten => h,1,Gosub(elbuz-report,s,1(${CDR(dst)},out,${CALLERID(num)})). - Wczytaj ponownie dialplan:
asterisk -rx "dialplan reload".
1
Pobierz plik konfiguracyjny- Przycisk „Pobierz plik konfiguracyjny” — gotowy plik z adresem i kluczem w środku.
W pliku zapisany jest adres Elbuz z 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ń blok na serwerze.
Jeśli fragment był wklejony wcześniej — zastąp go nowym z formularza. W starym wywołania były jednakowe dla przychodzących i wychodzących: przychodzące trafiały bez handlowca, wychodzące — jako przychodzące, a czas połączenia był czasem jego zakończenia.
Aby Asterisk działał z Elbuz
Co trafia do Elbuz
Wszystko poniżej sprawdzono z modułem integracji Asterisk w Elbuz, napisanym według dokumentacji AMI.
| Funkcja | Jak działa z Asterisk |
|---|---|
| Połączenie z karty i dziennika („Zadzwoń”) | tak, przez AMI Originate: Asterisk dzwoni na kanał handlowca, po odebraniu wybiera numer klienta; czeka 30 sekund |
| Przychodzące i wychodzące w dzienniku | tak, tylko ze zdarzeń dialplanu; każdy kierunek podłącza się własnymi wierszami z pliku konfiguracyjnego |
| Nazwa klienta na ekranie telefonu | tak: dialplan pyta Elbuz o nazwę i wstawia ją do CALLERID(name) |
| Karta połączenia przychodzącego w Elbuz | tak: numer wewnętrzny pracownika przekazuje trzeci argument wywołania elbuz-lookup |
| Nagranie rozmowy | nie: nagranie leży jako plik na Twoim serwerze; analizy AI też nie ma |
| Cogodzinna synchronizacja dziennika | nie: Asterisk nie udostępnia historii przez (dziennik bez synchronizacji) |
| Numer widoczny dla klienta | tak: „Linia dla połączeń wychodzących” staje się Caller ID |
| Głosowy pracownik AI | konfiguruje administrator serwera (niżej) |
| Rozłączenie połączenia z karty przychodzącego | nie: przycisku „Rozłącz” dla Asterisk w karcie nie ma |
Fragment dialplanu wykonuje dwa wywołania. Argumenty są w nich takie same: pierwszy — numer klienta, drugi — kierunek (in lub out), trzeci — numer wewnętrzny pracownika.
- elbuz-lookup przed Dial pyta Elbuz, kto dzwoni: nazwa trafia do CALLERID(name) na telefon, a w Elbuz pracownikowi wyskakuje karta klienta.
- elbuz-report po zakończeniu przekazuje do dziennika numer, kierunek, status, czas rozmowy, czas oczekiwania (czas całkowity minus rozmowa), czas rozpoczęcia połączenia i identyfikator.
Fragment korzysta z funkcji CURL() ze standardowej kompilacji Asterisk.
Cechy Asterisk
Dziennik bez synchronizacji
U operatorów chmurowych brakujące zdarzenie uzupełnia cogodzinna synchronizacja. W Asterisk historia połączeń (CDR) leży w bazie na Twoim serwerze i nie da się jej pobrać przez API, dlatego synchronizacja Asterisk nie obejmuje. Jeśli dialplan nie wywołał Elbuz, połączenia w dzienniku nie będzie nigdy. Ponowny ten sam raport nie utworzy duplikatu: połączenie jest rozpoznawane po identyfikatorze.
Jak ustalany jest handlowiec
Numer wewnętrzny pracownika fragment przekazuje jako trzeci argument. W połączeniu przychodzącym przed Dial sam wskazujesz, na który numer wewnętrzny idzie połączenie — po nim pracownikowi wyskakuje karta. Po rozmowie, w rozszerzeniu h, numer pobierany jest z kanału, który odebrał: jeśli połączenie przekazano, do dziennika trafi ten, kto faktycznie rozmawiał.
W połączeniu wychodzącym numer wewnętrzny to ${CALLERID(num)} pracownika, a numer klienta — ${EXTEN} przed wybraniem i ${CDR(dst)} po nim.
Wynik połączenia
Status pochodzi z DIALSTATUS Asterisk. Nieznany status ustalany jest według czasu rozmowy.
| DIALSTATUS | „Wynik” w dzienniku Elbuz |
|---|---|
| ANSWER | „Odebrane” |
| BUSY | „Zajęte” |
| NOANSWER | „Nieodebrane” |
| CANCEL | „Anulowane” |
| CONGESTION, CHANUNAVAIL | „Błąd połączenia” |
Jak przebiega połączenie z przycisku
Elbuz otwiera krótką sesję AMI, wysyła Originate z kanałem pracownika, kontekstem i numerem klienta i od razu się rozłącza, nie czekając na odpowiedź. Jeśli Asterisk odrzucił polecenie, zobaczysz jego przyczynę z pola Message.
Głosowy pracownik AI na numerze Asterisk
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 numer trzeba na nią skierować. Ustawienia sekcji „Głos przez telefon” — w artykule Głosowy pracownik AI.
Skierowanie numeru na AI konfiguruje administrator Twojego Asterisk. W sekcji „Głos przez telefon” podaj numer, wybierz operatora „Inny operator” i skopiuj adres w postaci <numer>@<domena SIP>. Dokumentacja Asterisk pozwala wybrać dowolny adres SIP przez istniejący endpoint PJSIP: Dial(PJSIP/<endpoint>/sip:<numer>@<domena SIP>). Gotowego fragmentu dialplanu dla głosu Elbuz nie dostarcza.
W pole „Adresy operatora” wpisz publiczny adres IP lub domenę swojego serwera — wtedy Elbuz będzie przyjmować połączenia na adres SIP tylko z niego. Domenę Elbuz zamienia na przy zapisie sekcji; jeśli IP serwera się zmieni, zmień dowolne pole sekcji „Głos”, aby zapisała się ponownie. Puste pole — z dowolnego adresu.
Do połączeń wychodzących AI w bloku „Połączenia wychodzące” potrzebne są „Serwer SIP” (adres Twojego Asterisk), „Login linii” i „Hasło linii” — konto SIP, na którym AI zarejestruje się jak telefon. Tworzy je administrator tak samo jak dla zwykłego telefonu SIP. Dla opcji „Inny operator” serwer SIP jest obowiązkowy.
Połączenia wychodzące działają tylko wtedy, gdy włączone jest „Odbieraj połączenia”: inaczej połączenie testowe zwróci „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:00 do 20:00 według czasu konta — pole „Dzwonić w godzinach”.
Scenariusze
Podłączyć FreePBX w typowej instalacji
- Administrator tworzy użytkownika AMI z klasą originate i otwiera port 5038 z zewnątrz (czego potrzeba).
- W formularzu — adres,
użytkownik:sekret; „Kanał pracownika” i „Kontekst dialplanu” zostają domyślne. - Fragment dialplanu — w extensions_custom.conf, wywołania Gosub — w kontekstach przychodzących i wychodzących (krok trzeci).
- Testowe połączenie na numer firmy — i jest w dzienniku.
Połączenie przekazano koledze
Przychodzące poszło na 101, handlowiec przekazał je na 102. Karta wyskakuje pracownikowi z numerem 101, a w dzienniku połączenie zapisuje się z handlowcem 102 — numer pochodzi z kanału, który odebrał (jak ustalany jest handlowiec).
Nieodebrane połączenie nie ginie
Handlowiec nie odebrał — wyskakuje karta „Nieodebrane połączenie”, a w „Pulsie” pojawia się zadanie „Oddzwoń”. W dzienniku takie połączenia pokazuje filtr „Tylko nieodebrane”. Więcej: nieodebrane połączenia.
Co zrobić, gdy Asterisk nie współpracuje z Elbuz
Ogólne problemy telefonii — brak przycisku połączenia, pusty dziennik — opisuje artykuł Telefonia w Elbuz. Tutaj — to, co dotyczy Asterisk.
| 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 — wtedy przyciski połączenia w ogóle się nie wyświetlają | 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 karcie pracownika (krok drugi) |
| „Centrala odrzuciła żądanie: not an Asterisk AMI port” | Pod podanym hostem i portem odpowiada coś innego niż AMI | Sprawdź port AMI (domyślnie 5038) i czy jest otwarty z zewnątrz |
| „Centrala odrzuciła żądanie: AMI login rejected (check user and secret)” | Błędny użytkownik lub sekret AMI albo nie są rozdzielone dwukropkiem | Sprawdź parę użytkownik:sekret w konfiguracji AMI |
| „Centrala odrzuciła żądanie: PBX address must be a public host” | Adres AMI prowadzi do sieci lokalnej albo nie rozwiązuje się na publiczny | Podaj publiczny adres serwera |
| Dziennik jest pusty, choć połączenia są | Fragment dialplanu nie jest wklejony, nie dodano wywołań Gosub albo nie wczytano ponownie dialplanu | Wykonaj trzy kroki z pliku konfiguracyjnego i sprawdź, czy serwer dociera do adresu Elbuz przez HTTPS |
Najczęstsze pytania
Z jakimi centralami opartymi na Asterisk działa integracja?
Z Asterisk, FreePBX i Issabel: liczy się tylko dostęp do AMI i możliwość wklejenia fragmentu dialplanu.
Co wpisać w „Kanał pracownika” i „Kontekst dialplanu”?
W większości instalacji FreePBX — wartości domyślne z pól. Dla PJSIP lub bez FreePBX wybierz wariant PJSIP lub SIP z podpowiedzi pod polem „Kanał pracownika” (krok pierwszy).
Dlaczego w dzienniku brakuje połączeń z czasu, gdy serwer był niedostępny?
Dla Asterisk nie ma cogodzinnej synchronizacji: historia połączeń leży w bazie Twojego serwera i nie da się jej pobrać przez API. Dziennik zasilają tylko zdarzenia z dialplanu.
Czy integracja działa, jeśli Asterisk stoi w zamkniętej sieci biura?
Nie. AMI musi być dostępny z internetu pod publicznym adresem, a serwer — docierać do Elbuz przez HTTPS (czego potrzeba).
Czy można odsłuchać nagranie rozmowy z Asterisk?
Nie. Nagranie leży jako plik na Twoim serwerze i Elbuz nie może zbudować do niego linku. Przycisku odsłuchu ani analizy AI dla Asterisk nie ma.
Czy jest gotowy dialplan dla głosowego AI?
Nie. Przekierowanie numeru na adres SIP AI konfiguruje administrator serwera (głosowy AI).
Gdzie to jest i kto ma dostęp
Podłączenie Asterisk 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” → „Asterisk / FreePBX”
- 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 Asterisk, użytkownika AMI, dostęp administratora do dialplanu
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 handlowca — Użytkownicy (pracownicy), pole „Telefon wewnętrzny”.
- Jeśli trzeba znaleźć rozmowę w historii klienta — Karta kontrahenta.
