Skip to main content

Microsoft / Outlook dla poczty przychodzącej w AMODIT

Aktualizacja

Artykuł zweryfikowany dla wersji 260331.

Wprowadzenie

Ten artykuł jest dla administratora, który chce skonfigurować konto Microsoft / Outlook jako źródło wiadomości dla poczty przychodzącej w AMODIT.

Materiał obejmuje konfigurację skrzynki procesu dla dwóch najważniejszych wariantów:

  • EWS z serwerem outlook.office365.com,
  • IMAP z serwerem konta Microsoft / Outlook.

W obu przypadkach AMODIT odbiera wiadomości dla procesu, a następnie przetwarza je zgodnie z ustawieniami tworzenia spraw z maila albo dopasowywania wiadomości do spraw już istniejących.

Kiedy ten artykuł ma sens

Ten materiał jest właściwy wtedy, gdy:

  • organizacja korzysta z kont Microsoft 365, Outlook.com albo innej skrzynki z tej rodziny,
  • AMODIT ma odbierać wiadomości z tej skrzynki na potrzeby konkretnego procesu,
  • administrator chce użyć logowania OAuth,
  • skrzynka ma być powiązana z procesem, a nie tylko opisana ogólnie na poziomie ustawień systemowych.

Jeżeli szukasz ogólnego opisu poczty przychodzącej albo samych ustawień procesu, zacznij od artykułów obszarowych. Ten wpis pokazuje, jak zastosować te mechanizmy konkretnie dla kont Microsoft / Outlook.

Wymagania wstępne

Zanim zaczniesz, przygotuj:

  • konto pocztowe Microsoft / Outlook, którego AMODIT ma używać,
  • uprawnienia administratora do Ustawień systemowych,
  • dostęp do konfiguracji procesu,
  • możliwość zalogowania się do Microsoft w oknie OAuth,
  • jeżeli organizacja używa własnej aplikacji Azure:
    • identyfikator aplikacji,
    • sekret aplikacji,
    • poprawny adres przekierowania dla AMODIT.

Co trzeba ustawić

Konfiguracja Microsoft / Outlook dla poczty przychodzącej obejmuje dwa poziomy:

  1. wspólną konfigurację aplikacji OAuth po stronie systemu,
  2. konfigurację skrzynki powiązanej z konkretnym procesem.

Ustawienia systemowe decydują o tym, z jakiej konfiguracji aplikacji korzysta AMODIT. Ustawienia procesu określają natomiast, z jakiej skrzynki i jakim wariantem połączenia system ma odbierać wiadomości.

Krok 1. Przygotuj konfigurację aplikacji w Azure

Autoryzacja Microsoft dla skrzynek procesu korzysta ze wspólnej konfiguracji aplikacji zapisanej w parametrze AzureApplicationConfig.

Ten parametr jest potrzebny wtedy, gdy organizacja korzysta z własnej aplikacji zarejestrowanej w Azure i sama zarządza zgodami OAuth. W takiej sytuacji trzeba:

  1. zarejestrować aplikację w Azure,
  2. przygotować dane klienta i adres przekierowania,
  3. zapisać konfigurację w parametrze AzureApplicationConfig.

To jest wspólny punkt startowy dla wariantów Microsoft opartych o OAuth, więc najpierw trzeba przygotować aplikację, a dopiero potem przejść do konfiguracji skrzynki przy konkretnym procesie.

Krok 2. Ustal wariant połączenia dla skrzynki procesu

W tym materiale opisane są dwa warianty odbioru wiadomości:

  • EWS,
  • IMAP.

Wybór wariantu zależy od tego, jak organizacja udostępnia skrzynkę i jaki sposób połączenia ma być utrzymany dla procesu.

Wariant EWS

Wariant EWS stosuje się wtedy, gdy poczta przychodząca dla procesu ma korzystać z serwera outlook.office365.com przez usługi Exchange.

Uwaga: dla skrzynek Exchange Online jest to wariant przejściowy. Według aktualnej dokumentacji Microsoft wycofywanie Exchange Web Services w Exchange Online rozpocznie się w październiku 2026, a pełne wyłączenie jest planowane na kwiecień 2027. Dla nowych konfiguracji warto planować przejście na mechanizmy oparte o Microsoft Graph.

