↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak podłączyć Asterisk i FreePBX do Elbuz: AMI, dialplan i dziennik połączeń

    6 min czytaniaZaktualizowano

    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:

    1. W sekcji [general] — enabled = yes; port domyślny to 5038 (parametr port).
    2. Osobna sekcja użytkownika, np. [elbuz], z hasłem secret.
    3. W write tego użytkownika musi być klasa originate — bez niej Asterisk nie pozwoli zainicjować połączenia.
    4. 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 formularzuCo 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
    Karta podłączenia telefonii w formularzu Asterisk / FreePBX
    1Link do instrukcji
    2Przełącznik „Aktywność”
    3Adres AMI
    4Użytkownik i sekret AMI
    5Kanał pracownika
    6Kontekst dialplanu
    7Linia dla połączeń wychodzących
    8Sprawdź połączenie
    1. Link „Gdzie dokładnie — krok po kroku w instrukcji dla Twojego operatora” prowadzi na tę stronę.
    2. Przełącznik „Aktywność” — integracja jest włączona.
    3. Pole „Adres AMI (host:port)” — publiczny adres serwera; bez portu używany jest 5038.
    4. Pole „Użytkownik i sekret AMI” — rozdzielone dwukropkiem.
    5. Pole „Kanał pracownika” — domyślnie Local/{ext}@from-internal.
    6. Pole „Kontekst dialplanu” — domyślnie from-internal.
    7. Pole „Linia dla połączeń wychodzących” — staje się Caller ID widocznym dla klienta.
    8. 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:

    1. Wklej blok do /etc/asterisk/extensions_custom.conf.
    2. 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,)).
    3. 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)})).
    4. Wczytaj ponownie dialplan: asterisk -rx "dialplan reload".
    Karta pliku konfiguracyjnego dla centrali w formularzu Asterisk / FreePBX
    1Pobierz plik konfiguracyjny
    1. 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.

    FunkcjaJak 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 dziennikutak, tylko ze zdarzeń dialplanu; każdy kierunek podłącza się własnymi wierszami z pliku konfiguracyjnego
    Nazwa klienta na ekranie telefonutak: dialplan pyta Elbuz o nazwę i wstawia ją do CALLERID(name)
    Karta połączenia przychodzącego w Elbuztak: numer wewnętrzny pracownika przekazuje trzeci argument wywołania elbuz-lookup
    Nagranie rozmowynie: nagranie leży jako plik na Twoim serwerze; analizy AI też nie ma
    Cogodzinna synchronizacja dziennikanie: Asterisk nie udostępnia historii przez (dziennik bez synchronizacji)
    Numer widoczny dla klientatak: „Linia dla połączeń wychodzących” staje się Caller ID
    Głosowy pracownik AIkonfiguruje administrator serwera (niżej)
    Rozłączenie połączenia z karty przychodzącegonie: 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

    1. Administrator tworzy użytkownika AMI z klasą originate i otwiera port 5038 z zewnątrz (czego potrzeba).
    2. W formularzu — adres, użytkownik:sekret; „Kanał pracownika” i „Kontekst dialplanu” zostają domyślne.
    3. Fragment dialplanu — w extensions_custom.conf, wywołania Gosub — w kontekstach przychodzących i wychodzących (krok trzeci).
    4. 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 mówi program i co z tym zrobić
    Co widziszDlaczego tak jestCo 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

    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