Postmark Integration

Postmark Integration łączy natywną pocztę PrestaShop z SMTP Postmark i zapisuje zdarzenia Bounce oraz SpamComplaint dla wybranego sklepu. Dokumentacja opisuje token serwera, ręczną konfigurację DNS, wysyłkę i raport zdarzeń.

Szybki start

1. Wgraj ZIP przez menedżer modułów i zainstaluj Postmark Integration.
2. Otwórz konfigurację pojedynczego sklepu. Kontekst grupy i wszystkich sklepów jest odrzucany.
3. Przygotuj istniejący serwer Postmark z włączonym SMTP i aktywnym transakcyjnym strumieniem outbound. Skonfiguruj uwierzytelnienie nadawcy w Postmark dla adresu wysyłkowego sklepu.
4. Opublikuj wpisy DNS podane przez Postmark u swojego dostawcy, także w Cloudflare. Moduł nie publikuje wpisów DNS.
5. Zapisz token serwera, zweryfikuj połączenie i włącz SMTP. Webhook zwrotów skonfiguruj osobno; nie jest warunkiem aktywacji.
6. Uruchom mail testowy i sprawdź oddzielnie jego wynik oraz skrzynkę pracownika, który uruchamia test.
7. Przetestuj także zwykłe powiadomienie sklepu z jego szablonem i nadawcą.

Funkcje

• Prosty początek. Token serwera Postmark łączy istniejący serwer wysyłkowy.
• Sprawdzanie DNS. Zapytania DNS sprawdzają politykę DMARC domeny nadawcy i CNAME Return-Path.
• Ręczne wpisy DNS. Skopiuj wpisy domeny z Postmark do swojego dostawcy DNS.
• Wiadomości sklepu. PrestaShop nadal przygotowuje maile o zamówieniach i kontach, a Postmark je wysyła.
• Informacja o problemach. Zwroty i zgłoszenia spamu trafiają do panelu.
• Test i kontrola. Test natywnej wysyłki oraz przywracanie zapisanych ustawień pomagają zarządzać zmianą.

Opcje konfiguracji

Token konta i nadawca

Połączenie wymaga tokenu API serwera Postmark z istniejącego serwera. Domena do sprawdzania DNS pochodzi z efektywnego PS_SHOP_EMAIL wybranego sklepu. Dla strony shop.example.com wysyłającej jako zamowienia@example.com jest to example.com. Poprawny adres nadawcy jest więc częścią konfiguracji.

Samodzielnie wpisz token serwera. Sekret odbioru zdarzeń jest generowany podczas konfiguracji webhooka. Zastąpienie lub usunięcie tokenu najpierw przywraca nadal zarządzane natywne ustawienia poczty i zeruje status weryfikacji oraz webhooka; ponownie zweryfikuj i aktywuj połączenie. Zmiana domeny adresu sklepu nie wyłącza automatycznie SMTP.

DNS i aktywacja

Wpisy DNS publikujesz ręcznie u każdego dostawcy, także w Cloudflare. Pobierz wpisy domeny nadawcy z Postmark i opublikuj je u swojego dostawcy DNS. Moduł nie ma połączenia z Cloudflare ani funkcji edycji DNS.

Weryfikacja sprawdza dostępność SMTP i aktywny transakcyjny strumień outbound. Zapytania DNS odczytują DMARC i Return-Path, bez sprawdzania statusu weryfikacji domeny w Postmark. Polityka DMARC quarantine lub reject bez pasującego Return-Path wymaga Twojego potwierdzenia weryfikacji domeny w Postmark przed aktywacją. Webhook konfiguruje się osobno. Dezaktywacja przywraca wartości należące do integracji. Raport obejmuje zdarzenia i zachowane sumy wybranego sklepu.

Przykłady dostosowania

Domena u innego dostawcy

Schemat pokazuje rodzaje wpisów. Rzeczywiste nazwy i wartości trzeba pobrać z konfiguracji swojej domeny w Postmark:

TXT   <selektor>._domainkey.example.com   <wartosc DKIM z Postmark>
CNAME pm-bounces.example.com             pm.mtasv.net

Selektor i wartość DKIM to symbole zastępcze. Edytor DNS może wymagać pełnej nazwy lub tylko części przed nazwą strefy. CNAME Return-Path musi działać jako DNS only, bez proxy. Moduł nie generuje polityk SPF i DMARC; przykład nie zastępuje Twoich istniejących wpisów.

Dotychczasowe szablony

Treść potwierdzeń zamówień i wiadomości konta nadal powstaje w PrestaShop. Nie trzeba odtwarzać jej jako szablonów Postmark. Moduł z własnym niezależnym transportem nie przechodzi automatycznie na natywny serwer sklepu.

Zachowanie późniejszych zmian

