본문으로 건너뛰기

요청 양식

요청 양식은 방문자가 Kaleidr 지도에서 Reserve, Schedule a Tour, Request Pickup 같은 요청 작업을 누르거나, Kaleidr AI가 준비한 요청에서 검토 후 보내기를 누를 때 열립니다. 요청은 조직의 받은편지함으로 전송됩니다. 요청 설정 방법은 예약 요청에서 다룹니다.

동작하는 위치​

양식은 Kaleidr 자체 사이트에서만 동작합니다. 페이지에 추가하는 스크립트가 아닙니다. 내 사이트에서는 <kaleidr-map product="viewer">로 임베드한 게시된 지도 안에서 열립니다. viewer는 iframe 안의 Kaleidr 페이지이며, 양식은 그 지도 위에 열립니다. Kaleidr Studio에서도 동작하며, Kaleidr Map에서는 Kaleidr 자체 베이스맵을 표시하는 동안에만 동작합니다.

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer" share-id="YOUR_MAP_ID" layout="guide"
             style="display:block; height:640px"></kaleidr-map>
  • Content Security Policy에 추가할 것이 없습니다. 양식과 사람 확인 절차는 viewer의 iframe 안에서 로드되므로, 페이지에는 viewer 자체의 script-src와 frame-src 항목만 있으면 됩니다.
  • 처음 누를 때 로드됩니다. 방문자가 양식을 열지 않는 지도에서는 양식이 로드되지 않습니다.
  • 요청을 받는 장소에만 버튼이 표시됩니다. 어떤 장소가 받는지는 Studio와 Kaleidr Booking에서 설정합니다. 요청 켜기를 참고하세요.

방문자에게 보이는 내용​

  1. 작업의 레이블을 제목으로 하는 양식: 조직이 설정한 키트의 필드, 이름, 이메일, 선택 입력 전화번호, 메시지, 그리고 업체 이름과 개인정보처리방침 링크가 들어간 동의 문구.
  2. 요청 보내기는 필수 필드를 채우고 동의 확인란을 선택하면 활성화됩니다. 확인란은 처음에 선택되어 있지 않습니다. Kaleidr에 로그인하지 않은 방문자는 짧은 사람 확인 절차를 거칩니다.
  3. 요청을 보냈습니다와 함께 K-7XQ2MD 같은 참조 번호가 표시되며, 조직이 접수 확인을 보내도록 설정한 경우 방문자의 이메일로 사본을 보냈다는 안내가 표시됩니다.

양식은 방문자에 대한 정보를 미리 채우지 않습니다. Kaleidr AI가 준비한 요청에는 날짜나 인원처럼 방문자가 말한 내용만 들어가며, 방문자가 보내기 전에 검토합니다.

방문자에게 보이는 내용조건
"이 장소는 온라인 요청을 받지 않습니다."해당 장소나 조직에서 요청이 꺼져 있습니다.
같은 문구와 장소의 전화번호 또는 링크조직이 월간 요청 한도에 도달했습니다.
필드 옆의 문장필수 필드가 비어 있거나 답변이 범위를 벗어났습니다.

양식의 레이블은 지도의 언어를 따르며 영어, 스페인어, 프랑스어, 독일어, 포르투갈어, 일본어, 한국어, 중국어 간체 및 번체, 아랍어를 지원합니다. 직접 만든 질문과 레이블은 작성한 그대로 표시됩니다.

이벤트​

양식은 자신을 담고 있는 Kaleidr 페이지에 알리며, 내 페이지에는 알리지 않습니다.

이벤트발생 시점
ready양식이 표시되었습니다.
resize높이가 바뀌었습니다.
submitted요청이 접수되었으며 참조 번호가 함께 전달됩니다.
error요청이 거부되었으며 오류 코드가 함께 전달됩니다.
close방문자가 양식을 닫았습니다.

내 페이지는 어떤 이벤트도 받지 않습니다. 요청이 전송되어도 viewer는 공개 메시지를 게시하지 않으며, ready와 error 외의 iframe 메시지는 공개 계약이 아닙니다. 요청에 대응하려면 받은편지함이나, 요청 전체를 내 시스템으로 전달하는 웹훅을 사용하세요.

게시된 지도에서 Kaleidr Analytics가 켜져 있으면, 전송된 요청은 그 지도의 전환으로 집계됩니다. 전환에는 요청 종류만 담기며 방문자의 정보는 담기지 않습니다.

스타일​

양식은 자체 섀도 루트에 그려지며, 열린 지도의 색상, 글꼴, 모서리 반경을 라이트와 다크 모두에서 따릅니다. 내 페이지의 CSS는 양식에 닿지 않습니다. 양식은 viewer의 iframe 안에 있기 때문입니다.

다음은 양식의 스타일에 쓰이는 CSS 사용자 지정 속성과 기본값입니다. Kaleidr 페이지가 지도의 테마에서 이 값을 설정합니다.

속성기본값대상
--kbw-fontinherit글꼴.
--kbw-fg#111텍스트.
--kbw-bg#fff배경.
--kbw-muted#6b7280힌트와 보조 텍스트.
--kbw-border#d1d5db필드 테두리.
--kbw-accent#2da84a보내기 버튼과 포커스 링.
--kbw-accent-fg#fff보내기 버튼의 텍스트.
--kbw-danger#b91c1c오류 문장.
--kbw-radius10px모서리 반경.
--kbw-space8px간격 단위.

관련 문서​