Amazon SES - creare cont și configurare pentru integrarea trimiterii

Scopul documentului

Acest document descrie cum să pregătești contul AWS și serviciul Amazon SES astfel încât să poată fi realizată integrarea trimiterii cu modulele acestui proiect.

Instrucțiunea include:

• crearea contului AWS,
• activarea Amazon SES,
• verificarea domeniului și a expeditorului,
• ieșirea din sandbox,
• pregătirea credențialelor,
• două variante de integrare cu Magento:
  • prin Amazon SES API,
  • prin Amazon SES SMTP.

Observație importantă pentru acest proiect

În codul proiectului sunt disponibile două căi de integrare cu Amazon SES:

1. SES API în Kowal_EmailTransport cu tipul de transport ses.
2. SES SMTP în Kowal_EmailSmtp cu tipul de transport smtp.

Asta înseamnă că merită să pregătești o singură dată contul AWS și SES, dar modul final de conectare la Magento depinde de varianta de implementare aleasă.

Ipoteze preliminare

Înainte de a începe pregătește:

• domeniul din care vor fi trimise mesajele, de exemplu example.com,
• acces la DNS-ul acestui domeniu,
• adresa expeditorului, de exemplu newsletter@example.com,
• card bancar sau metodă de facturare activă în AWS,
• decizia privind regiunea în care va funcționa SES, de exemplu eu-central-1 sau us-east-1.

1. Crearea contului AWS

1. Intră în panoul AWS: https://aws.amazon.com/
2. Creează un cont AWS.
3. Activează MFA pentru contul root.
4. Nu folosi cheile de acces ale contului root pentru integrarea aplicației.

Pentru integrarea Magento pregătește un utilizator IAM separat sau credențiale SMTP separate, în funcție de varianta aleasă.

2. Activarea Amazon SES

1. Autentifică-te în AWS Console.
2. Deschide serviciul Amazon Simple Email Service.
3. Alege regiunea în care vrei să rulezi trimiterea.

Acest aspect este important, deoarece în SES regiunea are semnificație operațională:

• identitățile expeditorului sunt menținute per regiune,
• statusul sandbox/production access este legat de regiune,
• datele de configurare Magento trebuie să indice aceeași regiune,
• credențialele SMTP în SES sunt unice per regiune.

Dacă magazinul funcționează internațional, cel mai bine este să stabilești din start regiunea țintă pentru piața respectivă sau pentru întreaga organizație și să o folosești consecvent.

3. Verificarea domeniului sau a adresei expeditorului

Cea mai bună practică pentru un magazin este verificarea întregului domeniu, nu doar a unei singure adrese de email.

Varianta recomandată

Verifică domeniul, de exemplu example.com.

Datorită acestui lucru:

• poți trimite din mai multe adrese ale domeniului,
• treci mai ușor la trimiterea în producție,
• te pregătești mai bine pentru campanii, tranzacții și mai mulți expeditori,
• este mai ușor să gestionezi mai multe magazine, limbi și branduri într-un singur ecosistem.

Pași

1. În SES mergi la Identities.
2. Alege Create identity.
3. Selectează tipul Domain.
4. Introdu domeniul de trimitere.
5. Activează Easy DKIM, dacă nu ai un motiv să folosești propriile chei DKIM.
6. Adaugă în zona DNS înregistrările indicate de AWS.
7. Așteaptă statusul Verified.

Domeniu minim DNS

În practică vei avea nevoie cel puțin de:

• înregistrări de verificare SES,
• înregistrări DKIM,
• opțional o înregistrare pentru custom MAIL FROM.

4. Ieșirea din sandbox-ul SES

Un cont SES nou funcționează de obicei inițial în sandbox.

Asta înseamnă, printre altele, că:

• poți trimite doar din identități verificate,
• și destinatarii trebuie să fie verificați,
• nu vei putea face o trimitere normală de producție către clienții magazinului.

Pași

1. În SES deschide Account dashboard sau ecranul inițial de configurare.
2. Alege opțiunea Request production access.
3. Completează formularul conform destinației sistemului:
   • transactional,
   • marketing,
   • newsletter,
   • e-commerce communications.