Wyłączenie połączenia odtwarza tylko wartości nadal zgodne z zapisanymi przez integrację. Późniejsza zmiana sprzedawcy pozostaje zachowana. Następna aktywacja zapisuje jako punkt wyjścia bieżącą konfigurację.

Instalacja

Wymagania

• Ogólny zakres: PS 1.6 – 9.x. Dokładne deklarowane minimum: PrestaShop 1.6.1.0.
• PHP od 7.1, w wersji odpowiedniej dla używanego PrestaShop.
• Rozszerzenia PHP cURL i JSON. Wywołania API mają limit 5 sekund na połączenie i 20 sekund łącznie.
• Konto Postmark, istniejący serwer z SMTP i aktywnym transakcyjnym strumieniem outbound oraz token tego serwera. Usługa ma własne płatne plany, moduł jest darmowy.
• Poprawny adres nadawcy sklepu, dostęp do DNS domeny i publicznie dostępny adres HTTPS odbioru zdarzeń.
• Wpisy uwierzytelnienia nadawcy publikuj ręcznie u dostawcy DNS, także w Cloudflare.

Odczyt wymaga dostępu pracownika do sklepu i prawa podglądu, a zmiana dodatkowo prawa edycji. Ukryj sekrety na zrzutach ekranu. W multistore konfiguruj i sprawdzaj konkretny sklep, zamiast zakładać wspólną aktywację wszystkich sklepów.

Jak to działa

Zapis tokenu serwera, sprawdzenie serwera i strumienia outbound, aktywacja natywnego SMTP, konfiguracja webhooka i mail testowy to osobne działania. Moduł korzysta z wysyłki sklepu i uwierzytelnionego odbioru zdarzeń.

Postmark Integration porządkuje wysyłkę ważnych wiadomości

Postmark Integration kieruje wiadomości już przygotowywane przez sklep do usługi wysyłki transakcyjnej Postmark. Samodzielnie skonfiguruj uwierzytelnienie nadawcy w Postmark, a następnie połącz sklep tokenem istniejącego serwera. Zachowujesz treści tworzone przez PrestaShop, a w panelu odnajdujesz informacje o zwrocie lub zgłoszeniu wiadomości jako spam. Masz punkt wyjścia do sprawdzenia problemu, gdy klient czeka na potwierdzenie zamówienia.

Cloudflare publikuje wpisy uwierzytelniające nadawcę

Opublikuj ręcznie w Cloudflare wpisy domeny nadawcy z Postmark. CNAME Return-Path pozostaw w trybie DNS only. Moduł nie edytuje DNS w Cloudflare i nie sprawdza w Postmark statusu weryfikacji domeny. Jego zapytania DNS dotyczą domeny adresu wysyłkowego sklepu, która nie musi odpowiadać adresowi strony.

Inny dostawca domeny oznacza ręczne dodanie wpisów

Wpisy z konfiguracji swojej domeny w Postmark dodaj w edytorze DNS dostawcy. Publikacja jest ręczna u każdego dostawcy. Moduł nie podaje wartości DKIM ani nie publikuje wpisów.

Treść i wygląd maili nadal przygotowuje PrestaShop

PrestaShop nadal składa wiadomość, jej układ i załączniki. Moduł zmienia ustawienia wysyłki na Postmark, bez tworzenia nowych szablonów. Powiadomienia innych modułów korzystają z tej samej drogi, jeśli używają natywnej poczty PrestaShop. Nie trzeba odtwarzać dotychczasowego potwierdzenia zamówienia w innym edytorze.

Raport zwrotów i zgłoszeń spamu jest dostępny w panelu

Panel pokazuje zwroty oraz zgłoszenia spamu przekazane przez Postmark, wraz z odbiorcą, czasem i identyfikatorem wiadomości. Zespół ma konkretny zapis do sprawdzenia, gdy klient zgłasza brak oczekiwanego maila. Dodatnia odpowiedź przy wysyłce nie zastępuje informacji o późniejszym problemie.

Test sprawdza drogę wysyłki sklepu

Test korzysta z natywnej poczty PrestaShop i szablonu testowego modułu. Jest adresowany do pracownika uruchamiającego test i przechodzi przez sklepową drogę wysyłki. Odpowiedź otrzymana podczas wysyłania oraz wiadomość odnaleziona w skrzynce to dwie odrębne rzeczy do sprawdzenia.

Natywne wartości i śledzenie

Aktywacja zapisuje PS_MAIL_METHOD=2, PS_MAIL_SERVER=smtp.postmarkapp.com i port 587. Zapisany token serwera służy jako login oraz hasło. PrestaShop 1.6 do 8 używa tls, a PrestaShop 9 natywnej wartości off, aby umożliwić automatyczny STARTTLS. To nie oznacza zamierzonej wysyłki bez szyfrowania.

