Konfiguracja wysylki przez EWS

Aktualizacja2 kwietnia 2026

Artykuł zweryfikowany dla linii 251231.

Wprowadzenie

Ten artykuł jest dla administratora, który chce skonfigurować wysyłkę wiadomości przez EWS w AMODIT. Po lekturze powinno być jasne, jak wybrać EWS jako mechanizm outgoing, które pola odpowiadają za host i autoryzację, jak działa wariant z OAuth i dlaczego EWS nie korzysta z override przez mailbox.

Wymagania wstępne

Zanim zaczniesz, przygotuj:

adres serwera Exchange lub Microsoft 365, z którego AMODIT ma korzystać przy EWS,
konto, które ma prawo wysyłać wiadomości w tym środowisku,
login i hasło albo token OAuth, jeśli środowisko wymaga logowania przez Microsoft,
adres nadawcy, który ma być widoczny dla odbiorców,
poprawne adresy AMODIT używane w linkach z wiadomości,
uprawnienia administratora do Ustawień systemowych.

Jeśli wiadomości mają wychodzić z adresu skrzynki współdzielonej, przygotuj też potwierdzenie, że konto używane przez AMODIT ma prawo wysyłki z tego adresu. Bez tego sama konfiguracja w AMODIT może być poprawna, a wysyłka nadal zakończy się błędem.

Krótki przykład: administrator ustawia jako nadawcę faktury@firma.pl, ale do logowania używa konta technicznego amodit-service@firma.pl. Taka konfiguracja zadziała tylko wtedy, gdy środowisko Exchange lub Microsoft 365 pozwala temu kontu wysyłać z adresu faktury@firma.pl.

Instrukcja krok po kroku

Otwórz Ustawienia systemowe i przejdź do sekcji Ogólne > Powiadomienia.
W tym miejscu znajdziesz ustawienia mechanizmu wysyłki oraz pola wspólne dla całej poczty wychodzącej.
Ustaw mechanizm wysyłki na EWS.
To właściwy wybór wtedy, gdy Twoje środowisko ma wysyłać wiadomości przez Exchange lub Microsoft 365, a nie przez klasyczny serwer SMTP.
Uzupełnij pole Notification server name or IP adresem serwera Exchange.
Wpisz host usługi EWS, na przykład nazwę serwera Exchange. Na tej podstawie system sam zbuduje właściwy adres połączenia.
Uzupełnij pole User kontem, które ma być używane do wysyłki przez EWS.
To konto odpowiada za logowanie i ma wpływ na to, czy środowisko Microsoft dopuści wysyłkę z wybranego adresu nadawcy.
Ustal, czy Twoje środowisko używa hasła, czy tokenu OAuth.
W wariancie podstawowym wpisz sekret do pola Password. Jeżeli środowisko pracuje na logowaniu Microsoft OAuth, wygeneruj token przez Generate OAuth token dla parametru EWSNotificationOAuthToken. Gdy token jest ustawiony, system korzysta z niego zamiast zwykłego hasła.
Ustaw Use SSL? zgodnie z wymaganiami środowiska Exchange.
To pole decyduje, czy system buduje adres EWS z https://, czy z http://. Przy błędnym ustawieniu wysyłka nie połączy się z właściwą usługą.
Potraktuj pole Port jako ustawienie wspólne dla outgoing, a nie główny parametr EWS.
W tym wariancie najważniejsze są host, autoryzacja i ustawienie Use SSL?. Sam port nie jest tu podstawowym elementem konfiguracji transportu.
Uzupełnij pole Sender mail adress adresem, który ma być widoczny dla odbiorców.
To ten adres odbiorca zobaczy jako nadawcę wiadomości. Jeżeli należy on do shared mailbox albo innej skrzynki niż konto logujące, środowisko Microsoft musi pozwalać na wysyłkę z tego adresu.
Sprawdź ustawienia linków używanych w mailach wychodzących.
Zwróć uwagę na Web URL for internal users, adres dla użytkowników zewnętrznych i ustawienie UseCurrentWebUrl. Poprawne EWS nie wystarczy, jeżeli wiadomość prowadzi użytkownika pod zły adres.
Ustal podstawowe zasady pracy kolejki wychodzącej.
Sprawdź Sending limit, Delete notifications older than [X] days, Log emails sent with the SendMessage function i listę kodów błędów pomijanych przy ponownej wysyłce. Te ustawienia nie są samym EWS, ale wpływają na zachowanie systemu po błędzie i przy większej liczbie wiadomości.
Zapisz ustawienia i wykonaj rzeczywisty test wysyłki.
Po teście sprawdź, czy wiadomość wyszła, czy odbiorca widzi właściwy adres nadawcy, czy link prowadzi do poprawnego adresu AMODIT i czy środowisko Exchange zaakceptowało wysyłkę z wybranego adresu.

Weryfikacja

Po poprawnej konfiguracji:

wiadomość testowa wychodzi bez błędu,
odbiorca widzi właściwy adres nadawcy,
linki w treści prowadzą do poprawnego środowiska,
logi nie pokazują błędu autoryzacji ani odrzucenia nadawcy przez Exchange.

Jeśli system nadal nie wysyła wiadomości, sprawdź najpierw:

czy mechanizm wysyłki na pewno jest ustawiony na EWS,
czy host Exchange jest poprawny,
czy Use SSL? odpowiada temu, jak działa usługa EWS w Twoim środowisku,
czy konto logujące ma prawo wysyłać z adresu ustawionego jako nadawca,
czy używany sekret jest właściwym hasłem lub aktualnym tokenem OAuth.

Wynik końcowy

Po wykonaniu tej konfiguracji AMODIT wysyła wiadomości przez EWS, korzystając z poprawnego hosta Exchange, właściwej autoryzacji i adresu nadawcy, który jest akceptowany przez środowisko Microsoft.

Ważne informacje i ostrzeżenia

Nie traktuj EWS jako odmiany SMTP. To osobny transport, mimo że korzysta z części historycznie nazwanych pól.
Dla EWS najważniejsze są host, autoryzacja i uprawnienia do nadawcy. Pole Port nie jest tu głównym elementem konfiguracji.
mailbox nie nadpisuje transportu EWS. Ten wyjątek dotyczy ścieżki SMTP, nie EWS.
Jeśli używasz shared mailbox, kluczowe są uprawnienia po stronie Exchange lub Microsoft 365, a nie dodatkowa konfiguracja skrzynki w AMODIT.
Przy OAuth pamiętaj, że wygaśnięcie albo cofnięcie tokenu może zatrzymać wysyłkę mimo pozornie poprawnych ustawień hosta i użytkownika.

Typowe problemy

Wiadomość nie wychodzi mimo poprawnego hosta

Najczęstsze przyczyny:

zły schemat połączenia wynikający z Use SSL?,
niewłaściwy login lub sekret,
nieważny token OAuth,
brak dostępu do usługi EWS.

Wiadomość nie wychodzi z wybranego adresu

Najpierw sprawdź:

Sender mail adress,
konto używane do logowania,
uprawnienia do wysyłki z tego adresu po stronie Exchange.

Problem jest szukany w `mailbox`, a konfiguracja dotyczy `EWS`

W tym wariancie punkt diagnostyczny jest inny. Dla EWS sprawdzaj przede wszystkim host usługi, autoryzację, ustawienie Use SSL? i uprawnienia do adresu nadawcy.