Przejdź do treści

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

DostawcaObsługa danych logowaniaUwagi
GmailOgraniczonaWymagane hasło aplikacji i włączony IMAP. Zwykłe hasło konta nie działa przy włączonym 2FA.
YahooTakPo włączeniu 2FA wymagane jest hasło aplikacji.
Microsoft Office 365OgraniczonaUwierzytelnianie Basic Auth przez IMAP/SMTP może być wyłączone polityką organizacji. Działa tylko wtedy, gdy nadal jest włączone.
Microsoft Graph APINieObsługuje tylko OAuth2. IMAP/SMTP z hasłem użytkownika nie są dostępne.

Ustawienia SMTP

Parametry serwera SMTP przy uwierzytelnianiu danymi logowania

DostawcaSerwer SMTPPort SMTPZabezpieczenia SMTP
Gmailsmtp.gmail.com465SSL/TLS
Yahoosmtp.mail.yahoo.com465SSL/TLS
Microsoft Office 365smtp.office365.com587STARTTLS
Microsoft Graph API———

Ustawienia IMAP

Parametry serwera IMAP przy uwierzytelnianiu danymi logowania

DostawcaSerwer IMAPPort IMAPZabezpieczenia IMAP
Gmailimap.gmail.com993SSL/TLS
Yahooimap.mail.yahoo.com993SSL/TLS
Microsoft Office 365outlook.office365.com993SSL/TLS
Microsoft Graph API———

Konfiguracja konta

Poniższy zrzut przedstawia pola wymagane dla uwierzytelniania danymi logowania w Mint Service Desk.

Opis pól:

PoleOpis
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 SMTPProtokół 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/POP3Szyfrowanie 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 adresyOpcjonalne 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.

PoleOpis
Typ autoryzacjiWybrana 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 SMTPSSL/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/POP3Zabezpieczenia połączenia przychodzącego, SSL/TLS.
Adres e-mail*Adres użytkownika, którego skrzynka jest integrowana.
Dodatkowe adresyOpcjonalne 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.