postmark

Skill do wysyłania transakcyjnych wiadomości e-mail za pośrednictwem Postmark API. Zarządzaj szablonami wiadomości, śledzij bounce'i i przeglądaj statystyki dostarczalności. Obsługuje wysyłanie pojedynczych maili, wiadomości z szablonów oraz wysyłkę zbiorczą. Idealne dla aplikacji wymagających niezawodnej dostarczalności e-maili — potwierdzenia zamówień, resetowanie haseł, powiadomienia systemowe.

1. Utwórz konto na Postmark (https://account.postmarkapp.com) i wygeneruj token serwera (POSTMARK_SERVER_TOKEN) w panelu administracyjnym.

2. Ustaw zmienną środowiskową POSTMARK_SERVER_TOKEN, aby skill mógł się uwierzytelnić. Eksportuj ją w swoim terminalu lub dodaj do pliku konfiguracyjnego aplikacji.

3. Aby wysłać prosty mail, użyj endpointu /email z Postmark API. Podaj adres nadawcy (From), odbiorcy (To), temat (Subject) oraz treść w formacie tekstowym (TextBody) lub HTML (HtmlBody).

4. Jeśli chcesz wysyłać maile z szablonów, najpierw utwórz szablon w panelu Postmark, zapamiętaj jego ID, a następnie użyj endpointu /email/withTemplate. Przekaż TemplateId i dane do wstawienia (TemplateModel).

5. Aby wysłać wiele maili jednocześnie, użyj endpointu /email/batch i przekaż tablicę obiektów e-mail. To przyspiesza wysyłkę zbiorczą.

6. Monitoruj dostarczalność poprzez endpointy /bounces (bounce'i) i /deliverystats (statystyki dostarczenia). Pozwala to śledzić problemy z dostarczalnością i reagować na nieudane wysyłki.