Każdy e-mail powiąż ze zweryfikowanym zdarzeniem biznesowym, a nie z dowolnym zapisem zamówienia. Określ odbiorcę, cel, wymagane dane i warunek ponownej wysyłki. Szablony modyfikuj w minimalnym zakresie, testuj na rzeczywistych statusach i nigdy nie umieszczaj w wiadomości notatek wewnętrznych, tajnych tokenów ani zbędnych danych osobowych. Język wiadomości zapisuj razem z zamówieniem.
Transakcyjne e-maile WooCommerce potwierdzają zamówienie, zmianę statusu, zwrot środków lub inne zdarzenie, którego klient oczekuje. Dostarczona wiadomość może jednak nadal być błędna: zostaje wysłana zbyt wcześnie, zawiera nieaktualny status, pokazuje notatkę wewnętrzną lub po ponownym callbacku zostaje wysłana dwukrotnie. Wygląd szablonu to jedynie ostatnia warstwa niezawodnego procesu.
Ten poradnik dotyczy znaczenia zdarzeń, treści i testowania e-maili. Techniczna dostarczalność SMTP, DNS i reputacja to osobny temat. Tutaj skupiamy się na tym, aby właściwy odbiorca otrzymał właściwą informację we właściwym momencie i aby szablony można było aktualizować bez psucia danych, lokalizacji czy wyświetlania w popularnych klientach poczty.
Utwórz katalog wiadomości i ich wyzwalaczy
Proszę spisać wszystkie wiadomości dla klientów i wewnętrzne, ich odbiorcę, cel oraz dokładne zdarzenie. Nowe zamówienie, potwierdzona płatność i przyjęcie do realizacji mogą być trzema różnymi momentami. Jeśli jeden szablon je myli, klient uzna zamówienie za potwierdzone, zanim system pozna wynik płatności.
Dla każdego wyzwalacza należy określić idempotencję. Ponowne doręczenie webhooka lub ręczne zapisanie zamówienia nie powinno wysłać tego samego potwierdzenia po raz drugi. Należy zapisać identyfikator wiadomości, czas i wynik bez całej treści. Przy ponownej wysyłce korygującej administrator musi widzieć, co klient już otrzymał.
- Zdarzenie biznesowe i warunki
- Odbiorca zewnętrzny (klient) lub wewnętrzny
- Obowiązkowe dane w wiadomości
- Reguła pierwszego i ponownego wysłania
Pisz treści według kolejnego kroku klienta
Temat i pierwszy akapit powinny nazywać rzeczywisty stan. Wiadomość wyjaśnia, czy klient musi zapłacić, uzupełnić dane, czekać na wysyłkę, czy może śledzić przesyłkę. Niejasne marketingowe nagłówki utrudniają odnalezienie potwierdzenia. Numer zamówienia i kontakt do wsparcia podawaj spójnie we wszystkich szablonach.
Należy wyświetlać wyłącznie dane potrzebne do danego celu. Wewnętrzne notatki, techniczne komunikaty o błędach, tajne linki i pełne odpowiedzi systemu płatności nie powinny trafiać do e-maila dla klienta. Przy wrażliwej czynności samoobsługowej należy użyć wygasającego linku z weryfikacją tożsamości, a nie stałego URL opartego wyłącznie na łatwo dostępnym numerze zamówienia.
Modyfikacja szablonów z minimalnym powiązaniem z rdzeniem
Najpierw należy wykorzystać obsługiwane ustawienia, hooki i style. Pełną kopię szablonu w motywie warto tworzyć tylko wtedy, gdy potrzebna jest zmiana strukturalna. Kopia może po aktualizacji WooCommerce stać się nieaktualna, dlatego należy ewidencjonować jej pierwotną wersję i przy każdym wydaniu porównywać zmiany upstreamu.
Warunki dotyczące danych należy trzymać poza prezentacyjnym HTML. Własna wtyczka przygotowuje bezpieczny model danych, a szablon jedynie go wyświetla z odpowiednim escapowaniem. Dzięki temu można testować decyzje bez renderowania w każdym kliencie. Logo i kolory proszę ustawić tak, aby tekst pozostał czytelny również przy zablokowanych obrazach i w trybie ciemnym.
Pamiętaj o języku, urządzeniach i dostępności
Język wiadomości należy wyprowadzić z zamówienia i zapisać go w momencie zakupu; bieżące ustawienie profilu mogło się zmienić. Tłumaczenia obejmują temat, zdania dynamiczne oraz własne nazwy statusów. Formaty waluty, daty i adresu należy generować z danych zamówienia i lokalizacji, a nie przez ręczne składanie ciągów w szablonie.
Oprzyj e-mail na prostej, responsywnej strukturze i nie przekazuj ważnych informacji wyłącznie kolorem lub obrazem. Przyciski powinny mieć opisowy tekst i odpowiedni rozmiar, obrazy opis alternatywny, a kolejność treści powinna mieć sens także bez CSS. Wersja tekstowa musi zawierać ten sam kolejny krok i bezpieczny link.
Testujcie zdarzenia, dane i kompatybilność
Należy utworzyć testowe zamówienia dla gościa, konta, rabatu, dostawy, wielu stawek podatku, zwrotu, produktu cyfrowego i długich nazw. Każdy e-mail warto wywołać pierwotnym zdarzeniem, a nie tylko statycznym podglądem. Należy zweryfikować odbiorców, temat, kwoty, linki, język, brakujące dane opcjonalne oraz zachowanie po powtórzeniu zdarzenia.
Po aktualizacji WooCommerce proszę sprawdzić komunikaty o przestarzałych szablonach i porównać je ze źródłem. Wiadomość testową należy wysłać do reprezentatywnych klientów poczty i sprawdzić widok mobilny, tryb ciemny oraz zablokowane obrazy. Monitoring operacyjny śledzi następnie liczbę wygenerowanych i przekazanych wiadomości; za dostarczalność odpowiada kolejna warstwa SMTP.
Najczęstsze pytania
Dlaczego klient otrzymał e-mail dwukrotnie?
Wyzwalacz mógł zareagować na ponowiony webhook lub kilka zmian tego samego stanu bez kontroli idempotentności. Proszę odnaleźć zdarzenie i identyfikator wysyłki, a następnie zmodyfikować regułę tak, aby ten sam wynik biznesowy wysyłał wiadomość tylko raz.
Czy kopiowanie szablonów WooCommerce do motywu jest bezpieczne?
To wspierany sposób wprowadzania niezbędnych modyfikacji, ale kopię trzeba śledzić przy aktualizacjach. Należy preferować ustawienia i hooki; w przypadku kopii trzeba ewidencjonować wersję i testować regresyjnie zarówno dane, jak i wygląd.
Jak przetestować e-mail bez prawdziwego zamówienia?
Podgląd przydaje się do oceny wyglądu, ale nie wystarcza. Na stagingu należy utworzyć reprezentatywne zamówienie i wywołać rzeczywistą zmianę statusu, aby zweryfikować warunki, odbiorcę, dane dynamiczne oraz ochronę przed duplikatami.