Asistent de recuperare a coșului bazat pe inteligență artificială pentru Magento 2

Modul Magento 2 pentru recuperarea coșurilor abandonate cu funcții de:

• detectare a coșurilor abandonate
• scoring al coșului folosind AI sau euristică
• generare de mesaje e-mail pentru recuperarea coșului
• generare opțională de cupoane
• conversații cu asistentul AI de cumpărături
• panou administrativ și analitică
• endpointuri REST API și comenzi CLI

Prezentare generală

Modulul ajută la recuperarea coșurilor abandonate în Magento 2 prin detectarea coșurilor inactive, evaluarea intenției de cumpărare și trimiterea de mesaje e-mail cu un link securizat pentru restaurarea coșului. În funcție de configurare, poate funcționa în două moduri:

• modul heuristic, fără AI extern
• modul OpenAI, cu analiză AI, generare de conținut pentru e-mailuri și conversații cu asistentul

Flux tipic de funcționare:

1. Clientul adaugă produse în coș.
2. Clientul părăsește magazinul fără a plasa comanda.
3. După trecerea timpului de inactivitate configurat, coșul este marcat ca abandonat.
4. Modulul atribuie coșului un scoring.
5. Dacă scorul este suficient de mare, se trimite un e-mail de recuperare.
6. E-mailul poate conține un cupon de reducere și un link către pagina asistentului AI.
7. Dacă clientul revine și plasează comanda, coșul este marcat ca recuperat.

Cerințe

Înainte de instalare, asigurați-vă că magazinul îndeplinește următoarele cerințe:

• Magento 2 cu acces la CLI
• cron Magento funcțional corect
• trimiterea e-mailurilor tranzacționale configurată în Magento
• HTTPS activat pe storefront
• dacă este utilizat modul AI: cont OpenAI API cu billing activ și cheie API

Recomandări operaționale:

• mod de producție pentru magazinul live
• șablon de e-mail testat și expeditor setat corect
• politică de confidențialitate care include utilizarea serviciilor AI, dacă modul OpenAI este activat

Instalare

* = în producție folosiți opțiunea --keep-generated

Tip: Composer

1. Adăugați repository-ul Composer în configurare:

   

   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. Sunt disponibile și în panoul clientului după autentificarea pe kowal.store. Înlocuiți TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului dumneavoastră, iar TWOJ_TOKEN cu tokenul primit. Executați comenzile în directorul rădăcină Magento.

   composer config repositories.kowal composer https://repo.kowal.store

2. Configurați accesul la repository-ul Composer Kowal:

   

   composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

3. Instalați modulul prin Composer:

   

   composer require kowal/module-ai-abandoned-cart

Apoi rulați:

bin/magento module:enable Kowal_AiAbandonedCartbin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flush

Checklist după instalare

După instalare, verificați:

• dacă modulul este activat în Magento
• dacă schema bazei de date a fost instalată prin setup:upgrade
• dacă cron Magento funcționează corect
• dacă magazinul trimite e-mailuri tranzacționale
• dacă storefrontul folosește adrese HTTPS corecte

Comenzi utile de verificare:

bin/magento module:status Kowal_AiAbandonedCartbin/magento cron:runbin/magento cache:flush

Configurare

Magento Admin:

Stores -> Configuration -> Kowal -> AI Abandoned Cart

Pagini administrative:

Marketing -> AI Abandoned Cart

Câmpuri de configurare

Cele mai importante setări:

• Enable Module Activează sau dezactivează întregul modul.

• Cart Inactivity Threshold (minutes) Stabilește după câte minute de inactivitate un coș activ trebuie considerat abandonat.

• AI Provider Valori disponibile:

  • Heuristic Fallback
  • OpenAI

• OpenAI API Key Necesar doar atunci când AI Provider este setat la OpenAI.

• Minimum Intent Score Doar coșurile cu un scor egal sau mai mare decât această valoare se califică pentru trimiterea e-mailului de recuperare.

• Enable Dynamic Coupons Activează generarea cupoanelor de unică folosință pentru coșurile abandonate selectate.

• Maximum Coupon Discount Stabilește limita superioară a reducerii procentuale generate automat.

• Maximum Failed Email Attempts Stabilește câte încercări eșuate de trimitere sunt permise înainte ca modulul să înceteze reîncercarea trimiterii.

• Email Address for Message Copies Destinatar BCC opțional pentru mesajele de recuperare.

