Poczta e-mail
Podręcznik Mint Service Desk 3.4.2: instalacja, administracja oraz praca agentów i klientów.
Konta
W sekcji kont konfigurujesz skrzynki pocztowe do odbierania i wysyłania wiadomości w systemie.
Lista pokazuje wszystkie skonfigurowane konta.
Aby dodać konto, kliknij przycisk po prawej stronie wyszukiwania.
W formularzu uzupełnij wszystkie wymagane pola oznaczone symbolem *.
Wybierz przynajmniej jedną kolejkę wychodzącą. Wiadomości agentów ze zgłoszeń w tych kolejkach będą wysyłane z tego konta. Jeśli kolejka nie jest przypisana do żadnej skrzynki, wiadomość zostanie wysłana z konta systemowego. Jeśli nie wskazano konta systemowego, wiadomość nie zostanie wysłana.
Następnie wybierz jedną kolejkę przychodzącą. Wiadomość klienta wysłana na skonfigurowany adres utworzy zgłoszenie w tej kolejce.
Skrzynkę można oznaczyć jako konto systemowe.
Konto systemowe wysyła automatyczne powiadomienia, na przykład o nowych zgłoszeniach i zmianach statusu, oraz obsługuje zgłoszenia z kolejek bez przypisanej innej skrzynki.
Następnie wybierz dostawcę poczty.
Dostępne opcje:
- Gmail
- Yahoo!
- Microsoft Office 365
- Inny
- Microsoft Graph API
Dla dostawców przygotowano domyślne ustawienia połączenia. Wyjątkiem jest opcja Inny, w której wszystkie parametry wpisuje się ręcznie.
Połączenie można skonfigurować z użyciem uwierzytelniania:
- Dane logowania
- OAuth2
Obie metody opisano poniżej. Końcowa część rozdziału obejmuje konfigurację Microsoft Office 365 i Microsoft Graph API.
Powiązane artykuły
Dane logowania
Ta metoda uwierzytelniania wymaga podstawowych danych logowania do skrzynki oraz parametrów serwerów poczty przychodzącej i wychodzącej. Podaje się adres e-mail, hasło, protokoły i ustawienia zabezpieczeń połączeń.
Wymagania połączenia
Do poprawnej konfiguracji potrzebne są:
- poprawne dane logowania: adres e-mail i aktualne hasło,
- adres serwera SMTP, właściwy port i zabezpieczenia, na przykład SSL/TLS lub STARTTLS,
- adres serwera IMAP, zalecanego do odbierania poczty, lub POP3, wraz z portem i zabezpieczeniami,
- włączone usługi odbierania i wysyłania poczty w ustawieniach skrzynki,
- informacja o włączonym 2FA, ponieważ może wymagać innej metody logowania, na przykład hasła aplikacji,
- w razie potrzeby potwierdzenie, że sieć i zapora nie blokują odpowiednich portów i protokołów.
Poniższe tabele przedstawiają obsługę danych logowania oraz parametry SMTP i IMAP u poszczególnych dostawców.
Obsługa uwierzytelniania danymi logowania
Obsługa uwierzytelniania danymi logowania
| Dostawca | Obsługa danych logowania | Uwagi |
|---|---|---|
| Gmail | Ograniczona | Wymagane hasło aplikacji i włączony IMAP. Zwykłe hasło konta nie działa przy włączonym 2FA. |
| Yahoo | Tak | Po włączeniu 2FA wymagane jest hasło aplikacji. |
| Microsoft Office 365 | Ograniczona | Uwierzytelnianie Basic Auth przez IMAP/SMTP może być wyłączone polityką organizacji. Działa tylko wtedy, gdy nadal jest włączone. |
| Microsoft Graph API | Nie | Obsługuje tylko OAuth2. IMAP/SMTP z hasłem użytkownika nie są dostępne. |
Ustawienia SMTP
Parametry serwera SMTP przy uwierzytelnianiu danymi logowania
| Dostawca | Serwer SMTP | Port SMTP | Zabezpieczenia SMTP |
|---|---|---|---|
| Gmail | smtp.gmail.com | 465 | SSL/TLS |
| Yahoo | smtp.mail.yahoo.com | 465 | SSL/TLS |
| Microsoft Office 365 | smtp.office365.com | 587 | STARTTLS |
| Microsoft Graph API | — | — | — |
Ustawienia IMAP
Parametry serwera IMAP przy uwierzytelnianiu danymi logowania
| Dostawca | Serwer IMAP | Port IMAP | Zabezpieczenia IMAP |
|---|---|---|---|
| Gmail | imap.gmail.com | 993 | SSL/TLS |
| Yahoo | imap.mail.yahoo.com | 993 | SSL/TLS |
| Microsoft Office 365 | outlook.office365.com | 993 | SSL/TLS |
| Microsoft Graph API | — | — | — |
Konfiguracja konta
Poniższy zrzut przedstawia pola wymagane dla uwierzytelniania danymi logowania w Mint Service Desk.
Opis pól:
| Pole | Opis |
|---|---|
| Nazwa użytkownika* | Login do skrzynki, zwykle pełny adres e-mail, chyba że dostawca wymaga innego formatu. |
| Hasło* | Hasło konta skrzynki powiązane z podaną nazwą użytkownika. |
| Adres serwera wysyłania* | Adres serwera SMTP wysyłającego wiadomości. |
| Port serwera wysyłania* | Port SMTP, zwykle 465 lub 587 zależnie od zabezpieczeń. |
| Zabezpieczenia SMTP | Protokół zabezpieczenia połączenia wychodzącego: SSL/TLS lub STARTTLS. |
| Protokół odbierania* | IMAP, zalecany, albo POP3. |
| Adres serwera odbierania* | Serwer poczty przychodzącej IMAP lub POP3. |
| Port serwera odbierania* | Port serwera przychodzącego, na przykład 993 dla IMAP lub 995 dla POP3. |
| Zabezpieczenia IMAP/POP3 | Szyfrowanie połączenia przychodzącego, zwykle SSL/TLS. |
| Adres e-mail* | Adres skrzynki obsługiwanej przez konfigurację. U większości dostawców musi odpowiadać danym logowania. |
| Dodatkowe adresy | Opcjonalne aliasy lub dodatkowe adresy tej samej skrzynki, które system ma obsługiwać. |
Po uzupełnieniu pól kliknij przycisk , aby zapisać konto.
Połączenie i aktywacja
Problemy z połączeniem powodują wyświetlenie błędu podczas zapisu, jak pokazano poniżej.
Po poprawnym zapisie wrócisz do listy kont, gdzie pojawi się nowa pozycja z informacjami o skrzynce.
Jeżeli podczas używania skrzynki wystąpi błąd połączenia, na przykład po zmianie hasła zewnętrznego konta, w kolumnie błędu pojawi się ikona ostrzeżenia .
Aktywuj konto przyciskiem . W razie potrzeby wyłączysz je przyciskiem .
Po dodaniu działającego konta przyciskiem można ręcznie wymusić pobranie wiadomości.
Wiadomości znajdziesz w sekcji wiadomości na karcie logów, gdzie można je przeglądać.
Do edycji lub usunięcia skrzynki służą przyciski i w kolumnie działań na liście kont.
OAuth2
OAuth2 zapewnia dostęp do skrzynki bez przechowywania hasła użytkownika w aplikacji. Wykorzystuje autoryzację oraz tokeny dostępu wydawane przez serwer uwierzytelniania dostawcy. Metodę tę zalecają dostawcy poczty, tacy jak Gmail i Yahoo.
UWAGA: zaleca się konfigurację w trybie prywatnym lub incognito przeglądarki. Na przykład ostatni etap konfiguracji Office 365 wymaga autoryzacji konta Microsoft. Jeśli przeglądarka jest już zalogowana do innego konta z opcją pozostania zalogowanym, na przykład przez Outlook lub OneDrive, system może użyć niewłaściwego konta do autoryzacji połączenia.
Wymagania połączenia OAuth2
Użytkownik lub administrator powinien:
- mieć aktywną skrzynkę u obsługiwanego dostawcy,
- zarejestrować aplikację Mint Service Desk u dostawcy poczty,
- uzyskać Client ID i Client Secret,
- ustawić poprawny Redirect URI wskazujący Mint Service Desk, widoczny w prawym górnym rogu karty OAuth2, na przykład https://mintsd.opgksoftware.com/admin/channels/accounts/create,
- włączyć wymagane usługi API, na przykład Gmail API,
- upewnić się, że w skrzynce działa IMAP, jeśli służy do odbierania poczty,
- sprawdzić, czy zapora i sieć nie blokują komunikacji pocztowej,
- udzielić zgody podczas autoryzacji w oknie przeglądarki.
Obsługę uwierzytelniania danymi logowania oraz parametry SMTP i IMAP poszczególnych dostawców opisano w części „Dane logowania” rozdziału o poczcie e-mail.
Wybierz OAuth2 jako typ autoryzacji. Parametry zostaną uzupełnione według wcześniej wybranego dostawcy. Przy opcji „Inny” trzeba wpisać je samodzielnie.
Poniższa tabela opisuje pola na przykładzie opcji Inny.
| Pole | Opis |
|---|---|
| Typ autoryzacji | Wybrana metoda, w tym przykładzie OAuth2. |
| Client ID* | Unikalny identyfikator aplikacji nadany przez dostawcę poczty, na przykład Google lub Yahoo. |
| Client Secret* | Sekret aplikacji używany do jej autoryzacji podczas wymiany tokenów. |
| Serwer autoryzacji* | Adres serwera odpowiedzialnego za logowanie użytkownika i wydanie kodu autoryzacyjnego. |
| Serwer tokenów dostępu* | Adres punktu końcowego wydającego token dostępu i token odświeżania. |
| Zakresy* | Uprawnienia żądane przez aplikację; muszą umożliwiać odczyt i wysyłanie poczty. |
| Adres serwera wysyłania* | Adres serwera SMTP poczty wychodzącej. |
| Port serwera wysyłania* | Port SMTP, zwykle 465 lub 587. |
| Zabezpieczenia SMTP | SSL/TLS lub STARTTLS dla połączenia wychodzącego. |
| Protokół odbierania* | IMAP, zalecany, albo POP3. |
| Adres serwera odbierania* | Adres serwera IMAP lub POP3 poczty przychodzącej. |
| Port serwera odbierania* | Port poczty przychodzącej, na przykład 993 dla IMAP. |
| Zabezpieczenia IMAP/POP3 | Zabezpieczenia połączenia przychodzącego, SSL/TLS. |
| Adres e-mail* | Adres użytkownika, którego skrzynka jest integrowana. |
| Dodatkowe adresy | Opcjonalne aliasy tego konta, jeśli także mają obsługiwać pocztę. |
Po zapisaniu ustawień adres przekierowania zmienia się z końcówki create na edit z konkretnym UUID. Ten dodatkowy adres należy dopisać w ustawieniach aplikacji u dostawcy używanego do konfiguracji OAuth2.
Office 365
WAŻNE!
Integracja IMAP/SMTP outlook.office.com z OAuth opiera się na starszym modelu, którego wsparcie jest ograniczone i stopniowo zawężane. Microsoft zaleca przejście na Microsoft Graph API w celu poprawy niezawodności, bezpieczeństwa i długoterminowej zgodności. Dalsze korzystanie z IMAP/SMTP OAuth może w przyszłych aktualizacjach skutkować ograniczeniem funkcji lub przerwami w działaniu usługi.
Poniżej opisano przykładową konfigurację. Zaleca się użycie trybu incognito przeglądarki zgodnie z uwagą w części OAuth2.
Rejestracja aplikacji
Najpierw zarejestruj aplikację. Otwórz https://portal.azure.com/ i zaloguj się. Wybierz rejestracje aplikacji z lewego menu, a następnie nową rejestrację.
Wpisz nazwę aplikacji. W obsługiwanych typach kont wybierz konta w dowolnym katalogu organizacyjnym Azure AD, czyli wariant wielodostępny, oraz osobiste konta Microsoft, na przykład Skype lub Xbox. W sekcji URI przekierowania wybierz typ Web i wklej adres z formularza tworzenia konta pocztowego.
Kliknij przycisk rejestracji.
Po rejestracji na stronie podsumowania skopiuj identyfikator aplikacji, czyli klienta.
Wklej go w polu Client ID w konfiguracji Mint.
Uprawnienia
Następnie otwórz uprawnienia API na pasku bocznym i wybierz dodawanie uprawnienia.
Wybierz Microsoft Graph.
Wybierz uprawnienia delegowane i zaznacz:
- IMAP.AccessAsUser.All
- SMTP.Send
- offline_access
Kliknij przycisk dodawania uprawnień.
Sekret klienta
Przejdź do certyfikatów i sekretów w lewym menu, a następnie dodaj nowy sekret klienta.
Uzupełnij opis i kliknij „Dodaj”.
Pamiętaj o włączeniu uwierzytelniania SMTP. Więcej informacji: https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission
Na stronie podsumowania skopiuj wartość sekretu. Po odświeżeniu strony pole zostanie ukryte.
Wklej wartość w polu Client Secret w konfiguracji MINT.
Zapis połączenia
Wybierz IMAP jako protokół odbierania i wpisz adres Microsoft Office 365, dla którego przygotowano konfigurację.
Kliknij „Zapisz”. Otworzy się formularz logowania Outlook. Jeśli dane są poprawne, system połączy się z Microsoft Office 365 przez OAuth2.
Po zapisaniu adres przekierowania zmienia się z końcówki create na edit z konkretnym UUID. Dopisz ten adres w ustawieniach aplikacji w portalu Azure lub innym portalu dostawcy OAuth2.
Przykładowy adres przekierowania może wyglądać następująco:
Uwaga:
Niektórzy dostawcy OAuth2 pozwalają wygenerować tylko jeden token odświeżania dla danej konfiguracji. Z tego powodu może pojawić się błąd połączenia ze skrzynką. W takim przypadku sprawdź dokumentację używanego dostawcy.
Rozwiązywanie problemów z połączeniem
Uwaga:
Jeśli mimo zastosowania powyższych ustawień nadal nie możesz połączyć skrzynki, poproś administratora aplikacji o wykonanie następujących kroków:
Krok 1: Przejdź do następującej sekcji w Microsoft Entra ID:
Strona główna > Zarządzanie > Aplikacje dla przedsiębiorstw (Home > Manage > Enterprise applications)
Następnie przejdź do Zabezpieczenia > Zgoda i uprawnienia (Security > Consent and permissions).
Krok 2: Skonfiguruj sekcję Ustawienia zgody użytkownika (User consent settings).
W sekcji Ustawienia zgody użytkownika może być konieczne wybranie opcji zezwalającej użytkownikom na wyrażanie zgody dla aplikacji od zweryfikowanych wydawców, w zakresie wybranych uprawnień (Allow user consent for apps from verified publishers, for selected permissions).
Krok 3: Sklasyfikuj uprawnienia.
W sekcji Klasyfikacje uprawnień > Klasyfikuj uprawnienia (Permission classifications > Classify permissions) administrator może potrzebować przypisać poniższym uprawnieniom poziom Niski (Low):
- offline_access
- IMAP.AccessAsUser.All
- SMTP.Send
Opisane rozwiązanie jest przykładem. Wymagane ustawienia mogą się różnić w zależności od polityk bezpieczeństwa i konfiguracji organizacji.
Microsoft Graph API
Po kliknięciu tego przycisku pojawi się formularz:
Rejestracja aplikacji
Otwórz https://portal.azure.com, zaloguj się i przejdź do usługi Microsoft Entra ID.
Otwórz aplikacje i rejestrację aplikacji.
Pojawi się poniższy formularz.
Uzupełnij go:
- W polu nazwy wpisz wybraną nazwę.
- Pozostaw domyślny wybór obsługiwanych typów kont.
- Dla adresu przekierowania wybierz typ Web.
Skopiuj identyfikator aplikacji, czyli klienta, oraz identyfikator katalogu, czyli dzierżawy.
Wklej je tutaj:
Uprawnienia API
Po rejestracji otwórz Zarządzaj → Uprawnienia API w lewym menu.
Kliknij przycisk i w panelu po prawej wybierz Microsoft Graph.
Z dwóch opcji wybierz uprawnienia aplikacji po prawej stronie.
W sekcji poczty wybierz poniższe opcje:
Zapisz uprawnienia przyciskiem .
Możesz napotkać poniższą sytuację:
Nadanie uprawnień odczytu, zapisu i wysyłania wymaga zgody administratora domeny. Zaleca się ograniczenie dostępu aplikacji Graph do potrzebnych adresów e-mail. Domyślnie uprawnienia obejmują całą domenę, czyli wszystkie jej skrzynki.
Polityka dostępu aplikacji
Aby skonfigurować politykę dostępu aplikacji i ograniczyć zakres uprawnień:
Połącz się z Exchange Online PowerShell:
- Aby wymagać podpisu zaufanego wydawcy dla skryptów PowerShell pobranych z internetu, uruchom poniższe polecenie w oknie Windows PowerShell otwartym jako administrator.
Set-ExecutionPolicy RemoteSigned
- Zainstaluj moduł ExchangeOnlineManagement do zarządzania Exchange Online.
Install-Module -Name ExchangeOnlineManagement
- Zaloguj się do Exchange Online PowerShell. Pojawi się okno logowania.
Connect-ExchangeOnline -UserPrincipalName {your-admin-account@your-domain.com}
Ustal identyfikator klienta aplikacji oraz grupę zabezpieczeń z obsługą poczty, do której ograniczysz dostęp. Identyfikator aplikacji znajdziesz w portalu rejestracji Azure. Utwórz grupę lub użyj istniejącej i ustal jej adres e-mail:
- Dostęp do centrum administracyjnego Exchange wymaga uprawnień administratora Microsoft 365. Szczegóły opisują uprawnienia Exchange Online.
- Zaloguj się do Microsoft 365 lub Office 365 kontem służbowym albo szkolnym i wybierz kafelek administratora.
- W centrum administracyjnym wybierz Centra administracyjne → Exchange.
- W centrum Exchange przejdź do Odbiorcy → Grupy.
- Wybierz Nowy → Grupy zabezpieczeń i uzupełnij wymagane pola.
Utwórz politykę dostępu aplikacji.
- Uruchom poniższe polecenie, zastępując argumenty AppId, PolicyScopeGroupId i Description.
- New-ApplicationAccessPolicy -AppId e7e4dbfc-046f-4074-9b3b 2ae8f144f59b -PolicyScopeGroupId EvenUsers@contoso.com -AccessRight RestrictAccess -Description “Restrict this app to members of distribution group EvenUsers.”
Uwaga: zmiany polityk dostępu aplikacji mogą zacząć działać w wywołaniach Microsoft Graph REST API dopiero po ponad godzinie.
Sekret klienta i zapis
Następnie przejdź do certyfikatów i sekretów.
Kliknij przycisk .
W wysuniętym panelu wpisz opis ułatwiający rozpoznanie sekretu. W polu wygaśnięcia pozostaw domyślne 6 miesięcy lub wybierz inny okres.
Zatwierdź przyciskiem .
Po zapisaniu skopiuj wartość sekretu.
Wartość sekretu klienta jest widoczna tylko bezpośrednio po utworzeniu. Zapisz ją przed opuszczeniem strony.
Wklej skopiowaną wartość w polu Client Secret w MINT.
Konfiguracja powinna wyglądać podobnie do poniższej:
Zapisz konfigurację skrzynki przyciskiem .
Reguły poczty
Ta sekcja służy do tworzenia listy blokowanych adresów e-mail, z których system nie będzie odbierał wiadomości.
Aby dodać adres, kliknij plus po prawej stronie głównego widoku.
Pojawi się małe okno z polem adresu do zablokowania.
Wpisz adres i kliknij „Utwórz”. Nowa pozycja pojawi się na liście.
Filtry wiadomości
Możesz utworzyć dowolną liczbę filtrów wiadomości przychodzących. Sprawdzają one treść poczty i po spełnieniu warunków kierują utworzone z niej zgłoszenia do odpowiedniej kolejki lub nadają im właściwy typ.
Warunki filtra
Aby utworzyć filtr, kliknij przycisk obok wyszukiwania po prawej stronie.
W formularzu kliknij przycisk pod drzewem warunków.
W nowym oknie wybierz rodzaj warunku.
Na początku dostępne są tylko warunki logiczne AND i OR. Wybierz odpowiedni i zapisz.
Ponownie kliknij i dodaj kolejny warunek, na przykład filtr wiadomości.
Pojawią się pola typu, operacji i wartości.
Typ określa sprawdzaną część wiadomości: treść, temat, nadawcę, odbiorcę lub konto skrzynki odbierającej.
Operacja określa sposób dopasowania: Contains (zawiera), StartsWith (zaczyna się od), EndsWith (kończy się na), IsEqual (jest równe), MatchPattern (pasuje do wzorca).
W polu wartości wpisz tekst, który ma zostać dopasowany.
Dla każdego kryterium można zaznaczyć rozróżnianie wielkości liter. W opisie konfiguracji jest ono powiązane z opcją zatrzymania po dopasowaniu.
Kolejne kryterium dodasz przyciskiem , a zbędny warunek usuniesz przyciskiem .
Działania po dopasowaniu
Panel poniżej określa, co ma się stać ze zgłoszeniem po dopasowaniu.
Nadaj filtrowi nazwę. Wybierz kolejkę i typ zgłoszenia tworzonego z wiadomości. Można też ustawić status, przypisanego agenta, priorytet i usługę. Po dopasowaniu zostaną zastosowane wskazane wartości.
Następnie możesz zaznaczyć zatrzymanie po dopasowaniu. Zgodnie z opisem opcji zaznacza się je, aby dopasować jedno lub kilka przygotowanych kryteriów z włączonym rozróżnianiem wielkości liter. Aby dopasować wszystkie kryteria, pozostaw opcję odznaczoną.
Pole aktywności u dołu formularza włącza lub wyłącza filtr. Ustawienie można później zmienić podczas edycji.
Zapisz filtr przyciskiem .
Przykłady łączenia warunków
Przykładowo chcemy kierować do kolejki Support wiadomości od customer1@mintsd.com ORAZ z tematem Support.
Tworzymy poniższą konfigurację z operatorem AND:
Wiadomość musi spełniać oba warunki, aby trafić do kolejki Support.
Teraz chcemy kierować do Support wiadomości od customer1@mintsd.com LUB z tematem Support.
Tworzymy konfigurację z operatorem OR:
Do kolejki trafi każda wiadomość spełniająca przynajmniej jeden z warunków.
W bardziej złożonym przykładzie wiadomość ma pochodzić od customer1@mintsd.com lub customer2@mintsd.com, a jednocześnie zawierać słowo Support zarówno w temacie, jak i treści.
Przygotowujemy poniższą konfigurację:
W ten sposób można budować coraz bardziej złożone warunki logiczne.
Edycja filtra
Filtr można zmienić przyciskiem albo usunąć przyciskiem . Aby zmienić zapisane drzewo warunków, włącz tryb edycji:
i potwierdź zamiar edycji w poniższym oknie.
Certyfikat
Na dole formularza tworzenia i edycji konta pocztowego znajduje się sekcja certyfikatu. Pozwala skonfigurować certyfikat klienta używany podczas komunikacji pocztowej do dodatkowego zabezpieczenia lub podpisywania wiadomości, zależnie od wymagań serwera.
Dostępne pola:
- Dodaj plik: certyfikat w formacie .pfx lub .p12, zawierający klucz prywatny i łańcuch certyfikatów potrzebne do uwierzytelniania lub podpisywania wiadomości.
- Hasło pliku certyfikatu: hasło do odszyfrowania i odczytania przesłanego pliku.
Konfiguracja jest opcjonalna i zwykle potrzebna, gdy:
- serwer pocztowy wymaga uwierzytelniania certyfikatem lub
- użytkownik potrzebuje podpisywania albo szyfrowania wiadomości wychodzących S/MIME.
Popularni publiczni dostawcy poczty, tacy jak Gmail, Yahoo i Office 365, zwykle nie wymagają certyfikatów klienta do logowania. Funkcja jest przeznaczona głównie dla serwerów firmowych lub lokalnych z dodatkowymi politykami bezpieczeństwa.