| Termin | Definicja |
|---|---|
| Pepipost | Pepipost to usługa wysyłek transakcyjnych i marketingowych z rozliczeniem opartym na dostarczonych wiadomościach. Pepipost jako usługa dostarczania wiadomości e-mailPepipost to usługa chmurowa przeznaczona do wysyłania wiadomości transakcyjnych oraz marketingowych. Wiadomość transakcyjna jest generowana w związku z konkretnym zdarzeniem w systemie, na przykład utworzeniem konta, zmianą hasła, złożeniem zamówienia albo zmianą statusu procesu. Wiadomość marketingowa jest elementem zaplanowanej komunikacji z większą grupą odbiorców. W obu przypadkach aplikacja korzystająca z Pepipost przekazuje treść oraz dane odbiorcy do zewnętrznej platformy wysyłkowej, zamiast samodzielnie obsługiwać cały proces dostarczania poczty. Rozliczenie usługi jest związane z dostarczonymi wiadomościami. Nie oznacza to jednak, że każda wysłana wiadomość musi zostać dostarczona do skrzynki odbiorcy. System pocztowy rozróżnia między przyjęciem komunikatu przez usługę wysyłkową, przekazaniem go do serwera odbiorcy oraz końcowym statusem dostarczenia. Znaczenie mają również odrzucenia, błędy tymczasowe, trwałe zwroty oraz blokady po stronie serwera adresata. Dlatego w integracji trzeba analizować statusy dostarczenia, a nie tylko wynik samego żądania wysłania. Integracja przez SMTP i interfejs programistycznyUsługa może być wykorzystywana jako zewnętrzny przekaźnik SMTP albo przez interfejs API udostępniany aplikacjom. SMTP jest protokołem służącym do przekazywania wiadomości między klientem pocztowym, usługą wysyłkową i serwerem odbiorcy. Integracja SMTP wymaga poprawnego skonfigurowania hosta, portu, danych uwierzytelniających oraz szyfrowania połączenia. Błędny port, nieprawidłowe dane dostępowe albo odrzucenie połączenia TLS mogą spowodować, że aplikacja nie przekaże wiadomości do Pepipost. Interfejs API pozwala przekazywać dane wiadomości bezpośrednio z kodu aplikacji. Typowe żądanie zawiera adres nadawcy, adres lub adresy odbiorców, temat, treść tekstową albo HTML oraz opcjonalne elementy wiadomości. Aplikacja powinna sprawdzać kod odpowiedzi i treść odpowiedzi API, zapisywać identyfikator komunikatu oraz odpowiednio reagować na błędy. Samo otrzymanie odpowiedzi wskazującej na przyjęcie żądania nie potwierdza jeszcze dostarczenia do skrzynki. Do późniejszego śledzenia potrzebne są informacje o dalszym przebiegu wysyłki. Ważnym elementem konfiguracji jest rozdzielenie adresu nadawcy od adresu do odpowiedzi. Adres nadawcy powinien być zgodny z domeną skonfigurowaną w usłudze, natomiast pole odpowiedzi może kierować korespondencję do właściwej skrzynki. Należy również uważać na ponawianie żądań po przekroczeniu limitu czasu. Bez identyfikatora operacji albo mechanizmu idempotencji ponowienie może doprowadzić do wysłania tej samej wiadomości więcej niż raz. Statusy dostarczenia i uwierzytelnianie domenyOcena działania Pepipost wymaga odróżnienia błędu aplikacji od problemu występującego po przekazaniu wiadomości. Błąd uwierzytelniania wskazuje zwykle na niewłaściwą konfigurację konta, klucza API lub danych SMTP. Odrzucenie przez serwer odbiorcy może wynikać z nieistniejącego adresu, pełnej skrzynki, polityki domeny albo oceny reputacji nadawcy. Błąd tymczasowy nie musi oznaczać trwałej utraty wiadomości, ponieważ serwer może później ponowić próbę przekazania. Do weryfikacji domeny nadawcy stosuje się rekordy DNS związane z SPF, DKIM i DMARC. SPF określa, które serwery mogą wysyłać wiadomości w imieniu domeny. DKIM dodaje do wiadomości podpis kryptograficzny, który odbiorca może zweryfikować na podstawie klucza publicznego opublikowanego w DNS. DMARC definiuje sposób interpretacji wyników SPF i DKIM oraz politykę dla wiadomości, które nie przechodzą kontroli. Nieprawidłowy rekord DNS, brak propagacji zmian albo konflikt z inną usługą wysyłkową może powodować odrzucenia lub kierowanie wiadomości do spamu. Przy diagnozowaniu problemu warto zebrać czas wysyłki, adres odbiorcy, temat, identyfikator wiadomości, kod odpowiedzi oraz pełny opis zwrotu. Pomocne są także nagłówki wiadomości, ponieważ pokazują trasę komunikatu i wyniki kontroli uwierzytelniania. Analiza powinna obejmować zarówno log aplikacji, jak i panel lub zdarzenia dostarczane przez usługę. Bez tych danych trudno ustalić, czy problem powstał podczas generowania wiadomości, komunikacji z Pepipost, rozwiązywania DNS, czy po stronie domeny odbiorcy. Rola Pepipost w działaniu aplikacji użytkowejPepipost nie jest programem instalowanym na laptopie ani sterownikiem urządzenia. Jest usługą działającą poza lokalnym komputerem, z którą aplikacja komunikuje się przez sieć. Na laptopie lub komputerze można natomiast diagnozować program korzystający z tej usługi: sprawdzić ustawienia SMTP lub API, poprawność certyfikatów, rozwiązywanie nazw DNS, zaporę sieciową oraz sposób obsługi błędów przez aplikację. W przypadku wiadomości HTML można dodatkowo zweryfikować kod treści, załączniki i zgodność danych przekazywanych do formularza wysyłkowego. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów stacjonarnych PC i ich podzespołów, dlatego w odniesieniu do Pepipost zakres czynności może dotyczyć lokalnego komputera oraz aplikacji używanej do komunikacji z usługą. Diagnostyka pozwala rozdzielić usterkę sprzętową, problem systemowy i błąd konfiguracji od niedostępności albo odrzucenia po stronie zewnętrznego operatora poczty. Taki podział jest konieczny, aby nie traktować braku dostarczenia wiadomości jako automatycznego dowodu awarii laptopa lub komputera. |