Коннектор Magento
Работает с Magento
Подключите Magento 2 или Adobe Commerce к FreeScout, чтобы в обращениях отображались сопоставленные заказы клиента и контекст покупок. Небольшой модуль Magento только для чтения предоставляет сводку поддержки через REST API Magento, а коннектор FreeScout показывает её на боковой панели обращения. ReplyRabbit также передаёт контекст принадлежности товаров в слой ИИ, чтобы черновики могли ссылаться на то, что купил клиент.
Ищете обзор?
Обзор
Коннектор 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 выполните:В магазине в рабочем режиме также выполните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 (в дереве администратора верхнего уровня). Сохраните.Активируйте и скопируйте access token
Нажмите Активировать рядом с новой интеграцией, затем Разрешить. Скопируйте Access Token. Magento показывает токен в деталях интеграции, поэтому вы можете вернуться к нему позже.
Доступ только для чтения
Установите модуль-коннектор FreeScout
Модуль коннектора Magento для FreeScout вызывает эндпоинты Magento и отображает боковую панель заказа в переписках. Это отдельный модуль со своими настройками, независимый от ReplyRabbit.
Скачать модуль коннектора
Войдите на app.replyrabbit.app чтобы скачать ZIP модуля коннектора FreeScout. Обе загрузки появляются после того, как вы купили коннектор или имеете активный план ReplyRabbit Pro или Team.Загрузить в FreeScout
В FreeScout перейдите в Модули, нажмите кнопку загрузки, выберите ZIP и установите его.Активируйте модуль
Активируйте Интеграция Magento модуль из списка модулей.
Настроить для каждого почтового ящика
После установки модуля подключите его к вашему магазину на собственной странице настроек коннектора для каждого почтового ящика.
Откройте настройки коннектора
В FreeScout откройте почтовый ящик, который должен показывать данные заказов Magento, откройте меню настроек почтового ящика и выберите Коннектор магазина. Это страница настроек коннектора Magento, а не раздел внутри настроек ReplyRabbit.Введите базовый URL Magento
Вставьте базовый URL вашего магазина Magento по HTTPS, напримерhttps://your-store.com. Завершающая косая черта не нужна.Введите токен доступа
Вставьте Access Token из интеграции Magento. Он хранится в зашифрованном виде, и после сохранения показывается только маскированный предпросмотр.Укажите ID магазина (необязательно)
Оставьте пустым, чтобы сопоставлять заказы по всем магазинам. Введите ID магазина Magento, чтобы ограничить боковую панель одним магазином или представлением магазина.Добавьте лицензионный ключ коннектора
Если вы купили коннектор, введите его лицензионный ключ. Пропустите этот шаг, если активный план ReplyRabbit Pro или Team покрывает установку.Сохранить и проверить
Сохраните настройки. Откройте разговор FreeScout, где email клиента совпадает с заказом Magento, и подтвердите, что боковая панель заказа появляется.
Каждый почтовый ящик FreeScout хранит свой собственный базовый URL, токен доступа и ID магазина, поэтому вы можете подключать разные почтовые ящики к разным магазинам или представлениям магазина 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 или недоступный хост отклоняется. |
| Заказы пусты для известного клиента | Убедитесь, что email клиента в разговоре FreeScout совпадает с email в его заказах Magento и что ID магазина (если задан) совпадает с магазином, где он сделал заказ. |
| Позиции, финансы или CLV не отображаются | Убедитесь, что лицензионный ключ коннектора сохранён или что активный тариф ReplyRabbit Pro или Team покрывает установку. |
| Контекст владения товаром не появляется в черновиках | Убедитесь, что коннектор лицензирован, ReplyRabbit установлен, коннектор возвращает заказы и функция контекста ИИ включена для почтового ящика. |
Для более широких проблем см. Устранение неполадок ReplyRabbit.
Конфиденциальность и обработка данных
Когда коннектор запрашивает Magento, он отправляет адрес электронной почты клиента в ваш собственный магазин Magento по HTTPS. Данные о заказах, возвращённые из вашего магазина, заполняют боковую панель FreeScout и, вместе с ReplyRabbit, формируют контекст ИИ для черновиков.
Токену интеграции нужен только доступ для чтения API коннектора ReplyRabbit ресурс, поэтому коннектор никогда не записывает данные в ваш магазин. Токен хранится в FreeScout в зашифрованном виде, а исходящие запросы проверяют TLS и не следуют перенаправлениям.
Данные заказов Magento не передаются третьим сторонам, кроме как через AI-провайдера, выбранного для почтового ящика, и только когда их использует функция AI-контекста. Если ваша политика требует, чтобы данные заказов полностью оставались на ваших собственных серверах, используйте локального AI-провайдера (например, Ollama) для почтового ящика.
Следующие шаги
- Завершить Как настроить ReplyRabbit если почтовому ящику всё ещё нужны настройки провайдера, контекста или стиля.
- Также на WooCommerce? Смотрите коннектор WooCommerce руководство.
FAQ
Нужен ли мне модуль Magento для коннектора?
Да. Коннектор читает endpoint support-summary, который модуль ReplyRabbit Connector добавляет в REST API Magento 2. Есть две загрузки, модуль Magento и модуль коннектора FreeScout Magento, обе доступны в вашей учётной записи 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. Если вы его покупаете, вставьте его лицензионный ключ в настройки коннектора.
Какое разрешение нужно для токена доступа?
Только ресурс ReplyRabbit Connector API, который доступен только для чтения. Коннектор никогда не записывает данные в ваш магазин, поэтому интеграции не нужны никакие другие права администратора.
Может ли каждый почтовый ящик FreeScout подключаться к разному магазину Magento?
Да. Каждый почтовый ящик хранит собственный base URL, access token и необязательный store ID в настройках коннектора, поэтому разные магазины или представления магазина могут подключаться к разным почтовым ящикам.