Integracja z Magento

Połącz swój sklep Magento 2 (Open Source / Adobe Commerce) z Conviro, aby chatbot mógł śledzić zamówienia, obsługiwać anulowania i zwroty oraz odpowiadać na pytania o produkty bezpośrednio w czacie.

Są dwa sposoby połączenia i oba odblokowują te same możliwości przepływów:

1. Z oficjalnym rozszerzeniem Conviro – zautomatyzowana konfiguracja jednym kliknięciem. Zalecane dla większości sprzedawców.
2. Bez żadnego rozszerzenia – ręczna konfiguracja przy użyciu natywnego API REST Magento plus mały snippet widżetu. Użyj tego, jeśli nie możesz (lub nie chcesz) instalować modułów innych firm.

> Kluczowe: rozszerzenie to warstwa wygody, a nie wymóg. Śledzenie zamówień, anulowanie, zwroty i wyszukiwanie produktów działają przez natywne API REST Magento po stronie backendu Conviro – więc działają w obu przypadkach. Rozszerzenie automatyzuje jedynie konfigurację, wstrzyknięcie widżetu i webhooki zdarzeń.

Wymagania

• Plan Pro lub wyższy
• Magento 2.4+ (Open Source / Community lub Adobe Commerce)
• Dostęp administratora do sklepu Magento
• Twój klucz API Conviro (wygeneruj go w Dashboard -> Settings -> API Keys)

Metoda A – Z oficjalnym rozszerzeniem (zalecane)

Najszybsza droga. Jedno pole, jedno kliknięcie i wszystko jest połączone.

Instalacja

1. Zainstaluj moduł przez Composer:

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <YOUR_CONVIRO_API_KEY>
composer require conviro/module-aichat
php bin/magento module:enable Conviro_AiChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

(Lub prześlij plik ZIP rozszerzenia z panelu Conviro, jeśli nie używasz Composera.)

1. W panelu administracyjnym Magento przejdź do Stores -> Configuration -> Conviro -> AI Chat.
2. Wklej swój klucz API Conviro i kliknij Save Config.

Co dzieje się automatycznie

Po zapisaniu klucza API rozszerzenie:

• Tworzy integrację Magento o nazwie „Conviro AI Chat” z uprawnieniami REST o minimalnym zakresie (Sales orders, Catalog products, Customers, Carts) i generuje token dostępu.
• Rejestruje Twój sklep w Conviro (URL sklepu + token), aby przepływy mogły odczytywać Twoje dane.
• Automatycznie wstrzykuje widżet czatu na każdej stronie sklepu – bez edycji motywu.
• Wysyła webhooki zdarzeń (złożono zamówienie, zmiana statusu zamówienia, zapisano produkt, rejestracja klienta), aby dane pozostawały aktualne niemal w czasie rzeczywistym.
• Przechowuje podpisany sekret webhooka, aby zdarzenia przychodzące/wychodzące były weryfikowane.

To wszystko – Twoje przepływy są aktywne.

Metoda B – Bez rozszerzenia (konfiguracja ręczna)

Nie trzeba instalować żadnego modułu. W ~5 minut zrobisz to, co rozszerzenie robi automatycznie: utworzysz token API i wkleisz snippet widżetu.

Krok 1 – Utwórz integrację Magento (dla przepływów)

1. W panelu administracyjnym Magento przejdź do System -> Extensions -> Integrations.
2. Kliknij Add New Integration.
3. Nadaj nazwę (np. „Conviro”) i wprowadź hasło administratora.
4. Otwórz zakładkę API i przyznaj dostęp do tych zasobów:

• Sales -> Operations -> Orders (wyszukiwanie zamówień, status, anulowanie)
• Catalog -> Inventory -> Products (wyszukiwanie produktów)
• Customers -> Customer (weryfikacja własności klienta/zamówienia)
• (opcjonalnie) Sales -> Operations -> Returns, jeśli używasz przepływu zwrotów

1. Kliknij Save, a następnie Activate.
2. Skopiuj Access Token wyświetlony po aktywacji.

Krok 2 – Połącz w Conviro

1. Przejdź do Dashboard -> Settings -> Integrations -> Magento.
2. Wprowadź URL swojego sklepu (np. https://your-store.com) i wklej Access Token.
3. Kliknij Connect. Conviro weryfikuje token i włącza przepływy e-commerce.

Krok 3 – Dodaj widżet czatu

Ponieważ żadne rozszerzenie nie wstrzykuje widżetu automatycznie, dodaj snippet samodzielnie. Umieść go tuż przed zamykającym znacznikiem body w swoim motywie lub załaduj przez Google Tag Manager:

<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
  cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });
</script>

W Magento najczystszym miejscem jest Content -> Design -> Configuration -> [Twój motyw] -> HTML Head / Footer lub blok Miscellaneous HTML. GTM również działa i przetrwa aktualizacje motywu.

Co daje każda metoda

Podsumowując: wszystkie przepływy skierowane do klienta działają w obu trybach. Bez rozszerzenia rezygnujesz jedynie z konfiguracji jednym kliknięciem, automatycznego wstrzykiwania widżetu i synchronizacji webhookami w czasie rzeczywistym – a każde z nich ma prosty ręczny odpowiednik.

Bezpieczeństwo: weryfikacja własności zamówienia

Obie metody zawierają tę samą ochronę przed zgadywaniem numerów zamówień. Zanim ujawni jakiekolwiek szczegóły zamówienia, przepływ prosi klienta o e-mail przypisany do zamówienia:

1. Klient podaje numer zamówienia.
2. Bot prosi o e-mail użyty przy realizacji zakupu.
3. Conviro ujawnia szczegóły zamówienia tylko wtedy, gdy e-mail zgadza się z zamówieniem.
4. Jeśli się nie zgadza, bot odpowiada dokładnie tak, jakby zamówienia nie znaleziono – dzięki czemu atakujący nie może stwierdzić, czy numer zamówienia jest prawdziwy.

Jest to egzekwowane w backendzie Conviro, niezależnie od rozszerzenia, poprzez krok weryfikacji e-maila w przepływie zamówień. Gotowe szablony przepływów e-commerce już zbierają e-mail przed jakimkolwiek wyszukiwaniem.

Przepływy e-commerce

Użyj gotowych szablonów w Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – sprawdzenie statusu, wysyłki i śledzenia po numerze zamówienia + e-mailu.
• Cancel & Refund – weryfikacja własności, a następnie anulowanie kwalifikującego się zamówienia.
• Returns & Exchanges – weryfikacja własności, zebranie powodu i rozpoczęcie RMA.
• Product Search – znajdowanie produktów po nazwie/SKU i udostępnianie szczegółów w czacie.

Wszystko to wywołuje natywne API REST Magento przy użyciu tokena z Metody A lub B – nie są wymagane żadne niestandardowe endpointy.

Wskazówki

• Użyj rozszerzenia, jeśli możesz – usuwa każdy ręczny krok i utrzymuje aktualność danych dzięki webhookom.
• Użyj trybu ręcznego w zablokowanych sklepach, na marketplace’ach lub gdy polityka bezpieczeństwa zabrania nowych modułów.
• Przyznaj integracji tylko minimalne zasoby, których naprawdę używasz – Returns zawsze możesz dodać później.
• Zacznij od przepływu Order Status; odpowiada na pytanie nr 1 w e-commerce i potwierdza, że połączenie działa.
• Po połączeniu przetestuj, pytając bota o prawdziwe zamówienie (z pasującym e-mailem) oraz o prawdziwy produkt/SKU.