Połącz Asterisk z Xcellerate OPS: identyfikacja, połączenie jednym kliknięciem i rejestr

Połącz swój Asterisk z Xcellerate OPS: połączenia przychodzące pokazują pasujący kontakt, każda rozmowa trafia na oś czasu CRM klienta, a zespół dzwoni do klientów prosto z OPS. Przewodnik dla administratorów MSP i firm usługowych z samodzielnie zarządzanym Asteriskiem (wersja 16 lub nowsza).

TL;DR

• OPS łączy się z Asteriskiem przez AJAM po HTTPS, z użytkownikiem manager, który akceptuje tylko adres OPS.
• Okno połączenia przychodzącego, dzwonienie jednym kliknięciem (najpierw dzwoni Twój telefon) i rejestr na osi czasu CRM.
• Opcjonalnie: nagrania z chronionego folderu HTTPS i nocne uzgadnianie z bazą CDR.

Zanim zaczniesz

• Jesteś administratorem OPS albo Twoja rola może zarządzać telefonią.
• Administrator Asteriska, który może edytować http.conf, manager.conf i dialplan. Asterisk 16+; fragment dialplanu przetestowano na 18 i 20.
• OPS musi docierać do Asteriska po HTTPS. Centrali, do której OPS nie dociera, nie da się jeszcze podłączyć.
• Adres OPS dla zapory, pokazany na stronie telefonii jako "Our address, for your firewall" (Nasz adres dla Twojej zapory).

Telefonia to funkcja podstawowa w każdym planie.

Krok 1: przygotuj Asteriska

AJAM po HTTPS

W http.conf:

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Użytkownik manager dla OPS

W manager.conf utwórz użytkownika z długim sekretem, ograniczonego do adresu OPS:

deny = 0.0.0.0/0.0.0.0
permit = <adres OPS>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Zezwól na adres OPS do tego portu w zaporze.

Opcjonalnie: nagrania i CDR

• Dodaj makra nagrywania OPS (ops-recording i ops-hangup) z opublikowanego fragmentu dialplanu do kontekstów przychodzących i wychodzących. Nie zmieniaj nazw plików.
• Udostępnij folder monitor (/var/spool/asterisk/monitor) tylko do odczytu po HTTPS, z basic auth i listą dozwolonych IP.
• Do uzgadniania: dostęp do odczytu bazy CDR, na przykład mysql:host=…;dbname=asteriskcdrdb, tabela cdr.

OPS nigdy sam nie włącza nagrywania. Jeśli musisz je zapowiadać, zrób to w dialplanie przed startem nagrania. Przeładuj Asteriska.

Krok 2: dodaj Asteriska w OPS

Otwórz Settings → Data and security → Telephony (Ustawienia → Dane i bezpieczeństwo → Telefonia), kliknij Add a phone system (Dodaj centralę telefoniczną), wybierz Asterisk i nadaj nazwę.

Strona Telefonia z listą wyboru centrali, polem nazwy i komunikatem, że nie podłączono jeszcze żadnej centrali.

Wypełnij Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret. Dla nagrań: Recordings base URL, Recordings user, Recordings password. Dla uzgadniania: CDR database DSN, CDR database user, CDR database password. Przy certyfikacie samopodpisanym zaznacz Accept this certificate (Akceptuj ten certyfikat). Zapisz.

Krok 3: test, numery wewnętrzne i włączenie

1. Kliknij Test connection (Testuj połączenie). Oczekuj "The PBX answered over AJAM." (Centrala odpowiedziała przez AJAM) i "A recording source is configured." (Źródło nagrań jest skonfigurowane) albo podpowiedzi.
2. Numery wewnętrzne nie są importowane. Wpisz każdy numer i wybierz w Belongs to (Należy do) osobę. Dla grupy dodaj wszystkich przez Add person (Dodaj osobę).
3. Kliknij Enable (Włącz) i wykonaj połączenie testowe.

Co się dzieje po połączeniu

• Połączenia przychodzące: OPS odczytuje zdarzenia Asteriska w krótkich odstępach. W prawym dolnym rogu widać, kto dzwoni, z przyciskami do otwarcia kontaktu lub firmy, nowego zgłoszenia z wpisanym numerem albo dodania numeru jako kontaktu. Przekazane połączenie pozostaje jednym połączeniem.
• Dzwonienie jednym kliknięciem: z własnym numerem wewnętrznym (nie grupą) najpierw dzwoni Twój telefon, potem klient. OPS nie przenosi dźwięku. Potem zapisujesz wynik.
• Rejestr: każda rozmowa trafia na oś czasu CRM kontaktu i firmy, powiązana z najnowszą otwartą szansą sprzedaży. Nie do zgłoszeń. Nieznane numery trafiają na osobną listę; OPS nigdy sam nie tworzy kontaktów.
• Nieodebrane połączenia powiadamiają osobę, której telefon dzwonił, a w innym przypadku właściciela szansy.
• Nagrania są pobierane po rozmowie, przypisywane do właściwego połączenia i odtwarzane w OPS, z rejestrem odsłuchów. Nieodebrane połączenia nie są pobierane.
• Uzgadnianie: z bazą CDR OPS co noc uzupełnia dane.

Warto wiedzieć

• Tylko HTTPS: OPS nigdy nie wysyła danych managera przez zwykłe HTTP.
• Nagrania OPS pobiera tylko z folderu HTTPS.
• Połączenia wychodzące OPS rozpoczyna w kontekście from-internal.
• Nagrywanie dwukanałowe podwaja zajętość dysku, ale pozwala podsumowaniom rozmów oddzielić rozmówcę od pracownika. Podsumowania są domyślnie wyłączone (ustawienia AI) i zużywają kredyty AI.
• OPS nie usuwa nagrań z Twojego Asteriska. Sekretu managera nie da się odczytać po zapisaniu.

Rozwiązywanie problemów

• "The base URL is not HTTPS." (Bazowy URL nie jest HTTPS.) Umieść AJAM za TLS.
• "The PBX did not answer over AJAM: …" (Centrala nie odpowiedziała przez AJAM.) Sprawdź, czy użytkownik manager istnieje, czy linia permit zawiera adres OPS i czy port jest otwarty.
• "No recording source is configured." (Nie skonfigurowano źródła nagrań.) Udostępnij folder monitor przez chronione HTTPS i zastosuj fragment dialplanu.
• Brak nagrań, brak błędu: nazwy plików w dialplanie zostały zmienione.

Zacznij teraz

Niech Twój Asterisk współpracuje z CRM i service deskiem. Zacznij za darmo. Przeczytaj też o europejskich integracjach OPS oraz sprzedaży i fakturowaniu.