Integracja z platformą PrestaShop

Koszyk.pro integruje się ze sklepami na platformie PrestaShop przez dedykowany moduł PHP i widget JavaScript. Moduł automatycznie przesyła dane o koszykach i zamówieniach przez webhooki, a widget zbiera adresy email bezpośrednio na stronie sklepu.

Instalacja modułu

Połączenie sklepu PrestaShop z Koszyk.pro wymaga zainstalowania modułu PHP:

  1. Zaloguj się do swojego konta w Koszyk.pro.
  2. Przejdź do sekcji „Sklepy" i kliknij przycisk „Dodaj sklep".
  3. Wybierz platformę PrestaShop z listy dostępnych integracji.
  4. Podaj adres URL swojego sklepu — musi zaczynać się od https:// (np. https://mójsklep.pl/shop).
  5. Pobierz moduł — po utworzeniu sklepu otrzymasz widget token i instrukcje instalacji modułu.
  6. Zainstaluj moduł w PrestaShop — przejdź do Moduły → Zarządzanie modułami w panelu administracyjnym PrestaShop i wgraj pobrany plik ZIP.
  7. Skonfiguruj moduł — w ustawieniach modułu wklej widget token otrzymany z Koszyk.pro. Moduł automatycznie zarejestruje się i skonfiguruje webhooki.

Synchronizacja koszyków

PrestaShop przesyła dane o koszykach i zamówieniach przez webhooki w czasie rzeczywistym. Dodatkowo Koszyk.pro może opcjonalnie odpytywać API Webservice PrestaShop.

Webhooki (real-time)

Moduł PHP wysyła webhooki przy następujących zdarzeniach:

  • cart.updated — koszyk został utworzony lub zaktualizowany
  • order.created — zamówienie zostało złożone (koszyk oznaczany jako odzyskany)

Webhooki są zabezpieczone podpisem HMAC-SHA256 w nagłówku X-PrestaShop-Signature. Sekret webhooka jest generowany automatycznie podczas rejestracji modułu.

API Webservice (polling)

Jeśli moduł PrestaShop skonfigurował klucz API Webservice, Koszyk.pro co 15 minut odpytuje endpoint /api/carts, pobierając koszyki zaktualizowane od ostatniej synchronizacji. Wymaga aktywacji Webservice w panelu PrestaShop (Zaawansowane → Webservice).

Detekcja porzucenia

Koszyk uznawany jest za porzucony, gdy:

  • Upłynął skonfigurowany czas od ostatniej aktualizacji koszyka (domyślnie 60 minut).
  • Klient nie złożył zamówienia — dopasowywanie po cart_id lub adresie email.

Widget JS

Widget JavaScript zbiera adresy email klientów bezpośrednio ze strony sklepu. Po zainstalowaniu modułu widget jest automatycznie dodawany do Twojego sklepu.

Jeśli wolisz dodać widget ręcznie, wklej poniższy kod przed zamykającym tagiem </body>: 

<script src="https://app.koszyk.pro/widget/koszyk.js" data-token="TWÓJ_TOKEN"></script>

Token widgetu znajdziesz w panelu Koszyk.pro, w ustawieniach sklepu.

FAQ

Jaka wersja PrestaShop jest wspierana?

Moduł Koszyk.pro wspiera PrestaShop 1.7.x i 8.x. Starsze wersje (1.6 i wcześniejsze) nie są oficjalnie wspierane.

Czy moduł modyfikuje dane w moim sklepie?

Nie. Moduł tylko odczytuje dane koszyków i zamówień oraz wysyła je do Koszyk.pro. Nie modyfikuje żadnych danych w Twoim sklepie PrestaShop.

Czy muszę włączać API Webservice?

Nie jest to wymagane. Webhooki zapewniają dane w czasie rzeczywistym. API Webservice to opcjonalny backup — przydatny, gdy moduł PHP nie mógł wysłać webhooka (np. krótkotrwała awaria serwera).

Jak sprawdzić, czy integracja działa?

W panelu Koszyk.pro przejdź do ustawień sklepu. Jeśli status to „Aktywny" i widoczna jest data ostatniej synchronizacji, integracja działa poprawnie. Dodaj testowy produkt do koszyka w swoim sklepie, aby zobaczyć, czy pojawi się w panelu Koszyk.pro.