4. Descrie faptul că trimiterea va fi realizată din propriul Magento pentru un magazin online.
5. Trimite cererea.

Înainte de trimiterea cererii este bine să ai deja domeniul verificat. De obicei acest lucru accelerează aprobarea.

5. Configurarea livrabilității

Nu este minimul obligatoriu pentru primul test, dar este puternic recomandat înainte de producție.

DKIM

Dacă folosești Easy DKIM, SES semnează mesajele automat după configurarea corectă a DNS-ului.

Custom MAIL FROM

Dacă vrei să îmbunătățești controlul asupra expeditorului tehnic și livrabilității:

1. Deschide domeniul verificat în SES.
2. Configurează Custom MAIL FROM domain, de exemplu mail.example.com.
3. Adaugă în DNS:
   • înregistrare MX,
   • înregistrare SPF/TXT pentru MAIL FROM.

Acest lucru are sens în special pentru magazinele care derulează email marketing regulat și vor să reducă problemele legate de reputația expeditorului.

6. Varianta A - integrare prin Amazon SES API

Această variantă folosește tipul de transport ses disponibil în Kowal_EmailTransport.

Când să alegi această variantă

Alege SES API dacă:

• vrei să folosești direct Amazon SES ca provider,
• vrei să menții un cont de transport de tip ses,
• vrei să rutezi mesajele prin Kowal_EmailTransport.

6.1. Crearea unui utilizator IAM pentru trimitere

Nu folosi contul root.

Pregătește un utilizator IAM separat, de exemplu:

• magento-ses-sender

Apoi atribuie-i o politică cu permisiuni minime pentru trimitere.

Exemplu de politică minimă

{ 'Version': '2012-10-17', 'Statement': [ { 'Effect': 'Allow', 'Action': [ 'ses:SendEmail', 'ses:SendRawEmail' ], 'Resource': '*' } ]}

Dacă dorești, o poți extinde cu citirea limitelor sau a statisticilor, dar pentru simpla trimitere domeniul de mai sus este punctul de plecare.

6.2. Crearea Access Key și Secret Key

1. Deschide IAM.
2. Mergi la Users.
3. Deschide utilizatorul pregătit.
4. Intră în fila Security credentials.
5. În secțiunea Access keys alege Create access key.
6. Salvează:
   • Access Key ID
   • Secret Access Key

Secretul îl vei vedea o singură dată. Dacă îl pierzi, trebuie să creezi o cheie nouă.

6.3. Date necesare în Magento pentru varianta API

Pentru contul de transport ses din Magento pregătește:

• provider_region, de exemplu eu-central-1,
• provider_api_key,
• provider_api_secret,
• sender_name,
• sender_email,
• reply_to_email opțional,
• store_id, dacă acel cont trebuie să funcționeze doar pentru un anumit store view.

6.4. Mapare în panoul Magento

În Kowal / Email Marketing:

1. Adaugă un cont nou de transport.
2. Setează:
   • Transport Type = Amazon SES,
   • Region = regiunea SES,
   • Access Key = cheia IAM,
   • Secret Key = secretul IAM.
3. Salvează contul.
4. Asociază contul cu rutarea mesajelor.
5. Execută un test de trimitere din contul de transport.

7. Varianta B - integrare prin Amazon SES SMTP

Această variantă folosește Kowal_EmailSmtp.

Când să alegi această variantă

Alege SES SMTP dacă:

• vrei să implementezi Amazon SES ca sursă SMTP,
• folosești pachetul Advance Email Delivery,
• vrei să păstrezi un model de integrare mai simplu pe partea Magento.

7.1. Crearea credențialelor SMTP în SES

1. Deschide Amazon SES.
2. Mergi la SMTP settings.
3. Alege Create SMTP credentials.
4. AWS te va ghida prin crearea unui utilizator IAM pentru SMTP.
5. Salvează:
   • SMTP username
   • SMTP password

Acestea nu sunt chei AWS obișnuite. Sunt credențiale SMTP separate pentru SES.