Od PrestaShop 1.7.6 moduł dodaje brakujące nagłówki X-PM-KeepID: true, X-PM-TrackOpens: false i X-PM-TrackLinks: None. Istniejące jawne wartości są zachowane. Starsze wersje korzystają z ustawień serwera. Weryfikacja ostrzega o włączonym śledzeniu na serwerze, ale nie zmienia tych ustawień.

Zdarzenia i domena From

Uwierzytelnione zdarzenie musi pasować do zapisanego serwera i strumienia outbound. Bounce i SpamComplaint są normalizowane i deduplikowane. Raport pokazuje 30 ostatnich zdarzeń oraz zachowane sumy z czasem UTC, odbiorcą, identyfikatorem zdarzenia i Message-ID.

Od PrestaShop 1.7.6 końcowy hook wiadomości sprawdza zapisany stan aktywacji oraz to, czy natywna metoda i serwer poczty używają Postmark, zanim doda nagłówki. Nie weryfikuje domeny From ani nie sprawdza ponownie gotowości serwera lub danych SMTP przy każdej wiadomości. Samodzielnie sprawdź uprawnienia nadawcy w Postmark.

Rzeczywiste ograniczenia

Przyjęcie wiadomości i odbiór

Dodatnia odpowiedź natywnej wysyłki oznacza przyjęcie do wysyłki. Nie potwierdza odbioru ani umieszczenia w odebranych. Uwierzytelnienie domeny nie wyłącza filtrów odbiorcy. Nie deklarujemy procentowej dostarczalności ani certyfikacji Gmail lub Outlook.

Test wywołuje natywne Mail::Send synchronicznie i trafia do pracownika, który go uruchamia. Nie ma osobnego procesu CLI, limitu czasu wysyłki narzuconego przez moduł ani automatycznego ponowienia. W razie błędu sprawdź natywne ustawienia poczty i diagnostykę. Zwykła wysyłka nadal korzysta z natywnej poczty.

Zakres i dane

Obsługiwany jest wyłącznie domyślny transakcyjny outbound przez natywną pocztę. Nie ma tu kampanii newsletterowych, wysyłki masowej, wyboru własnego strumienia, edytora szablonów ani ponawiania zwróconych maili. Niezależne transporty rozszerzeń pozostają poza zakresem.

Zwroty i zgłoszenia zawierają dane osobowe, w tym adresy odbiorców i identyfikatory wiadomości. Zdarzenia nie zawierają treści maila; moduł zapisuje pola znormalizowane zamiast surowego MIME. Skonfigurowany webhook nie ma wyzwalaczy Open ani Click. Śledzenie wiadomości może nadal zależeć od ustawień serwera lub istniejących nagłówków. Nie oznacza to braku transferu danych: Postmark otrzymuje wiadomości przeznaczone do wysłania.

Sekrety są przechowywane po stronie serwera i niewidoczne w bezpiecznym podglądzie. Nie deklarujemy szyfrowania aplikacyjnego danych dostępu. Moduł nie zmienia zgód newsletterowych i nie odblokowuje automatycznie odbiorców w Postmark.

Domena i przywracanie

Skonfiguruj DKIM i Return-Path w Postmark i samodzielnie opublikuj ich wpisy DNS. Moduł nie tworzy ani nie naprawia całej polityki SPF/DMARC, nie publikuje DNS i nie sprawdza w Postmark statusu weryfikacji domeny.

Przywracanie zachowuje zmiany sprzedawcy i nie usuwa zdalnych zasobów Postmark. Moduł nie zmienia natywnych treści ani załączników, ale nie gwarantuje zachowania ich bajt po bajcie podczas późniejszego przetwarzania przez dostawcę.

Rozwiązywanie problemów

• Ostrzeżenie DNS: sprawdź uwierzytelnienie nadawcy w Postmark i opublikuj jego dokładne wpisy u dostawcy DNS. CNAME Return-Path pozostaw bez proxy.
• Odrzucony nadawca: sprawdź, czy rzeczywisty nadawca sklepu lub modułu jest autoryzowany w Postmark. Sam adres strony nie wyznacza nadawcy.
• Test przyjęty, brak maila: sprawdź skrzynkę pracownika, spam i dostępne zdarzenia. Pusty raport nie dowodzi odbioru.
• Brak zdarzeń: sprawdź publiczny HTTPS i przekazywanie nagłówka uwierzytelniającego. Otwarcie adresu w przeglądarce nie jest poprawnym zdarzeniem.
• Ręczna zmiana poczty: sprawdź natywne ustawienia i stan połączenia. Przywracanie zachowuje zmiany sprzedawcy.
• Błąd dostępu: rozwiąż wskazany problem z tokenem serwera, SMTP lub strumieniem outbound. Lokalna dezaktywacja działa bez odpowiedzi usługi Postmark.