
Konektor Stripe dla FreeScout
Współpracuje z Stripe
Konektor Stripe umieszcza kontekst płatności i subskrypcji klienta obok rozmowy FreeScout. Używa ograniczonego klucza API Stripe tylko do odczytu, więc może wyszukiwać informacje bez zmieniania czegokolwiek w Stripe.
Szukasz przeglądu?
Co pokazuje konektor
Gdy rozmowa w FreeScout zawiera adres e-mail klienta, konektor wyszukuje w Stripe pasującego klienta i ostatnie rekordy płatności. W zależności od znalezionych danych panel boczny może pokazać:
- Tożsamość klienta z nazwą powiązaną z klientem Stripe oraz adresem e-mail i datą klienta od.
- Subskrypcje pokazujące ikonę linku, która otwiera subskrypcję w Stripe, okres, kolorową kropkę statusu, cenę jednostkową pierwszej pozycji z jej interwałem rozliczeniowym, takim jak
€49/mlub€120/y, oraz nazwę produktu (z fallbackiem do pseudonimu ceny, a następnie ogólnej etykiety). Kolumny takie jak Anulowania, Koniec okresu próbnego lub Rabat pojawiają się tylko wtedy, gdy plan je zawiera. - Płatności w tabeli w stylu zamówień: ikona linku otwierająca płatność w Stripe, data, kropka statusu z ikonami ryzyka Radar i weryfikacji karty, suma oraz skrócona lista kupionych pozycji.
- Zwroty i spory pokazane jako szczegóły w wierszu płatności, do którego należą. Kolumna Szczegóły pojawia się tylko wtedy, gdy co najmniej jeden wiersz ma coś do pokazania.
- Nieudane płatności z dostępnym powodem odrzucenia, pokazane w tej samej kolumnie Details.
- Kwoty z symbolem waluty, jeśli istnieje, na przykład
€61lub$12.50, w przeciwnym razie kod waluty; daty są wyświetlane zwięźle, np.Sep 24 '26. - Łączne wartości Pobrano, Zwroty i Netto dla załadowanych płatności.
- Łączenie e-maili: gdy klient pisze z innego adresu niż ten w Stripe, połącz e-mail Stripe z wątkiem, a panel pokaże płatności tego klienta.
- Marka, cztery ostatnie cyfry i data ważności zapisanej metody płatności.
Gdy konektor widzi tylko część historii płatności, pojedyncza notatka pod sumami informuje, że sumy obejmują tylko załadowane płatności. Nie powtarza się przy każdej sumie.
Konektor ogranicza każde wyszukiwanie i sprawdza tylko rekordy powiązane z tym klientem. Nie skanuje całego konta Stripe w poszukiwaniu sporów ani historii płatności. Pusty lub częściowy wynik nie dowodzi, że w Stripe nie istnieje inny rekord.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Działająca instalacja FreeScout.
- Dostęp do panelu Stripe, który pozwala utworzyć ograniczony klucz API.
- Aktywna licencja ReplyRabbit Pro lub Team albo samodzielna licencja Stripe Connector. Samodzielna licencja kosztuje 18 EUR jako jednorazowy zakup na jedną instalację FreeScout.
- ReplyRabbit zainstalowany tylko wtedy, gdy chcesz opcjonalny, jawnie włączony kontekst handlu AI dla wersji roboczych.
Zaloguj się do twój panel ReplyRabbit. Aktywny plan ReplyRabbit Pro lub Team obejmuje pobranie konektora. Jeśli nie masz żadnego z tych planów, kup tam licencję samodzielną, a następnie pobierz konektor i zachowaj jego klucz licencji w panelu.
Utwórz ograniczony klucz API Stripe
Konektor wymaga Stripe klucz z ograniczeniami, a nie klucz tajny. Utwórz nowy klucz ograniczony w panelu Stripe. Ustaw Klienci, Subskrypcje, Faktury, Opłaty, PaymentIntents, PaymentMethods, oraz Spory do Odczyt, i ustaw Produkty do Odczyt aby pokazywać nazwy planów subskrypcji. Bez odczytu Produktów subskrypcje wracają do nazwy ceny lub ogólnej etykiety. Pozostaw każdy niepowiązany zestaw uprawnień na Brak.
Nie wklejaj klucza tajnego
Skopiuj ograniczony klucz, gdy Stripe go wyświetli. Traktuj go jak hasło. Konektor szyfruje go przy zapisie i nigdy więcej nie pokazuje pełnej wartości.
Zainstaluj łącznik
Pobierz Stripe Connector
Zaloguj się na app.replyrabbit.app. Pobierz konektor w ramach aktywnego planu ReplyRabbit Pro lub Team albo najpierw kup licencję samodzielną Stripe Connector.Prześlij to do FreeScout
W FreeScout otwórz Moduły, użyj kontrolki przesyłania, aby wybrać plik ZIP, i zainstaluj go.Aktywuj moduł
Aktywuj Konektor Stripe z listy modułów FreeScout.
Skonfiguruj skrzynkę
Otwórz ustawienia Stripe Connector
Otwórz skrzynkę FreeScout, która ma pokazywać kontekst płatności Stripe, a następnie wybierz Konektor Stripe z jego menu ustawień.Wklej klucz z ograniczonymi uprawnieniami
Włącz konektor i wklej ograniczony klucz Stripe tylko do odczytu. Jeśli kupiłeś samodzielną licencję konektora, wklej także jej klucz licencji z Twojego konta ReplyRabbit. Zainstalowana licencja ReplyRabbit Pro lub Team automatycznie odblokowuje Stripe Connector. Zapisz ustawienia.Przetestuj zapisany klucz
Użyj Przetestuj zapisany klucz aby potwierdzić, że Stripe akceptuje klucz i jego uprawnienie do odczytu klientów.Sprawdź pasującą rozmowę
Otwórz rozmowę, której adres e-mail klienta istnieje w Stripe, i potwierdź, że panel Stripe pojawia się na pasku bocznym.
Każda skrzynka FreeScout przechowuje własny zaszyfrowany klucz Stripe. Możesz połączyć różne konta Stripe z różnymi skrzynkami.
Dopasuj klienta piszącego z innego adresu e-mail
Stripe dopasowuje według adresu e-mail rozmowy. Gdy pisze współpracownik lub klient używa innego adresu niż ten na jego profilu klienta Stripe, powiąż właściwy adres e-mail z wątkiem:
Znajdź panel Stripe
Otwórz rozmowę i znajdź panel Stripe na pasku bocznym.Połącz inny adres e-mail
Wybierz Połącz inny adres e-mail, a następnie wybierz adres z wątku lub wpisz adres rozliczeniowy użyty w Stripe.Sprawdź panel
Panel pokazuje teraz płatności tego klienta, odnotowuje Połączono z adres i oferuje Usuń powiązanie. Ustawienia konektora wyświetlają każdy zapisany link z Usuń akcja na adres.
Łączenie mapuje każdy adres inny niż skrzynka w wątku, nadawcę, Do i DW, na wybrany przez Ciebie adres e-mail Stripe. Te powiązania są przechowywane dla skrzynki, więc przyszłe rozmowy z któregokolwiek z nich prowadzą do tego samego klienta Stripe. Konektor nadal odczytuje tylko dane Stripe.
Opcjonalny kontekst szkicu ReplyRabbit
Pasek boczny działa bez ReplyRabbit. ReplyRabbit jest potrzebny tylko wtedy, gdy chcesz mieć dostępne najnowsze szczegóły Stripe podczas generowania szkiców AI.
Aby wyrazić zgodę, ustaw STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true w środowisku FreeScout, a następnie włącz konektor dla skrzynki. Po stronie ReplyRabbit ustaw albo REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true dla każdej skrzynki lub wybierz Wł. dla jednej skrzynki w sekcji Ustawienia skrzynki, Produkty, Dane sklepu w wersjach roboczych. Ten wiersz pojawia się w widoku Essentials, gdy konektor sklepu jest dostępny dla skrzynki; wcześniej przełącz się na Wszystkie ustawienia, aby go znaleźć. Tylko administrator FreeScout może to zmienić. Wybór skrzynki zastępuje ustawienie serwera; "Użyj ustawienia domyślnego" (domyślnie) podąża za nim. Oba ustawienia są domyślnie wyłączone. Po zmianie wartości środowiska uruchom php artisan config:clear z katalogu FreeScout, aby FreeScout pobrał nowe wartości zamiast buforowanej konfiguracji.
Stripe musi być jedynym aktywnym dostawcą pełnego kontekstu dla tej skrzynki. Jeśli Shopify również dostarcza pełny kontekst handlowy, ReplyRabbit pomija dane handlowe w wersjach roboczych, dopóki nie pozostanie włączony tylko jeden z nich. Wyszukiwania uprawnień Magento i WooCommerce nie kolidują. Pasek boczny Stripe pozostaje dostępny dla agenta pomocy technicznej.
Obsługa danych i limity
Konektor wysyła e-mail z rozmowy do Stripe przez HTTPS, aby znaleźć pasujące rekordy w zakresie klienta. Przechowuje ograniczony klucz w formie zaszyfrowanej. Nie buforuje pełnych numerów kart, surowych ładunków Stripe, adresów rozliczeniowych, metadanych, sekretów intencji płatności ani adresów URL paragonów.
Żądania Stripe używają przypiętego 2026-02-25.clover Wersja API. Gdy żaden rekord Customer nie pasuje, konektor sprawdza nie więcej niż 200 ostatnich obciążeń z ostatnich 90 dni i lokalnie dopasowuje e-mail dokładnie. Ten mechanizm awaryjny dla płatności gości jest celowo niekompletny.
Ograniczone wyszukiwanie utrzymuje responsywność panelu bocznego i ogranicza niepotrzebny dostęp do danych. Jedna notatka pod sumami wyjaśnia, kiedy obejmują one tylko płatności załadowane przez konektor. Do pełnego audytu całego konta użyj panelu Stripe.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
| Stripe odrzuca klucz | Utwórz nowy ograniczony klucz z wymaganymi uprawnieniami do odczytu. Nie używaj pełnego klucza sekretnego. |
| Pasek boczny jest pusty dla znanego kupującego | Potwierdź, że adres e-mail rozmowy FreeScout dokładnie odpowiada adresowi e-mail kupującego w Stripe. Płatności gości są sprawdzane tylko w ograniczonym zakresie 90 dni i 200 opłat. |
| Brakuje zwrotu lub sporu | Konektor sprawdza tylko ograniczony zestaw ostatnich rekordów dla tego klienta. Pełną historię konta sprawdź w panelu Stripe. |
| Wersje robocze ReplyRabbit nie zawierają kontekstu płatności | Potwierdź, że obie flagi środowiskowe kontekstu handlowego są true, konektor Stripe jest dostępny dla skrzynki i żaden inny dostawca handlu nie jest aktywny. |
| Niektóre szczegóły płatności są niedostępne | W przypadku zakupu samodzielnego potwierdź, że klucz licencji Stripe Connector jest zapisany w ustawieniach konektora i aktywny dla zamierzonej domeny FreeScout. W przypadku dostępu w pakiecie potwierdź, że aktywna licencja ReplyRabbit Pro lub Team jest zainstalowana w tej samej witrynie FreeScout. |
Następne kroki
- Odczyt Jak skonfigurować ReplyRabbit jeśli skrzynka nadal wymaga ustawień dostawcy AI lub wersji roboczych.
- Zobacz Konektor Shopify, konektor WooCommerce, lub Konektor Magento przewodniki dla innych platform handlowych.
FAQ
Czy Stripe Connector zapisuje do Stripe?
Nie. Konektor używa ograniczonego klucza API Stripe z wyłącznie udokumentowanymi uprawnieniami do odczytu. Nie tworzy zwrotów, nie anuluje subskrypcji, nie ponawia obciążeń ani nie zmienia danych Stripe.
Jeśli nie pokazano zwrotu ani sporu, czy to oznacza, że żaden nie istnieje w Stripe?
Nie. Konektor sprawdza ograniczony zestaw ostatnich rekordów dla tego klienta. Pusty panel opisuje tylko te rekordy, a nie pełną historię konta Stripe.
Czy dane Stripe mogą być używane w szkicach ReplyRabbit?
Tak, po włączeniu kontekstu handlowego ReplyRabbit i Stripe Connector oraz gdy Stripe jest jedynym aktywnym dostawcą pełnego kontekstu dla skrzynki. Jeśli Shopify również dostarcza pełny kontekst handlowy, ReplyRabbit pomija dane handlowe w szkicach, dopóki nie pozostanie włączony tylko jeden. Wyszukiwania uprawnień Magento i WooCommerce nie kolidują.
Ile kosztuje konektor Stripe?
Konektor Stripe jest dołączony do aktywnego planu ReplyRabbit Pro lub Team. W przeciwnym razie kosztuje 18 EUR jako jednorazowa licencja na jedną instalację FreeScout.
Czy mogę dopasować klienta, który pisze z innego adresu e-mail?
Tak. Otwórz konwersację, wybierz Link another email w panelu Stripe i wybierz adres z wątku lub wpisz go. Powiązania są zapamiętywane dla skrzynki, więc przyszłe konwersacje z dowolnego powiązanego adresu pokażą tego samego klienta Stripe. Panel pokaże wtedy Manually connected i możesz stamtąd odłączyć.