---
title: "Руководство по интеграции с Magento | Tajo"
description: "Подключите Adobe Commerce (Magento) к Tajo через Commerce REST API для синхронизации клиентов, заказов и товаров"
url: https://tajo.io/ru/docs/ecommerce-platforms/magento/
markdown: https://tajo.io/ru/docs/ecommerce-platforms/magento.md
lang: ru-RU
author: "Set Noa"
author_url: https://tajo.io/ru/set-noa/
robots: noindex
---

Подайте заявку на ранний доступ

Укажите имя и рабочий адрес электронной почты. Мы отправим ссылку для подтверждения запроса на доступ к Tajo.

# Руководство по интеграции с Magento

[Set Noa](https://tajo.io/ru/set-noa/)

Tajo подключается к Adobe Commerce (Magento 2) через **Commerce REST API**. Устанавливать расширение Tajo в кодовую базу Magento не нужно: подключение работает по токену интеграции, поэтому конвейер развёртывания вашего магазина остаётся нетронутым.

Magento сейчас относится к **подключениям, которые настраиваются при онбординге**: в отличие от Shopify и WooCommerce, самостоятельное подключение пока недоступно, и синхронизацию настраивает ваша команда Tajo в рамках онбординга. Текущее положение дел отражает [статус реализации коннектора](https://tajo.io/docs/connectors/magento/). Описанная ниже подготовка на стороне магазина включает всё, что нужно Magento с вашей стороны, и работает со стандартным Magento, без изменений кода.

## Предварительные требования

- **Adobe Commerce / Magento Open Source 2.4+**
- Права администратора для создания токена интеграции
- HTTPS в вашем магазине (обязателен для аутентификации по токену)
- **Аккаунт Tajo** с активной подпиской

## Шаг 1: создайте токен интеграции Magento

1. В админке Magento откройте **System → Extensions → Integrations → Add New Integration**.
2. Назовите интеграцию `Tajo`, укажите свой пароль администратора и в разделе **API** выдайте доступ на чтение к ресурсам **Customers**, **Sales** и **Catalog**.
3. Сохраните, затем нажмите **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](https://tajo.io/docs/connectors/magento/): статус реализации и технические заметки
- [Синхронизация клиентов](https://tajo.io/ru/docs/skills/data-sync/customer-sync/): сопоставление клиентов Magento с вашей системой учёта
