메인 콘텐츠로 건너뛰기

개요

에이전트가 Shopify를 통해 전자상거래 운영을 관리할 수 있게 하세요. 고객, 주문, 제품, 재고 및 스토어 분석을 처리하여 AI 기반 자동화를 통해 온라인 비즈니스를 간소화할 수 있습니다.

사전 요구 사항

Shopify 연동을 사용하기 전에 다음을 확인하세요:
  • 활성 구독이 있는 CrewAI AMP 계정
  • 적절한 관리자 권한이 있는 Shopify 스토어
  • 통합 페이지를 통해 Shopify 스토어 연결

Shopify 통합 설정

1. Shopify 스토어 연결

  1. CrewAI AMP 통합으로 이동합니다.
  2. 인증 통합 섹션에서 Shopify를 찾습니다.
  3. 연결을 클릭하고 OAuth 과정을 완료합니다.
  4. 스토어 및 제품 관리에 필요한 권한을 부여합니다.
  5. 통합 설정에서 Enterprise Token을 복사합니다.

2. 필수 패키지 설치

3. 환경 변수 설정

Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다.
또는 .env 파일에 추가하세요:

사용 가능한 도구

고객 관리

설명: Shopify 스토어에서 고객 목록을 조회합니다.파라미터:
  • customerIds (string, 선택): 필터링할 고객 ID의 쉼표로 구분된 목록 (예: “207119551, 207119552”)
  • createdAtMin (string, 선택): 이 날짜 이후에 생성된 고객만 반환 (ISO 또는 Unix 타임스탬프)
  • createdAtMax (string, 선택): 이 날짜 이전에 생성된 고객만 반환 (ISO 또는 Unix 타임스탬프)
  • updatedAtMin (string, 선택): 이 날짜 이후에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)
  • updatedAtMax (string, 선택): 이 날짜 이전에 업데이트된 고객만 반환 (ISO 또는 Unix 타임스탬프)
  • limit (string, 선택): 반환할 최대 고객 수 (기본값 250)
설명: 고급 필터링 기준을 사용하여 고객을 검색합니다.파라미터:
  • filterFormula (object, 선택): 필드별 연산자가 포함된 불리언 합정규형의 고급 필터
  • limit (string, 선택): 반환할 최대 고객 수 (기본값 250)
설명: Shopify 스토어에 새로운 고객을 생성합니다.파라미터:
  • firstName (string, 필수): 고객의 이름
  • lastName (string, 필수): 고객의 성
  • email (string, 필수): 고객의 이메일 주소
  • company (string, 선택): 회사명
  • streetAddressLine1 (string, 선택): 거리 주소
  • streetAddressLine2 (string, 선택): 거리 주소 2
  • city (string, 선택): 도시
  • state (string, 선택): 주 또는 도 코드
  • country (string, 선택): 국가
  • zipCode (string, 선택): 우편번호
  • phone (string, 선택): 전화번호
  • tags (string, 선택): 배열 또는 쉼표로 구분된 태그 목록
  • note (string, 선택): 고객 메모
  • sendEmailInvite (boolean, 선택): 이메일 초대장 전송 여부
  • metafields (object, 선택): 추가 메타필드(JSON 형식)
설명: Shopify 스토어에 기존 고객을 업데이트합니다.파라미터:
  • customerId (string, 필수): 업데이트할 고객의 ID
  • firstName (string, 선택): 고객의 이름
  • lastName (string, 선택): 고객의 성
  • email (string, 선택): 고객의 이메일 주소
  • company (string, 선택): 회사명
  • streetAddressLine1 (string, 선택): 거리 주소
  • streetAddressLine2 (string, 선택): 거리 주소 2
  • city (string, 선택): 도시
  • state (string, 선택): 주 또는 도 코드
  • country (string, 선택): 국가
  • zipCode (string, 선택): 우편번호
  • phone (string, 선택): 전화번호
  • tags (string, 선택): 배열 또는 쉼표로 구분된 태그 목록
  • note (string, 선택): 고객 메모
  • sendEmailInvite (boolean, 선택): 이메일 초대장 전송 여부
  • metafields (object, 선택): 추가 메타필드(JSON 형식)

주문 관리

설명: Shopify 스토어에서 주문 목록을 조회합니다.파라미터:
  • orderIds (string, optional): 필터링할 주문 ID의 콤마로 구분된 목록 (예: “450789469, 450789470”)
  • createdAtMin (string, optional): 이 날짜 이후에 생성된 주문만 반환 (ISO 또는 Unix 타임스탬프)
  • createdAtMax (string, optional): 이 날짜 이전에 생성된 주문만 반환 (ISO 또는 Unix 타임스탬프)
  • updatedAtMin (string, optional): 이 날짜 이후에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)
  • updatedAtMax (string, optional): 이 날짜 이전에 업데이트된 주문만 반환 (ISO 또는 Unix 타임스탬프)
  • limit (string, optional): 반환할 주문의 최대 개수 (기본값: 250)
