연동
외부 상거래 동기화
Shopify 또는 WooCommerce를 연결하고 실시간 상거래 데이터를 OrderInChat에 미러링합니다.
개요
채널 및 연동 → 외부 상거래 (/ko/integrations/commerce)는 Shopify 또는 WooCommerce에서 체크아웃을 유지하면서 지원되는 데이터를 OrderInChat에 미러링합니다. 위젯, WhatsApp 및 Instagram AI, 자동화 및 선택적 배송 라벨은 미러링된 데이터를 사용합니다.
이 통합은 소스 테마를 복제하지 않으며 외부 체크아웃을 대체하지 않습니다.
Shopify 연결
OrderInChat은 Shopify OAuth를 사용하므로 토큰을 수동으로 복사할 필요가 없습니다.
- Shopify 파트너 대시보드에서 Order in Chat이라는 앱을 만듭니다.
- 허용된 리디렉션 URL에 콜백 URL
https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback을 추가합니다. - 다음 Admin API 범위를 부여합니다:
read_products,write_products,read_inventory,write_inventory,read_orders,read_customers,read_content,read_legal_policies,read_discounts,read_shipping,read_files,read_locales,read_locations,read_script_tags,write_script_tags. - OrderInChat에서 채널 및 연동 → 외부 상거래로 이동하여 Shopify를 선택하고 HTTPS 스토어 URL(예:
https://your-store.myshopify.com)을 입력한 후 Shopify와 연결을 클릭합니다. - Shopify에서 권한을 승인합니다. 자동으로 OrderInChat으로 돌아갑니다. 그런 다음 연결 테스트, 웹후크 등록, 지금 동기화를 클릭합니다.
OAuth를 사용할 수 없는 경우 수동 토큰 설정 섹션을 확장하고 Admin API 액세스 토큰과 사용자 정의 앱 API 비밀 키를 붙여넣습니다. API 비밀은 Shopify 웹후크 HMAC 서명을 확인하는 데 필요합니다. OrderInChat은 자격 증명을 암호화하고 다시 표시하지 않습니다.
공식 가이드: Shopify 사용자 정의 앱 및 Admin API 액세스 토큰.
WooCommerce 연결
WordPress에서 WooCommerce → 설정 → 고급 → REST API를 열고 미러 전용 동기화를 위한 읽기 권한이 있는 키를 생성하거나, 대량 편집기 변경 사항이 WooCommerce에 다시 기록되어야 하는 경우 읽기/쓰기 권한을 부여하고 HTTPS 스토어 URL, 소비자 키 및 소비자 비밀을 입력합니다. WordPress 페이지 및 게시물을 동기화하려면 사용자 → 프로필에서 WordPress 사용자 이름과 응용 프로그램 비밀번호도 입력합니다.
공식 가이드: WooCommerce REST API.
일부 호스트는 HTTP 기본 인증을 거부합니다. 커넥터는 쿼리 문자열 인증으로 WooCommerce 요청을 재시도할 수 있으며, 자격 증명은 로그에서 삭제됩니다.
동기화 동작
- 연결을 저장하고 테스트합니다.
- 웹후크 등록 — 외부 스토어에서 제품, 주문 및 고객 변경 사항이 OrderInChat에 거의 실시간으로 알림을 보내도록 구독을 생성합니다. 웹후크가 누락될 경우에 대비해 OrderInChat은 변경 사항도 정기적으로 확인합니다.
- 미러링할 리소스를 선택합니다.
- 초기 동기화를 실행합니다.
안전을 위해 OrderInChat은 모든 웹후크를 확인하고 저장하기 전에 Shopify 또는 WooCommerce에서 데이터를 다시 확인합니다. 정기 확인은 상거래 소스로 사용이 활성화된 경우에만 누락된 웹후크를 보완합니다. 웹후크 상태에 오류가 표시되고 연결이 비활성 상태인 경우, 소스 스토어에서 변경 후 웹후크 등록 및 지금 동기화를 사용하십시오; 연결 테스트만으로는 제품이 업데이트되지 않습니다. 반복된 업데이트는 중복 레코드를 생성하지 않습니다.
Shopify 변형 배송 무게는 Shopify의 변형 무게에서 가져옵니다. 제품 편집기는 이를 스토어에 설정된 무게 단위로 표시합니다. length, width 또는 height라는 이름의 치수 메타필드는 센티미터로 변환됩니다. Shopify 제품 설명은 제품 자체의 설명에서 가져오며, 공유 테마 섹션이나 배너에서 가져오지 않습니다; 테마 복사본은 제품별 설명이 되지 않습니다. 초안 및 보관된 제품은 고객에게 표시되지 않습니다.
스토어가 외부 상거래를 사용하는 경우 고객은 소스 제품 URL을 통해 구매합니다. 해당 스토어에서는 OrderInChat 장바구니 체크아웃과 WhatsApp 체크아웃 흐름이 꺼집니다.
재고 위치
Shopify 위치 및 변형별 재고 수준은 OrderInChat 창고/위치 레코드에 미러링됩니다. 제품 및 변형 재고는 채팅 및 체크아웃을 위해 모든 위치의 합계를 표시합니다. WooCommerce 코어는 하나의 총 재고 값을 노출하므로 기본 가상 위치에 미러링됩니다; WooCommerce 플러그인의 다중 위치 재고는 지원되는 플러그인이 필요합니다.
카탈로그 → 재고에서 직접 OrderInChat 위치를 추가할 수 있습니다. 대량 편집기 재고 셀은 위치별로 확장됩니다. Shopify에 재고를 푸시하면 선택된 위치만 업데이트되며 write_inventory 범위가 필요합니다. 잠긴 재고 필드는 이후 재고 동기화로 덮어쓰지 않습니다.
배송 라벨
OrderInChat 배송 라벨은 기본적으로 꺼져 있습니다. OrderInChat에서만 라벨을 생성하려는 경우에만 활성화하십시오. 활성화되더라도 외부 주문에 이미 이행 또는 추적 정보가 있는 경우 OrderInChat은 라벨을 구매하지 않습니다.
위젯 스니펫
Shopify: 웹후크 등록은 채팅 위젯을 Shopify 스토어에 자동으로 설치하려고 시도합니다. 필요할 경우 Custom Liquid에 스니펫을 붙여넣을 수 있습니다. 자동 설치가 실패하면 사용자 정의 앱에서 write_script_tags를 부여하십시오.
WooCommerce: REST API는 테마 스크립트를 주입할 수 없습니다. 통합 페이지에서 JavaScript 또는 PHP 스니펫을 테마 바닥글 또는 functions.php에 복사하십시오.
페이지 → 지식 베이스
페이지 및 게시물이 활성화되면 Shopify 페이지/기사/정책 및 WooCommerce 페이지/게시물이 OrderInChat 지식 베이스에 추가(또는 업데이트)되어 AI 답변에 사용됩니다. 일치하는 Shopify 정책 제목은 반품/약관 스토어 필드도 채웁니다. 이는 전체 테마/CMS 복제가 아닙니다.
API 제한 사항
통합은 값을 발명하는 대신 지원되지 않거나 사용할 수 없는 데이터를 보고합니다. 일반적인 제한 사항은 다음과 같습니다:
- Shopify는 Admin API를 통해 모든 결제 설정을 노출하지 않습니다.
- 운송업체 계산 배송 가격은 외부 체크아웃에서 계산됩니다.
- WooCommerce REST는 WordPress 응용 프로그램 비밀번호 없이 WordPress 페이지를 포함하지 않습니다.
- 리뷰 및 예약은 해당 리소스를 노출하는 플랫폼 또는 앱 API가 필요합니다.
- 제품 추가 기능은 소스 API에 실제 동등물이 있을 때만 미러링됩니다.
