Quick StartIntegrationAPI ReferenceCustomizationArchitecture

연동 가이드

원하는 프레임워크로 웹사이트에 LaunchChat 위젯을 추가하세요.

설치

닫는 </body> 태그 앞에 이 코드를 추가하세요:

<!-- LaunchChat Widget -->
<script>
  window.LaunchChatConfig = {
    widgetId: "YOUR_WIDGET_ID"
  };
</script>
<script src="https://your-domain.com/widget.js" async></script>

콘텐츠 보안 정책 (CSP)

사이트에서 CSP 헤더를 사용하는 경우, 다음 도메인을 추가하세요:

Content-Security-Policy:
  script-src 'self' https://your-launchchat-domain.com;
  connect-src 'self' https://your-launchchat-domain.com;
  frame-src 'self' https://your-launchchat-domain.com;

보안 고려사항

Widget ID는 공개 정보입니다

Widget ID는 공개되어 클라이언트 측 코드에 삽입되도록 설계되었습니다. 지식베이스와 채팅 기능에 대한 읽기 접근만 허용합니다. Widget ID만으로는 민감한 작업을 수행할 수 없습니다.

도메인 제한

대시보드의 위젯 → 동작 → 허용 도메인에서 위젯을 삽입할 수 있는 도메인을 제한할 수 있습니다. 설정하면 해당 도메인에서만 위젯이 작동합니다.

설치 확인

코드를 추가한 후, 위젯이 올바르게 로드되는지 확인하세요:

  1. 브라우저에서 웹사이트를 엽니다
  2. 오른쪽 하단에 채팅 버튼이 있는지 확인합니다
  3. 클릭하여 채팅 창을 엽니다
  4. 테스트 메시지를 보내 작동을 확인합니다

위젯이 나타나지 않으면 브라우저 콘솔에서 오류를 확인하고 Widget ID가 올바른지 확인하세요.