send-email

Umiejętność do wysyłania e-maili transakcyjnych, powiadomień i szablonów za pośrednictwem API SendGrid v3. Obsługuje proste wiadomości tekstowe i HTML, załączniki, kopie do osób trzecich, szablony dynamiczne oraz personalizację treści. Idealny do automatyzacji powiadomień o rejestracji, resetowania haseł, potwierdzeń zamówień i innych komunikatów programowych. Integruje się z projektami JavaScript/TypeScript poprzez oficjalny SDK Node.js.

1. Sprawdź konfigurację SendGrid, uruchamiając skrypt testowy: ../scripts/send-test-email.sh recipient@example.com — to zweryfikuje klucz API i wyśle testową wiadomość.
2. Zainstaluj SDK SendGrid dla swojego projektu — jeśli używasz Node.js/TypeScript, zainstaluj pakiet @sendgrid/mail; dla innych języków sprawdź dokumentację w references/installation.md.
3. Przygotuj wiadomość e-mail, określając obowiązkowe parametry: adres nadawcy (from — musi być zweryfikowany w SendGrid), adresata (to), temat (subject) oraz treść (text dla zwykłego tekstu lub html dla sformatowanej wiadomości).
4. Dodaj opcjonalne parametry, jeśli potrzebujesz: cc i bcc dla kopii, reply_to dla adresu odpowiedzi, attachments dla załączników w formacie base64, template_id dla szablonów dynamicznych.
5. Wyślij wiadomość za pomocą Mail Send API i obsłuż błędy — w przypadku kodów 429 (zbyt wiele żądań) lub 5xx (błąd serwera) zastosuj ponowną próbę.
6. Przetestuj integrację z rzeczywistymi scenariuszami: powiadomienia o rejestracji, resetowanie haseł, potwierdzenia zamówień lub inne komunikaty programowe.