Коннектор Shopify
Работает с Shopify
Подключите Shopify к FreeScout, чтобы в обращениях отображались сопоставленные заказы клиента и контекст покупок. Вы создаёте пользовательское приложение только для чтения в админке Shopify и вставляете его токен доступа во FreeScout, поэтому не нужны ни партнёрский аккаунт, ни проверка приложения. ReplyRabbit также передаёт контекст принадлежности товаров в слой ИИ, чтобы черновики могли ссылаться на то, что купил клиент.
Ищете обзор?
Обзор
Коннектор Shopify добавляет боковую панель заказа в переписки FreeScout. Когда в переписке есть адрес электронной почты клиента, коннектор запрашивает GraphQL Admin API Shopify вашего магазина на совпадающие заказы и показывает их рядом с перепиской.
Боковая панель показывает панель клиента, полную историю заказов, позиции по каждому заказу с количеством и ценами, финансовые итоги, пожизненную ценность клиента (CLV), среднюю стоимость заказа (AOV) и право на владение продуктом, которое передаётся в контекст ReplyRabbit AI для более релевантных черновиков.
Есть один компонент для установки: Модуль коннектора Shopify для FreeScout. Он читает Shopify GraphQL Admin API по HTTPS, используя токен доступа Admin API из пользовательского приложения, затем отображает боковую панель заказа. У него есть собственная страница настроек для каждого почтового ящика в FreeScout.
Боковая панель заказов работает сама по себе. Права на продукты, которые передаются в черновики AI, это часть, использующая ReplyRabbit.
Предварительные требования
Перед началом убедитесь, что у вас есть:
- Работающая установка FreeScout.
- Магазин Shopify на
your-store.myshopify.comдомен (или собственный домен, который на него указывает), с правами сотрудника для разработки приложений. - ReplyRabbit установлен и активирован, если вы хотите контекст владения продуктами в черновиках ИИ.
- Лицензия Shopify Connector (18 EUR единоразово, для одной установки FreeScout) или активный тариф ReplyRabbit Pro или Team, который её включает.
Если ReplyRabbit ещё не установлен, начните с Как установить модуль ReplyRabbit, затем завершите Как настроить ReplyRabbit.
Создать пользовательское приложение в Shopify
Коннектор аутентифицируется с помощью токена доступа Admin API из пользовательского приложения, которое находится в вашем собственном магазине.
Открыть Develop apps
В админке Shopify перейдите в Настройки, затем Приложения и каналы продаж, затем Разработка приложений. Если будет предложено, разрешите разработку пользовательских приложений.Создать приложение
Нажмите Создать приложение, назовите его "ReplyRabbit Connector" и создайте его.Установите области доступа Admin API
Открыть Настройте области Admin API и отметьтеread_customers,read_orders, иread_products. Отметьтеread_all_ordersтакже, если вам нужна история заказов старше 60 дней. Сохраните.Установите и скопируйте токен
Нажмите Установить приложение, затем Показать токен один раз и скопируйте Токен доступа Admin API (начинается сshpat_). Shopify показывает его только один раз, поэтому сохраните его в надёжном месте.
Доступ только для чтения
Установите модуль-коннектор FreeScout
Скачать модуль коннектора
Скачайте ZIP-архив модуля коннектора FreeScout из Панель управления ReplyRabbit. Загрузка появляется после того, как вы купили коннектор или имеете активный план ReplyRabbit Pro или Team.Загрузить в FreeScout
В FreeScout перейдите в Модули, нажмите кнопку загрузки, выберите ZIP и установите его.Активируйте модуль
Активируйте Интеграция с Shopify модуль из списка модулей.
Настроить для каждого почтового ящика
Откройте настройки коннектора
В FreeScout откройте почтовый ящик, который должен показывать данные заказов Shopify, откройте меню настроек почтового ящика и выберите Коннектор магазина. Это страница настроек коннектора Shopify, а не раздел внутри настроек ReplyRabbit.Введите домен магазина и токен доступа
Введите домен вашего магазина, напримерyour-store.myshopify.com, и вставьте токен доступа Admin API. Сохраните. Коннектор проверяет токен и области доступа в вашем магазине перед сохранением; токен хранится в зашифрованном виде и больше не отображается.Добавьте лицензионный ключ коннектора
Если вы купили коннектор, задайтеSHOPIFYINTEGRATION_LICENSE_KEYв вашем FreeScout.envк его лицензионному ключу. Пропустите этот шаг, если установку покрывает активный план ReplyRabbit Pro или Team.Тест
Откройте разговор в FreeScout, где email клиента совпадает с заказом Shopify, и убедитесь, что боковая панель заказа появилась.
Каждый почтовый ящик FreeScout хранит свой собственный домен магазина и токен доступа, поэтому вы можете подключать разные почтовые ящики к разным магазинам.
Что показывает коннектор
- Панель клиента для человека, работающего с беседой.
- Полная история заказов с номером заказа, датой, статусом и суммой.
- Позиции по каждому заказу с количеством и ценами.
- Финансовые итоги (подытог, скидка, доставка, налог, возвраты).
- Пожизненная ценность клиента (CLV) и средняя стоимость заказа (AOV).
- Право доступа к товару для черновиков ИИ.
Как получить коннектор
Коннектор Shopify - это платный модуль. Вы можете получить его двумя способами:
- Купите Shopify Connector за 18 EUR как разовую лицензию на одну установку FreeScout, затем задайте его лицензионный ключ как
SHOPIFYINTEGRATION_LICENSE_KEYв FreeScout.env. - Используйте активный тариф ReplyRabbit Pro или Team, который включает коннектор без дополнительной платы.
Купите лицензию или скачайте коннектор из своего Панель управления ReplyRabbit. Посетите страница с ценами для вариантов плана ReplyRabbit. Если активный план ReplyRabbit Pro или Team покрывает установку, коннектор работает после настройки, без отдельного лицензионного ключа.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| "Shopify отклонил подключение" при сохранении | Токен был введён с ошибкой, отозван или принадлежит другому магазину. Покажите новый токен, переустановив пользовательское приложение, и вставьте его снова. |
| "Отсутствуют следующие области Admin API" при сохранении | Откройте пользовательское приложение, добавьте недостающие области доступа в разделе Настройте области Admin API, сохраните и переустановите приложение. Переустановка выдаёт новый токен. |
| Домен магазина отклонён | Используйте your-store.myshopify.com домен или собственный домен, который на него указывает. Частные хосты и IP-адреса отклоняются. |
| Боковая панель заказа не отображается | Убедитесь, что панель почтового ящика включена и подключение отображается как подключённое на странице настроек. |
| Заказы пусты для известного клиента | Убедитесь, что email клиента в разговоре FreeScout совпадает с email в его заказах Shopify. |
| Показываются только заказы за последние 60 дней | Добавьте read_all_orders область действия на пользовательское приложение, переустановите его и вставьте новый токен. |
| Позиции, финансы или CLV не отображаются | Убедитесь, что лицензионный ключ коннектора сохранён или что активный тариф ReplyRabbit Pro или Team покрывает установку. |
| Контекст владения товаром не появляется в черновиках | Убедитесь, что коннектор лицензирован, ReplyRabbit установлен, коннектор возвращает заказы и функция контекста ИИ включена для почтового ящика. |
Для более широких проблем см. Устранение неполадок ReplyRabbit.
Конфиденциальность и обработка данных
Когда коннектор запрашивает Shopify, он отправляет адрес электронной почты клиента в Shopify GraphQL Admin API по HTTPS с использованием токена вашего пользовательского приложения. Данные о заказах, возвращённые из вашего магазина, заполняют боковую панель FreeScout и, вместе с ReplyRabbit, формируют контекст ИИ для черновиков.
Пользовательское приложение имеет только области действия для чтения, поэтому коннектор никогда не записывает данные в ваш магазин. Токен доступа хранится в FreeScout в зашифрованном виде, а исходящие запросы проверяют TLS и не следуют перенаправлениям.
Данные заказов Shopify не передаются третьим сторонам, кроме как через AI-провайдера, выбранного для почтового ящика, и только когда их использует функция AI-контекста. Если ваша политика требует, чтобы данные заказов полностью оставались на ваших собственных серверах, используйте локального AI-провайдера (например, Ollama) для почтового ящика.
Следующие шаги
- Завершить Как настроить ReplyRabbit если почтовому ящику всё ещё нужны настройки провайдера, контекста или стиля.
- Также на WooCommerce или Magento? Смотрите коннектор WooCommerce и Коннектор Magento руководства.
FAQ
Как коннектор Shopify подключается к моему магазину?
С пользовательским приложением, которое вы создаёте в админке Shopify (Settings, Apps and sales channels, Develop apps). Дайте ему области read_customers, read_orders и read_products, установите его и вставьте его токен доступа Admin API вместе с доменом вашего магазина в настройки коннектора FreeScout. Коннектор проверяет токен в вашем магазине перед сохранением.
Нужен ли мне аккаунт Shopify Partner или листинг в App Store?
Нет. Пользовательское приложение создаётся в админке вашего собственного магазина и не требует аккаунта партнёра, проверки приложения и публичного листинга.
Сколько стоит коннектор Shopify?
Коннектор Shopify включён в активный тариф ReplyRabbit Pro или Team. В противном случае он стоит 18 EUR как разовая лицензия для одной установки FreeScout. Если вы его покупаете, задайте его лицензионный ключ как SHOPIFYINTEGRATION_LICENSE_KEY в вашем FreeScout .env.
Почему я вижу только заказы за последние 60 дней?
Shopify ограничивает приложения 60 днями истории заказов, если у приложения нет области доступа read_all_orders. Отметьте read_all_orders при настройке пользовательского приложения, чтобы видеть полную историю.
Может ли каждый почтовый ящик FreeScout подключаться к разному магазину Shopify?
Да. Каждый почтовый ящик хранит собственный домен магазина и access token в настройках коннектора, поэтому разные магазины могут подключаться к разным почтовым ящикам.