개요
에이전트가 Shopify를 통해 전자상거래 운영을 관리할 수 있게 하세요. 고객, 주문, 제품, 재고 및 스토어 분석을 처리하여 AI 기반 자동화를 통해 온라인 비즈니스를 간소화할 수 있습니다.사전 요구 사항
Shopify 연동을 사용하기 전에 다음을 확인하세요:- 활성 구독이 있는 CrewAI Enterprise 계정
- 적절한 관리자 권한이 있는 Shopify 스토어
- 통합 페이지를 통해 Shopify 스토어 연결
사용 가능한 도구
고객 관리
SHOPIFY_GET_CUSTOMERS
SHOPIFY_GET_CUSTOMERS
설명: 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)
SHOPIFY_SEARCH_CUSTOMERS
SHOPIFY_SEARCH_CUSTOMERS
설명: 고급 필터링 기준을 사용하여 고객을 검색합니다.파라미터:
filterFormula
(object, 선택): 필드별 연산자가 포함된 불리언 합정규형의 고급 필터limit
(string, 선택): 반환할 최대 고객 수 (기본값 250)
SHOPIFY_CREATE_CUSTOMER
SHOPIFY_CREATE_CUSTOMER
설명: Shopify 스토어에 새로운 고객을 생성합니다.파라미터:
firstName
(string, 필수): 고객의 이름lastName
(string, 필수): 고객의 성email
(string, 필수): 고객의 이메일 주소company
(string, 선택): 회사명streetAddressLine1
(string, 선택): 거리 주소streetAddressLine2
(string, 선택): 거리 주소 2city
(string, 선택): 도시state
(string, 선택): 주 또는 도 코드country
(string, 선택): 국가zipCode
(string, 선택): 우편번호phone
(string, 선택): 전화번호tags
(string, 선택): 배열 또는 쉼표로 구분된 태그 목록note
(string, 선택): 고객 메모sendEmailInvite
(boolean, 선택): 이메일 초대장 전송 여부metafields
(object, 선택): 추가 메타필드(JSON 형식)
SHOPIFY_UPDATE_CUSTOMER
SHOPIFY_UPDATE_CUSTOMER
설명: Shopify 스토어에 기존 고객을 업데이트합니다.파라미터:
customerId
(string, 필수): 업데이트할 고객의 IDfirstName
(string, 선택): 고객의 이름lastName
(string, 선택): 고객의 성email
(string, 선택): 고객의 이메일 주소company
(string, 선택): 회사명streetAddressLine1
(string, 선택): 거리 주소streetAddressLine2
(string, 선택): 거리 주소 2city
(string, 선택): 도시state
(string, 선택): 주 또는 도 코드country
(string, 선택): 국가zipCode
(string, 선택): 우편번호phone
(string, 선택): 전화번호tags
(string, 선택): 배열 또는 쉼표로 구분된 태그 목록note
(string, 선택): 고객 메모sendEmailInvite
(boolean, 선택): 이메일 초대장 전송 여부metafields
(object, 선택): 추가 메타필드(JSON 형식)
주문 관리
SHOPIFY_GET_ORDERS
SHOPIFY_GET_ORDERS
설명: 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_CREATE_ORDER
SHOPIFY_CREATE_ORDER
설명: Shopify 스토어에 새 주문을 생성합니다.파라미터:
email
(string, required): 고객 이메일 주소lineItems
(object, required): title, price, quantity, variant_id가 포함된 JSON 형식의 주문 아이템sendReceipt
(boolean, optional): 주문 영수증을 발송할지 여부fulfillmentStatus
(string, optional): 주문 이행 상태 - 옵션: fulfilled, null, partial, restockedfinancialStatus
(string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voidedinventoryBehaviour
(string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policynote
(string, optional): 주문 메모
SHOPIFY_UPDATE_ORDER
SHOPIFY_UPDATE_ORDER
설명: Shopify 스토어에서 기존 주문을 업데이트합니다.파라미터:
orderId
(string, required): 업데이트할 주문의 IDemail
(string, optional): 고객 이메일 주소lineItems
(object, optional): JSON 형식의 업데이트된 주문 아이템sendReceipt
(boolean, optional): 주문 영수증을 발송할지 여부fulfillmentStatus
(string, optional): 주문 이행 상태 - 옵션: fulfilled, null, partial, restockedfinancialStatus
(string, optional): 결제 상태 - 옵션: pending, authorized, partially_paid, paid, partially_refunded, refunded, voidedinventoryBehaviour
(string, optional): 인벤토리 동작 - 옵션: bypass, decrement_ignoring_policy, decrement_obeying_policynote
(string, optional): 주문 메모
SHOPIFY_GET_ABANDONED_CARTS
SHOPIFY_GET_ABANDONED_CARTS
설명: 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)
SHOPIFY_GET_PRODUCTS
SHOPIFY_GET_PRODUCTS
설명: REST API를 사용하여 Shopify 스토어에서 제품 목록을 조회합니다.파라미터:
productIds
(string, optional): 필터링할 제품 ID의 콤마(,)로 구분된 목록 (예: “632910392, 632910393”)title
(string, optional): 제품 제목으로 필터링productType
(string, optional): 제품 유형으로 필터링vendor
(string, optional): 공급업체로 필터링status
(string, optional): 상태별 필터링 - 옵션: active, archived, draftcreatedAtMin
(string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 생성된 제품만 반환createdAtMax
(string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 생성된 제품만 반환updatedAtMin
(string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이후에 수정된 제품만 반환updatedAtMax
(string, optional): 해당 날짜(ISO 혹은 Unix 타임스탬프) 이전에 수정된 제품만 반환limit
(string, optional): 반환할 최대 제품 수 (기본값: 250)
SHOPIFY_CREATE_PRODUCT
SHOPIFY_CREATE_PRODUCT
설명: 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, continueimageUrl
(string, optional): 제품 이미지 URLisPublished
(boolean, optional): 제품 공개 여부publishToPointToSale
(boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부
SHOPIFY_UPDATE_PRODUCT
SHOPIFY_UPDATE_PRODUCT
설명: REST API를 사용하여 Shopify 스토어의 기존 제품을 업데이트합니다.파라미터:
productId
(string, required): 업데이트할 제품 IDtitle
(string, optional): 제품 제목productType
(string, optional): 제품 유형/카테고리vendor
(string, optional): 제품 공급업체productDescription
(string, optional): 제품 설명 (일반 텍스트 또는 HTML 가능)tags
(string, optional): 배열 또는 콤마(,)로 구분된 태그 목록price
(string, optional): 제품 가격inventoryPolicy
(string, optional): 재고 정책 - 옵션: deny, continueimageUrl
(string, optional): 제품 이미지 URLisPublished
(boolean, optional): 제품 공개 여부publishToPointToSale
(boolean, optional): 포인트 오브 세일(Point of Sale)에 공개 여부
제품 관리 (GraphQL)
SHOPIFY_GET_PRODUCTS_GRAPHQL
SHOPIFY_GET_PRODUCTS_GRAPHQL
설명: 고급 GraphQL 필터링 기능을 사용하여 제품을 조회합니다.파라미터:
productFilterFormula
(object, 선택): id, title, vendor, status, handle, tag, created_at, updated_at, published_at와 같은 필드를 지원하는 불리언 정규합형(DNF) 기반의 고급 필터
SHOPIFY_CREATE_PRODUCT_GRAPHQL
SHOPIFY_CREATE_PRODUCT_GRAPHQL
설명: 미디어 지원이 강화된 GraphQL API를 사용하여 새 제품을 생성합니다.파라미터:
title
(string, 필수): 제품 제목productType
(string, 필수): 제품 유형/카테고리vendor
(string, 필수): 제품 공급업체productDescription
(string, 선택): 제품 설명 (일반 텍스트 또는 HTML 허용)tags
(string, 선택): 배열 또는 쉼표로 구분된 리스트 형태의 제품 태그media
(object, 선택): 대체 텍스트, 콘텐츠 유형 및 소스 URL을 가진 미디어 객체additionalFields
(object, 선택): status, requiresSellingPlan, giftCard와 같은 추가 제품 필드
SHOPIFY_UPDATE_PRODUCT_GRAPHQL
SHOPIFY_UPDATE_PRODUCT_GRAPHQL
설명: 미디어 지원이 강화된 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 연동 설정 또는 문제 해결에 관한 지원이 필요하시면 고객 지원팀에 문의해 주세요.