연동 개요

코드의 window.SingChat 등은 위젯과 API의 기술 이름입니다. 적힌 그대로 사용하세요.

AskAIs는 호스팅 서비스입니다. 워크스페이스, 받은 메시지함, AI 상담원, 지식 베이스가 모두 askais.com에 있습니다. 아래 방법으로 고객을 연결하면 모든 대화가 같은 공유 받은 메시지함으로 들어오고, 같은 지식과 설정을 가진 같은 AI 상담원이 답합니다.

연결 방법

웹사이트

</body> 앞에 아래 코드를 추가하세요. App ID는 설정 → 받은 메시지함에서 복사하면 되며, 공개 정보이므로 그대로 배포해도 안전합니다.

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

⚠️ widget.js는 askais.com에서 불러오세요

widget.js를 내려받거나 자체 코드에 번들링하지 마세요. askais.com에서 불러오면 항상 최신 버전이 실행되지만, 복사본은 그 상태로 멈춰 이후의 수정 사항과 새 기능을 모두 놓치게 됩니다.

모바일 및 데스크톱 앱

설치할 SDK는 없습니다. WebView에서 https://askais.com/api/widget-embed?appId=YOUR_APP_ID를 열면 앱에 웹사이트와 같은 채팅이 전체 화면으로 표시됩니다. 로그인한 사용자의 ID, 이메일, 이름을 URL에 추가하면 팀이 누구와 대화하는지 알 수 있습니다. 앱 내 채팅 페이지에 Flutter, iOS, Android, JavaScript 코드가 포함된 전체 가이드가 있습니다.

로그인한 방문자와 신원 확인

로그인한 사용자라면 externalId, email, name을 전달하세요. 그러면 기기를 바꿔도 채팅이 이어집니다. 다른 사용자로 위장하지 못하게 하려면 hmac도 함께 전달하세요. 이 값은 받은 메시지함 시크릿 키를 키로 사용해 서버에서 계산한 externalId의 HMAC-SHA256입니다. 방법은 웹 위젯 페이지에서 설명합니다.

Telegram

@BotFather로 봇을 만들고, 설정 → Channels에 토큰을 붙여 넣은 뒤 연결하세요. 봇으로 온 메시지는 같은 받은 메시지함으로 들어오고, AI 상담원과 팀이 답합니다.

AI 클라이언트(MCP)

MCP 서버를 사용하면 Claude Code, Cursor 또는 Gemini CLI가 워크스페이스에서 작업할 수 있습니다. 대화 읽기와 답장, AI 학습, FAQ 편집, 분석 확인이 가능합니다. 고객용이 아니라 여러분과 팀을 위한 기능입니다. MCP 키는 워크스페이스 소유자나 관리자가 만듭니다.

현재 제공되지 않는 기능

• 설치형 SDK 패키지(npm, pub.dev, CocoaPods, Gradle). 웹에서는 스크립트 태그를, 앱에서는 WebView 페이지를 사용하세요.
• 자체 백엔드에서 쓰는 공개 REST API. API 키는 MCP 서버에서만 사용할 수 있습니다.
• 대화 또는 메시지 이벤트용 웹훅. 설정 → Webhooks에서 엔드포인트를 저장하고 서명된 테스트 핑을 보낼 수는 있지만, 아직 이벤트는 전달되지 않습니다.
• 위젯을 열거나 닫거나 이벤트를 수신하는 JavaScript 메서드. 스크립트가 제공하는 메서드는 window.SingChat.start() 하나뿐입니다.

더 알아보기

• 웹 위젯: 스크립트 옵션, 로그인한 방문자, 신원 확인
• 앱 내 채팅(WebView)
• MCP 서버
• 지식 베이스