Конектор Shopify
Працює з Shopify
Підключіть Shopify до FreeScout, щоб у розмовах показувалися зіставлені замовлення клієнта та контекст покупок. Ви створюєте власний застосунок лише для читання в адмінці Shopify і вставляєте його токен доступу у FreeScout, тож партнерський акаунт чи перевірка застосунку не потрібні. ReplyRabbit також передає контекст володіння продуктами в шар AI, щоб чернетки могли посилатися на те, що купив клієнт.
Шукаєте огляд?
Огляд
Конектор 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 модуль зі списку Modules.
Налаштувати для кожної поштової скриньки
Відкрийте налаштування конектора
У FreeScout відкрийте поштову скриньку, яка має показувати дані замовлень Shopify, відкрийте меню налаштувань поштової скриньки та виберіть Конектор магазину. Це сторінка налаштувань конектора Shopify, а не розділ у налаштуваннях ReplyRabbit.Введіть домен магазину та токен доступу
Введіть домен вашого магазину, наприкладyour-store.myshopify.com, і вставте токен доступу Admin API. Збережіть. Конектор перевіряє токен і області доступу щодо вашого магазину перед збереженням; токен зберігається зашифрованим і більше ніколи не показується.Додайте ліцензійний ключ конектора
Якщо ви придбали конектор, встановітьSHOPIFYINTEGRATION_LICENSE_KEYу вашому FreeScout.envдо його ліцензійного ключа. Пропустіть цей крок, якщо активний план ReplyRabbit Pro чи Team покриває встановлення.Тест
Відкрийте розмову FreeScout, де електронна пошта клієнта збігається із замовленням 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-адреси відхиляються. |
| Бічна панель замовлення не з'являється | Переконайтеся, що панель поштової скриньки увімкнена, а з'єднання відображається як підключене на сторінці налаштувань. |
| Замовлення порожні для відомого клієнта | Переконайтеся, що електронна пошта клієнта в розмові FreeScout збігається з електронною поштою в його замовленнях Shopify. |
| Показуються лише замовлення за останні 60 днів | Додайте read_all_orders область дії для користувацького застосунку, перевстановіть його та вставте новий токен. |
| Позиції, фінансові дані або CLV не відображаються | Переконайтеся, що ліцензійний ключ конектора збережено, або що активний план ReplyRabbit Pro чи Team покриває встановлення. |
| Контекст володіння продуктом не з'являється в чернетках | Переконайтеся, що конектор ліцензовано, ReplyRabbit встановлено, конектор повертає замовлення, а функцію контексту ШІ увімкнено для поштової скриньки. |
Для ширших проблем дивіться Усунення несправностей ReplyRabbit.
Конфіденційність і обробка даних
Коли конектор запитує Shopify, він надсилає електронну адресу клієнта до Shopify GraphQL Admin API через HTTPS, використовуючи токен вашого власного застосунку. Дані замовлень, повернені з вашого магазину, заповнюють бічну панель FreeScout і, разом із ReplyRabbit, формують контекст ШІ для чернеток.
Власний застосунок має лише області дії для читання, тому конектор ніколи не записує у ваш магазин. Токен доступу зберігається в зашифрованому вигляді у FreeScout, а вихідні запити перевіряють TLS і не переходять за перенаправленнями.
Дані замовлень Shopify не надсилаються третім сторонам, окрім як через постачальника ШІ, вибраного для поштової скриньки, і лише коли їх використовує функція контексту ШІ. Якщо ваша політика вимагає, щоб дані замовлень повністю залишалися на ваших власних серверах, використовуйте локального постачальника ШІ (наприклад, Ollama) для поштової скриньки.
Наступні кроки
- Завершити Як налаштувати ReplyRabbit якщо поштова скринька все ще потребує налаштувань провайдера, контексту або стилю.
- Також на WooCommerce чи Magento? Дивіться Конектор WooCommerce і Конектор Magento посібники.
Часті запитання
Як конектор 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?
Так. Кожна поштова скринька зберігає власний домен магазину та токен доступу в налаштуваннях конектора, тож різні магазини можуть підключатися до різних поштових скриньок.