7.2. Endpoint SMTP

Pentru SES folosește hostul în formatul:

email-smtp..amazonaws.com

Exemplu:

email-smtp.eu-central-1.amazonaws.com

7.3. Port și criptare

Setările cel mai des utilizate:

• port 587 + STARTTLS,
• sau port 465 + TLS Wrapper / SSL.

În practică, pentru Magento cel mai sigur punct de plecare este:

• host: email-smtp..amazonaws.com
• port: 587
• security: STARTTLS

7.4. Date necesare în Magento pentru varianta SMTP

Pregătește:

• host SMTP,
• port,
• tip de criptare,
• login SMTP,
• parolă SMTP,
• adresă de expeditor conformă cu verified identity din SES.

7.5. Mapare în panoul Magento

În Kowal / Email Marketing:

1. În secțiunea smtp setează global:
   • enabled = Yes,
   • host = endpoint SES,
   • port = 587,
   • username = SMTP username,
   • password = SMTP password,
   • connection_security = STARTTLS,
   • test_recipient_email = adresă pentru test.
2. Salvează configurația.
3. Execută Send Test Email.

Dacă folosești mai multe conturi sau mai multe store view, poți configura și un cont de transport separat de tip smtp cu date dedicate de conexiune.

8. Ce să alegi în acest proiect

Alege SES API dacă:

• vrei să folosești conturi de transport ses,
• vrei să rutezi trimiterea per cont și provider,
• vrei să dezvolți transportul fără a te baza complet pe stratul SMTP.

Alege SES SMTP dacă:

• vrei o primă implementare mai rapidă,
• vrei să tratezi SES ca pe un server SMTP extern,
• implementezi în principal pachetul delivery bazat pe Kowal_EmailSmtp.

9. Checklist minim înainte de testul de trimitere

Înainte de primul test confirmă:

1. Contul AWS există și are facturarea activă.
2. Regiunea SES a fost aleasă.
3. Domeniul sau adresa expeditorului au status Verified.
4. Contul SES are production access sau testezi doar în condiții de sandbox.
5. DKIM este configurat.
6. Magento are datele corecte ale expeditorului.
7. Varianta de integrare a fost aleasă:
   • API,
   • sau SMTP.
8. Credențialele sunt salvate în siguranță.
9. A fost trimis un test și s-a confirmat livrarea mesajului.

10. Cele mai frecvente erori

Contul este încă în sandbox

Simptom:

• mesajul nu ajunge la destinatari normali.

Cauză:

• lipsă production access.

Domeniul nu este verificat

Simptom:

• eroare de expeditor sau respingerea trimiterii.

Cauză:

• lipsă verified identity pentru domeniu sau adresa expeditorului.

Regiune greșită

Simptom:

• datele par corecte, dar trimiterea tot nu funcționează.

Cauză:

• identitatea este verificată într-o altă regiune decât cea folosită de integrare.

Confuzie între cheile API și credențialele SMTP

Simptom:

• autentificarea SMTP nu funcționează.

Cauză:

• în SMTP au fost introduse chei IAM în loc de SMTP username și SMTP password.

Utilizarea contului root

Simptom:

• lipsă de separare a securității și rotație mai dificilă a credențialelor.

Cauză:

• integrarea se bazează pe datele root în locul unui utilizator IAM separat sau al unor credențiale SMTP separate.

11. Linkuri către documentația oficială AWS

• Set up your SES account: https://docs.aws.amazon.com/ses/latest/dg/setting-up.html
• Creating and verifying identities: https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html
• Verified identities: https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html
• Request production access: https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html
• SMTP credentials: https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html
• SMTP endpoint connection: https://docs.aws.amazon.com/ses/latest/dg/smtp-connect.html
• Custom MAIL FROM: https://docs.aws.amazon.com/ses/latest/dg/mail-from.html
• SES regions: https://docs.aws.amazon.com/ses/latest/dg/regions.html
• SES credentials overview: https://docs.aws.amazon.com/ses/latest/dg/send-email-concepts-credentials.html
• IAM access keys: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html

