위젯 연동

빠른 시작

<script
  src="https://widget.guidme.ai/v1/loader.js"
  data-key="gm_live_xxxxxxxxxxxx"
  data-app-id="11111111-1111-4111-8111-111111111111"
  data-locale="auto"
></script>

위젯은 오른쪽 아래에 플로팅 버튼으로 표시됩니다. data-locale="auto"는 페이지에 선언된 언어를 사용하며 지원하지 않는 언어이면 영어로 전환합니다.

개인정보 보호 경계는 이 단일 script 태그만 사용하며 앱별 마스킹 코드는 필요하지 않습니다. 애플리케이션이 표준 HTML 요소에 닫힌 shadow root를 만드는 경우 로더가 로컬 참조를 유지할 수 있도록 애플리케이션의 메인 번들보다 먼저 태그를 배치하세요.

런처 이미지

Pro 및 Enterprise 고객은 대시보드 > 위젯에서 선택 사항인 런처 이미지를 업로드할 수 있습니다. 이 이미지는 런처 아이콘을 대체합니다. 5MB 이하의 JPEG, PNG, WebP 또는 AVIF 파일을 사용하세요. GuidMe가 이미지를 검증하고 정사각형으로 자른 뒤 관리형 WebP로 게시합니다. 같은 편집기에서 이미지를 제거하면 선택한 아이콘이 다시 표시됩니다.

프로덕션 위젯은 GuidMe 브랜드마크를 사용합니다. 서버에서 제공하는 요금제 설정이 브랜딩을 비활성화하지 않는 한 Powered by GuidMe는 https://www.guidme.ai/를 새 탭에서 엽니다.

권한

음성 입력에는 마이크 권한이 필요하며 패널을 닫으면 마이크가 중지됩니다. 사용자가 보호된 화면 공유를 선택하고 이 애플리케이션의 브라우저 탭을 공유하기 전에는 보호된 화면 공유가 시작되지 않습니다. GuidMe는 감지된 민감한 영역을 기기에서 마스킹하고 유용한 맥락을 위해 민감하지 않은 텍스트와 요소를 계속 표시하며, 보호된 첫 번째 정확한 이미지를 확인용으로 보류합니다. 확인 전에는 아무것도 전송되지 않습니다. 확인 후에도 각 이미지를 다시 정제하며 보호된 JPEG만 Google Gemini로 전송됩니다. 로더는 iframe에 microphone을 위임하고 화면 공유가 활성화된 경우에만 display-capture를 위임합니다. 브라우저는 항상 사용자에게 허용 여부를 묻습니다.

화면 공유를 거부하거나 취소하거나 중지해도 음성 및 텍스트 지원은 계속 사용할 수 있습니다. 사용자가 나중에 다시 시도할 수 있도록 보호된 화면 공유는 계속 표시됩니다. 권한을 자동으로 다시 요청하지 않습니다.

앱 관리자는 프로젝트별 프로필을 위젯 > 규칙 > 화면 개인정보 보호에서 제어합니다. 균형 조정(권장) 은 감지된 민감한 콘텐츠를 선택적으로 마스킹하고 일반 맥락을 유지합니다. 엄격 은 표시되는 모든 폼 컨트롤과 편집 가능한 필드도 마스킹합니다. 포털에는 컨트롤, 텍스트 또는 더 넓은 페이지 영역이 숨겨져 안내가 덜 구체적이거나 추가 확인이 필요할 수 있다는 경고가 표시됩니다. 임베드 태그로 서버에서 발급한 이 프로필을 선택하거나 약화할 수 없습니다.

보안 및 무결성

gm_live_로 시작하는 위젯 키만 사용하고 관리자 키를 클라이언트에 노출하지 마세요.
호스트 도메인을 앱의 허용된 오리진에 추가하세요.
호스트 페이지 CSP에서 script-src https://widget.guidme.ai, frame-src https://widget.guidme.ai, connect-src https://api.guidme.ai를 허용하세요. iframe에는 별도의 제한된 CSP가 적용됩니다.
Sentry/OpenTelemetry 운영 텔레메트리는 기본적으로 꺼져 있습니다. 조직에서 해당 처리를 승인한 경우에만 data-operational-telemetry="true"를 설정하세요.
/v1/loader.js는 사용할 때마다 재검증되는 채널 별칭입니다. iframe 별칭은 브라우저나 CDN 캐시에 저장되지 않으며 로더의 정확한 개인정보 보호 빌드에 연결됩니다. /v1/integrity.json에서 SHA-384 값과 콘텐츠 해시가 포함된 변경 불가 경로를 확인해 배포 시 고정할 수 있습니다.

공개 위젯 아티팩트에는 소스 맵이 포함되지 않습니다.