g GaonTalk v1

스크립트 한 줄로 붙이는 AI 채팅 위젯

계열 서비스 어디에나 얹을 수 있는 플로팅 채팅 위젯입니다. 호스트 페이지는 스크립트를 넣고 로그인 상태만 알려주면 되고, 나머지는 위젯이 처리합니다.

설치

1단계

스니펫 붙이기

</body> 앞에 넣습니다. 스텁이 먼저 정의되므로 로더 로드를 기다릴 필요가 없습니다.

<!-- 로더가 붙기 전 호출을 큐에 쌓아두는 스텁 -->
<script>
  window.GaonTalk = window.GaonTalk || function () {
    (window.GaonTalk.q = window.GaonTalk.q || []).push(arguments);
  };
</script>
<script async src="https://gaontalk.gaonprime.com/loader.js" data-app-id="내-app-id"></script>

2단계

로그인 상태 알려주기

위젯은 로그인 유저에게만 보입니다. identify 를 부르기 전에는 버튼조차 뜨지 않습니다.

// 로그인 직후
GaonTalk('identify', {
  getToken: () => fetch('/api/gaontalk-token', { credentials: 'same-origin' })
    .then(r => r.json()).then(d => d.token),
});

// 로그아웃 직후
GaonTalk('shutdown');

직접 눌러보기

이 페이지에 실제 위젯이 붙어 있습니다. 아래 버튼이 위 코드와 똑같은 호출을 합니다.

API

이벤트

토큰 발급

토큰은 호스트 백엔드가 만듭니다. app 별 secret 은 서버에만 두고 브라우저로 내려보내지 않습니다.

alg    HS256
secret app 별 secret (서버 보관)
exp    5분
claims { sub: 유저ID, app_id: 내-app-id, jti: 매번 새 값 }