Magento 集成指南

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

目前 Magento 属于由实施团队搭建的连接：与 Shopify 和 WooCommerce 不同，它还不能自助开通，需要 Tajo 团队在实施阶段为你接好同步链路。连接器实现状态会跟踪它的当前进展。下面的店铺侧准备工作就是 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 连接器参考：实现状态与技术说明
• 客户同步：把 Magento 客户映射到你的记录系统