Jak platforma łączy się z SES
Amazon SES (Simple Email Service) to usługa wysyłki poczty w chmurze AWS. W Endora Commerce jest jednym z trzech dostawców na liście adapterów poczty, obok SMTP i SendGrid. W panelu administracyjnym, w poświadczeniach, tworzysz konfigurację typu „adapter poczty”, wybierasz dostawcę Amazon SES i podajesz trzy wartości: region, identyfikator klucza dostępowego i klucz tajny. Klucz tajny jest szyfrowany w spoczynku i po zapisaniu nie wraca w postaci jawnej.
Przejście na SES z własnego serwera SMTP albo ze SendGrid to wskazanie innej konfiguracji, bez zmian w kodzie modułów, które wysyłają wiadomości.
Co przygotować po stronie AWS
- Zweryfikowana tożsamość nadawcy. SES wymaga weryfikacji każdej domeny lub adresu, którego używasz w polu „Od”. W praktyce oznacza to dodanie rekordów DNS dla domeny sklepu.
- Wyjście z sandboxa. Każde nowe konto SES startuje w trybie sandbox, osobno w każdym regionie. W tym trybie wiadomości można wysyłać tylko na zweryfikowane adresy i w niewielkim dziennym limicie, więc przed startem sklepu trzeba złożyć wniosek o dostęp produkcyjny. AWS pyta w nim o rodzaj poczty (transakcyjna czy marketingowa) i adres strony.
- Klucz dostępowy IAM. Platforma uwierzytelnia się kluczem dostępowym AWS, więc warto założyć dla niej osobnego użytkownika IAM, z uprawnieniami ograniczonymi do wysyłki przez SES, i wskazać w konfiguracji ten sam region, w którym zweryfikowano domenę.
Limity wysyłki SES liczy osobno dla każdego regionu i według liczby odbiorców, nie wiadomości.
Które wiadomości wychodzą tą drogą
Przez transport transakcyjny przechodzi cała poczta, którą platforma wysyła w reakcji na zdarzenia:
- zamówienia: potwierdzenie zamówienia, komentarz do zamówienia, ponowienie zamówienia, zamówienie utworzone przez administratora,
- płatności i wysyłka: zmiana statusu płatności, utworzenie przesyłki,
- zwroty: zwrot zaakceptowany lub odrzucony,
- konta firmowe: weryfikacja adresu e-mail, zaproszenie do organizacji, nowa rejestracja,
- magazyn: niski stan i ponowna dostępność produktu.
Temat, treść i wygląd każdej z tych wiadomości administrator edytuje w panelu, globalnie albo osobno dla kanału sprzedaży i języka, z podglądem na przykładowych danych. Pojedynczą wiadomość można też wyłączyć, z wyjątkiem tych, które są potrzebne do założenia konta. SES dostaje gotową wiadomość HTML z alternatywą tekstową; szablonów po stronie AWS się nie używa.
Co wie platforma, a co wie SES
| Pytanie | Gdzie jest odpowiedź |
|---|---|
| Czy wiadomość została przekazana do wysyłki? | Rekord dostarczenia w bazie platformy: wysłana, wstrzymana albo nieudana, z odbiorcą, rodzajem wiadomości, kanałem i czasem próby |
| Czy dotarła do skrzynki, czy wróciła jako odbicie lub skarga? | Amazon SES: powiadomienia o odbiciach i skargach oraz statystyki konta |
Status „wysłana” oznacza, że SES przyjął wiadomość, a nie że odbiorca ją otrzymał. Sama wysyłka idzie w tle, przez kolejkę opartą na Redis, więc nie wstrzymuje obsługi zamówienia. Wyjście z sandboxa i poprawne poświadczenia warto mimo to sprawdzić przed uruchomieniem sklepu, a nie po pierwszym zamówieniu.
Newsletter na SES: osobne poświadczenia
Moduł newslettera ma własnego dostawcę wysyłki, niezależnego od transportu transakcyjnego i ustawianego w panelu administracyjnym, z sekretem przechowywanym w postaci zaszyfrowanej. Tym dostawcą też może być SES, na osobnym kluczu dostępowym.
Kampanie wychodzą przez osobną kolejkę, z ustawianym limitem wiadomości na sekundę. Pozwala to dopasować tempo wysyłki do limitu przyznanego kontu SES, a duża kampania nie opóźnia potwierdzeń zamówień. Jeżeli newsletter prowadzisz w zewnętrznym systemie mailingowym, cały moduł można wyłączyć bez wpływu na pocztę transakcyjną.
Kiedy wybrać SES
SES jest naturalnym wyborem, gdy firma ma już konto AWS, na przykład pliki sklepu trzyma w Amazon S3, i chce mieć pocztę w tym samym miejscu, w wybranym regionie, w tym europejskim. Wymaga jednak osoby, która swobodnie porusza się w IAM, skonfiguruje rekordy DNS i złoży wniosek o dostęp produkcyjny. Jeśli takiej osoby nie ma, prościej zacząć od SendGrid albo od serwera SMTP, z którego firma już korzysta. Ponieważ wszystkie trzy opcje wybiera się z tej samej listy dostawców, decyzję da się później zmienić bez przebudowy sklepu.