Конектор Magento
Працює з Magento
Підключіть Magento 2 або Adobe Commerce до FreeScout, щоб у розмовах показувалися зіставлені замовлення клієнта та контекст покупок. Невеликий модуль Magento лише для читання надає зведення підтримки через REST API Magento, а конектор FreeScout показує його на бічній панелі розмови. ReplyRabbit також передає контекст володіння продуктами в шар AI, щоб чернетки могли посилатися на те, що купив клієнт.
Шукаєте огляд?
Огляд
Конектор Magento додає бічну панель замовлення до розмов FreeScout. Коли розмова має адресу електронної пошти клієнта, конектор викликає moo-support/summary кінцева точка на вашому магазині Magento для зіставлення замовлень і показує їх поруч із розмовою.
Бічна панель показує панель клієнта, повну історію замовлень, позиції кожного замовлення з кількостями та цінами, фінансові підсумки, довічну цінність клієнта (CLV), середню вартість замовлення (AOV) і право власності на продукт, що потрапляє в контекст ReplyRabbit AI для більш релевантних чернеток.
Є два компоненти для встановлення:
- The Модуль конектора ReplyRabbit для Magento 2. Він додає дві кінцеві точки REST лише для читання (
/rest/V1/moo-support/summaryі/rest/V1/moo-support/purchased-products) за окремим адміністративним дозволом під назвою API конектора ReplyRabbit. Він не змінює вітрину магазину чи оформлення замовлення. - The Модуль конектора Magento для FreeScout. Він викликає ці ендпоінти через HTTPS, використовуючи токен доступу інтеграції Magento, і відображає бічну панель замовлення. Він має власну сторінку налаштувань для кожної поштової скриньки у FreeScout.
Бічна панель замовлень працює самостійно. Право власності на продукти, яке передається в чернетки AI, це частина, що використовує ReplyRabbit.
Передумови
Перед початком переконайтеся, що у вас є:
- Робоче встановлення FreeScout.
- Магазин Magento 2.4 або новішої версії (Magento Open Source або Adobe Commerce), доступний через HTTPS, із доступом SSH для запуску команд Magento CLI.
- Доступ адміністратора Magento для створення Integration.
- ReplyRabbit встановлено та активовано, якщо ви хочете мати контекст володіння продуктами в чернетках ШІ.
- Ліцензія Magento Connector (18 EUR одноразово, для одного встановлення FreeScout) або активний план ReplyRabbit Pro чи Team, який її включає.
Якщо ReplyRabbit ще не встановлено, почніть з Як встановити модуль ReplyRabbit, потім завершіть Як налаштувати ReplyRabbit.
Встановіть модуль Magento
Завантажити модуль Magento
Увійдіть на app.replyrabbit.app і завантажте ZIP-файл модуля Magento з картки конектора Magento.Розпакуйте його в app/code
Завантажте ZIP у корінь вашого Magento і розпакуйте його. Він створюєapp/code/Moogento/SupportData.Увімкнути модуль
З кореня Magento виконайте:У магазині в режимі production також запустітьbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deployяк і для будь-якого встановлення модуля.
Встановлення Composer
moogento/m2-supportdata з репозиторію пакетів Moogento. Встановлення ZIP вище не потребує облікових даних Composer.Створити токен інтеграції Magento
Конектор автентифікується за допомогою токена доступу від Magento Integration. Створіть його з областю дії лише для читання, потрібною модулю.
Відкрити Integrations
В адміністраторі Magento перейдіть до Система, потім Розширення, потім Інтеграції, і натисніть Додати нову інтеграцію.Назвіть його та задайте область API
Введіть назву, наприклад "ReplyRabbit Connector", і пароль адміністратора. На API вкладка, встановіть Доступ до ресурсів до Власний і позначте лише API конектора ReplyRabbit (під деревом адміністратора верхнього рівня). Збережіть.Активуйте та скопіюйте токен доступу
Натисніть Активувати поруч із новою інтеграцією, потім Дозволити. Скопіюйте Токен доступу. Magento показує токен у деталях інтеграції, тож ви можете повернутися до нього пізніше.
Доступ лише для читання
Встановіть модуль конектора FreeScout
Модуль конектора FreeScout Magento викликає кінцеві точки Magento і відображає бічну панель замовлення в розмовах. Це окремий модуль із власними налаштуваннями, відокремлений від ReplyRabbit.
Завантажити модуль конектора
Увійдіть на app.replyrabbit.app щоб завантажити ZIP-модуль конектора FreeScout. Обидва завантаження з'являються після того, як ви придбали конектор або маєте активний план ReplyRabbit Pro чи Team.Завантажити у FreeScout
У FreeScout перейдіть до Модулі, натисніть кнопку завантаження, виберіть ZIP і встановіть його.Активуйте модуль
Активуйте Інтеграція Magento модуль зі списку Modules.
Налаштувати для кожної поштової скриньки
Після встановлення модуля підключіть його до вашого магазину на власній сторінці налаштувань конектора для кожної поштової скриньки.
Відкрийте налаштування конектора
У FreeScout відкрийте поштову скриньку, яка має показувати дані замовлень Magento, відкрийте меню налаштувань поштової скриньки та виберіть Конектор магазину. Це сторінка налаштувань конектора Magento, а не розділ у налаштуваннях ReplyRabbit.Введіть базову URL-адресу Magento
Вставте базову URL-адресу вашого магазину Magento через HTTPS, наприкладhttps://your-store.com. Завершальна скісна риска не потрібна.Введіть токен доступу
Вставте Токен доступу з інтеграції Magento. Він зберігається зашифрованим, і після збереження показується лише замаскований попередній перегляд.Установіть ідентифікатор магазину (необов'язково)
Залиште порожнім, щоб зіставляти замовлення з усіх магазинів. Введіть ID магазину Magento, щоб обмежити бічну панель одним магазином або поданням магазину.Додайте ліцензійний ключ конектора
Якщо ви придбали конектор, введіть його ліцензійний ключ. Пропустіть цей крок, якщо активний план ReplyRabbit Pro або Team покриває встановлення.Зберегти й перевірити
Збережіть налаштування. Відкрийте розмову FreeScout, де електронна адреса клієнта збігається із замовленням Magento, і підтвердьте, що бічна панель замовлення з'являється.
Кожна поштова скринька FreeScout зберігає власну базову URL-адресу, токен доступу та ідентифікатор магазину, тож ви можете підключати різні поштові скриньки до різних магазинів або представлень магазину Magento.
Що показує конектор
- Панель клієнта для особи в розмові.
- Повна історія замовлень із номером замовлення, датою, статусом і сумою.
- Позиції для кожного замовлення з кількостями та цінами.
- Фінансові підсумки (проміжний підсумок, знижка, доставка, податок, повернення).
- Довічна цінність клієнта (CLV) та середня вартість замовлення (AOV).
- Право власності на продукт для чернеток ШІ.
Як отримати конектор
Конектор Magento є платним модулем. Ви можете отримати його двома способами:
- Купіть Magento Connector за 18 EUR як одноразову ліцензію на одне встановлення FreeScout, потім вставте його ліцензійний ключ у налаштування конектора.
- Використовуйте активний план ReplyRabbit Pro або Team, який включає конектор без додаткової плати.
Купіть ліцензію або завантажте конектор зі свого Панель керування ReplyRabbit. Відвідайте сторінка цін для варіантів плану ReplyRabbit. Якщо активний план ReplyRabbit Pro або Team покриває встановлення, конектор працює після налаштування, без окремого ліцензійного ключа.
Усунення несправностей
| Симптом | Що перевірити |
|---|---|
| Бічна панель замовлення не з'являється | Переконайтеся, що базова URL-адреса та токен доступу в налаштуваннях конектора правильні, а панель поштової скриньки увімкнена. |
| HTTP 404 від магазину | Модуль ReplyRabbit Connector не встановлено або не ввімкнено. Повторно запустіть bin/magento module:enable Moogento_SupportData і bin/magento setup:upgrade, потім очистіть кеш. |
| HTTP 401 або 403 від магазину | Інтеграцію не активовано, токен було перегенеровано, або інтеграції бракує API конектора ReplyRabbit ресурс. Повторно активуйте інтеграцію та вставте поточний токен. |
| Помилка "Connection refused" або тайм-аут | Переконайтеся, що сервер FreeScout може досягти URL вашого магазину через HTTPS. Брандмауери, списки дозволених IP-адрес або режим обслуговування можуть блокувати запит. |
| Базову URL-адресу відхилено | Магазин має обслуговуватися через HTTPS. Звичайний http:// URL-адреса або недоступний хост відхиляється. |
| Замовлення порожні для відомого клієнта | Переконайтеся, що електронна пошта клієнта в розмові FreeScout збігається з електронною поштою в його замовленнях Magento, а ідентифікатор магазину (якщо встановлено) відповідає магазину, де він зробив замовлення. |
| Позиції, фінансові дані або CLV не відображаються | Переконайтеся, що ліцензійний ключ конектора збережено, або що активний план ReplyRabbit Pro чи Team покриває встановлення. |
| Контекст володіння продуктом не з'являється в чернетках | Переконайтеся, що конектор ліцензовано, ReplyRabbit встановлено, конектор повертає замовлення, а функцію контексту ШІ увімкнено для поштової скриньки. |
Для ширших проблем дивіться Усунення несправностей ReplyRabbit.
Конфіденційність і обробка даних
Коли конектор запитує Magento, він надсилає електронну адресу клієнта до вашого власного магазину Magento через HTTPS. Дані замовлень, повернені з вашого магазину, заповнюють бічну панель FreeScout і, разом із ReplyRabbit, формують контекст ШІ для чернеток.
Токену інтеграції потрібен лише доступ лише для читання API конектора ReplyRabbit ресурс, тож конектор ніколи не записує у ваш магазин. Токен зберігається зашифрованим у FreeScout, а вихідні запити перевіряють TLS і не переходять за перенаправленнями.
Дані замовлень Magento не надсилаються третім сторонам, окрім як через постачальника ШІ, вибраного для поштової скриньки, і лише коли їх використовує функція контексту ШІ. Якщо ваша політика вимагає, щоб дані замовлень повністю залишалися на ваших власних серверах, використовуйте локального постачальника ШІ (наприклад, Ollama) для поштової скриньки.
Наступні кроки
- Завершити Як налаштувати ReplyRabbit якщо поштова скринька все ще потребує налаштувань провайдера, контексту або стилю.
- Також на WooCommerce? Дивіться Конектор WooCommerce посібник.
Часті запитання
Чи потрібен мені модуль Magento для конектора?
Так. Конектор читає кінцеву точку support-summary, яку модуль ReplyRabbit Connector додає до REST API Magento 2. Є два завантаження, модуль Magento і модуль конектора Magento для FreeScout, обидва доступні з вашого облікового запису ReplyRabbit.
Які версії Magento підтримуються?
Magento 2.4 і новіші, включно з Magento Open Source та Adobe Commerce, на PHP 8.0 до 8.4. Magento 1 не підтримується.
Скільки коштує конектор Magento?
Конектор Magento включено до активного плану ReplyRabbit Pro або Team. Інакше він коштує 18 EUR як одноразова ліцензія для одного встановлення FreeScout. Якщо ви його купуєте, вставте його ліцензійний ключ у налаштування конектора.
Який дозвіл потрібен токену доступу?
Лише ресурс API ReplyRabbit Connector, який доступний лише для читання. Конектор ніколи не записує у ваш магазин, тому інтеграція не потребує жодних інших прав адміністратора.
Чи може кожна поштова скринька FreeScout підключатися до іншого магазину Magento?
Так. Кожна поштова скринька зберігає власну базову URL-адресу, токен доступу та необов'язковий ідентифікатор магазину в налаштуваннях конектора, тож різні магазини чи представлення магазинів можуть підключатися до різних поштових скриньок.