Skip to main content

Konfiguracja wysylki przez SMTP

Aktualizacja

Artykuł zweryfikowany dla linii 251231.

Wprowadzenie

Ten artykuł jest dla administratora, który chce skonfigurować wysyłkę wiadomości przez SMTP w AMODIT. Po lekturze powinno być jasne, które pola odpowiadają za samo połączenie z serwerem SMTP, które ustawienia są wspólne dla całej poczty wychodzącej i kiedy trzeba sprawdzić także osobną skrzynkę nadawczą.

Wymagania wstępne

Zanim zaczniesz, przygotuj:

  • adres serwera SMTP,
  • port i wymagany tryb połączenia po stronie dostawcy poczty,
  • login i hasło do konta wysyłkowego albo token OAuth, jeżeli dostawca tego wymaga,
  • docelowy adres nadawcy, który ma być widoczny dla odbiorców,
  • poprawny adres AMODIT używany w linkach z wiadomości,
  • uprawnienia administratora do Ustawień systemowych.

Jeżeli w Twojej organizacji część wiadomości ma wychodzić z innych adresów niż jeden globalny nadawca, przygotuj też listę takich skrzynek. W takim wariancie sama konfiguracja globalna SMTP może nie wystarczyć.

Instrukcja krok po kroku

  1. Otwórz Ustawienia systemowe i przejdź do sekcji Ogólne > Powiadomienia.
    W tym miejscu znajdziesz zarówno ustawienia samego połączenia SMTP, jak i pola wspólne dla całej poczty wychodzącej.

  2. Ustaw mechanizm wysyłki na SMTP.
    To właściwy wybór wtedy, gdy Twoja organizacja udostępnia serwer lub relay SMTP do wysyłki wiadomości z AMODIT.

  3. Uzupełnij pole Notification server name or IP wartością serwera SMTP.
    To podstawowy adres, pod który AMODIT łączy się przy wysyłce. Jeżeli będzie błędny, wiadomości nie wyjdą z systemu.

  4. Uzupełnij pola User i Password danymi konta wysyłkowego.
    Większość serwerów SMTP wymaga uwierzytelnienia. W części środowisk Password może oznaczać hasło aplikacyjne, a nie zwykłe hasło użytkownika.

  5. Ustaw Use SSL? i Port zgodnie z wymaganiami dostawcy poczty.
    W linii 251231 punkt startowy to Use SSL? = true i Port = 587. Zwykle 587 oznacza połączenie z negocjowanym TLS, a 465 jest używany dla implicit SSL.

  6. Uzupełnij pole Sender mail adress adresem, który ma być widoczny dla odbiorców.
    To ten adres odbiorca zobaczy jako nadawcę wiadomości. Nie jest to parametr samego połączenia SMTP, ale ma duży wpływ na odbiór wiadomości.

  7. Sprawdź ustawienia linków używanych w mailach wychodzących.
    Sprawdź przede wszystkim Web URL for internal users, adres dla użytkowników zewnętrznych i ustawienie UseCurrentWebUrl. Poprawne SMTP nie wystarczy, jeżeli wiadomość prowadzi użytkownika pod zły adres.

  8. Ustal podstawowe zasady pracy kolejki wychodzącej.
    Zwróć uwagę na Sending limit, Delete notifications older than [X] days, Log emails sent with the SendMessage function i listę kodów pomijanych przy ponownej wysyłce. Te ustawienia wpływają na zachowanie kolejki po błędzie i przy większej liczbie wiadomości.

  9. Jeżeli korzystasz z Gmail albo Outlook z OAuth, sprawdź także wariant logowania przez token.
    To ważne wtedy, gdy dostawca nie akceptuje już klasycznego hasła albo wymaga XOAUTH2. W takim scenariuszu warto też zweryfikować ustawienie ForceSMTPClientEx.

  10. Jeżeli część wiadomości ma wychodzić z innego adresu niż globalny nadawca, sprawdź konfigurację skrzynek nadawczych.
    Dla adresu, który ma własną skrzynkę, system może użyć jej własnych ustawień serwera, loginu, hasła, SSL i portu zamiast konfiguracji globalnej. Możesz więc mieć globalne SMTP dla powiadomień systemowych i osobną skrzynkę dla konkretnego działu lub procesu.

  11. 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 w logach nie pojawił się błąd połączenia albo uwierzytelnienia.

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,
  • przy kolejnych wysyłkach nie pojawiają się błędy połączenia, portu ani uwierzytelnienia.

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

  1. czy mechanizm wysyłki nadal jest ustawiony na SMTP,
  2. czy serwer, port i tryb SSL odpowiadają wymaganiom dostawcy,
  3. czy konto wysyłkowe rzeczywiście może logować się w wybranym trybie,
  4. czy finalny adres nadawcy nie ma własnej skrzynki nadawczej, która nadpisuje ustawienia globalne.

Wynik końcowy

Po wykonaniu tej konfiguracji AMODIT wysyła wiadomości przez SMTP z użyciem poprawnego serwera, portu i uwierzytelnienia, a odbiorca dostaje je z właściwego adresu i z poprawnymi linkami.

Ważne informacje i ostrzeżenia

  • Nie utożsamiaj całej poczty wychodzącej z samym SMTP. Część ustawień z tej samej sekcji wpływa na nadawcę, linki albo zachowanie kolejki, ale nie jest transportem.
  • Jeżeli wiadomość wychodzi z innego adresu niż globalny Sender mail adress, sprawdź najpierw, czy ten adres nie ma własnej skrzynki nadawczej.
  • Port 587 i Use SSL? nie oznaczają dokładnie tego samego scenariusza co port 465. Przy problemach z połączeniem sprawdzaj zawsze oba pola razem.
  • Jeżeli środowisko wymaga OAuth dla Gmail albo Outlook, klasyczne hasło może nie wystarczyć.
  • ForceSMTPClientEx jest ustawieniem technicznym. Zmieniaj je świadomie, zwykle wtedy, gdy wymaga tego konkretny scenariusz połączenia lub autoryzacji.

Typowe problemy

Wiadomość nie wychodzi mimo poprawnego serwera

Najczęstsze przyczyny:

  • zły port,
  • niezgodny tryb SSL,
  • błędny login lub hasło,
  • dostawca wymaga OAuth zamiast klasycznego hasła.

Wiadomość wychodzi z innego adresu niż oczekiwany

Najpierw sprawdź:

  • Sender mail adress,
  • finalny adres nadawcy użyty w danym scenariuszu,
  • konfigurację osobnej skrzynki nadawczej dla tego adresu.

Wiadomość dochodzi, ale link prowadzi pod zły adres

To zwykle nie jest problem SMTP. Sprawdź ustawienia adresów bazowych dla linków w wiadomościach.

Powiązane artykuły