---
title: "Magento 集成指南 | Tajo"
description: "通过 Commerce REST API 将 Adobe Commerce（Magento）连接到 Tajo，同步客户、订单和商品数据"
url: https://tajo.io/zh-cn/docs/ecommerce-platforms/magento/
markdown: https://tajo.io/zh-cn/docs/ecommerce-platforms/magento.md
lang: zh-CN
author: "Set Noa"
author_url: https://tajo.io/zh-cn/set-noa/
robots: noindex
---

申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

# Magento 集成指南

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

Tajo 通过 **Commerce REST API** 连接 Adobe Commerce（Magento 2）。无需在你的 Magento 代码库中安装任何 Tajo 扩展：连接使用集成令牌，你店铺的部署流程完全不受影响。

目前 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 基础 URL（`https://yourstore.com/rest/V1/`）发起认证。

## 第 2 步：把连接信息交给 Tajo 团队

请把以下内容发给你的 Tajo 实施对接人：

| 字段 | 值 |
| --- | --- |
| **店铺 URL** | `https://yourstore.com` |
| **访问令牌** | 第 1 步中得到的集成令牌 |

在任何同步开始之前，连接都会先用一次只读请求完成校验。你可以随时在 Magento 中轮换令牌以撤销访问权限。

## Magento 连接会同步什么

- **客户**：用于联系人归并的身份字段和账号元数据；营销同意绝不会因为账号存在就被推断出来
- **订单**：购买历史、总额、币种、状态和订单行，用于生命周期细分和赢回自动化
- **商品与分类**：目录结构，用于兴趣细分和结合商品的营销活动

历史数据导入会先运行，随后增量同步通过轮询变更记录让 Tajo 保持最新。实时店面事件（购物车、进行中的结账）需要一个安装在店铺内的扩展，而 Magento 目前还没有；基于订单的自动化仍然可以通过同步获得完整支持。

## 营销自动化

自动化（通过 Brevo 及其他服务商发送邮件、短信和 WhatsApp 消息）在 Tajo 中基于已同步的数据配置，例如针对新订单的售后跟进、针对流失客户的赢回，以及依据分类历史的商品兴趣营销活动。

## 故障排查

| 现象 | 原因与处理 |
| --- | --- |
| 店铺返回 401 | 集成令牌被重新生成，或集成已被停用；请重新激活并在 Tajo 中更新令牌 |
| 客户能同步，订单不能 | 该集成的 API 授权缺少 **Sales** 资源 |
| 首次导入很慢 | 大型店铺按页导入；你的 Tajo 对接人可以随时反馈进度 |

## 后续步骤

- [Magento 连接器参考](https://tajo.io/docs/connectors/magento/)：实现状态与技术说明
- [客户同步](https://tajo.io/zh-cn/docs/skills/data-sync/customer-sync/)：把 Magento 客户映射到你的记录系统