웹 위젯

웹 위젯은 작은 JS 번들(gzip 후 약 30 kB)로, 모든 페이지의 오른쪽 아래 모서리에 채팅 버블을 마운트합니다.

로딩

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"></script>

로그인한 사용자 식별

익명 방문자의 경우 위젯이 자동으로 연락처를 생성합니다. 로그인한 사용자의 경우SingChat.identify() 를 사용자 정보와 함께 호출하세요:

window.SingChat.identify({
  externalId: "user_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
  customAttributes: { plan: "pro", signupAt: "2025-01-12" },
});

프로그래밍 방식의 열기 / 닫기

SingChat.open();
SingChat.close();
SingChat.toggle();

이벤트 수신

SingChat.on("message:new", (msg) => {
  console.log("new message", msg);
});

SingChat.on("ai:stream:end", ({ messageId }) => {
  // AI finished streaming
});

테마 설정

Settings → Inboxes에서 위젯의 기본 색상, 위치, 인사말 텍스트를 구성할 수 있습니다. 화이트 라벨("Powered by AskAIs Customer Service" 숨기기) 은 Pro 이상에서 제공됩니다.

보안

• app-id 는 공개되어 있습니다 —— HTML 에 포함해도 괜찮습니다
• 비밀 키는 서버 측 전용입니다 —— 브라우저 코드에 절대 노출하지 마세요
• 높은 신뢰가 필요한 사용 사례의 경우, 서버 측에서 비밀 키로 사용자 페이로드에 서명하세요 (HMAC-SHA256) —— API 인증 을 참조하세요