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 de cumpărături AI
• panou de administrare ș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 mesajelor 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ă expirarea timpului de inactivitate configurat, coșul este marcat ca abandonat.
4. Modulul atribuie un scor coșului.
5. Dacă rezultatul este suficient de mare, este trimis un e-mail de recuperare.
6. E-mailul poate include 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, asigură-te că magazinul îndeplinește cerințele de mai jos:

• 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 production 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 folosește opțiunea --keep-generated

Tip: Composer

1. Adaugă repository-ul Composer în configurare:

   

   composer config repositories.ai.abandoned.cart vcs https://github.com/kowalco/ai-abandoned-cart

2. Adaugă tokenul de acces la repository-ul privat GitHub:

   

   composer config --global --auth github-oauth.github.com 

3. Instalează modulul prin Composer:

   

   composer require kowal/module-ai-abandoned-cart

Apoi rulează:

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

Checklist după instalare

După instalare, verifică:

• 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ă storefront 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 de trimitere eșuate sunt permise înainte ca modulul să nu mai reîncerce trimiterea.

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

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

• Conversation Expiration Time (minutes) Stabilește cât timp rămâne valid 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 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

Folosește acest mod dacă vrei să începi fără integrare cu AI extern.

În acest mod, modulul:

• detectează coșurile abandonate
• calculează intent score pe baza regulilor de business integrate
• trimite e-mailuri de recuperare
• poate genera cupoane
• poate pune în continuare la dispoziție pagina asistentului, dar răspunsurile vor fi bazate pe logica integrată în loc de OpenAI

Modul OpenAI

Folosește acest mod dacă ai nevoie de 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 descrierile produselor, produsele asociate, up-sell și cross-sell în răspunsuri

Configurare OpenAI

Pentru a activa modul OpenAI:

1. Creează o cheie API în contul OpenAI Platform.
2. În Magento Admin, mergi la Stores -> Configuration -> Kowal -> AI Abandoned Cart.
3. Setează AI Provider la OpenAI.
4. Lipește cheia în câmpul OpenAI API Key.
5. Salvează configurarea.
6. Curăță 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 procesare automată.

Joburi cron configurate:

• kowal_ai_abandoned_cart_detect
• kowal_ai_abandoned_cart_score
• kowal_ai_abandoned_cart_email

Funcționarea acestora:

• 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ă logurile

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

Primul test după configurare

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

1. Deschide storefront ca utilizator neautentificat.
2. Adaugă unul sau mai multe produse în coș.
3. Începe checkoutul și introdu adresa de e-mail.
4. Părăsește checkoutul fără a plasa comanda.
5. Așteaptă până trece pragul de inactivitate configurat.
6. Rulează cron sau comenzile CLI manual.
7. Confirmă că respectivul coș a apărut în panoul de administrare.
8. Confirmă că e-mailul de recuperare a fost trimis.
9. Deschide linkul de restaurare a coșului din mesaj.
10. Dacă opțiunea este activată, deschide linkul către asistentul AI și trimite 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 include:

• 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, compara opțiuni și ghida 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ă reducerea poate ajuta
• reducerea calculată nu depășește maximul configurat

Reguli integrate actuale:

• coșurile sub 100 de unități din moneda 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

Poți rula modulul manual din CLI, mai ales î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 include:

• 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 cu un coș concret și limitat în timp.

Depanare

Coșurile nu sunt detectate

Verifică:

• dacă quote este încă activ
• dacă respectivul coș conține produse
• dacă quote nu are asociată o comandă finalizată
• 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

Verifică:

• 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 atribuită coșului este corectă

Modul OpenAI este activat, dar rezultatul AI nu este utilizat

Verifică:

• dacă AI Provider este setat la OpenAI
• dacă OpenAI API Key este completat corect
• dacă serverul permite conexiuni outbound către API OpenAI
• dacă respectivul cont OpenAI are billing activ

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

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

Verifică:

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

Observații pentru utilizarea în producție

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

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

Informații necesare la trimiterea unei solicitări de suport

La raportarea unei probleme, pregătește:

• 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 exemplu de quote ID sau adresa de e-mail a clientului vizat de problemă
• intrările relevante din logurile de excepții sau din logurile de sistem Magento