설명: Shopify 스토어에 새 주문을 생성합니다.파라미터:
  • email (string, required): 고객 이메일 주소
  • lineItems (object, required): title, price, quantity, variant_id가 포함된 JSON 형식의 주문 아이템
  • sendReceipt (boolean, optional): 주문 영수증을 발송할지 여부
  • fulfillmentStatus (string, optional): 주문 이행 상태 - 옵션: fulfilled, null, partial, restocked
  • financialStatus (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
  • inventoryBehaviour (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy
  • note (string, optional): 주문 메모
설명: Shopify 스토어에서 기존 주문을 업데이트합니다.파라미터:
  • orderId (string, required): 업데이트할 주문의 ID
  • email (string, optional): 고객 이메일 주소
  • lineItems (object, optional): JSON 형식의 업데이트된 주문 아이템
  • sendReceipt (boolean, optional): 주문 영수증을 발송할지 여부
  • fulfillmentStatus (string, optional): 주문 이행 상태 - 옵션: fulfilled, null, partial, restocked
  • financialStatus (string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
  • inventoryBehaviour (string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policy
  • note (string, optional): 주문 메모
설명: Shopify 스토어에서 방치된 장바구니를 조회합니다.파라미터:
  • createdWithInLast (string, optional): 지정된 기간 내에 생성된 체크아웃 결과만 제한
  • createdAfterId (string, optional): 지정된 ID 이후 결과로 제한
  • status (string, optional): 주어진 상태의 체크아웃만 표시 - 옵션: open, closed (기본값: open)
  • createdAtMin (string, optional): 이 날짜 이후에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)
  • createdAtMax (string, optional): 이 날짜 이전에 생성된 장바구니만 반환 (ISO 또는 Unix 타임스탬프)
  • limit (string, optional): 반환할 장바구니의 최대 개수 (기본값: 250)

제품 관리 (REST API)

설명: REST API를 사용하여 Shopify 스토어에서 제품 목록을 조회합니다.파라미터:
  • productIds (string, optional): 필터링할 제품 ID의 콤마(,)로 구분된 목록 (예: “632910392, 632910393”)
  • title (string, optional): 제품 제목으로 필터링
  • productType (string, optional): 제품 유형으로 필터링
  • vendor (string, optional): 공급업체로 필터링
  • status (string, optional): 상태별 필터링 - 옵션: active, archived, draft
  • createdAtMin (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 생성된 제품만 반환
  • createdAtMax (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 생성된 제품만 반환
  • updatedAtMin (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 수정된 제품만 반환
  • updatedAtMax (string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 수정된 제품만 반환
  • limit (string, optional): 반환할 최대 제품 수 (기본값: 250)
설명: REST API를 사용하여 Shopify 스토어에 새로운 제품을 생성합니다.파라미터:
  • title (string, required): 제품 제목
  • productType (string, required): 제품 유형/카테고리
  • vendor (string, required): 제품 공급업체
  • productDescription (string, optional): 제품 설명 (일반 텍스트 또는 HTML 가능)
  • tags (string, optional): 배열 또는 콤마(,)로 구분된 태그 목록
  • price (string, optional): 제품 가격
  • inventoryPolicy (string, optional): 재고 정책 - 옵션: deny, continue
  • imageUrl (string, optional): 제품 이미지 URL
  • isPublished (boolean, optional): 제품 공개 여부
  • publishToPointToSale (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부
설명: REST API를 사용하여 Shopify 스토어의 기존 제품을 업데이트합니다.파라미터:
  • productId (string, required): 업데이트할 제품 ID
  • title (string, optional): 제품 제목
  • productType (string, optional): 제품 유형/카테고리
  • vendor (string, optional): 제품 공급업체
  • productDescription (string, optional): 제품 설명 (일반 텍스트 또는 HTML 가능)
  • tags (string, optional): 배열 또는 콤마(,)로 구분된 태그 목록
  • price (string, optional): 제품 가격
  • inventoryPolicy (string, optional): 재고 정책 - 옵션: deny, continue
  • imageUrl (string, optional): 제품 이미지 URL
  • isPublished (boolean, optional): 제품 공개 여부
  • publishToPointToSale (boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부

제품 관리 (GraphQL)

설명: 고급 GraphQL 필터링 기능을 사용하여 제품을 조회합니다.파라미터:
  • productFilterFormula (object, 선택): id, title, vendor, status, handle, tag, created_at, updated_at, published_at와 같은 필드를 지원하는 불리언 정규합형(DNF) 기반의 고급 필터
설명: 미디어 지원이 강화된 GraphQL API를 사용하여 새 제품을 생성합니다.파라미터:
  • title (string, 필수): 제품 제목
  • productType (string, 필수): 제품 유형/카테고리
  • vendor (string, 필수): 제품 공급업체
  • productDescription (string, 선택): 제품 설명 (일반 텍스트 또는 HTML 허용)
  • tags (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그
  • media (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 가진 미디어 객체
  • additionalFields (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드
설명: 미디어 지원이 강화된 GraphQL API를 사용하여 기존 제품을 업데이트합니다.파라미터:
  • productId (string, 필수): 업데이트할 제품의 GraphQL ID (예: “gid://shopify/Product/913144112”)
  • title (string, 선택): 제품 제목
  • productType (string, 선택): 제품 유형/카테고리
  • vendor (string, 선택): 제품 공급업체
  • productDescription (string, 선택): 제품 설명 (일반 텍스트 또는 HTML 허용)
  • tags (string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그
  • media (object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 포함한 업데이트된 미디어 객체
  • additionalFields (object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드

사용 예시

기본 Shopify 에이전트 설정

특정 Shopify 도구 필터링

GraphQL을 활용한 제품 관리

주문 및 고객 분석

도움 받기

도움이 필요하신가요?

Shopify 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해 주세요.