Integracja z platformą WooCommerce

Koszyk.pro integruje się ze sklepami WooCommerce przez dedykowaną wtyczkę WordPress i widget JavaScript. Wtyczka automatycznie przesyła dane o koszykach i zamówieniach przez webhooki, a widget zbiera adresy email bezpośrednio na stronie sklepu.

Instalacja wtyczki

Połączenie sklepu WooCommerce z Koszyk.pro wymaga zainstalowania wtyczki WordPress:

  1. Zaloguj się do swojego konta w Koszyk.pro.
  2. Przejdź do sekcji „Sklepy" i kliknij przycisk „Dodaj sklep".
  3. Wybierz platformę WooCommerce z listy dostępnych integracji.
  4. Podaj adres URL swojego sklepu — musi zaczynać się od https:// (np. https://mójsklep.pl).
  5. Pobierz wtyczkę — po utworzeniu sklepu otrzymasz widget token i instrukcje instalacji wtyczki.
  6. Zainstaluj wtyczkę w WordPress — przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer w panelu administracyjnym WordPress i wgraj pobrany plik ZIP.
  7. Skonfiguruj wtyczkę — w ustawieniach wtyczki (WooCommerce → Koszyk.pro) wklej widget token otrzymany z Koszyk.pro. Wtyczka automatycznie zarejestruje się i skonfiguruje webhooki.

Konfiguracja REST API

Wtyczka Koszyk.pro wymaga dostępu do WooCommerce REST API. Podczas instalacji wtyczka automatycznie generuje klucze Consumer Key i Consumer Secret.

Jeśli wolisz skonfigurować klucze ręcznie:

  1. Przejdź do WooCommerce → Ustawienia → Zaawansowane → REST API.
  2. Kliknij „Dodaj klucz".
  3. Ustaw uprawnienia na „Odczyt" — Koszyk.pro nie modyfikuje danych w Twoim sklepie.
  4. Skopiuj wygenerowane klucze Consumer Key i Consumer Secret do ustawień wtyczki Koszyk.pro.

Synchronizacja koszyków

WooCommerce przesyła dane o koszykach i zamówieniach przez webhooki w czasie rzeczywistym.

Webhooki (real-time)

Wtyczka WordPress wysyła webhooki przy następujących zdarzeniach:

  • cart.updated — koszyk został utworzony lub zaktualizowany
  • checkout.started — klient rozpoczął proces checkout (przechwycenie emaila)
  • order.created — zamówienie zostało złożone (koszyk oznaczany jako odzyskany)

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

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 wtyczki 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 WooCommerce jest wspierana?

Wtyczka Koszyk.pro wspiera WooCommerce 5.0+ na WordPress 5.8+. Zalecamy korzystanie z najnowszych wersji obu platform.

Czy wtyczka modyfikuje dane w moim sklepie?

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

Czy WooCommerce ma natywne API koszyków?

WooCommerce nie udostępnia natywnego API dla koszyków — dlatego wtyczka Koszyk.pro śledzi koszyki po stronie serwera i przesyła dane przez webhooki. Nie jest wymagana dodatkowa konfiguracja API.

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.