쇼피파이 앱

쇼피파이 앱은 쇼피파이 스토어에 AI 에이전트를 붙이는 앱입니다. 앱을 설치하면 쇼피파이 관리자 안에 앱 홈이 열리고, 스토어 분석으로 배정된 에이전트가 테마의 앱 임베드를 통해 스토어프론트에 표시됩니다. 상품과 정책 정보는 쇼피파이에서 직접 들어옵니다.

설치와 관리는 쇼피파이 스토어 관리자 계정으로 진행합니다. voidX 회원가입과 voidx.ai 로그인은 필요하지 않고, 요금도 쇼피파이 결제로 지불합니다.

전체 다섯 단계이고 스토어 분석 대기를 포함해 10분 정도 걸립니다.

사전 준비#

• 스토어 관리자 계정: 앱을 설치하고 테마를 편집하고 앱 요금을 승인할 수 있는 권한이 있어야 합니다.
• 온라인 스토어 테마: 에이전트는 온라인 스토어 테마의 앱 임베드로 표시됩니다.
• 스토어프론트 공개 상태: 스토어프론트가 비밀번호로 보호돼 있으면 분석이 페이지를 읽지 못하고 등록된 상품 정보만으로 진행됩니다.

요금과 결제#

표시 가격은 세금 별도이고, 앱 요금은 쇼피파이 청구서에 합산됩니다. 결제 주기는 달력 월이 아니라 플랜을 승인한 시각부터 30일입니다. 제공 토큰은 주기마다 새로 채워지고 남은 토큰은 다음 주기로 넘어가지 않습니다.

무료 플랜과 무료 체험은 없습니다. 플랜을 선택하기 전에도 스토어 분석과 앱 임베드 활성화는 할 수 있지만, 방문자와의 대화는 플랜을 선택한 뒤에 열립니다.

충전팩은 100만 토큰 $13.99, 250만 토큰 $34.99 두 가지입니다. 플랜을 구독 중일 때만 구매할 수 있고, 플랜 토큰을 다 쓴 뒤에 사용되며 만료가 없습니다. 플랜 변경과 충전팩 구매는 플랜과 사용량 (쇼피파이)에서 설명합니다.

앱스토어에서 설치#

1. 쇼피파이 앱스토어에서 voidX AI 앱 페이지를 열고 설치를 누릅니다.
2. 쇼피파이가 앱이 사용할 데이터 접근 권한을 보여주는 화면이 나옵니다. 상품, 테마, 스토어 정책 읽기가 여기에 포함됩니다. 동의하면 설치가 끝납니다.
3. 설치가 끝나면 쇼피파이 관리자 안에서 앱 홈이 열리고 "👋 환영합니다!" 화면에 "스토어:" 뒤로 내 스토어 이름이 표시됩니다.

앱 홈을 닫았다면 쇼피파이 관리자 왼쪽 메뉴의 앱에서 voidX AI를 누릅니다. 같은 화면이 다시 열립니다.

앱 홈 위에는 "홈", "대화 내역", "상담원 설정" 탭이 있고 설치 직후에는 "홈"에서 진행합니다. 화면 문구는 쇼피파이 관리자 언어가 한국어면 한국어로, 그 밖의 언어면 영어로 표시됩니다.

스토어 분석#

"홈" 탭 위에 "① 분석", "② 페르소나 확인", "③ 위젯 켜기" 세 단계가 표시됩니다. 첫 단계에서 스토어를 분석해 업종에 맞는 에이전트를 배정합니다.

1. "스토어:" 뒤의 스토어 이름이 내 스토어가 맞는지 확인합니다.
2. "스토어 분석 시작"을 누릅니다.

화면이 "🔍 스토어를 분석하고 있어요…"로 바뀌고 진행 바가 세 단계로 차오릅니다.

1. "스토어 페이지를 읽고 있어요"
2. "업종·키워드를 추출하고 있어요"
3. "어울리는 AI 상담원을 찾고 있어요"

1~2분 정도 걸리고, 창을 닫아도 진행됩니다. 분석이 끝나면 "✨ AI 상담원이 준비됐어요!" 카드에 에이전트의 이름, 업종, 한 줄 소개가 표시됩니다. 분석은 스토어당 한 번만 진행되고, 배정된 에이전트는 앱 홈에서 바꿀 수 없습니다.

"분석에 실패했어요. 다시 시도해 주세요." 안내가 나오면 "스토어 분석 시작"을 다시 누릅니다. 스토어에 접근할 수 없거나 일시적인 오류일 때 생기는 일입니다.

앱 임베드 활성화#

분석이 끝나면 "마지막 단계: 위젯을 켜 주세요" 카드와 "아직 꺼져 있음" 배지가 표시됩니다. 에이전트는 테마의 앱 임베드로 스토어프론트에 들어가므로 테마 에디터에서 한 번 켜고 저장해야 합니다.

