
Конектор Stripe для FreeScout
Працює з Stripe
Конектор Stripe розміщує контекст платежів і підписок клієнта поруч із розмовою FreeScout. Він використовує обмежений ключ Stripe API лише для читання, тож може шукати інформацію, нічого не змінюючи в Stripe.
Шукаєте огляд?
Що показує конектор
Коли розмова FreeScout має електронну адресу клієнта, конектор шукає в Stripe відповідного клієнта та нещодавні записи про платежі. Залежно від знайденого, бічна панель може показати:
- Ідентичність клієнта з ім'ям, пов'язаним із клієнтом Stripe, а також електронною поштою та датою, відколи він клієнт.
- Підписки, що показують значок посилання, який відкриває підписку в Stripe, період, кольорову крапку статусу, ціну за одиницю першої позиції з її інтервалом оплати, як-от
€49/mабо€120/y, і назву продукту (з відкатом до назви ціни, потім до загальної мітки). Стовпці, як-от Cancels, Trial end або Discount, з'являються лише тоді, коли вони є в плані. - Платежі у вигляді таблиці в стилі замовлень: іконка посилання, що відкриває платіж у Stripe, дата, крапка статусу з будь-яким ризиком Radar та іконками перевірки картки, сума та обрізаний список куплених позицій.
- Повернення коштів і спори показані як деталі в рядку платежу, до якого вони належать. Стовпець Details з'являється лише тоді, коли принаймні один рядок має що показати.
- Невдалі платежі з доступною причиною відхилення, показані в тому самому стовпці Details.
- Суми із символом валюти, де він існує, наприклад
€61або$12.50, інакше код валюти; дати відображаються компактно, як-отSep 24 '26. - Захоплені, повернення та чисті підсумки для завантажених платежів.
- Зв'язування електронної пошти: коли клієнт пише з іншої адреси, ніж та, що в Stripe, зв'яжіть електронну пошту Stripe з ланцюжком, і панель покаже платежі цього клієнта.
- Бренд збереженого способу оплати, останні чотири цифри та термін дії.
Коли конектор бачить лише частину історії платежів, одна нотатка під підсумками зазначає, що підсумки охоплюють лише завантажені платежі. Вона не повторюється під кожним підсумком.
Конектор обмежує кожен пошук і перевіряє лише записи, пов'язані з цим клієнтом. Він не сканує весь обліковий запис Stripe на наявність спорів чи історії платежів. Порожній або частковий результат не доводить, що в Stripe немає іншого запису.
Передумови
Перед початком переконайтеся, що у вас є:
- Робоче встановлення FreeScout.
- Доступ до панелі Stripe, що дозволяє створити обмежений ключ API.
- Активна ліцензія ReplyRabbit Pro або Team, або окрема ліцензія Stripe Connector. Окрема ліцензія коштує 18 EUR як одноразова покупка на одне встановлення FreeScout.
- ReplyRabbit встановлено, лише якщо ви хочете додатковий, явно ввімкнений контекст ШІ-комерції для чернеток.
Увійдіть у ваша панель керування ReplyRabbit. Активний план ReplyRabbit Pro або Team включає завантаження конектора. Якщо у вас немає жодного з цих планів, купіть там окрему ліцензію, потім завантажте конектор і зберігайте його ліцензійний ключ у панелі.
Створити обмежений API-ключ Stripe
Конектору потрібен Stripe обмежений ключ, а не секретний ключ. Створіть новий обмежений ключ у панелі Stripe. Встановіть Клієнти, Підписки, Рахунки, Списання, PaymentIntents, PaymentMethods, і Спори до Читати, і встановіть Продукти до Читати щоб показувати назви планів підписки. Без дозволу на читання Products підписки відображаються як назва ціни або загальна мітка. Залиште всі не пов'язані набори дозволів у Немає.
Не вставляйте секретний ключ
Скопіюйте обмежений ключ, коли Stripe його покаже. Поводьтеся з ним як із паролем. Конектор шифрує його під час збереження і більше ніколи не показує повне значення.
Встановіть конектор
Завантажити Stripe Connector
Увійдіть за адресою app.replyrabbit.app. Завантажте конектор через ваш активний план ReplyRabbit Pro або Team, або спершу придбайте окрему ліцензію Stripe Connector.Завантажте його у FreeScout
У FreeScout відкрийте Модулі, скористайтеся елементом керування завантаженням, щоб вибрати ZIP, і встановіть його.Активуйте модуль
Активувати Конектор Stripe зі списку модулів FreeScout.
Налаштувати поштову скриньку
Відкрити налаштування Stripe Connector
Відкрийте поштову скриньку FreeScout, яка має показувати контекст платежів Stripe, потім виберіть Конектор Stripe з його меню налаштувань.Вставте обмежений ключ
Увімкніть конектор і вставте обмежений ключ Stripe лише для читання. Якщо ви придбали окрему ліцензію конектора, також вставте її ліцензійний ключ зі свого облікового запису ReplyRabbit. Встановлена ліцензія ReplyRabbit Pro або Team автоматично розблоковує Stripe Connector. Збережіть налаштування.Перевірити збережений ключ
Використовувати Перевірити збережений ключ щоб підтвердити, що Stripe приймає ключ і його дозвіл на читання клієнтів.Перевірте відповідну розмову
Відкрийте розмову, електронна адреса клієнта якої є в Stripe, і переконайтеся, що панель Stripe з'являється на бічній панелі.
Кожна поштова скринька FreeScout зберігає власний зашифрований ключ Stripe. Ви можете підключати різні акаунти Stripe до різних поштових скриньок.
Зіставити клієнта, який пише з іншої електронної адреси
Stripe зіставляє за адресою електронної пошти розмови. Коли пише колега або клієнт використовує іншу адресу, ніж та, що в його клієнті Stripe, прив'яжіть правильну електронну пошту до ланцюжка:
Знайдіть панель Stripe
Відкрийте розмову та знайдіть панель Stripe на бічній панелі.Прив'язати іншу електронну адресу
Вибрати Прив'язати іншу електронну адресу, потім виберіть адресу з ланцюжка або введіть платіжну адресу, використану в Stripe.Перевірте панель
Панель тепер показує платежі цього клієнта, зазначає Прив'язано до адресу, і пропонує Видалити посилання. Налаштування конектора перелічують кожне збережене посилання з Видалити дія на адресу.
Прив'язування зіставляє кожну адресу, відмінну від поштової скриньки, у ланцюжку, відправника, To та Cc, з обраною вами адресою Stripe. Ці зв'язки зберігаються для поштової скриньки, тому майбутні розмови з будь-якої з них ведуть до того самого клієнта Stripe. Конектор, як і раніше, лише читає дані Stripe.
Необов'язковий контекст чернетки ReplyRabbit
Бічна панель працює без ReplyRabbit. ReplyRabbit потрібен лише тоді, коли ви хочете мати останні дані Stripe під час генерації AI-чернеток.
Щоб увімкнути, встановіть STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true у середовищі FreeScout, потім увімкніть конектор для поштової скриньки. З боку ReplyRabbit або задайте REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true для кожної поштової скриньки, або виберіть On для однієї поштової скриньки в розділі Mailbox settings, Products, Store data in drafts. Цей рядок відображається в поданні Essentials, щойно для поштової скриньки стає доступним конектор магазину; до того перемкніться на All settings, щоб знайти його. Лише адміністратор FreeScout може його змінити. Вибір поштової скриньки перевизначає налаштування сервера; "Use the default setting" (за замовчуванням) дотримується його. Обидва налаштування за замовчуванням вимкнені. Після зміни значень середовища запустіть php artisan config:clear з каталогу FreeScout, щоб FreeScout підхопив нові значення замість кешованої конфігурації.
Stripe має бути єдиним активним провайдером повного контексту для цієї поштової скриньки. Якщо Shopify також надає повний контекст торгівлі, ReplyRabbit залишає дані торгівлі поза чернетками, доки не залишиться ввімкненим лише один. Перевірки прав Magento та WooCommerce не конфліктують. Бічна панель Stripe залишається доступною агенту підтримки.
Обробка даних і обмеження
Конектор надсилає електронну адресу розмови до Stripe через HTTPS, щоб знайти відповідні записи, обмежені конкретним клієнтом. Він зберігає обмежений ключ у зашифрованому вигляді. Він не кешує повні номери карток, необроблені дані Stripe, платіжні адреси, метадані, секрети платіжних намірів або URL-адреси квитанцій.
Запити Stripe використовують закріплений 2026-02-25.clover Версія API. Коли жоден запис Customer не збігається, конектор перевіряє не більше 200 недавніх списань за останні 90 днів і точно зіставляє електронну пошту локально. Цей резервний варіант для гостьових платежів навмисно неповний.
Обмежений пошук зберігає швидкість бічної панелі та зменшує непотрібний доступ до даних. Примітка під підсумками пояснює, коли вони охоплюють лише платежі, які завантажив конектор. Для повного аудиту в межах усього облікового запису використовуйте панель Stripe.
Усунення несправностей
| Симптом | Що перевірити |
|---|---|
| Stripe відхиляє ключ | Створіть новий обмежений ключ із потрібними дозволами на читання. Не використовуйте повний секретний ключ. |
| Бічна панель порожня для відомого покупця | Переконайтеся, що електронна пошта розмови FreeScout точно збігається з електронною поштою покупця в Stripe. Гостьові платежі перевіряються лише в межах обмеженого резервного пошуку за 90 днів і 200 списань. |
| Відсутнє повернення коштів або спір | Конектор перевіряє лише обмежений набір останніх записів для цього клієнта. Повну історію облікового запису дивіться в панелі Stripe. |
| Чернетки ReplyRabbit не містять платіжного контексту | Переконайтеся, що обидва прапорці середовища контексту комерції true, конектор Stripe доступний для поштової скриньки, і жоден інший комерційний провайдер не активний. |
| Деякі дані про платежі недоступні | Для окремої покупки переконайтеся, що ліцензійний ключ Stripe Connector збережено в налаштуваннях конектора і він активний для потрібного домену FreeScout. Для включеного доступу переконайтеся, що активна ліцензія ReplyRabbit Pro або Team встановлена на тому самому сайті FreeScout. |
Наступні кроки
- Читати Як налаштувати ReplyRabbit якщо поштова скринька все ще потребує налаштувань провайдера ШІ або чернеток.
- Див. Конектор Shopify, Конектор WooCommerce, або Конектор Magento посібники для інших комерційних платформ.
Часті запитання
Чи записує Stripe Connector до Stripe?
Ні. Конектор використовує обмежений ключ API Stripe лише з задокументованими правами читання. Він не створює повернень, не скасовує підписки, не повторює платежі та не змінює дані Stripe.
Якщо не показано жодного повернення коштів або спору, чи це означає, що їх немає в Stripe?
Ні. Конектор перевіряє обмежений набір останніх записів для цього клієнта. Порожня панель описує лише ці записи, а не повну історію облікового запису Stripe.
Чи можна використовувати дані Stripe у чернетках ReplyRabbit?
Так, після того як ви ввімкнете комерційний контекст ReplyRabbit і Stripe Connector, і Stripe буде єдиним активним постачальником повного контексту для поштової скриньки. Якщо Shopify також надає повний комерційний контекст, ReplyRabbit не включає комерційні дані в чернетки, доки не залишиться ввімкненим лише один. Перевірки прав Magento і WooCommerce не конфліктують.
Скільки коштує конектор Stripe?
Stripe Connector входить до активного плану ReplyRabbit Pro або Team. Інакше він коштує 18 EUR як одноразова ліцензія для одного встановлення FreeScout.
Чи можу я зіставити клієнта, який пише з іншої електронної пошти?
Так. Відкрийте розмову, виберіть Link another email на панелі Stripe і виберіть адресу з ланцюжка або введіть її. Зв'язки запам'ятовуються для поштової скриньки, тож майбутні розмови з будь-якої пов'язаної адреси показуватимуть того самого клієнта Stripe. Панель тоді показує Manually connected, і звідти можна від'єднати.