회원가입과 초기 세팅

voidX AI는 웹사이트에 AI 에이전트를 붙이는 서비스입니다. 설치에 앞서 계정을 만들고, 요금제를 결제하고, 사이트를 읽혀 에이전트의 페르소나와 지식을 준비합니다. 이 네 단계는 모두 콘솔 안에서 진행되며 코드 수정이 필요하지 않습니다.

이 문서는 직접 운영하는 웹사이트에 위젯을 붙이는 경우의 순서입니다. 카페24 쇼핑몰은 voidx.ai 계정 없이 앱 설치만으로 같은 준비가 끝나므로 카페24 유료앱 문서를 따릅니다.

사이트 분석과 지식 수집을 기다리는 시간을 포함해 전체 30분 정도 걸립니다.

사전 준비#

• 사이트 주소 : https://로 시작하는 공개 주소
• 결제 카드 : 국내 카드 1장. 카드 번호, 유효 기간, 비밀번호 앞 2자리, 생년월일 또는 사업자등록번호
• 자주 묻는 안내문 : 배송비, 교환·환불 규정처럼 사이트에 흩어져 있는 정책. 지식 등록 단계에서 직접 입력에 사용

회원가입#

voidx.ai 오른쪽 위의 "로그인" 버튼을 누르면 가입 창이 열립니다. 소셜 계정으로 바로 시작하거나 이메일로 가입합니다.

1. "Google로 계속하기" 또는 "Apple로 계속하기"를 누르면 팝업에서 로그인이 진행되고 가입이 끝납니다.
2. 이메일로 가입하려면 이름, 이메일, 비밀번호를 입력하고 "회원가입"을 누릅니다.
3. "이용약관 동의"와 "개인정보 수집·이용 동의"는 필수이고, "마케팅 정보 수신 동의 (선택)"은 선택입니다.

이메일로 가입하면 검증 메일이 발송됩니다. 메일의 링크를 열면 로그인 상태에서 검증이 자동으로 이어집니다. 메일이 보이지 않으면 스팸함을 확인하고, 링크가 만료됐다면 그 화면의 "검증 메일 재발송"을 누릅니다.

팀원과 함께 운영하는 경우에도 계정은 하나면 됩니다. 관리자 계정으로 시작한 뒤 매니저 초대로 편집자나 뷰어를 추가합니다.

요금제 결제#

페르소나와 지식 화면은 멤버십이 있어야 열립니다. 요금제를 결제하면 멤버십이 켜지고 나머지 단계가 가능해집니다.

표시 가격은 VAT 별도입니다. 상담 세션 1건당 16,000토큰이 차감됩니다. 추가 충전은 카페24·쇼피파이 앱에서만 할 수 있고, 직접 설치한 위젯은 토큰이 부족하면 상위 플랜으로 변경합니다. 토큰 규칙은 토큰과 사용량에서 설명합니다.

결제는 콘솔에서 카드 한 장으로 진행합니다.

1. 요금제 페이지에서 원하는 플랜의 "시작하기"를 누릅니다.
2. 결제 화면의 "결제 수단"에서 "카드 등록"을 누르고 카드 정보를 입력합니다. 카드는 한 장만 등록되며, 새로 등록하면 기존 카드는 자동으로 해지됩니다.
3. "결제하기"를 누르면 확인 문구가 나옵니다. "결제 진행"을 누르면 등록된 카드로 즉시 결제되고, 이후 매월 같은 날짜에 자동 결제됩니다.
4. 결제가 끝나면 "멤버십 관리" 화면으로 이동하고 상태가 "이용 중"으로 표시됩니다.

플랜 변경과 해지는 멤버십과 결제에서 다룹니다.

사이트 캐스팅#

캐스팅은 사이트 주소 하나로 에이전트를 준비하는 과정입니다. 사이트를 읽어 업종과 어조를 파악하고, 결과를 내 사이트에 연결하면 거기에 맞는 페르소나를 에이전트에 적용하고 위젯 키를 발급합니다.