1. "테마 에디터 열기"를 누릅니다. 테마 에디터가 열리고 앱 임베드 목록에 "AI Chat Widget"이 선택된 상태로 나옵니다.
2. "AI Chat Widget" 토글이 켜져 있는지 확인하고 오른쪽 위 "저장"을 누릅니다. 토글만 켜면 반영되지 않습니다.
3. 저장한 뒤 쇼피파이 관리자의 앱 > voidX AI로 돌아오면 몇 초 안에 "위젯이 스토어에서 작동 중이에요" 배너와 "켜짐" 배지로 바뀝니다.

에이전트 위치는 앱 임베드 설정의 "Widget position"에서 "Bottom right"(기본)와 "Bottom left" 중 고를 수 있습니다. 위치를 바꾼 뒤에도 "저장"을 눌러야 반영됩니다.

"나중에 하기"를 누르면 "설정은 나중에 마쳐도 돼요" 안내로 바뀌고, 이후 테마 에디터에서 켜고 저장하는 순간 앱 홈이 자동으로 감지합니다. "활성화 자동 확인이 지금 원활하지 않아요" 안내가 보이면 테마 에디터의 App embeds에서 "AI Chat Widget" 토글이 켜져 있는지 직접 확인합니다.

플랜을 아직 선택하지 않았다면 완료 배너에 "지금은 방문자에게 대화 대신 안내 문구가 표시돼요"가 함께 표시됩니다. 다음 단계에서 플랜을 선택하면 대화가 열립니다.

플랜 선택#

"홈" 탭 아래 "플랜·사용량" 카드에서 결제를 시작합니다. 구독 전에는 "플랜 없음" 배지와 "플랜을 선택하면 AI 상담원이 스토어에서 대화를 시작해요" 안내가 보입니다.

1. "플랜 선택"을 누릅니다. 쇼피파이가 제공하는 플랜 선택 페이지가 열리고 Light와 Premium이 나란히 표시됩니다.
2. 플랜을 고르고 승인합니다. 요금은 쇼피파이 청구서에 합산됩니다.
3. 승인하면 앱 홈으로 돌아오고 "플랜 변경을 확인하고 있어요" 안내 뒤에 카드의 배지가 "Light" 또는 "Premium"으로 바뀝니다. 이때부터 스토어프론트에서 대화가 열립니다.

플랜 선택 페이지는 쇼피파이가 호스팅하므로 특정 플랜이 미리 골라진 상태로 열리지 않습니다.

스토어에서 확인#

1. 완료 배너의 "스토어에서 보기"를 누르면 내 스토어가 새 탭으로 열립니다.
2. 아무 페이지나 열고 새로고침합니다. 에이전트는 테마가 적용된 스토어 페이지 어디에나 표시됩니다.
3. 설정한 위치에 에이전트 캐릭터가 나타나고, 말을 걸었을 때 답하면 설치가 끝난 것입니다.

플랜을 선택하기 전에는 캐릭터는 보이지만 대화를 열면 "지금은 AI 상담을 이용할 수 없어요. 불편을 드려 죄송합니다."가 표시됩니다. 플랜을 승인한 뒤 다시 확인합니다.

상품과 정책 정보가 들어오는 경로#

쇼피파이 채널은 웹페이지를 크롤링하지 않습니다. 상품은 쇼피파이 Admin API로, 정책은 스토어 정책 설정에서 가져옵니다.

• 설치 직후 전체 상품과 정책을 한 번 가져옵니다.
• 이후 상품을 등록·수정·삭제하면 자동으로 반영됩니다.
• 하루 한 번 전체 상품과 정책을 다시 맞춥니다.

에이전트가 아는 상품은 상태가 "활성"인 상품입니다. 초안과 보관 처리된 상품은 에이전트가 알지 못합니다. 상품마다 제목, 상품 유형, 공급업체, 태그, 옵션, 설명, 가격을 가져옵니다. 에이전트가 특정 상품을 모른다면 쇼피파이에서 그 상품의 상태를 먼저 확인합니다.

배송·환불 같은 질문에는 쇼피파이 관리자 > 설정 > 정책에 작성한 환불 정책, 배송 정책, 개인정보 처리방침, 이용약관 등을 근거로 답합니다. 정책이 비어 있으면 그 주제는 답할 근거가 없으므로, 방문자가 자주 묻는 정책은 설정에 작성해 둡니다.

세팅 확인#

에이전트의 이름과 첫 인사말은 앱 홈에서 바꿀 수 없습니다. Premium 플랜에서는 "상담원 설정" 탭에서 말투와 지킬 것·피할 것을 정할 수 있습니다.

다음 단계#

• 플랜 변경, 충전팩 구매, 해지는 플랜과 사용량 (쇼피파이)를 참고하세요.
• 방문자와 에이전트가 나눈 대화는 대화 내역 (쇼피파이)를 참고하세요.
• 방문자에게 보이는 화면 요소는 대화 화면을 참고하세요.
• 에이전트가 보이지 않으면 위젯 미표시를 참고하세요.