웹사이트 챗봇

기능

• Studio에서 만드는 스크립트 플로우: 인사말, 버튼, 질문, 리드 수집.
• 사이트에 게시된 콘텐츠를 바탕으로 한 AI 답변. 요금제의 AI 크레딧으로 비용이 청구됩니다. 크레딧이 남아 있지 않으면 봇이 폴백 메시지를 보냅니다.
• 외관과 트리거: 색상, 런처 이미지, 열리는 시점을 Studio에서 사이트별로 설정합니다.
• 대화가 자동화된 것으로 보일 때 Turnstile 보호.
• 리드: 방문자가 리드 단계에서 공유한 정보는 폼 문의처럼 Forms & leads → Leads에 도착합니다.

사람 상담원에게 실시간으로 넘기는 기능은 아직 없습니다.

라이브 웹사이트에서

챗봇은 릴리스에 담겨 프로덕션으로 전달됩니다. 프로덕션이 켜져 있고 서명된 릴리스가 라이브이면, 릴리스된 챗봇이 해당 릴리스에 포함된 페이지의 지식(최대 5,000개 구절)을 사용해 실제 방문자에게 응답합니다. 개발 환경의 변경 사항은 다음에 승인된 릴리스와 함께 방문자에게 도달합니다.

프로덕션이 꺼져 있는 동안 챗봇 주소는 404 CP_NOT_FOUND로 응답하고, 프로덕션은 켜져 있지만 라이브 릴리스가 없으면 403 CP_PRODUCTION_LOCKED로 응답합니다.

Next.js 사이트에 추가

1. 루트 레이아웃에서 위젯을 한 번 렌더링합니다. 토큰은 필요 없습니다. 브라우저가 Atlas와 직접 통신하며, Atlas는 등록된 웹사이트 출처만 받습니다.

   app/atlas-chat.tsx

   'use client';
   import { AtlasChat } from '@atlas/chat-widget';
   import '@atlas/chat-widget/styles.css';
   import { usePathname } from 'next/navigation';
   
   export function SiteChat() {
     const path = usePathname();
     return (
       <AtlasChat
         apiOrigin="https://delivery.atlas.example"
         environmentId="env_XXXXXXXX"
         botKey="support"
         path={path}
       />
     );
   }

2. Content-Security-Policy에서 Atlas를 허용합니다. Atlas API 출처를 connect-src와 img-src에 추가합니다.

3. 라이브 배포에는 프로덕션 환경 ID를 사용하고, 그 외에는 모두 개발 환경 ID를 사용합니다.

위젯 패키지는 연결된 고객에게 직접 배포되며 아직 공개 npm 레지스트리에는 없습니다. React를 사용하지 않는 경우 bot(), start(path), send(…)를 제공하는 일반 클라이언트 createChatClient({ apiOrigin, environmentId, botKey })를 사용하세요.

개인정보

• 대화는 방문자의 세션 스토리지에 보관되는 임의의 비밀 값에 연결됩니다. 쿠키는 없습니다.
• 리드 정보는 방문자가 리드 단계에서 제출한 경우에만 저장됩니다.
• IP 주소별, 대화별로 속도 제한이 적용됩니다. 제한을 참고하세요.

다음에 읽을 내용

리드 다루기브라우저 엔드포인트