voidX AI 서비스 도입 가이드

📗voidX AI 서비스 도입 가이드

자, 이제 우리가 만든 멋진 AI 에이전트를 웹사이트에 설치해볼까요? 정말 간단해요!

AI Agent 적용 안내 (3-Step)

고객님의 웹사이트에 AI Agent를 활성화하는 방법은 매우 간단합니다. 아래 3가지 필수 단계를 따라 진행해주세요.

Step 1: 연동 정보 확인하기

AI Agent를 웹사이트와 연동하기 위해서는 API Key와 JS SDK URL이 필요합니다. 이 정보는 Admin 페이지에서 확인할 수 있어.

voidX.ai 홈페이지에서 가입 후, Admin 페이지로 이동하여 로그인합니다.
'개발자 설정' 또는 'API 연동 정보' 메뉴로 이동합니다.
아래 세 가지 핵심 정보를 확인합니다.
- voidX AI API Key: 고객님 계정의 고유 식별 키입니다. 외부 유출에 주의해주세요!
- JS SDK URL: 웹사이트에 설치할 Javascript 파일의 경로입니다.
- 허용 도메인 (Allowed Domains): AI Agent가 작동할 웹사이트의 주소를 등록하는 곳입니다. www.example.com과 같이 정확한 도메인을 입력해야 합니다.

Step 2: 웹사이트 코드에 스크립트 삽입하기

위에서 확인한 JS SDK URL과 API Key를 사용하여 아래와 같은 스크립트 코드를 만듭니다.

<!-- voidX.ai AI Agent Script Start -->
<script src="[여기에 JS SDK URL을 붙여넣으세요]"></script>
<script>
  voidx.init({
    apiKey: "[여기에 voidX AI API Key를 붙여넣으세요]"
  });
</script>
<!-- voidX.ai AI Agent Script End -->

완성된 스크립트 코드를 복사하여, AI Agent를 설치할 웹사이트 HTML의 </body> 태그 바로 위에 삽입합니다.
수정한 파일을 웹 서버에 업로드합니다. 이제 기술적인 적용은 완료되었습니다.

Step 3: 최종 사용자에 대한 고지 의무 이행하기 (필수)

고객과의 신뢰는 무엇보다 중요해요. 서비스 이용약관에 따라, 웹사이트 방문자에게 voidX AI 서비스 사용 사실과 데이터 수집에 대해 명확하게 알려주셔야 합니다.

개인정보 처리방침 업데이트: 웹사이트의 '개인정보 처리방침'에 데이터 수집 항목(비식별 상호작용 데이터)과 이용 목적(AI 기반 경험 최적화)을 명시하세요.
고지 배너 사용: 웹사이트 방문 시 "더 나은 사용자 경험을 위해 행동 데이터를 분석하는 AI 서비스를 사용합니다."와 같은 문구로 고지하고 필요한 경우 동의를 받으세요.

⚙️ Admin 페이지 이용 안내

Admin 페이지는 AI 에이전트의 성과를 확인하고 팀원과 협업하며 설정을 관리하는 똑똑한 통합 관리 도구예요. (https://admin.voidx.ai/로 바로 접속할 수 있어요)

대시보드

AI 에이전트가 얼마나 많은 고객과 대화했는지(MAU), 총 상호작용 수, 예상 비용 절감액 등 핵심 성과를 한눈에 볼 수 있어요. Professional 플랜 이상에서는 일별 사용량 추이, AI 해결 문의 비율 등 더 상세한 데이터 분석과 csv 다운로드 기능도 제공된답니다.

AI Agent 커스터마이징

웹사이트의 브랜드 아이덴티티와 톤앤매너에 맞게 AI Agent의 디자인과 작동 방식을 자유롭게 변경할 수 있어요.

디자인 설정: AI Agent 아이콘, 채팅창 색상, 로고 등을 직접 업로드하고 웹사이트 내 노출 위치(예: 우측 하단)도 변경할 수 있어요.
메시지 및 행동 설정: 첫 환영 메시지를 수정하고, 특정 조건(예: 특정 페이지에 3초 이상 머무는 경우)에서 먼저 말을 거는 '선제적 가이드'의 발동 조건을 세밀하게 조정할 수 있습니다.

지식 베이스 관리

AI가 방문자의 질문에 답변하는 데 사용하는 정보의 원천을 관리하는 곳이에요.

콘텐츠 등록: 자주 묻는 질문(FAQ)을 직접 입력하거나, 제품/서비스 소개 문서(PDF)를 업로드하여 AI가 학습하도록 할 수 있어요.
정확도 관리: AI의 답변이 부정확했다면, 올바른 답변을 추가하여 AI의 학습을 유도하고 답변 정확도를 지속적으로 향상시킬 수 있습니다.

결제 및 플랜 관리

현재 이용 중인 서비스 플랜을 확인하고 결제 정보를 관리합니다. 실시간 사용량, 다음 결제일, 결제 수단 변경, 인보이스(세금계산서) 발행 등 모든 업무를 처리할 수 있어요.

주요 기능 상세 안내

역할 (Role)	주요 권한	설명
Admin	모든 설정 변경, 멤버 초대 및 관리, 결제 정보, API Key 접근 등	서비스 소유자 또는 총괄 책임자에게 적합한 역할입니다.
Editor	AI Agent 커스터마이징, 지식 베이스 편집 등 운영 관련 설정 변경	개발자 설정(API 키)이나 멤버 관리, 결제 정보에는 접근할 수 없습니다. 마케터나 운영자에게 적합합니다.
Viewer	대시보드, 통계 등 모든 정보 조회 (설정 변경 불가)	데이터 분석이나 성과 보고가 필요한 팀원에게 부여할 수 있는 읽기 전용 역할입니다.