1. 콘솔 왼쪽 메뉴에서 "에이전트 연결"을 열고 "사이트 캐스팅하기"를 누릅니다. 공개 캐스팅 페이지가 열립니다.
2. 사이트 주소를 입력하고 "캐스팅하기"를 누릅니다. 10~30초 뒤 업종 에이전트가 결과로 표시됩니다.
3. "이 에이전트로 시작하기"를 누르면 결과가 계정에 보관되고 "에이전트 연결"로 돌아옵니다.
4. "다음 할 일" 카드의 "이 주소로 연결"을 누르고, 확인 창에서 "연결"을 누릅니다.
5. "연결했습니다."가 표시되면 페르소나 적용과 위젯 키 발급이 끝난 것입니다.

연결에는 관리자 권한과 멤버십이 모두 필요합니다. 편집자나 뷰어 계정에서는 연결 버튼 대신 관리자 계정으로 연결하라는 안내가 표시됩니다.

연결 확인 창에는 금융·의료 등 규제 업종 사이트가 서비스 제공 범위에서 제외된다는 고지가 함께 표시됩니다. 해당 업종 여부는 운영자가 확인해야 합니다.

연결 중 분석이 실패해도 위젯 키는 정상적으로 발급됩니다. 이 경우 에이전트는 기본 동작으로 응답하고, 주소를 확인한 뒤 다시 연결할 수 있습니다.

연결이 끝나면 "내 페르소나" 메뉴에서 에이전트 이름, 첫 인사말, 어조, 사업자 맞춤 지침을 수정할 수 있습니다. 화면 설명은 페르소나와 캐스팅에, 캐스팅이 읽는 것과 만드는 것은 페르소나 캐스팅에 있습니다.

지식 등록#

에이전트는 등록된 지식 범위에서만 답합니다. 지식을 등록하지 않으면 사이트 내용을 알지 못하므로, 설치 전에 이 단계를 마쳐야 첫 대화부터 정확한 답이 나옵니다.

1. 콘솔 왼쪽 메뉴에서 "지식 관리"를 열고 "새 지식 추가"를 누릅니다.
2. 1단계 "사이트 SEO 진단"에 사이트 주소를 입력하고 "진단 실행"을 누릅니다. 주소는 https://만 허용됩니다. 결과는 참고 정보이며 결과와 무관하게 수집을 진행할 수 있습니다. 진단 없이 등록하려면 "건너뛰고 직접 등록"을 누릅니다.
3. 2단계에서 지식을 추가할 방식을 고릅니다.

4. "등록 후 바로 수집"이 켜진 상태에서 "등록하고 수집 시작"을 누릅니다.

수집에는 한도가 있습니다. 사이트 전체 수집은 최대 1,000페이지 또는 최대 15분 중 먼저 도달하는 쪽에서 끝나고, URL 단건은 페이지당 400KiB까지 수집됩니다. 어느 방식이든 오늘 수집 횟수가 차감되며 실패해도 차감됩니다. 등록 화면에 같은 문구가 표시됩니다.

텍스트로 등록한 지식은 목록에 표시되지 않으며 등록 후 수정·삭제할 수 없습니다. 바뀔 수 있는 내용은 사이트 수집으로 등록합니다.

수집이 시작되면 목록의 상태 배지가 "대기", "수집 중"을 거쳐 "준비됨"으로 바뀝니다. "실패"로 표시되면 소스를 열어 원인을 확인하고 "수집 실행"으로 다시 시도합니다.

세팅 확인#

검색 결과가 비어 있으면 수집이 끝나지 않았거나 해당 내용이 사이트에 없는 경우입니다. 상태 배지가 "준비됨"인데도 비어 있으면 텍스트 직접 입력으로 그 내용을 추가합니다.

다음 단계#

• 위젯을 사이트에 붙이는 절차는 위젯 설치를 참고하세요.
• 상품 인식과 지식 수집을 위해 사이트 쪽에서 갖춰야 할 조건은 설치 전 사이트 준비를 참고하세요.