Brevo – Elhagyott Kosár Modul

Mit csinál?

A modul az elhagyott kosár folyamat teljes életciklusát kezeli: felismeri az elhagyott rendeléseket, triggereli a Brevo Automationt, és leállítja az emlékeztetőket, ha a vevő végül vásárol.

• Elhagyott kosár detektálás – Automatikusan felismeri azokat a vevőket, akik elkezdték a checkoutot, de nem fejezték be a vásárlást.
• Kosár visszatöltő link – SHA-256 tokenes, biztonságos recovery link, amely egy kattintással visszatölti a vevő kosarát.
• Brevo Automation trigger – Lista alapú automation: a modul a megfelelő listára helyezi a kontaktot, a Brevo Automation innen veszi át az email sorozatot.
• Duplikáció szűrés – Nem küld emlékeztetőt, ha a vevő az elmúlt X napban már vásárolt hasonló terméket.
• Hírlevél szinkronizálás – Az összes rendelést leadó vevő email címe automatikusan szinkronizálható egy Brevo hírlevél listára.
• Multi-store & multi-currency – A rendelésből veszi a store URL-t és a valutát; több webshop és pénznem is támogatott.

Hogyan működik?

A rendszer három cron script és egy recovery link kezelő segítségével valósítja meg az elhagyott kosár funkciót:

Adatbázis táblák

A telepítés során két tábla jön létre automatikusan (CREATE TABLE IF NOT EXISTS):

Cron scriptek áttekintése

Követelmények

1. Előkészítés Brevóban

A. Két lista létrehozása

Brevo → Contacts → Lists → New list

B. Contact attribútumok létrehozása

Brevo → Contacts → Contact attributes → New attribute

Hozd létre az alábbi 3 attribútumot, mind TEXT típusú:

2. Fájlok feltöltése

Töltsd fel az összes fájlt FTP/SFTP-vel a webshop gyökérkönyvtárába. A ZIP struktúrája megfelel a szerver struktúrájának (1:1 másolás).

3. Telepítés az OpenCart adminban

4. Beállítások megadása az adminban

Általános beállítások

Duplikáció szűrés

Vevők szinkronizálása

Recovery titkos kulcs generálása

php -r "echo bin2hex(random_bytes(16));"

Az eredményt illeszd be a mezőbe. Titkosan kezeld – ha megváltoztatod, az összes korábban kiküldött recovery link érvénytelenné válik.

5. Brevo Automation létrehozása

Brevo → Automations → Create an automation → Create from scratch

Trigger (Triggers fül)

Húzd a canvasra: Contact added to list → válaszd ki az Elhagyott Kosár listát.

Lépések (Actions fül)

Contact added to list: Elhagyott Kosár
  ↓
Send email  ← 1. emlékeztető levél (azonnali)
  ↓
Time delay: 23 óra
  ↓
Send email  ← 2. emlékeztető
  ↓
Time delay: 2 nap
  ↓
Send email  ← 3. emlékeztető (esetleg kuponnal)
  ↓
Remove from list: Elhagyott Kosár  ← lista tisztítás

Exit condition (Rules fül)

Contact removed from list → Elhagyott Kosár lista

6. Email sablon változók

Az email sablonban az alábbi Brevo contact attribútumok érhetők el:

Visszatérés gomb sablonban

<a href="{{ contact.CART_RECOVERY_URL }}"
   style="display:inline-block; background:#e74c3c; color:#fff;
          padding:12px 28px; text-decoration:none; border-radius:4px;
          font-size:15px;">
  Folytatom a vásárlást →
</a>

Termékek táblázat sablonban

<table style="width:100%; border-collapse:collapse;">
  <tr style="background:#f5f5f5;">
    <th style="padding:6px;"></th>
    <th style="padding:6px; text-align:left;">Termék</th>
    <th style="padding:6px;">Mennyiség</th>
    <th style="padding:6px;">Ár</th>
  </tr>
  {{ contact.CART_ITEMS_HTML }}
</table>
<p><strong>Összesen: {{ contact.CART_TOTAL }}</strong></p>

Termék HTML sablon változói (admin beállítás)

Az admin felületen a Termék HTML sablon mezőben az alábbi változók használhatók (minden termékre ismétlődik):

7. Cron beállítása

Az admin felület Cron szekciójában láthatod a pontos fájlútvonalakat a szerveredhez igazítva.

SSH-n futtasd: crontab -e

# Elhagyott kosár – óránként
0 * * * * php /home/user/public_html/system/cron/brevo_abandoned.php >> /home/user/logs/brevo_abandoned.log 2>&1

# Vásárlás befejezve – 30 percenként
*/30 * * * * php /home/user/public_html/system/cron/brevo_completed.php >> /home/user/logs/brevo_completed.log 2>&1

# Vevők szinkronizálása – naponta egyszer hajnali 2-kor
0 2 * * * php /home/user/public_html/system/cron/brevo_sync_contacts.php >> /home/user/logs/brevo_sync.log 2>&1

Kézi tesztelés

php /home/user/public_html/system/cron/brevo_abandoned.php

Elvárt output:

[INFO] 2026-02-10 14:00:01 – Feldolgozandó orderek: 2
[OK]    order_id=1042 → valaki@example.com
[OK]    order_id=1043 → masik@example.com

8. Meglévő vevők szinkronizálása (opcionális)

Ha korábban már szinkronizáltad a vevőket Brevóba, töltsd fel a tracking táblát, hogy a cron ne próbálja újra az összes emailt:

INSERT IGNORE INTO `oc_brevo_contacts` (email, synced_at)
SELECT DISTINCT email, NOW()
FROM `oc_order`
WHERE email != '';

Eltávolítás

Hibaelhárítás

„Nincs jogosultságod" hiba az admin mentésnél

• Admin → System → Users → User Groups → adjunk hozzá extension/module/brevo jogosultságot (view + modify).

Cron script nem fut

• Ellenőrizd a PHP bináris útvonalát: which php.
• Győződj meg róla, hogy az útvonal helyes a crontab sorban.

HTTP 400 / 404 hiba a cron outputban

• Ellenőrizd az API kulcsot (Brevo → Settings → API Keys).
• Győződj meg róla, hogy a Lista ID helyes – a Brevo felületén a lista neve mellett látható a szám.

Recovery link nem működik

• Az order order_status_id már nem 0? Ez szándékos védelem – leadott rendelést nem lehet visszatölteni.
• A RECOVER_SECRET megváltozott? Ha igen, az összes korábban kiküldött link érvénytelen lett.

Termék nem töltődik vissza a kosárba

• A termék valószínűleg status=0 (deaktivált) – a rendszer szándékosan kihagyja az inaktív termékeket.

Email nem érkezik meg, de a cron [OK]-t ír

• Ellenőrizd a Brevo Automation beállítását – aktív-e az automation, és a helyes listára van-e beállítva a trigger.

Fájlszerkezet

Változásnapló