폼과 사용자 필드 레퍼런스
폼 모드, 기본 필드, 사용자 필드 종류와 범위, 조회 통합 및 제출 동작을 확인하세요.
이 레퍼런스는 폼과 사용자 필드 설정이 고객, 예약과 운영 기능에 미치는 영향을 설명합니다.
폼 설정은 폼에서, 필드 설정은 사용자 필드에서 찾을 수 있습니다. 저장 결과는 고객, 예약, 응답에서 확인합니다. 조회를 자동화하려면 워크플로우를 여세요. 다음 표에서 결정할 항목을 고른 뒤 해당 절을 확인하세요.
| 결정할 항목 | 확인할 절 |
|---|---|
| 제출이 고객과 예약 중 무엇을 바꾸는지 | 모드 |
| 기본 이름, 연락처, 예약 시각을 포함할지 | 기본 필드 |
| 사용자 필드가 저장하는 값과 필터 방식 | 사용자 필드 종류 |
| 필드를 모든 폼 또는 특정 폼에서 사용할지 | 폼 범위 |
| 표 필터와 자동화에서 같은 값을 찾는 방법 | 표, 조회와 자동화 |
| 초안, 재개 링크와 최종 제출이 값을 다루는 법 | 초안과 최종 제출 |
폼 설정
| 화면 항목 | 역할 | 제약 또는 기본값 |
|---|---|---|
Slug | /f/<slug> 주소에서 폼을 구분합니다. | 영문 소문자, 숫자와 하이픈을 사용합니다. 같은 조직 안에서 고유해야 합니다. |
Label | 고객에게 보이는 폼 제목입니다. | 운영 언어별로 입력합니다. |
Description | 폼의 목적과 입력 안내를 표시합니다. | 받을 정보와 사용 목적을 설명합니다. |
Success Message | 서버 저장이 끝난 뒤 표시합니다. | 접수 결과와 다음 행동을 씁니다. |
Prompt | 이 폼을 목표로 하는 AI 대화에 추가 맥락을 줍니다. | 필드 규칙을 복사하거나 비밀과 개인 정보를 넣지 않습니다. |
Static Fields | 대상이 공개하도록 허용한 기본 필드 중 표시할 항목입니다. | 비워 두면 대상의 공개 기본 필드를 모두 사용합니다. |
Active | 새 링크에서 폼을 사용할 수 있게 합니다. | 끄더라도 기존 제출 기록은 유지됩니다. |
Mode | 대상과 쓰기 동작을 함께 결정합니다. | 선택한 모드와 맞지 않는 대상이나 접근은 저장되지 않습니다. |
Access | 공개 링크 또는 고객에게 연결한 보안 링크를 사용합니다. | Update Target은 항상 Token입니다. |
모드
Mode | 대상 | 제출 동작 | 허용 접근 | 대표 용도 |
|---|---|---|---|---|
Update Self | 고객 | 현재 방문자 또는 링크에 연결된 고객을 갱신합니다. | Public, Token | 고객 정보 수집과 갱신 |
Insert | 예약 | 링크의 고객에게 새 예약을 만듭니다. | Public, Token | 고객 정보를 따로 받지 않는 예약 생성 |
Profile Then Insert | 예약 | 예약자 정보를 고객에 저장한 뒤 새 예약을 만듭니다. | Public, Token | 공개 상담과 예약 접수 |
Update Target | 예약 | 보안 링크에 고정된 기존 예약을 갱신합니다. | Token | 예약 변경과 사전 정보 보완 |
Profile Then Insert의 예약자 정보에는 고객 기본 필드인 이름, 이메일과 전화번호가 포함됩니다.
폼에 속한 공개 고객 사용자 필드도 같은 영역에 표시됩니다. 예약을 확정할 연락처가 필요하므로
새로 입력한 전화번호나 기존 고객의 전화번호가 있어야 제출할 수 있습니다.
기본 필드
| 대상 | 공개 기본 필드 | 참고 |
|---|---|---|
| 고객 | name, email, phone | 같은 키의 고객 사용자 필드를 만들지 않습니다. |
| 예약 | starts_at, notes | starts_at은 예약 가능 시간 규칙을 따릅니다. |
Static Fields에 하나 이상의 키를 입력하면 그 항목만 표시합니다. 대상의 공개 기본 필드가 아닌
키를 넣으면 폼 구성이 거부됩니다.
사용자 필드 설정
| 화면 항목 | 역할 | 제약 또는 기본값 |
|---|---|---|
Target | 값을 소유할 고객, 예약 또는 대화를 정합니다. | 폼 모드의 대상과 맞는 필드만 대상 영역에 표시됩니다. |
Key | 저장, 표와 자동화에서 계속 사용할 식별자입니다. | 영문자 또는 숫자로 시작하고 영문자, 숫자, _, -를 사용합니다. 최대 63자입니다. |
Label | 사람에게 보이는 열과 입력 필드 이름입니다. | 키를 바꾸지 않고 레이블만 바꿀 수 있습니다. |
Description | 고객에게 답의 범위와 사용 이유를 설명합니다. | 레이블을 반복하지 않고 짧게 작성합니다. |
Kind | 값의 형식과 렌더링 방식을 정합니다. | 아래 종류 표를 확인하세요. |
Field Group | 관련 질문을 하나의 폼 영역으로 묶습니다. | 같은 영역에는 정확히 같은 그룹 이름을 사용합니다. |
Visibility | 고객용 폼과 공개 AI 입력에 내보낼지 정합니다. | Private은 내부 관리자 기능에서만 사용합니다. |
Required | 활성 상태의 값이 비어 있을 때 쓰기를 막습니다. | 숨겨진 조건부 필드에는 적용하지 않습니다. |
Position | 같은 영역의 표시 순서를 정합니다. | 작은 값이 먼저 표시됩니다. |
Forms | 특정 이름의 폼에만 필드를 포함합니다. | 실제 폼을 검색해 하나 이상 선택합니다. 비우면 모든 이름 있는 폼, 기본 랜딩 입력과 AI가 공유합니다. |
Show When | 기준값이 맞을 때만 필드를 표시합니다. | 기준키=값을 사용합니다. 중첩 조건은 지원하지 않습니다. |
같은 조직과 대상 안에서 키를 중복하지 마세요. Profile Then Insert의 고객 사용자 필드에는
name, email, phone 키를 사용하지 마세요.
사용자 필드 종류
Kind | 저장하는 값 | 고객용 폼 | 표 필터 | 추가 설정 |
|---|---|---|---|---|
Text | 문자열 | 예 | 텍스트 검색 | 없음 |
Text Area | 긴 문자열 | 예 | 텍스트 검색 | 없음 |
Markdown | 마크다운 문자열 | 예 | 텍스트 검색 | 없음 |
Date | 날짜 문자열 | 예 | 정확한 값 | 없음 |
Switch | true 또는 false | 예 | 켜짐 또는 꺼짐 | 조건 기준으로 사용 가능 |
Number | 숫자 | 예 | 정확한 값 | 없음 |
Select | 선택값 한 개 | 예 | 선택값 | 쉼표로 구분한 Options |
Multi Select | 선택값 배열 | 예 | 선택값 포함 | 쉼표로 구분한 Options |
File | 업로드한 파일 주소 | 예 | 없음 | 파일 업로드 또는 공개 URL |
Member | 멤버 참조 | 아니요 | 내부 선택 | 내부 식별자를 고객에게 노출하지 않습니다. |
Entity | 콘텐츠 참조 | 아니요 | 내부 선택 | 선택 범위를 정하는 상위 노드가 필요할 수 있습니다. |
Organization | 조직 참조 | 아니요 | 내부 선택 | 조직 범위와 권한을 따릅니다. |
Visibility를 Public으로 설정해도 고객용 입력에 안전하지 않은 Member, Entity,
Organization 종류는 공개 폼에 나타나지 않습니다. File은 공개 HTTP URL을 저장하며,
업로드 파일은 현재 방문자의 전용 Storage 경로에 생성됩니다.
폼 범위
다음 표는 공개 가능 종류이면서 Visibility가 Public인 필드를 기준으로 합니다.
Forms 값 | 이름 있는 고객 폼 | 기본 랜딩 입력 | 고객 대화 AI | 관리자 표와 자동화 |
|---|---|---|---|---|
| 비어 있음 | 모든 폼에 표시 | 포함 | 포함 | 포함 |
| 하나 이상의 슬러그 | 지정한 폼에만 표시 | 제외 | 일반 AI 입력에서 제외 | 포함 |
모든 열에서 같은 뜻으로 사용할 필드는 폼 범위를 비워 두세요. 특정 이벤트나 캠페인에서만 받을 필드는 Forms에서 실제 폼을 검색해 선택하세요. 자유 텍스트나 Enter로 없는 슬러그를 만들 수 없습니다. 여러 폼을 선택하면 한 필드 정의와 저장 키를 그대로 재사용합니다. 폼 범위는 값의 소유 대상이나 내부 표 표시 여부를 바꾸지 않습니다.
표, 조회와 자동화
고객과 예약 표는 사용자 필드를 Label 이름의 열로 표시합니다. 표 머리글에서 종류에 맞는
검색 또는 필터를 사용할 수 있습니다. 필터 상태는 다른 표 조건과 함께 하나의 저장되는 조회에
포함됩니다.
자동화와 기술 레퍼런스에서는 custom.<key> 경로를 사용합니다.
query:
where:
"custom.consultation_type": { eq: "기타" }
"custom.preferred_channel": { contains: ["이메일"] }이 조회는 상담 유형이 기타이고 선호 연락 방법에 이메일이 포함된 예약을 선택합니다. 전체
조회 문법은 자동화 조회 문법 레퍼런스를 확인하세요.
AI 폼 목표
랜딩 섹션의 AI CTA에서 공개 폼을 선택하면 그 폼의 최종 제출이 대화 목표가 됩니다. 사용자 필드의 종류, 선택지, 필수와 조건이 AI 제출에도 그대로 적용됩니다. 폼 범위가 있는 필드도 해당 이름의 폼을 목표로 할 때는 포함됩니다.
AI 폼 목표는 Public 폼만 사용합니다. Token 폼과 특정 고객 또는 예약을 가진 보안 링크를
대화에 전달하지 않습니다. 같은 대화의 재시도는 응답과 고객 및 예약 작업을 중복하지 않습니다.
설정 절차는 AI 대화를 폼 목표에 연결하기를 확인하세요.
고객 계정
조직에 연결된 Kakao, LINE 또는 Meta 로그인 제공자는 랜딩의 /login에 나타납니다. 로그인한
고객은 /account에서 본인의 예약, 폼 초안과 제출 결과를 확인합니다. 대기 또는 확정 예약은
취소할 수 있습니다. 활성 Update Target Token 폼이 있으면 같은 화면에서 예약 변경을
시작할 수 있습니다. 자세한 경계는 고객 계정과 예약 관리를 확인하세요.
대표 구성 비교
| 운영 목적 | Mode | Access | 기본 필드 예시 | 사용자 필드 예시 |
|---|---|---|---|---|
| 신규 고객 정보 받기 | Update Self | Public | name, email, phone | 고객의 학년, 선호 언어 |
| 공개 상담 예약 받기 | Profile Then Insert | Public | starts_at, notes | 고객의 상담 목표, 예약의 상담 유형 |
| 확인된 고객 정보 갱신 | Update Self | Token | 바꿀 연락처만 선택 | 고객의 동의 상태 |
| 기존 예약 정보 보완 | Update Target | Token | notes | 예약의 방문 목적이나 사전 답변 |
이 표는 합성한 구성 예시입니다. 실제 폼에는 업무에 필요한 최소 필드만 포함하세요. 링크를 공유하기 전에는 공개 링크와 보안 링크 선택하기에서 정보 민감도와 대상 연결을 확인하세요.
초안과 최종 제출
- 이름 있는 폼은 값이 바뀐 뒤 초안을 저장합니다.
- 재개 정보가 있는 주소는 제출 전 초안을 복원합니다.
- 초안은 일부 필수값이 비어 있어도 저장할 수 있습니다.
- 최종 제출은 표시 중인 필수값과 값 형식을 다시 검사합니다.
- 허용하지 않은 필드와 숨겨진 조건부 값은 저장 대상에서 제외합니다.
- 한 제출 키는 고객이나 예약을 한 번만 변경합니다.
- 최종 제출은 당시 폼 버전, 사용자 필드 정의와 답변을 보존합니다.
- 제출 완료 뒤에
Success Message를 표시합니다.
설정 절차는 예약 접수 폼 만들고 게시하기를, 실패 증상은 폼 문제 해결과 게시 전 시험을 확인하세요.