Руководство по интеграции с Magento
Tajo подключается к Adobe Commerce (Magento 2) через Commerce REST API. Устанавливать расширение Tajo в кодовую базу Magento не нужно: подключение работает по токену интеграции, поэтому конвейер развёртывания вашего магазина остаётся нетронутым.
Magento сейчас относится к подключениям, которые настраиваются при онбординге: в отличие от Shopify и WooCommerce, самостоятельное подключение пока недоступно, и синхронизацию настраивает ваша команда Tajo в рамках онбординга. Текущее положение дел отражает статус реализации коннектора. Описанная ниже подготовка на стороне магазина включает всё, что нужно Magento с вашей стороны, и работает со стандартным Magento, без изменений кода.
Предварительные требования
- Adobe Commerce / Magento Open Source 2.4+
- Права администратора для создания токена интеграции
- HTTPS в вашем магазине (обязателен для аутентификации по токену)
- Аккаунт Tajo с активной подпиской
Шаг 1: создайте токен интеграции Magento
- В админке Magento откройте System → Extensions → Integrations → Add New Integration.
- Назовите интеграцию
Tajo, укажите свой пароль администратора и в разделе API выдайте доступ на чтение к ресурсам Customers, Sales и Catalog. - Сохраните, затем нажмите Activate и скопируйте Access Token.
Tajo аутентифицируется заголовком Authorization: Bearer <access token> по базовому REST-адресу вашего магазина (https://yourstore.com/rest/V1/).
Шаг 2: передайте подключение своей команде Tajo
Передайте контактному лицу по онбордингу в Tajo:
| Поле | Значение |
|---|---|
| URL магазина | https://yourstore.com |
| Токен доступа | Токен интеграции из шага 1 |
Подключение проверяется запросом только на чтение до начала любой синхронизации. Вы можете в любой момент сменить токен в Magento, чтобы отозвать доступ.
Что синхронизирует подключение Magento
- Клиенты: поля идентификации и метаданные аккаунта для разрешения контактов; маркетинговое согласие никогда не выводится из самого факта существования аккаунта
- Заказы: история покупок, суммы, валюта, статус и позиции заказа для сегментации по жизненному циклу и автоматизаций по возврату клиентов
- Товары и категории: структура каталога для сегментации по интересам и кампаний с учётом товаров
Сначала выполняется импорт истории, затем инкрементальная синхронизация поддерживает данные Tajo в актуальном состоянии, опрашивая изменённые записи. События витрины в реальном времени (корзины, незавершённые оформления заказа) требуют расширения внутри магазина, которого у Magento сегодня нет, но автоматизации на основе заказов полностью поддерживаются через синхронизацию.
Маркетинговая автоматизация
Автоматизации (email, SMS, WhatsApp через Brevo и других провайдеров) настраиваются в Tajo на синхронизированных данных, например сообщения после покупки по новым заказам, возврат ушедших клиентов и кампании по товарным интересам на основе истории категорий.
Устранение неполадок
| Симптом | Причина и решение |
|---|---|
| 401 от магазина | Токен интеграции был перевыпущен или интеграция деактивирована. Активируйте её заново и обновите токен в Tajo |
| Клиенты синхронизируются, а заказы нет | В правах API интеграции отсутствует ресурс Sales |
| Медленный первичный импорт | Крупные магазины импортируются постранично; ваш контакт в Tajo может сообщить о ходе импорта в любой момент |
Дальнейшие шаги
- Справочник по коннектору Magento: статус реализации и технические заметки
- Синхронизация клиентов: сопоставление клиентов Magento с вашей системой учёта