---
title: "Magento 연동 가이드 | Tajo"
description: "Commerce REST API를 통해 Adobe Commerce(Magento)를 Tajo에 연결하고 고객, 주문, 상품을 동기화하세요"
url: https://tajo.io/kr/docs/ecommerce-platforms/magento/
markdown: https://tajo.io/kr/docs/ecommerce-platforms/magento.md
lang: ko-KR
author: "Set Noa"
author_url: https://tajo.io/kr/set-noa/
robots: noindex
---

Tajo 사전 이용 신청

이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다.

# Magento 연동 가이드

[Set Noa](https://tajo.io/kr/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는 스토어의 REST 기본 URL(`https://yourstore.com/rest/V1/`)에 대해 `Authorization: Bearer <access token>`으로 인증합니다.

## 2단계: 연결 정보를 Tajo 팀에 전달

Tajo 온보딩 담당자에게 다음을 공유하세요.

| 항목 | 값 |
| --- | --- |
| **스토어 URL** | `https://yourstore.com` |
| **액세스 토큰** | 1단계에서 발급한 연동 토큰 |

동기화가 시작되기 전에 읽기 전용 요청으로 연결을 검증합니다. 언제든지 Magento에서 토큰을 교체해 접근 권한을 취소할 수 있습니다.

## Magento 연결이 동기화하는 데이터

- **고객**: 연락처 확인에 사용하는 식별 필드와 계정 메타데이터. 계정이 존재한다는 사실만으로 마케팅 동의를 추론하지 않습니다
- **주문**: 라이프사이클 세그먼테이션과 윈백 자동화를 위한 구매 이력, 합계, 통화, 상태, 라인 아이템
- **상품 및 카테고리**: 관심사 세그먼테이션과 상품 기반 캠페인을 위한 카탈로그 구조

먼저 과거 데이터 임포트가 실행되고, 이후 증분 동기화가 변경된 레코드를 폴링해 Tajo를 최신 상태로 유지합니다. 실시간 스토어프런트 이벤트(장바구니, 진행 중인 checkout)에는 스토어 내 익스텐션이 필요하지만 Magento는 현재 이를 제공하지 않습니다. 주문 기반 자동화는 동기화를 통해 온전히 지원됩니다.

## 마케팅 자동화

자동화(Brevo 및 기타 제공업체를 통한 이메일, SMS, WhatsApp)는 동기화된 데이터를 사용해 Tajo에서 설정합니다. 예를 들어 신규 주문에 대한 구매 후 후속 메시지, 이탈 고객 윈백, 카테고리 이력을 활용한 상품 관심사 캠페인 등이 있습니다.

## 문제 해결

| 증상 | 원인 및 해결 |
| --- | --- |
| 스토어에서 401 응답 | 연동 토큰이 재발급되었거나 연동이 비활성화되었습니다. 다시 활성화한 뒤 Tajo에서 토큰을 갱신하세요 |
| 고객은 동기화되지만 주문은 되지 않음 | 연동의 API 권한에 **Sales** 리소스가 빠져 있습니다 |
| 초기 임포트가 느림 | 대형 스토어는 페이지 단위로 임포트합니다. Tajo 담당자가 언제든 진행 상황을 알려드립니다 |

## 다음 단계

- [Magento 커넥터 레퍼런스](https://tajo.io/docs/connectors/magento/): 구현 현황과 기술 노트
- [고객 동기화](https://tajo.io/kr/docs/skills/data-sync/customer-sync/): Magento 고객을 기준 시스템에 매핑하기