• Enable AI Assistant Link Dacă opțiunea este activată, e-mailul de recuperare va conține un link securizat către pagina asistentului AI.

• Conversation Expiration Time (minutes) Stabilește cât timp rămâne valabil linkul către asistentul AI.

• Batch Size Definește câte coșuri sunt procesate într-o singură rulare de detecție, scoring și trimitere a e-mailurilor.

• Cart Analysis Prompt Utilizat atunci când scoringul AI este activ.

• Email Generation Prompt Utilizat pentru generarea conținutului mesajelor e-mail în modul AI.

• Conversation Prompt Utilizat de asistentul AI în timpul conversației cu clientul.

Configurare inițială recomandată

Pentru început, un set sigur de setări este:

• Enable Module: Yes
• Cart Inactivity Threshold (minutes): 30
• AI Provider: Heuristic Fallback sau OpenAI
• Minimum Intent Score: 0.45
• Enable Dynamic Coupons: Yes
• Maximum Coupon Discount: 5
• Maximum Failed Email Attempts: 3
• Enable AI Assistant Link: Yes
• Conversation Expiration Time (minutes): 1440
• Batch Size: 100

Modul Heuristic vs modul OpenAI

Modul Heuristic

Folosiți acest mod dacă doriți să începeți fără integrare cu AI extern.

În acest mod, modulul:

• detectează coșurile abandonate
• calculează intent score pe baza regulilor de business încorporate
• trimite e-mailuri de recuperare
• poate genera cupoane
• poate continua să ofere pagina asistentului, dar răspunsurile vor fi bazate pe logica încorporată în loc de OpenAI

Modul OpenAI

Folosiți acest mod dacă doriți o personalizare mai mare.

În acest mod, modulul poate suplimentar:

• analiza contextul coșului folosind OpenAI
• genera conținut mai personalizat pentru e-mailuri
• gestiona conversații cu asistentul AI despre produsele din coș
• utiliza descrieri de produse, produse asociate, up-sell și cross-sell în răspunsuri

Configurarea OpenAI

Pentru a activa modul OpenAI:

1. Creați o cheie API în contul OpenAI Platform.
2. În Magento Admin accesați Stores -> Configuration -> Kowal -> AI Abandoned Cart.
3. Setați AI Provider la OpenAI.
4. Lipiți cheia în câmpul OpenAI API Key.
5. Salvați configurarea.
6. Curățați cache-ul Magento.

Informații importante:

• abonamentele ChatGPT și billingul API sunt lucruri separate
• utilizarea API este facturată independent de OpenAI
• în modul AI, promptul și contextul coșului sunt trimise către OpenAI

Cron Jobs

Modulul folosește cronurile Magento pentru procesarea automată.

Taskuri cron configurate:

• kowal_ai_abandoned_cart_detect
• kowal_ai_abandoned_cart_score
• kowal_ai_abandoned_cart_email

Funcționarea lor:

• detect: caută coșuri inactive care se califică drept abandonate
• score: calculează intent score și reason code
• email: trimite e-mailuri de recuperare și salvează loguri

Dacă cron Magento nu funcționează, modulul nu va procesa automat coșurile.

Primul test după configurare

După instalare și configurare, efectuați un test complet end-to-end:

1. Deschideți storefrontul ca client neautentificat.
2. Adăugați unul sau mai multe produse în coș.
3. Începeți checkoutul și introduceți adresa de e-mail.
4. Părăsiți checkoutul fără a plasa comanda.
5. Așteptați până trece pragul de inactivitate configurat.
6. Rulați cronul sau comenzile CLI manual.
7. Confirmați că coșul a apărut în panoul administrativ.
8. Confirmați că e-mailul de recuperare a fost trimis.
9. Deschideți linkul de restaurare a coșului din mesaj.
10. Dacă opțiunea este activată, deschideți linkul către asistentul AI și trimiteți un mesaj de test.

Secvență CLI manuală:

bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emails

Pagini administrative

Modulul adaugă pagini administrative dedicate la:

Marketing -> AI Abandoned Cart

Secțiuni disponibile:

• Dashboard Prezentare generală a coșurilor detectate și recuperate.

• Recovery Analytics Statistici privind eficiența recuperării și metrici operaționale.

• Conversations Istoricul conversațiilor cu asistentul AI asociate coșurilor abandonate.

• Email Logs Registrul mesajelor de recuperare trimise și eșuate.

