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 연동 토큰 생성

Magento 관리자에서 System → Extensions → Integrations → Add New Integration으로 이동합니다.
이름을 Tajo로 지정하고 관리자 비밀번호를 입력한 다음, API 탭에서 Customers, Sales, Catalog 리소스에 읽기 권한을 부여합니다.
저장한 뒤 연동을 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 커넥터 레퍼런스: 구현 현황과 기술 노트
고객 동기화: Magento 고객을 기준 시스템에 매핑하기