12. Datele care trebuie furnizate pentru implementare

La final, persoana care creează SES ar trebui să transmită pentru implementare exact acest set:

Pentru varianta SES API

• regiunea SES,
• verified domain,
• access key,
• secret key,
• adresa expeditorului,
• reply-to, dacă trebuie să fie diferit,
• informația dacă acel cont trebuie să funcționeze global sau per store view.

Pentru varianta SES SMTP

• regiunea SES,
• host SMTP,
• port,
• security mode,
• SMTP username,
• SMTP password,
• adresa expeditorului,
• adresa de test pentru verificare.

Advanced Newsletter Suite pentru Magento 2 - instrucțiuni de instalare și configurare

Scopul documentului

Acest document descrie instalarea și configurarea pachetului magento-2-package-advanced-newsletter-suite. Este un pachet complet de newsletter și email marketing pentru Magento 2, care include destinatari, captare, campanii, conținut, trimitere, tracking, panou operațional și puncte de abonare pe frontend.

Cerințe preliminare

Înainte de implementare, pregătiți:

• Magento Open Source 2.4.x,
• Composer,
• acces CLI la bin/magento,
• cont de administrator Magento,
• date de acces SMTP,
• cron Magento configurat,
• pregătirea pentru rularea consumatorilor de cozi,
• mediu de testare pentru verificarea abonării, campaniilor și trimiterilor.

Ce instalează pachetul

Pachetul include:

• Kowal_MarketingCore,
• Kowal_EmailTransport,
• Kowal_EmailSmtp,
• Kowal_EmailEvents,
• Kowal_EmailTemplateStudio,
• Kowal_NewsletterAudience,
• Kowal_NewsletterCapture,
• Kowal_NewsletterCampaigns,
• Kowal_NewsletterConsole,
• Kowal_NewsletterFrontend.

Acesta este cel mai înalt nivel de agregare din ecosistemul modulelor de email marketing pentru Magento.

Instalare

1. Instalarea pachetului Composer

Datele de acces la repository-ul Composer (adresa de e-mail a clientului și tokenul de licență) le veți primi prin e-mail după achiziție. Acestea sunt disponibile și în panoul clientului după autentificare pe kowal.store. Înlocuiți TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului dvs., iar TWOJ_TOKEN cu tokenul primit. Executați comenzile în directorul principal Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/package-advanced-newsletter-suite

2. Activarea modulelor în Magento

bin/magento module:enable  Kowal_MarketingCore  Kowal_EmailTransport  Kowal_EmailSmtp  Kowal_EmailEvents  Kowal_EmailTemplateStudio  Kowal_NewsletterAudience  Kowal_NewsletterCapture  Kowal_NewsletterCampaigns  Kowal_NewsletterConsole  Kowal_NewsletterFrontendbin/magento setup:upgradebin/magento cache:flush

În modul de producție, executați suplimentar:

bin/magento setup:di:compilebin/magento setup:static-content:deploy -f

Configurare

1. Secțiunea de administrare

Configurarea de bază ar trebui să fie disponibilă în:

Kowal / Email Marketing

Conform specificației, grupurile de setări așteptate sunt:

• general,
• transport,
• smtp,
• campaigns,
• double_opt_in,
• events.

2. Configurarea trimiterii

Mai întâi configurați fundamentul livrării:

• activitatea modulului,
• tipul implicit de transport,
• logarea trimiterilor,
• contul sau conturile SMTP,
• rutarea mesajelor,
• fallback pentru conturile de rezervă, dacă este utilizat.

Implementarea pachetului complet necesită în continuare un strat SMTP și de transport funcțional.

3. Configurarea destinatarilor și abonărilor

Apoi confirmați configurarea stratului de destinatari:

• integrarea cu newsletter_subscriber,
• listele de mailing,
• segmentele,
• statusurile abonamentelor,
• metadatele suplimentare ale abonatului,
• sursele de achiziție,
• acordurile de marketing.

Configurați de asemenea procesul de abonare:

