Prosody
Web Widget

웹 위젯 설치

콘솔에서 만든 에이전트를 사이트 우하단 위젯으로 붙이는 방식입니다. 브라우저에는 공개 식별자만 두고, 민감한 API Key는 서버에서만 사용합니다.

위젯 설정 열기

허용 도메인

위젯을 띄울 도메인을 콘솔에서 제한합니다.

서버 프록시

공개 위젯 키로 위젯 전용 API를 호출하며 비공개 API Key는 브라우저에 두지 않습니다.

이벤트

열림, 닫힘, 에이전트 메시지, 상담원 연결 이벤트를 구독합니다.

설치 코드

콘솔의 웹 위젯 화면에서 발급된 pk_widget_... 공개 키만 사용합니다. 에이전트, 테마, 문구, 허용 도메인은 해당 키의 서버 설정에서 불러옵니다.

<script
  src="https://console.humelo.com/agent-widget.js"
  data-public-key="pk_widget_xxxxxxxxxxxxxxxx"
  async
></script>

클라이언트 이벤트

window.ProsodyAgent?.open?.();

window.ProsodyAgent?.on?.("conversation.opened", (event) => {
  console.log(event.sessionId);
});

window.ProsodyAgent?.on?.("agent.message", (event) => {
  console.log(event.content);
});

window.ProsodyAgent?.on?.("handoff.created", (event) => {
  console.log(event.conversationId);
});

window.ProsodyAgent?.on?.("conversation.closed", (event) => {
  console.log(event.reason);
});

현재 공개 위젯은 tool.called 같은 도구 호출 이벤트를 내보내지 않습니다. 도구 실행 내역이 필요한 기업 연동은 별도 도입 범위를 협의해야 합니다.