Aceste pagini sunt deosebit de utile în timpul implementării, deoarece permit verificarea funcționării corecte a detecției, scoringului, trimiterii e-mailurilor și urmăririi coșurilor recuperate.

Conținutul e-mailurilor și experiența clientului

Fiecare e-mail de recuperare poate conține:

• subiect personalizat
• conținut propriu al mesajului
• rezumatul produselor din coș
• valoarea coșului
• link securizat pentru restaurarea coșului
• cupon de reducere opțional de unică folosință
• link opțional către asistentul AI

Parcursul clientului:

1. Clientul primește e-mailul.
2. Clientul face clic pe linkul de restaurare și revine la coșul salvat.
3. Clientul poate deschide opțional pagina asistentului din mesaj.
4. Asistentul poate răspunde la întrebări despre produse, poate compara opțiuni și poate direcționa clientul înapoi către checkout.

Cum funcționează cupoanele

Dacă cupoanele dinamice sunt activate, modulul poate genera un cupon atunci când:

• valoarea coșului este suficient de mare
• intent score sugerează că o reducere poate ajuta
• reducerea calculată nu depășește maximul configurat

Reguli încorporate actuale:

• coșurile sub 100 de unități ale monedei magazinului nu primesc cupon
• coșurile cu intent score ridicat nu primesc cupon
• coșurile cu intenție mai scăzută pot primi o reducere, de obicei 3% sau 5%, limitată prin configurare

Cupoanele generate sunt:

• de unică folosință
• limitate per client
• asociate cu o regulă de coș Magento partajată pentru nivelul de reducere și magazinul respectiv

CLI

Puteți rula modulul manual din CLI, în special în timpul testelor și diagnosticării.

bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emails

Semnificația comenzilor:

• kowal:ai:cart:detect Detectează coșurile abandonate.

• kowal:ai:cart:score Atribuie coșurilor scoring și reason code.

• kowal:ai:cart:send-emails Trimite mesaje de recuperare pentru coșurile eligibile.

Securitate

Linkurile pentru restaurarea coșului și pentru asistent folosesc tokenuri semnate.

Payloadul tokenului conține:

• quote_id
• email
• store_id
• expires_at

Tokenul este validat prin:

1. verificarea semnăturii
2. verificarea datei de expirare
3. verificarea proprietății coșului

Astfel, clientul primește un link securizat asociat unui coș concret și limitat în timp.

Depanare

Coșurile nu sunt detectate

Verificați:

• dacă quote este încă activ
• dacă coșul conține produse
• dacă quote nu are o comandă finalizată asociată
• dacă adresa de e-mail a clientului a fost capturată
• dacă pragul de inactivitate a trecut
• dacă cron Magento funcționează

Coșurile sunt detectate, dar e-mailurile nu sunt trimise

Verificați:

• dacă Enable Module este activat
• dacă Minimum Intent Score nu este setat prea sus
• dacă trimiterea e-mailurilor funcționează în Magento
• dacă nu a fost atinsă limita Maximum Failed Email Attempts
• dacă adresa de e-mail asociată coșului este corectă

Modul OpenAI este activat, dar rezultatul AI nu este folosit

Verificați:

• dacă AI Provider este setat la OpenAI
• dacă OpenAI API Key este completat corect
• dacă serverul permite conexiuni de ieșire către API OpenAI
• dacă contul OpenAI are billing activ

Dacă apelul OpenAI eșuează, modulul va comuta la comportamentul euristic încorporat.

Linkul către asistentul AI se deschide, dar răspunsurile sunt generale

Verificați:

• dacă modul OpenAI este activ
• dacă promptul conversației este configurat corect
• dacă linkul este încă valabil și nu a expirat

Observații pentru utilizarea în producție

Înainte de lansarea în producție, merită să:

• verificați conținutul mesajelor e-mail și brandingul
• testați politica de cupoane cu reguli de business reale
• verificați cerințele de confidențialitate și compliance
• testați prompturile AI pe catalogul și tonul de comunicare al magazinului
• monitorizați primele zile de funcționare în Dashboard, Conversations și Email Logs

Informații necesare la solicitarea de suport

La raportarea unei probleme, pregătiți:

• versiunea Magento
• versiunea PHP
• modul magazinului: developer sau production
• informația dacă cron funcționează
• informația dacă problema apare în modul heuristic sau OpenAI
• un quote ID exemplu sau adresa de e-mail a clientului vizat de problemă
• intrările relevante din logurile de excepții sau logurile de sistem Magento