Konektor Magento
Współpracuje z Magento
Połącz Magento 2 lub Adobe Commerce z FreeScout, aby rozmowy pokazywały dopasowane zamówienia klientów i kontekst zakupów. Niewielki moduł Magento tylko do odczytu udostępnia podsumowanie wsparcia przez Magento REST API, a konektor FreeScout pokazuje je na pasku bocznym rozmowy. ReplyRabbit przekazuje także kontekst własności produktów do warstwy AI, aby szkice mogły odwoływać się do tego, co klient kupił.
Szukasz przeglądu?
Przegląd
Konektor Magento dodaje pasek boczny zamówienia do rozmów FreeScout. Gdy rozmowa ma adres e-mail klienta, konektor wywołuje moo-support/summary punkt końcowy w Twoim sklepie Magento do dopasowywania zamówień i wyświetla je obok rozmowy.
Pasek boczny pokazuje panel klienta, pełną historię zamówień, pozycje zamówień z ilościami i cenami, sumy finansowe, wartość życiową klienta (CLV), średnią wartość zamówienia (AOV) oraz uprawnienia do posiadania produktu, które trafiają do kontekstu AI ReplyRabbit w celu tworzenia trafniejszych szkiców.
Do zainstalowania są dwa komponenty:
- Ten Moduł konektora ReplyRabbit dla Magento 2. Dodaje dwa punkty końcowe REST tylko do odczytu (
/rest/V1/moo-support/summaryoraz/rest/V1/moo-support/purchased-products) za dedykowanym uprawnieniem administratora o nazwie API konektora ReplyRabbit. Nie zmienia witryny sklepu ani procesu finalizacji zakupu. - Ten Moduł konektora FreeScout Magento. Wywołuje te punkty końcowe przez HTTPS przy użyciu tokenu dostępu integracji Magento i renderuje pasek boczny zamówienia. Ma własną stronę ustawień dla każdej skrzynki w FreeScout.
Panel boczny zamówień działa samodzielnie. Częścią, która korzysta z ReplyRabbit, są uprawnienia do produktów przekazywane do szkiców AI.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Działająca instalacja FreeScout.
- Sklep Magento 2.4 lub nowszy (Magento Open Source lub Adobe Commerce) dostępny przez HTTPS, z dostępem SSH do uruchamiania poleceń CLI Magento.
- Dostęp administracyjny do Magento w celu utworzenia integracji.
- ReplyRabbit zainstalowany i aktywowany, jeśli chcesz kontekst własności produktów w wersjach roboczych AI.
- Licencja Magento Connector (18 EUR jednorazowo, na jedną instalację FreeScout) lub aktywny plan ReplyRabbit Pro albo Team, który ją obejmuje.
Jeśli ReplyRabbit nie jest jeszcze zainstalowany, zacznij od Jak zainstalować moduł ReplyRabbit, a następnie dokończ Jak skonfigurować ReplyRabbit.
Zainstaluj moduł Magento
Pobierz moduł Magento
Zaloguj się na app.replyrabbit.app i pobierz plik ZIP modułu Magento z karty konektora Magento.Rozpakuj to do app/code
Prześlij ZIP do katalogu głównego Magento i rozpakuj go. Tworzyapp/code/Moogento/SupportData.Włącz moduł
Z katalogu głównego Magento uruchom:W sklepie w trybie produkcyjnym uruchom takżebashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploytak jak przy każdej instalacji modułu.
Instalacje Composera
moogento/m2-supportdata z repozytorium pakietów Moogento. Instalacja ZIP powyżej nie wymaga danych uwierzytelniających Composer.Utwórz token integracji Magento
Konektor uwierzytelnia się tokenem dostępu z integracji Magento. Utwórz go z zakresem odpowiadającym uprawnieniu modułu tylko do odczytu.
Otwórz Integrations
W panelu administracyjnym Magento przejdź do System, następnie Rozszerzenia, następnie Integracje, i kliknij Dodaj nową integrację.Nazwij go i ustaw zakres API
Wpisz nazwę, np. "ReplyRabbit Connector", oraz hasło administratora. Na stronie API karta, ustaw Dostęp do zasobów do Niestandardowy i zaznacz tylko API konektora ReplyRabbit (w głównym drzewie administracyjnym). Zapisz.Aktywuj i skopiuj token dostępu
Kliknij Aktywuj obok nowej integracji, a następnie Zezwól. Skopiuj Token dostępu. Magento pokazuje token w szczegółach integracji, więc możesz do niego wrócić później.
Dostęp tylko do odczytu
Zainstaluj moduł łącznika FreeScout
Moduł konektora Magento dla FreeScout wywołuje punkty końcowe Magento i renderuje pasek boczny zamówienia w rozmowach. To osobny moduł z własnymi ustawieniami, niezależny od ReplyRabbit.
Pobierz moduł konektora
Zaloguj się na app.replyrabbit.app aby pobrać ZIP modułu konektora FreeScout. Oba pliki do pobrania pojawiają się po zakupie konektora lub posiadaniu aktywnego planu ReplyRabbit Pro lub Team.Prześlij do FreeScout
W FreeScout przejdź do Moduły, kliknij przycisk przesyłania, wybierz plik ZIP i zainstaluj go.Aktywuj moduł
Aktywuj Integracja Magento moduł z listy modułów.
Skonfiguruj dla każdej skrzynki
Po zainstalowaniu modułu połącz go ze swoim sklepem na własnej stronie ustawień konektora dla skrzynki.
Otwórz ustawienia konektora
W FreeScout otwórz skrzynkę, która powinna pokazywać dane zamówień Magento, otwórz menu ustawień skrzynki i wybierz Konektor sklepu. To jest strona ustawień konektora Magento, a nie sekcja w ustawieniach ReplyRabbit.Wpisz bazowy adres URL Magento
Wklej bazowy adres URL swojego sklepu Magento przez HTTPS, na przykładhttps://your-store.com. Ukośnik na końcu nie jest potrzebny.Wpisz token dostępu
Wklej Token dostępu z integracji Magento. Jest przechowywany zaszyfrowany, a po zapisaniu wyświetlany jest tylko zamaskowany podgląd.Ustaw identyfikator sklepu (opcjonalnie)
Pozostaw puste, aby dopasować zamówienia we wszystkich sklepach. Wprowadź identyfikator sklepu Magento, aby ograniczyć panel boczny do jednego sklepu lub widoku sklepu.Dodaj klucz licencji konektora
Jeśli kupiłeś konektor, wpisz jego klucz licencji. Pomiń ten krok, jeśli aktywny plan ReplyRabbit Pro lub Team obejmuje instalację.Zapisz i przetestuj
Zapisz ustawienia. Otwórz rozmowę FreeScout, w której e-mail klienta pasuje do zamówienia Magento, i potwierdź, że pojawia się panel boczny zamówienia.
Każda skrzynka FreeScout przechowuje własny bazowy URL, token dostępu i identyfikator sklepu, więc możesz połączyć różne skrzynki z różnymi sklepami lub widokami sklepu Magento.
Co pokazuje konektor
- Panel klienta dla osoby w rozmowie.
- Pełna historia zamówień z numerem zamówienia, datą, statusem i sumą.
- Pozycje dla poszczególnych zamówień z ilościami i cenami.
- Sumy finansowe (subtotal, discount, shipping, tax, refunds).
- Wartość życiowa klienta (CLV) i średnia wartość zamówienia (AOV).
- Uprawnienia do własności produktu dla szkiców AI.
Jak zdobyć konektor
Konektor Magento to płatny moduł. Możesz go uzyskać na dwa sposoby:
- Kup Magento Connector za 18 EUR jako jednorazową licencję na jedną instalację FreeScout, a następnie wklej jego klucz licencji w ustawieniach connectora.
- Użyj aktywnego planu ReplyRabbit Pro lub Team, który obejmuje konektor bez dodatkowych kosztów.
Kup licencję lub pobierz connector ze swojego Panel ReplyRabbit. Odwiedź strona z cennikiem dla opcji planów ReplyRabbit. Jeśli aktywny plan ReplyRabbit Pro lub Team obejmuje instalację, konektor działa po skonfigurowaniu, bez potrzeby osobnego klucza licencji.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
| Pasek boczny zamówienia nie pojawia się | Potwierdź, że bazowy adres URL i token dostępu w ustawieniach konektora są poprawne oraz że panel skrzynki jest włączony. |
| HTTP 404 ze sklepu | Moduł ReplyRabbit Connector nie jest zainstalowany lub włączony. Uruchom ponownie bin/magento module:enable Moogento_SupportData oraz bin/magento setup:upgrade, a następnie wyczyść pamięć podręczną. |
| HTTP 401 lub 403 ze sklepu | Integracja nie jest aktywowana, token został ponownie wygenerowany lub integracji brakuje API konektora ReplyRabbit zasób. Aktywuj ponownie integrację i wklej bieżący token. |
| Błąd "Connection refused" lub przekroczenie limitu czasu | Sprawdź, czy serwer FreeScout może połączyć się z adresem URL Twojego sklepu przez HTTPS. Zapory ogniowe, listy dozwolonych adresów IP lub tryb konserwacji mogą blokować żądanie. |
| Bazowy URL jest odrzucany | Sklep musi być obsługiwany przez HTTPS. Zwykły http:// URL lub nieosiągalny host jest odrzucany. |
| Zamówienia są puste dla znanego klienta | Potwierdź, że adres e-mail klienta w rozmowie FreeScout odpowiada adresowi e-mail w jego zamówieniach Magento oraz że identyfikator sklepu (jeśli ustawiony) odpowiada sklepowi, w którym zamówił. |
| Pozycje, finanse lub CLV nie są wyświetlane | Potwierdź, że klucz licencji konektora jest zapisany lub że aktywny plan ReplyRabbit Pro lub Team obejmuje instalację. |
| Kontekst własności produktu nie pojawia się w szkicach | Potwierdź, że konektor jest licencjonowany, ReplyRabbit jest zainstalowany, konektor zwraca zamówienia, a funkcja kontekstu AI jest włączona dla skrzynki. |
Szersze problemy znajdziesz w Rozwiązywanie problemów z ReplyRabbit.
Prywatność i przetwarzanie danych
Gdy konektor odpytuje Magento, wysyła adres e-mail klienta do Twojego własnego sklepu Magento przez HTTPS. Dane zamówień zwrócone z Twojego sklepu zasilają panel boczny FreeScout, a z ReplyRabbit budują kontekst AI dla szkiców.
Token integracji wymaga tylko uprawnienia tylko do odczytu API konektora ReplyRabbit zasób, więc konektor nigdy nie zapisuje do Twojego sklepu. Token jest przechowywany zaszyfrowany w FreeScout, a żądania wychodzące weryfikują TLS i nie podążają za przekierowaniami.
Żadne dane zamówień Magento nie są wysyłane stronom trzecim, z wyjątkiem dostawcy AI wybranego dla skrzynki i tylko wtedy, gdy korzysta z nich funkcja kontekstu AI. Jeśli Twoja polityka wymaga, aby dane zamówień pozostały całkowicie na Twoich serwerach, użyj lokalnego dostawcy AI (takiego jak Ollama) dla skrzynki.
Następne kroki
- Zakończ Jak skonfigurować ReplyRabbit jeśli skrzynka nadal wymaga ustawień dostawcy, kontekstu lub stylu.
- Masz też WooCommerce? Zobacz konektor WooCommerce przewodnik.
FAQ
Czy potrzebuję modułu Magento dla konektora?
Tak. Konektor odczytuje endpoint podsumowania wsparcia, który moduł ReplyRabbit Connector dodaje do REST API Magento 2. Dostępne są dwa pliki do pobrania, moduł Magento i moduł konektora Magento dla FreeScout, oba dostępne na Twoim koncie ReplyRabbit.
Które wersje Magento są obsługiwane?
Magento 2.4 i nowsze, w tym Magento Open Source i Adobe Commerce, na PHP 8.0 do 8.4. Magento 1 nie jest obsługiwane.
Ile kosztuje konektor Magento?
Konektor Magento jest dołączony do aktywnego planu ReplyRabbit Pro lub Team. W przeciwnym razie kosztuje 18 EUR jako jednorazowa licencja na jedną instalację FreeScout. Jeśli go kupisz, wklej jego klucz licencji do ustawień konektora.
Jakie uprawnienia wymaga token dostępu?
Tylko zasób ReplyRabbit Connector API, który jest tylko do odczytu. Konektor nigdy nie zapisuje do Twojego sklepu, więc integracja nie potrzebuje żadnych innych uprawnień administratora.
Czy każda skrzynka FreeScout może łączyć się z innym sklepem Magento?
Tak. Każda skrzynka przechowuje własny bazowy adres URL, token dostępu i opcjonalny identyfikator sklepu w ustawieniach konektora, więc różne sklepy lub widoki sklepów mogą łączyć się z różnymi skrzynkami.