Shopify 커넥터
호환 대상 Shopify
Shopify를 FreeScout에 연결하여 대화에 일치하는 고객 주문과 구매 컨텍스트가 표시되도록 하세요. Shopify 관리자에서 읽기 전용 사용자 정의 앱을 생성하고 액세스 토큰을 FreeScout에 붙여넣으면 파트너 계정이나 앱 검토가 필요하지 않습니다. ReplyRabbit은 또한 제품 소유권 컨텍스트를 AI 계층에 제공하여 초안이 고객이 구매한 내용을 참조할 수 있도록 합니다.
개요를 찾고 계신가요?
개요
Shopify 커넥터는 FreeScout 대화에 주문 사이드바를 추가합니다. 대화에 고객 이메일 주소가 있으면 커넥터는 스토어의 Shopify GraphQL Admin API를 쿼리하여 일치하는 주문을 찾고 대화 옆에 표시합니다.
사이드바에 고객 패널, 전체 주문 내역, 수량과 가격이 포함된 주문별 품목, 재무 합계, 고객 생애 가치(CLV), 평균 주문 가치(AOV), 그리고 더 관련성 높은 초안을 위해 ReplyRabbit AI 컨텍스트로 흘러가는 제품 소유 권한이 표시됩니다.
설치할 구성 요소가 하나 있습니다: FreeScout Shopify 커넥터 모듈. 사용자 지정 앱의 Admin API 액세스 토큰을 사용하여 HTTPS를 통해 Shopify GraphQL Admin API를 읽은 다음 주문 사이드바를 렌더링합니다. FreeScout에 자체 메일함별 설정 페이지가 있습니다.
주문 사이드바는 자체적으로 작동합니다. AI 초안으로 흐르는 제품 소유 권한이 ReplyRabbit을 사용하는 부분입니다.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- 작동하는 FreeScout 설치입니다.
- 다음의 Shopify 스토어
your-store.myshopify.com도메인(또는 그에 매핑되는 사용자 지정 도메인)으로, 앱 개발을 위한 직원 권한이 있어야 합니다. - AI 초안에 제품 소유권 컨텍스트를 원하는 경우 ReplyRabbit을 설치하고 활성화하세요.
- Shopify Connector 라이선스(FreeScout 설치 1개당 18 EUR 일회성) 또는 이를 포함하는 활성 ReplyRabbit Pro 또는 Team 요금제입니다.
ReplyRabbit이 아직 설치되지 않았다면 다음으로 시작하세요 ReplyRabbit 모듈 설치 방법, 그런 다음 완료 ReplyRabbit 설정 방법.
Shopify에서 사용자 정의 앱 생성
커넥터는 자체 스토어 내부에 있는 사용자 지정 앱의 Admin API 액세스 토큰으로 인증합니다.
앱 개발 열기
Shopify 관리자에서 다음으로 이동하세요 설정, 그런 다음 앱 및 판매 채널, 그런 다음 앱 개발. 메시지가 표시되면 사용자 지정 앱 개발을 허용하세요.앱 생성
클릭 앱 생성, 이름을 "ReplyRabbit Connector"로 지정하고 생성합니다.Admin API 범위 설정
열기 Admin API 범위 구성 그리고 체크read_customers,read_orders, 그리고read_products. 체크read_all_orders60일보다 오래된 주문 기록을 원하는 경우에도. 저장하세요.토큰 설치 및 복사
클릭 앱 설치, 그런 다음 토큰 한 번 표시 그리고 복사 관리자 API 액세스 토큰 (다음으로 시작합니다shpat_). Shopify는 이를 한 번만 표시하므로 안전한 곳에 보관하세요.
읽기 전용 액세스
FreeScout 커넥터 모듈 설치
커넥터 모듈 다운로드
FreeScout 커넥터 모듈 ZIP을 다음에서 다운로드하십시오 ReplyRabbit 대시보드. 커넥터를 구매했거나 활성 ReplyRabbit Pro 또는 Team 플랜을 보유하면 다운로드가 나타납니다.FreeScout에 업로드
FreeScout에서 다음으로 이동하세요 모듈, 업로드 버튼을 클릭하고 ZIP을 선택한 후 설치합니다.모듈 활성화
다음을 활성화하세요 Shopify 통합 모듈 목록에서 모듈.
메일박스별 구성
커넥터 설정 열기
FreeScout에서 Shopify 주문 데이터를 표시해야 하는 사서함을 열고 사서함 설정 메뉴를 열고 다음을 선택하세요 스토어 커넥터. 이것은 Shopify 커넥터의 설정 페이지이며 ReplyRabbit 설정 내부의 섹션이 아닙니다.스토어 도메인과 액세스 토큰 입력
스토어 도메인을 입력하세요. 예:your-store.myshopify.com, Admin API 액세스 토큰을 붙여넣습니다. 저장합니다. 커넥터는 저장하기 전에 스토어에 대해 토큰과 스코프를 확인하며, 토큰은 암호화되어 저장되고 다시 표시되지 않습니다.커넥터 라이선스 키 추가
커넥터를 구매했다면 설정하세요SHOPIFYINTEGRATION_LICENSE_KEYFreeScout에서.env라이선스 키로. 활성 ReplyRabbit Pro 또는 Team 플랜이 설치를 커버하면 이 단계를 건너뛰세요.테스트
고객 이메일이 Shopify 주문과 일치하는 FreeScout 대화를 열고 주문 사이드바가 나타나는지 확인하세요.
각 FreeScout 메일박스는 자체 스토어 도메인과 액세스 토큰을 저장하므로 서로 다른 메일박스를 서로 다른 스토어에 연결할 수 있습니다.
커넥터가 보여주는 것
- 대화 담당자를 위한 고객 패널입니다.
- 주문 번호, 날짜, 상태 및 총액이 포함된 전체 주문 내역.
- 수량 및 가격이 포함된 주문별 품목.
- 재무 합계(소계, 할인, 배송, 세금, 환불).
- 고객 생애 가치(CLV) 및 평균 주문 가치(AOV).
- AI 초안을 위한 제품 소유권 자격.
커넥터를 얻는 방법
Shopify Connector는 유료 모듈입니다. 두 가지 방법으로 얻을 수 있습니다:
- FreeScout 설치 하나에 대한 일회성 라이선스로 18 EUR에 Shopify Connector를 구매한 후 라이선스 키를 다음과 같이 설정하세요
SHOPIFYINTEGRATION_LICENSE_KEYFreeScout에서.env. - 커넥터가 추가 비용 없이 포함된 활성 ReplyRabbit Pro 또는 Team 플랜을 사용하세요.
라이선스를 구매하거나 다음에서 커넥터를 다운로드하세요 ReplyRabbit 대시보드. 방문 가격 페이지 ReplyRabbit 플랜 옵션. 활성 ReplyRabbit Pro 또는 Team 플랜이 설치를 포함하면 커넥터는 구성 후 별도 라이선스 키 없이 작동합니다.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 저장 시 "Shopify rejected the connection" | 토큰이 잘못 입력되었거나, 취소되었거나, 다른 스토어에 속해 있습니다. 커스텀 앱을 재설치하여 새 토큰을 표시하고 다시 붙여넣으세요. |
| 저장 시 "Missing these Admin API scopes" | 커스텀 앱을 열고 다음 아래에서 누락된 범위를 추가하세요 Admin API 범위 구성, 저장하고 앱을 다시 설치합니다. 다시 설치하면 새 토큰이 발급됩니다. |
| 스토어 도메인이 거부됨 | 사용 your-store.myshopify.com 도메인 또는 그에 매핑되는 사용자 지정 도메인. 사설 호스트와 IP 주소는 거부됩니다. |
| 주문 사이드바가 표시되지 않음 | 메일박스 패널이 활성화되어 있고 설정 페이지에서 연결이 연결됨으로 표시되는지 확인하세요. |
| 알려진 고객에 대해 주문이 비어 있음 | FreeScout 대화의 고객 이메일이 Shopify 주문의 이메일과 일치하는지 확인하세요. |
| 최근 60일의 주문만 표시됩니다 | 다음을 추가하세요 read_all_orders 범위를 사용자 지정 앱으로 지정하고, 재설치한 뒤, 새 토큰을 붙여넣으세요. |
| 품목, 재무 또는 CLV가 표시되지 않음 | 커넥터 라이선스 키가 저장되었는지, 또는 활성 ReplyRabbit Pro 또는 Team 요금제가 설치를 포함하는지 확인하세요. |
| 초안에 제품 소유권 컨텍스트가 표시되지 않음 | 커넥터가 라이선스되었는지, ReplyRabbit이 설치되었는지, 커넥터가 주문을 반환하는지, 메일박스에 대해 AI 컨텍스트 기능이 활성화되어 있는지 확인하세요. |
더 광범위한 문제는 다음을 참조하세요 ReplyRabbit 문제 해결.
개인정보 및 데이터 처리
커넥터가 Shopify를 쿼리하면 사용자 지정 앱의 토큰을 사용하여 HTTPS를 통해 고객 이메일 주소를 Shopify GraphQL Admin API로 전송합니다. 스토어에서 반환된 주문 데이터가 FreeScout 사이드바를 채우고 ReplyRabbit과 함께 초안용 AI 컨텍스트를 구축합니다.
사용자 지정 앱은 읽기 범위만 가지므로 커넥터가 스토어에 절대 쓰지 않습니다. 액세스 토큰은 FreeScout에 암호화되어 저장되며, 아웃바운드 요청은 TLS를 검증하고 리디렉션을 따르지 않습니다.
Shopify 주문 데이터는 메일함에 선택된 AI 제공자를 통하지 않고는 제3자에게 전송되지 않으며, AI 컨텍스트 기능이 사용할 때만 전송됩니다. 정책상 주문 데이터가 전적으로 자체 서버에 있어야 하는 경우 메일함에 로컬 AI 제공자(예: Ollama)를 사용하세요.
다음 단계
- 완료 ReplyRabbit 설정 방법 메일박스에 여전히 제공자, 컨텍스트 또는 스타일 설정이 필요한 경우.
- WooCommerce 또는 Magento에서도 사용 중이신가요? 다음을 참조하세요 WooCommerce 커넥터 그리고 Magento 커넥터 가이드.
FAQ
Shopify 커넥터는 내 스토어에 어떻게 연결되나요?
Shopify 관리자(Settings, Apps and sales channels, Develop apps)에서 생성한 사용자 지정 앱으로. read_customers, read_orders, read_products 범위를 부여하고 설치한 다음 Admin API 액세스 토큰을 스토어 도메인과 함께 FreeScout 커넥터 설정에 붙여넣습니다. 커넥터는 저장 전에 스토어에 대해 토큰을 확인합니다.
Shopify 파트너 계정이나 App Store 등록이 필요한가요?
아니요. 사용자 지정 앱은 자체 스토어 관리자 내에서 생성되며 파트너 계정, 앱 검토, 공개 목록이 필요하지 않습니다.
Shopify 커넥터 비용은 얼마인가요?
Shopify Connector는 활성 ReplyRabbit Pro 또는 Team 플랜에 포함됩니다. 그렇지 않은 경우 하나의 FreeScout 설치에 대해 18 EUR 일회성 라이선스 비용이 듭니다. 구매한 경우 라이선스 키를 FreeScout .env의 SHOPIFYINTEGRATION_LICENSE_KEY로 설정하세요.
최근 60일의 주문만 표시되는 이유
Shopify는 앱에 read_all_orders 범위가 없으면 주문 이력을 60일로 제한합니다. 전체 이력을 보려면 사용자 지정 앱을 구성할 때 read_all_orders를 선택하세요.
각 FreeScout 메일박스를 서로 다른 Shopify 스토어에 연결할 수 있나요?
예. 각 메일함은 커넥터 설정에 자체 스토어 도메인과 액세스 토큰을 저장하므로 서로 다른 스토어를 서로 다른 메일함에 연결할 수 있습니다.