Ten wariant ma sens głównie wtedy, gdy organizacja już korzysta z takiego modelu połączenia i chce go utrzymać w istniejącej konfiguracji.

Wariant IMAP

Wariant IMAP stosuje się wtedy, gdy skrzynka Microsoft / Outlook ma być obsługiwana przez standardowy protokół odbioru poczty, ale z logowaniem OAuth zamiast zwykłego hasła.

W praktyce dotyczy to serwera Microsoft / Outlook rozpoznawanego przez AMODIT, na przykład:

  • imap-mail.outlook.com,
  • outlook.office365.com,
  • adresu zawierającego outlook.com.

Ten wariant ma sens wtedy, gdy organizacja pozostaje przy modelu IMAP, ale chce logować skrzynkę procesu przez token.

Krok 3. Ustaw wspólną konfigurację poczty przychodzącej

W Ustawieniach systemowych, w sekcji Poczta przychodząca, ustaw wariant zgodny z wybranym sposobem odbioru:

  • dla EWS:
    • Protocol = EWS,
    • Server name or IP = outlook.office365.com,
  • dla IMAP:
    • Protocol = IMAP,
    • Server name or IP = serwer skrzynki Microsoft / Outlook używany w organizacji.

Ta konfiguracja jest ważna, ponieważ od niej zależy, jaki sposób logowania AMODIT udostępni później w ustawieniach procesu.

Krok 4. Powiąż skrzynkę z procesem

Ustawienia są dostępne w konfiguracji procesu, w zakładce Tworzenie spraw, w sekcji Tworzenie spraw na podstawie maila, w bloku Powiązana skrzynka mailowa.

W tym miejscu administrator:

  • wpisuje login skrzynki,
  • wskazuje folder, z którego mają być odbierane wiadomości,
  • generuje token OAuth,
  • zapisuje konfigurację procesu.

Po poprawnym zalogowaniu do Microsoft token zostaje wpisany do pola E-mail hasło. W tym scenariuszu pole to przechowuje dane autoryzacji OAuth, a nie zwykłe hasło użytkownika.

Krok 5. Wygeneruj token OAuth dla procesu

Po ustawieniu właściwego wariantu połączenia AMODIT pokazuje akcję generowania tokenu OAuth dla skrzynki procesu.

W tym miejscu:

  1. wpisz login skrzynki Microsoft / Outlook,
  2. użyj akcji generowania tokenu,
  3. zaloguj się na właściwe konto Microsoft,
  4. zaakceptuj wymagane zgody,
  5. zapisz konfigurację procesu.

Po poprawnym zakończeniu tego kroku proces ma już własny token i może używać tej skrzynki do odbioru wiadomości.

Weryfikacja

Po poprawnej konfiguracji:

  • proces zapisuje dane skrzynki Microsoft / Outlook,
  • w konfiguracji procesu jest dostępna akcja generowania tokenu OAuth,
  • token zostaje zapisany przy skrzynce procesu,
  • system może odbierać wiadomości zgodnie z wybranym wariantem połączenia.

Typowe problemy

Nie widać akcji generowania tokenu OAuth dla procesu

Najpierw sprawdź:

  • czy w ustawieniach systemowych wybrano właściwy protokół,
  • czy serwer odpowiada wybranemu wariantowi Microsoft / Outlook,
  • czy konfigurujesz skrzynkę na poziomie procesu, a nie tylko na poziomie systemowym.

Logowanie do Microsoft kończy się błędem

W takiej sytuacji trzeba sprawdzić zgodność trzech elementów:

  • konfiguracji aplikacji w AzureApplicationConfig,
  • adresu przekierowania wpisanego po stronie Microsoft,
  • rzeczywistego adresu AMODIT używanego przy generowaniu tokenu.

Organizacja planuje nowe wdrożenie dla Microsoft 365

Jeżeli skrzynka działa w Exchange Online, nie warto planować nowej konfiguracji opartej o EWS jako wariantu docelowego. W takim przypadku lepiej od razu przygotować przejście na mechanizmy oparte o Microsoft Graph.

Wynik końcowy

Po wykonaniu tej konfiguracji AMODIT potrafi odbierać wiadomości z konta Microsoft / Outlook dla konkretnego procesu i przetwarzać je zgodnie z ustawieniami poczty przychodzącej oraz tworzenia spraw z maila.

Powiązane artykuły