
Коннектор Stripe для FreeScout
Работает с Stripe
Коннектор Stripe помещает контекст платежей и подписок клиента рядом с разговором FreeScout. Он использует ограниченный ключ Stripe API только для чтения, поэтому может искать информацию, ничего не меняя в Stripe.
Ищете обзор?
Что показывает коннектор
Когда в переписке FreeScout есть адрес электронной почты клиента, коннектор ищет в Stripe совпадающего клиента и недавние записи о платежах. В зависимости от найденного боковая панель может показать:
- Идентификация клиента, где имя связано с клиентом Stripe, а также email и дата, с которой клиент с нами.
- Подписки, показывающие иконку ссылки, открывающую подписку в 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
Войдите на 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 принимает ключ и его разрешение на чтение клиентов.Проверьте подходящий разговор
Откройте диалог, в котором email клиента существует в Stripe, и убедитесь, что панель Stripe отображается в боковой панели.
Каждый почтовый ящик FreeScout хранит свой собственный зашифрованный ключ Stripe. Вы можете подключать разные аккаунты Stripe к разным почтовым ящикам.
Сопоставить клиента, который пишет с другого email
Stripe сопоставляет по адресу электронной почты разговора. Когда пишет коллега или клиент использует другой адрес, отличный от адреса его клиента в Stripe, привяжите правильный адрес к цепочке:
Найдите панель Stripe
Откройте диалог и найдите панель Stripe в боковой панели.Привязать другой email
Выбрать Привязать другой email, затем выберите адрес из цепочки или введите платёжный адрес, использованный в Stripe.Проверьте панель
Панель теперь показывает платежи этого клиента, отмечает Привязано к адрес и предлагает Удалить связь. В настройках коннектора перечислены все сохранённые ссылки с Удалить действие на адрес.
Привязка сопоставляет каждый не почтовый адрес в переписке, отправителя, To и Cc с выбранным вами email Stripe. Эти связи хранятся для почтового ящика, поэтому будущие переписки с любого из них будут соответствовать одному и тому же клиенту Stripe. Коннектор по-прежнему только читает данные Stripe.
Необязательный контекст черновика ReplyRabbit
Боковая панель работает без ReplyRabbit. ReplyRabbit нужен только если вы хотите, чтобы последние данные Stripe были доступны при генерации AI-черновиков.
Чтобы включить, установите STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true в окружении FreeScout, затем включите коннектор для почтового ящика. Со стороны ReplyRabbit либо задайте REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true для каждого почтового ящика, или выберите On для одного почтового ящика в разделе Настройки почтового ящика, Продукты, Данные магазина в черновиках. Эта строка отображается в представлении Essentials, как только для почтового ящика доступен коннектор магазина; до этого переключитесь на Все настройки, чтобы найти её. Изменять её может только администратор FreeScout. Выбор почтового ящика переопределяет настройку сервера; "Использовать настройку по умолчанию" (по умолчанию) следует за ней. Обе настройки по умолчанию выключены. После изменения значений окружения запустите php artisan config:clear из каталога FreeScout, чтобы FreeScout подхватил новые значения вместо кешированной конфигурации.
Stripe должен быть единственным активным провайдером полного контекста для этого почтового ящика. Если Shopify также предоставляет полный коммерческий контекст, ReplyRabbit исключает коммерческие данные из черновиков, пока не останется только один включённый. Проверки прав Magento и WooCommerce не конфликтуют. Боковая панель Stripe остаётся доступной агенту поддержки.
Обработка данных и ограничения
Коннектор отправляет электронную почту из переписки в Stripe по HTTPS, чтобы найти совпадающие записи, связанные с клиентом. Он хранит ограниченный ключ в зашифрованном виде. Он не кэширует полные номера карт, необработанные данные Stripe, платёжные адреса, метаданные, секреты payment intent или URL квитанций.
Запросы Stripe используют закреплённый 2026-02-25.clover Версия API. Когда ни одна запись Customer не совпадает, коннектор проверяет не более 200 недавних списаний за последние 90 дней и точно сопоставляет электронную почту локально. Этот резервный вариант для гостевых платежей намеренно неполный.
Ограниченный запрос сохраняет отзывчивость боковой панели и сокращает ненужный доступ к данным. Одно примечание под итогами объясняет, когда они охватывают только платежи, загруженные коннектором. Для полного аудита по всему аккаунту используйте панель Stripe.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Stripe отклоняет ключ | Создайте новый ограниченный ключ с необходимыми разрешениями на чтение. Не используйте полный секретный ключ. |
| Боковая панель пуста для известного покупателя | Убедитесь, что email разговора FreeScout точно совпадает с email покупателя в Stripe. Гостевые платежи проверяются только в ограниченном резервном поиске за 90 дней и 200 списаний. |
| Возврат или спор отсутствует | Коннектор проверяет только ограниченный набор недавних записей для этого клиента. Полную историю аккаунта смотрите в панели Stripe. |
| Черновики ReplyRabbit не включают платёжный контекст | Убедитесь, что оба флага окружения контекста коммерции true, коннектор Stripe доступен для почтового ящика, и другой поставщик коммерции не активен. |
| Некоторые сведения о платеже недоступны | Для отдельной покупки подтвердите, что лицензионный ключ Stripe Connector сохранён в настройках коннектора и активен для нужного домена FreeScout. Для входящего доступа подтвердите, что активная лицензия ReplyRabbit Pro или Team установлена на том же сайте FreeScout. |
Следующие шаги
- Чтение Как настроить ReplyRabbit если почтовому ящику всё ещё нужны настройки провайдера ИИ или черновиков.
- См. Коннектор Shopify, коннектор WooCommerce, или Коннектор Magento руководства для других торговых платформ.
FAQ
Записывает ли коннектор Stripe данные в 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, и оттуда можно отвязать адрес.