Öz Amazon SES hesabı vasitəsilə e-poçt göndərin

Sizə AWS hesabı və domeninizin DNS-inə giriş lazımdır. SES bu siyahıdakı ən ucuz seçim olmaqla yanaşı, ən çox addım tələb edənidir.

Amazon-un öz sənədləri: Domenin təsdiqlənməsi · SMTP etimadnamələrinin əldə edilməsi · Qumqutudan çıxış

⭐ Biz SES-ə onun REST API-si vasitəsilə deyil, SMTP interfeysi ilə qoşuluruq. Məhz buna görə də sizdən AWS giriş açarı deyil, SMTP istifadəçi adı və şifrəsi tələb olunur. Hər iki üsul tamamilə eyni mesajı çatdırır; SMTP üsulu kənardan diaqnostikası çox çətin olan bütün AWS sorğu-imzalama problemləri sinfinin qarşısını alır və bu, məhz bizim kimi alətlərin istifadə edə bilməsi üçün Amazon-un etimadnamələr dərc etdiyi interfeysdir.

1. Bir region seçin və həmin regionda qalın

SES regionaldır. Aşağıdakı hər şey — təsdiqlənmiş domeniniz, etimadnamələriniz, göndərmə kvotanız — bir AWS regionuna məxsusdur və başqa heç bir yerdə mövcud deyil.

Müştərilərinizə ən yaxın olanını (Avropa üçün eu-west-1, Şimali Amerika üçün us-east-1) seçin və onu qeyd edin. Domeninizi İrlandiyada təsdiqləyib, sonra Frankfurtda etimadnamələr yaratmaq burada günün yarısını boşa xərcləməyin ən çox yayılmış yoludur və bunun yaratdığı xəta regionlar haqqında heç nə demir.

2. Domeninizi təsdiqləyin

Amazon SES konsolu → İdentifikatorlar (Identities) → İdentifikator yarat (Create identity) → Domen (Domain). mail.yourdomain.com kimi alt domen daxil edin.

Easy DKIM funksiyasını yandırın və RSA_2048_BIT seçin. SES sizə üç CNAME qeydi verir:

| Tip | Host | | --- | --- | | CNAME | <token1>._domainkey.mail.yourdomain.com | | CNAME | <token2>._domainkey.mail.yourdomain.com | | CNAME | <token3>._domainkey.mail.yourdomain.com |

Hər üçünü əlavə edin. Təsdiqləmə adətən bir saat ərzində tamamlanır.

⭐ Həmçinin xüsusi MAIL FROM domenini (bounce.mail.yourdomain.com) aktivləşdirin və onun tələb etdiyi MX və SPF TXT qeydlərini əlavə edin. Bu olmadan sizin zərf göndərəriniz amazonses.com olur, buna görə də SPF sizə deyil, Amazona uyğunlaşır və siz yalnız DKIM-ə güvənirsiniz.

3. Qumqutudan çıxın — insanların qaçırdığı addım budur

⛔⛔ Yeni SES hesabı qumqutudadır (sandbox) və yalnız ayrıca təsdiqlədiyiniz ünvanlara mesaj göndərə bilər. O, digər hər şeyi qəbul edəcək, lakin heç birini çatdırmayacaq.

Təsdiqləmə addımımızın mövcud olma səbəbi məhz bu nasazlığı aşkar etməkdir: qumqutuda SES mesajınızı tamamilə adi uğurlu cavabla qəbul edir və sonra onu silir. Əgər quraşdırmamızı testi AWS-də təsadüfən təsdiqlədiyiniz ünvana göndərməklə yoxlasanız, işləyəcək — və bundan sonra real müştəriyə göndərilən hər bir mesaj yoxa çıxacaq.

Hesab idarə paneli (Account dashboard) → Prodakşn girişini tələb et (Request production access). Amazon nə göndərdiyinizi və qaytarmaları (bounces) necə idarə etdiyinizi soruşur; öz müştərilərinizə göndərilən tranzaksiya bildirişləri haqqında bir neçə dürüst cümlə adətən 24 saat ərzində təsdiqlənir.

⭐ Bunu SES-i burada birləşdirməmişdən əvvəl edin. Sonradan heç nəyi sazlamağa ehtiyac qalmayacaq, çünki heç nə xəta verməyəcək.

4. SMTP etimadnamələrini yaradın

SES konsolu → SMTP parametrləri (SMTP settings) → SMTP etimadnamələri yarat (Create SMTP credentials).

Bu, yalnız göndərmək icazəsi olan IAM istifadəçisi yaradır və sizə SMTP istifadəçi adı (SMTP username) və SMTP şifrəsi (SMTP password) verir.

⛔ Bunlar sizin AWS giriş açarınız (access key) və məxfi açarınız deyil. Onlar xüsusi alqoritm vasitəsilə IAM məxfi açarından əldə edilir və bir-birini əvəz edə bilməzlər. AWS məxfi giriş açarını bura yapışdırmaq hər dəfə autentifikasiyanın uğursuz olması ilə nəticələnəcək və xəta sadəcə etimadnamələrin rədd edildiyini bildirəcək.

⚠️ Şifrə yalnız bir dəfə göstərilir. Səhifəni tərk etməzdən əvvəl CSV faylını endirin.

5. Zinn®-də qoşun

İdarə panelinizdə E-poçt göndərmə (Email sending) bölməsini açın:

Provayder (Provider) — Amazon SES
Bu domendən göndər (Send from this domain) — mail.yourdomain.com
AWS regionu (AWS region) — 1-ci addımdan olan region, məsələn eu-west-1
SMTP istifadəçi adı (SMTP username) — 4-cü addımdan
Port (Port) — 587 olaraq saxlayın
SES SMTP şifrəsi (SES SMTP password) — 4-cü addımdan

Biz hostu sizin üçün qururuq (email-smtp.<region>.amazonaws.com), ona görə də host adını səhv yazmaq ehtimalı yoxdur.

6. Testi göndərin və kodu daxil edin

AWS-də təsdiqləmədiyiniz başqa bir domendəki gələn qutuya test mesajı göndərmək üçün Test mesajı göndər düyməsini sıxın — şəxsi Gmail ünvanı idealdır, çünki bu, qumqutudan çıxdığınızı sübut edən ünvandır. Kodu oxuyun və daxil edin.

İşləmədikdə

Real müştəriyə e-poçt göndərərkən "E-poçt ünvanı təsdiqlənməyib" ("Email address is not verified") xətası — siz hələ də qumqutudasınız. 3-cü addım.

535 Autentifikasiya Etimadnamələri Etibarsızdır (535 Authentication Credentials Invalid) — SMTP etimadnamələri (4-cü addım) əvəzinə AWS giriş açarınızdan istifadə etmisiniz və ya etimadnamələr daxil etdiyiniz regiondan fərqli regiona aiddir.

"Maksimum göndərmə sürəti aşdı" ("Maximum sending rate exceeded") — yeni prodakşn hesabı saniyədə 14 mesaj və gündə 50,000 mesajla başlayır. Bu, kifayət qədər çox bildiriş deməkdir, lakin böyük müştəri bazasını köçürürsünüzsə, əvvəlcə artım tələb edin.

Test zamanı işlədi, lakin prodakşnda dayandı — SES Reputasiya (Reputation) panelini yoxlayın. Geri qayıtma (bounce) və ya şikayət nisbəti onların həddini aşdıqda Amazon göndərişi avtomatik olaraq dayandırır və köhnə müştəri siyahısı ilə bu həddi aşmaq asandır.