• formularele și punctele de abonare,
• double opt-in,
• șablonul mesajului de confirmare,
• durata de valabilitate a tokenului de confirmare.

4. Configurarea campaniilor

În secțiunea campaigns setați:

• batch_size,
• max_retry_count,
• send_rate_limit_per_run,
• watchdog_timeout_minutes.

Pachetul acceptă:

• definirea campaniei,
• programarea,
• coada destinatarilor,
• procesarea pe loturi a trimiterii,
• istoricul execuției campaniei,
• trimiteri de test.

5. Configurarea Template Studio

Dacă implementarea include lucrul cu conținutul newsletterului, configurați EmailTemplateStudio conform domeniului MVP:

• lucrul pe șabloanele native de newsletter Magento,
• selectarea layouturilor de produse,
• salvarea secțiunii generate în șablonul nativ,
• importul conținutului pregătit în campanie.

6. Configurarea evenimentelor email

În secțiunea events configurați:

• procesarea evenimentelor,
• retenția payload-urilor,
• politica de acceptare a duplicatelor de evenimente de la furnizori.

Stratul EmailEvents răspunde de observabilitatea procesului de livrare și de corelarea evenimentelor cu logurile de transport și campaniile.

7. Configurarea panoului de administrare și a frontendului

Pachetul complet include:

• Kowal_NewsletterConsole ca panou operațional,
• Kowal_NewsletterFrontend ca strat al formularelor și widgeturilor de abonare pe frontend.

După instalare, verificați:

• disponibilitatea dashboardului,
• scurtăturile către configurare și modulele operaționale,
• vizualizarea ultimelor erori și trimiteri,
• prezența formularelor de abonare pe frontendul magazinului.

Cron și consumatorii de cozi

Pachetul complet necesită funcționarea procesării asincrone.

1. Cron Magento

bin/magento cron:install

Cron ar trebui să răspundă de:

• planificarea campaniilor,
• recuperarea sarcinilor,
• watchdog operațional.

2. Queue consumers

Consumatorii de cozi ar trebui să răspundă de procesarea efectivă a loturilor de trimitere. Numele consumatorilor trebuie preluate din fișierele actuale etc/queue_consumer.xml ale modulelor implementate.

În mediul de producție, asigurați:

• rularea consumers în fundal,
• autostart după repornirea serverului,
• monitorizarea defecțiunilor,
• logarea erorilor.

Pași după instalare

După implementare, parcurgeți lista completă de verificare:

1. Configurați și testați contul SMTP.
2. Verificați rutarea mesajelor.
3. Verificați abonarea abonatului și double opt-in.
4. Confirmați compatibilitatea cu newsletterul nativ Magento.
5. Creați o listă sau un segment de test.
6. Pregătiți o campanie de test.
7. Executați test send.
8. Verificați planificarea campaniei prin cron.
9. Verificați procesarea cozii de către consumers.
10. Confirmați salvarea logurilor și a evenimentelor email.
11. Verificați dashboardul administrativ.
12. Verificați formularele și widgeturile de abonare de pe frontend.

Test de acceptanță după implementare

Pachetul este implementat corect dacă:

• modulele se instalează corect în Magento 2.4.x,
• trimiterea SMTP funcționează la nivelul conturilor și rutării,
• abonarea abonatului rămâne compatibilă cu newsletterul nativ Magento,
• campania este planificată de cron și procesată de queue consumer,
• statusurile de livrare actualizează logurile și evenimentele email,
• panoul de administrare afișează date operaționale de bază,
• punctele de abonare de pe frontend funcționează corect,
• după dezactivarea modulelor, mecanismul de bază Magento_Newsletter poate funcționa în continuare.

Observații de implementare

• Merită să implementați pachetul complet împreună cu o configurare SMTP și tracking verificată.
• Datele extinse trebuie stocate în tabele proprii, fără duplicarea tabelului nativ newsletter_subscriber.
• Documentația operațională a implementării ar trebui să includă suplimentar procedura de gestionare a cozilor, webhookurilor și testelor de regresie ale configurării administrative.