온라인 쇼핑몰 운영에서 VIP 고객 주문 분류, 품절 위험 재고 알림, 이상 거래 방지를 위한 배송 보류 등의 작업은 반복적이지만 많은 리소스를 소모합니다. Shopify Flow는 코드 없이도 비즈니스 로직을 자동화할 수 있는 강력한 엔진을 제공하지만, 트리거(Trigger), 조건(Condition), 작업(Action)을 직접 수동으로 구성하려면 GraphQL Admin API 변수명이나 불리언 연산, 단일 항목과 목록 간의 데이터 불일치 등 기술적인 장벽에 부딪히기 쉽습니다. Shopify 관리자 화면에 기본 내장된 AI 비즈니스 어시스턴트인 Shopify Sidekick은 이러한 진입 장벽을 해결합니다. 운영자가 일상적인 자연어로 업무 요건을 입력하면, Sidekick이 Flow 캔버스에 워크플로 초안을 자동 생성하고 구성 오류를 진단하며 가상 테스트 데이터까지 생성해 안전하게 검증합니다.
Shopify Flow 내에서 Sidekick이 작동하는 원리
Sidekick은 Shopify Flow를 대체하는 도구가 아니라, Flow의 백엔드 자동화 엔진과 사용자를 연결해 주는 대화형 인터페이스 역할을 수행합니다. Shopify 관리자에서 Shopify Flow 앱을 연 상태로 Sidekick을 실행하면, AI는 현재 스토어의 자동화 작업 환경을 인식하여 일상적인 텍스트 명령을 Flow 캔버스의 시각적 노드로 변환합니다.
+-------------------------------------------------------------------+
| Shopify 관리자 화면 (데스크톱) -> 앱 (Apps) -> Shopify Flow |
+-------------------------------------------------------------------+
|
v
+-----------------------+ +------------------------+
| 운영자의 일상 언어 명령 | -- 프롬프트 -> | Shopify Sidekick AI |
| （업무 요구사항 및 로직)| | 자연어 분석 및 설계 |
+-----------------------+ +------------------------+
|
v
+-------------------------------------------------------------------+
| Shopify Flow 캔버스: 자동 생성된 워크플로 초안 |
| - 트리거: 이벤트 감지 (예: Order created, Order risk analyzed) |
| - 조건 분기: 비즈니스 필터 (예: 결제액 >= $200 및 주문 횟수 > 3) |
| - 작업 노드: 태그 부여, 배송 보류, 알림 이메일 발송 등 |
| - 상태: 비활성 (Inactive, 자동으로 "sidekick" 태그 지정) |
+-------------------------------------------------------------------+
|
+------------------+------------------+
| |
v v
+-------------------------------+ +-------------------------------+
| AI 기반 오류 진단 및 수정 | | 시뮬레이션 테스트 실행 |
| - "Data not found" 오류 해결 | | - Sidekick이 조건 충족/미충족 |
| - "For each" 루프 자동 삽입 | | 2가지 가상 이벤트 생성 |
| - 단일 항목과 목록 충돌 해결 | | - 실제 데이터 변경 없이 검증 |
+-------------------------------+ +-------------------------------+
|
v
+-------------------------------------------------------------------+
| 운영자 최종 검토 -> "워크플로 켜기" (Turn on workflow) 클릭 활성화 |
+-------------------------------------------------------------------+
필수 사전 요건 및 안전 장치
Sidekick을 활용해 자동화 작업을 설계하기 전에 반드시 숙지해야 할 시스템 규칙은 다음과 같습니다:
- 데스크톱 환경 필수: Sidekick을 통한 Shopify Flow 워크플로 생성 및 편집은 PC 데스크톱 브라우저에서만 지원됩니다.
- 앱 컨텍스트 유지: 반드시 Shopify 관리자 내에서 Flow 앱(
Apps > Flow) 화면을 먼저 연 후 Sidekick 아이콘을 클릭해야 합니다. 일반 대시보드나 다른 메뉴에서 질문하면 Flow 캔버스로 노드를 직접 구성할 수 없습니다. - 기본 비활성 상태(Inactive) 보호: Sidekick이 생성한 워크플로는 기본적으로 비활성(Inactive) 상태로 저장되며, 자동으로
sidekick태그가 부착됩니다. 운영자의 검토 없이 실제 스토어 주문에 즉시 실행되지 않습니다. - 최종 승인 권한: AI는 초안 작성과 수정 제안을 담당할 뿐이며, 워크플로를 실무에 적용하려면 운영자가 직접 Turn on workflow(워크플로 켜기) 버튼을 눌러야 합니다.
단계별 가이드: 일상 언어 프롬프트로 Flow 작업 구축하기
1단계: Shopify Flow 열기 및 Sidekick 실행
- Shopify 관리자 화면 왼쪽 메뉴에서 **앱(Apps)**을 누르고 Flow를 엽니다.
- 상단 네비게이션 바 또는 우측 하단 플로팅 위젯의 Sidekick 아이콘을 클릭합니다.
- Flow 전용 컨텍스트가 로드된 대화창이 열립니다.
2단계: 구조화된 프롬프트 작성하기
Sidekick이 한 번에 정확한 노드를 배치할 수 있도록, 지시문은 3가지 핵심 요소를 명시하여 작성하는 것이 좋습니다:
- 언제(When / 트리거): 작업이 시작되는 이벤트 시점.
- 조건(If / 필터): 만족해야 하는 구체적인 기준(주문 금액, 국가, 주문 횟수 등).
- 무엇을(Then / 작업): 조건 부합 시 수행해야 할 실제 동작.
3단계: 주요 쇼핑몰 운영 시나리오 및 프롬프트 예시
| 운영 시나리오 | 일상 언어 프롬프트 예시 | Shopify Flow 생성 구성 요소 |
|---|---|---|
| 고액 결제 단골 고객(VIP) 주문 자동 태그 지정 | "새 주문이 생성되었을 때, 결제 총액이 200달러 이상이고 해당 고객의 이전 주문 수가 3회 초과인 경우, 주문에 'VIP-HighValue' 태그를 추가하고 staff@store.com으로 내부 알림 이메일을 보내줘." | 트리거: Order created; 조건: Total price >= 200 및 Customer numberOfOrders > 3; 작업: Add order tags ("VIP-HighValue"), Send email |
| 인기 상품 저재고 경고 및 재발주 메모 추가 | "상품 재고 수량이 변경되었을 때, 임의의 옵션(변형)에 대해 판매 가능 재고가 10개 이하로 떨어지면 해당 상품에 'low-stock' 태그를 달고 재발주 메모를 상품에 기록해줘." | 트리거: Inventory quantity changed; 조건: Available inventory <= 10; 작업: Add product tags ("low-stock"), Add product note |
| 고위험 사기 의심 주문 자동 배송 보류 | "주문 위험도 분석이 완료되었을 때, 위험 수준이 High이거나 취소 권장이면 해당 주문의 배송 이행을 'Suspected fraud' 사유로 보류하고 주문에 'Fraud-Review' 태그를 지정해줘." | 트리거: Order risk analyzed; 조건: Risk level == HIGH; 작업: Hold fulfillment order (사유: "Suspected fraud"), Add order tags ("Fraud-Review") |
| 해외 배송 주문 식별 및 팀 알림 | "주문 결제가 완료되었을 때, 배송지 국가 코드가 US가 아니면 주문에 'International-Fulfillment' 태그를 추가하고 Slack의 logistics 채널에 알림 메시지를 전송해줘." | 트리거: Order paid; 조건: Shipping countryCode != "US"; 작업: Add order tags ("International-Fulfillment"), Send Slack message |
4단계: 캔버스 검토 및 대화형 수정
Sidekick이 구성을 마치면 대화창에 요약 설명과 함께 생성된 워크플로 바로가기 버튼이 표시됩니다. 버튼을 눌러 캔버스를 열고 연결 상태를 점검합니다. 추가 조건이 필요한 경우 캔버스에서 직접 수정하거나 대화창에서 후속 명령을 입력할 수 있습니다:
- "기프트카드로 전액 결제된 주문은 제외하는 조건을 추가해줘."
- 제안된 수정 사항을 확인한 후 **Apply changes(변경 사항 적용)**를 눌러 저장하거나, 원치 않으면 **Discard changes(변경 사항 취소)**를 누릅니다.
Sidekick을 활용한 오류 진단 및 워크플로 문제 해결
운영자가 수동으로 워크플로를 짤 때 가장 빈번하게 발생하는 문제는 필드 유형 불일치로 인한 저장 실패입니다. Sidekick은 에디터의 오류 로그를 인식하고 자연어 명령을 통해 구조적 결함을 자동으로 복구합니다.
가장 흔한 "Data not found(데이터를 찾을 수 없음)" 오류 해결
Shopify Flow에서 가장 자주 나타나는 유효성 검사 오류는 Data not found입니다. 이 오류는 후속 작업 노드가 **단일 항목(Single item)**을 요구하는데, 선행 트리거 또는 '데이터 가져오기(Get data)' 작업이 여러 항목이 포함된 목록(List/Array) 데이터를 반환할 때 발생합니다.
예를 들어 Scheduled time(예약 시간) 트리거 이후 Get product data로 상품 목록을 가져와 바로 Add product tags 작업에 연결하면, 시스템은 복수 상품 목록을 단일 태그 작업에 한 번에 대입할 수 없어 저장을 차단합니다.
Sidekick으로 해결하는 방법:
- 오류가 발생해 저장이 되지 않는 워크플로를 엽니다.
- Sidekick 창에 다음 명령을 입력합니다:
Fix the Data not found error on the Add product tags action.(Add product tags 작업의 Data not found 오류를 해결해줘.) - Sidekick은 데이터 형식 불일치를 감지하여 데이터 검색 단계와 태그 작업 사이에 For each(각 항목에 대해 반복 실행) 루프 노드를 자동으로 삽입하고 연결선을 재배치합니다.
- 화면에서 변경된 루프 구조를 확인하고 Apply changes를 누르면 정상적으로 저장됩니다.
다중 배송 주문(Fulfillment Order) 루프 충돌 해결
한 주문에 여러 창고나 발송지에서 출고되는 배송 주문이 포함된 경우, Order created 트리거 바로 뒤에 Mark a fulfillment order as fulfilled 작업을 연결하면 오류가 발생합니다. 주문 1건에 배송 주문 목록이 들어있기 때문입니다.
- Sidekick 명령 예시: "배송 이행 작업에서 데이터 누락 오류가 발생해. 주문 내의 모든 배송 주문을 반복 루프로 처리해줘."
- Sidekick이
fulfillmentOrders목록에 대한 For each 루프를 자동으로 구성합니다.
비동기 API 타이밍 차이로 인한 조건 판정 누락 방지
주문 생성 직후 사기 위험도나 마케팅 UTM 파라미터를 판별하기 위해 Order created 트리거를 사용하는 실수가 잦습니다. Shopify 백엔드 GraphQL Admin API에서 위험도 분석 및 상세 귀속 데이터는 주문 생성 후 수 초에서 수 분에 걸쳐 비동기적으로 기록됩니다. 생성 시점에 즉시 값을 읽으면 변수가 비어 있어 조건이 잘못 평가(False)됩니다.
- Sidekick 문제 진단 질의: "사기 의심 주문 태그 워크플로가 고위험 주문에 작동하지 않아. 트리거 타이밍 문제인지 확인해줘."
- Sidekick은 비동기 데이터 지연을 진단하고, 트리거를
Order created에서 전용 트리거인 **Order risk analyzed(주문 위험도 분석 완료 시)**로 교체하도록 안내합니다.
라이브 전환 전 안전 검증: Sidekick 가상 테스트 이벤트 생성
검증되지 않은 자동화 규칙을 실제 운영 환경에 바로 적용하면 고객에게 잘못된 이메일이 발송되거나 재고가 오염될 수 있습니다. Shopify Flow는 안전한 샌드박스 테스트 모드를 지원하며, Sidekick은 실제 스토어 구조를 바탕으로 2가지 대조군 가상 테스트 이벤트(Simulated events)를 즉시 생성해 줍니다.
+-------------------------------------------------------------------+
| 1. Flow 에디터에서 워크플로 열기 -> 트리거 노드의 "Test your workflow" 클릭 |
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 2. "Generate events" 선택 (Sidekick 기반 가상 이벤트 생성) |
| - Sidekick이 실제 스토어 데이터를 분석하여 대조군 2개 생성: |
| * 테스트 이벤트 A: 모든 조건 충족 (True 경로 시뮬레이션) |
| * 테스트 이벤트 B: 조건 미충족 (False 경로 시뮬레이션) |
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 3. 실행 경로 시각적 하이라이트 및 변수 검증 |
| - 캔버스에서 테스트 이벤트가 통과하는 경로가 색상으로 강조됨 |
| - 작업 노드의 "Preview" 탭에서 Liquid 동적 치환 결과값 점검 |
| - 실제 고객 발송이나 재고 변경이 발생하지 않는 읽기 전용 모드 |
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 4. 로직 확인 완료 -> 테스트 종료 -> "Turn on workflow" 활성화 |
+-------------------------------------------------------------------+
Sidekick 테스트 이벤트 생성 순서:
- 대상 워크플로 초안을 엽니다.
- 트리거 노드 우측 상단의 **Test your workflow(워크플로 테스트)**를 누릅니다.
- 팝업 창에서 Generate events를 선택합니다.
- Sidekick이 기존 주문 및 상품 데이터를 기반으로 다음 2가지 시나리오를 자동 생성합니다:
- 조건에 부합하는 시나리오 (True 분기 검증용);
- 조건에 부합하지 않는 시나리오 (False 분기 검증용).
- 저장된 이벤트 목록에서 각 시나리오를 선택해 봅니다.
- 캔버스에 강조 표시되는 이동 경로를 확인합니다. 각 작업 노드를 클릭한 뒤 Preview(미리보기) 탭을 열어 고객 이름, 금액 등 Liquid 동적 변수가 올바른 값으로 해석되는지 확인합니다.
- 테스트 모드는 실데이터를 수정하지 않는 안전한 가상 환경입니다. 검증을 마친 후 Turn on workflow를 클릭하면 안심하고 실무에 배포할 수 있습니다.
실무 운영 모범 사례 및 한계점
Sidekick과 Shopify Flow를 효율적이고 안정적으로 운영하기 위한 지침은 다음과 같습니다:
- 모호한 표현 지양, 구체적인 수치 제시: "VIP 주문 자동화 만들어줘"라는 막연한 표현 대신 "주문이 생성되었을 때, 소계가 150달러 이상이고 배송 국가가 대한민국이면 주문에 VIP-KR 태그를 달아줘"와 같이 명확한 기준을 제시하십시오.
- 동일 트리거 과다 분산(Fan-out) 방지:
Order created트리거에 단일 목적 워크플로를 수십 개 독립적으로 연결하면 시스템 부하가 증가합니다. Sidekick을 활용해 여러 조건 분기를 하나의 체계적인 워크플로로 통합하십시오. - 1,000개 워크플로 한도 관리: Shopify 스토어당 활성 및 비활성 워크플로의 총합 한도는 1,000개입니다. 사용하지 않는 오래된 초안은 정기적으로 정리하십시오.
- 고급 작업의 요금제 요건: 외부 웹훅으로 데이터를 전송하는
Send HTTP request와 같은 고급 커넥터 작업은 Shopify Grow, Advanced 또는 Plus 요금제 구독이 필요합니다. - 생태계 지원 범위 인식: Sidekick은 공식 기능 및 Flow 커넥터를 지원하는 주요 앱과의 연동을 빠르게 구성합니다. 커넥터가 없는 외부 독자 시스템과 연결하려면 범용 웹훅을 사용하거나 Shopify 파트너 개발자와 협업해야 합니다.
Sidekick의 자연어 처리 역량과 Shopify Flow의 안정적인 실행 엔진을 결합하면, 운영자는 백엔드 코딩 없이도 복잡한 주문 처리, 재고 관리, 부정 거래 방지 체계를 단 몇 분 만에 구축할 수 있습니다.