본문으로 건너뛰기

폼 ​

대시보드에서 폼을 만들고, 고유 링크로 게시하고, 원하는 어디에나 삽입하세요. 모든 제출 내용은 휴대폰으로 푸시 알림이 도착합니다. 웹훅과 같은 전달 경로를 사용하므로 라우팅, 우선순위 수준, 메시지 기록이 이미 익숙한 방식 그대로 동작합니다.

중간에 이메일 받은편지함도, 스프레드시트를 계속 확인할 필요도 없어요.

폼 만들기 ​

Forms → Create로 이동하세요. 폼 빌더에는 탭 5개와 옆에 실시간 미리보기가 있어요:

탭포함 내용
Fields제목, 소개 텍스트, 필드 자체, 바닥글 텍스트
Design테마, 색상, 글꼴, 크기, 모서리 둥글기, 제출 버튼
Settings푸시 제목, 라우팅, 우선순위, 응답 제한, 메시지
Share공개 링크, QR 코드, 임베드 코드
Preview좁은 화면에서 보는 동일한 실시간 미리보기

저장하면 Share 탭에서 링크를 확인할 수 있어요: https://frms.click/<id>.

필드 유형 ​

그룹유형
텍스트짧은 텍스트, 긴 텍스트, 이메일, 휴대폰, 숫자, URL, 날짜
선택드롭다운, 라디오 버튼, 체크박스, 단일 체크박스(동의)
평점별점(1–5), NPS(0–10)
레이아웃제목, 단락, 구분선
추적숨김 필드

폼 하나에 최대 30개 필드를 넣을 수 있고, 선택 필드에는 옵션을 최대 50개까지 넣을 수 있어요. 이메일, 휴대폰, 숫자, URL 필드는 브라우저와 서버에서 모두 검증합니다. 클라이언트 검사는 편의 기능일 뿐, 실제 보호 장치는 서버 검사예요.

레이아웃 필드는 장식용이라 메시지에 나타나지 않습니다. 파일 업로드와 결제는 지원하지 않아요.

숨김 필드 ​

숨김 필드는 링크에 담긴 값을 메시지로 전달합니다. 매개변수 이름을 지정하면 URL의 ?utm_source=newsletter가 알림으로 도착해요. 버튼 한 번으로 UTM 매개변수 5개를 한꺼번에 추가할 수 있습니다.

폼을 삽입하면 호스트 페이지의 매개변수가 함께 전달됩니다. 따라서 캠페인 랜딩 페이지는 별도 작업 없이도 자체 제출 건에 태그를 붙일 수 있어요.

메시지 모습 ​

답변이 먼저 나오며, 필드가 표시되는 순서를 따릅니다:

Name: Jane Doe
Email: [email protected]
Rating: ★★★★☆ 4/5
Message: Do you ship to Canada?

utm_source: newsletter
Form: Contact
IP: 203.0.113.10
Submitted: 2026-09-23 14:05

숨김 필드, 방문자 IP, 타임스탬프는 답변 아래쪽에 놓입니다. 타임스탬프는 계정의 시간대를 사용해요. 모든 내용은 다른 메시지와 마찬가지로 개인 키로 저장 시 암호화됩니다.

푸시 제목 ​

기본적으로 알림 제목은 Form: <form name>입니다. 템플릿을 쓰면 한눈에 파악하기 쉬워져요:

New lead: {Name} ({Email})

토큰은 필드 라벨을 기준으로 참조하며 대소문자를 구분하지 않아요. 폼 이름은 {form}으로 참조합니다. 답변이 비어 있는 항목은 제목에서 빠지고, 남은 내용이 없으면 기본 제목을 사용합니다. 템플릿은 공개 페이지에 절대 노출되지 않아요.

Pocket Alert 배지 ​

게시된 폼 아래에는 "Powered by Pocket Alert" 링크가 작게 표시됩니다. 유료 플랜에서는 Design → Branding에서 끌 수 있어요.

배지 표시 여부는 브라우저가 아니라 API가 결정합니다. 무료 플랜에서 이 설정을 저장하면 기본값으로 되돌아가고, 유료 플랜이 만료되면 폼을 건드리지 않아도 공개 페이지에 배지가 다시 표시돼요.

라우팅과 우선순위 ​

폼은 애플리케이션과 특정 기기를 지정할 수 있고, 무음부터 긴급까지의 우선순위 수준을 설정할 수 있습니다. API와 같은 수준이에요. 우선순위를 Default로 두면 폼은 평소의 전달 규칙을 따릅니다.

제출 건마다 일일 할당량에서 메시지 1개가 차감돼요. 할당량을 모두 쓰면 방문자에게는 플랜 언급 없이 "나중에 다시 시도해 주세요"라는 중립적인 메시지가 표시되고, 평소와 같은 한도 초과 이메일이 발송됩니다.

폼 마감하기 ​

서로 독립적인 스위치 3개가 있으며, 그중 하나라도 켜지면 폼이 마감돼요:

  • Accepting responses: 끄면 즉시 마감됩니다
  • Response limit: 제출이 N건에 도달하면 마감됩니다. 메시지를 만들기 전에 자리를 먼저 확보하므로 트래픽이 몰려도 한도를 넘지 않아요
  • Close on: 내 시간대 기준의 날짜와 시각

마감된 폼도 그대로 응답합니다. 방문자에게는 필드 대신 마감 안내 메시지가 보이고, 서버에서는 제출이 거부돼요.

삽입하기 ​

Share 탭에서 스크립트 임베드 코드를 받을 수 있어요:

html
<div data-pocketalert-form="<id>"></div>
<script src="https://frms.click/embed/form.js" async></script>

폼은 자신의 높이를 알려주는 iframe에 로드됩니다. 그래서 내부 스크롤바가 생기지 않고, 관리해야 할 고정 높이도 없어요. 페이지 배경이 그대로 비치므로, 폼 카드 색상을 투명한 배경과 어울리는 톤으로 설정하면 자연스럽게 녹아듭니다.

제출이 끝나면 컨테이너에서 pocketalert:submit 이벤트가 발생하며, 이 이벤트에 분석 도구를 연결할 수 있어요:

js
document.querySelector('[data-pocketalert-form]')
  .addEventListener('pocketalert:submit', () => gtag('event', 'generate_lead'));

스크립트가 허용되지 않는 환경을 위해 일반 <iframe> 코드도 제공합니다. 높이가 고정되고, URL 매개변수는 전달되지 않아요.

폼 사용 위치 제한하기 ​

폼 ID는 공개된 값입니다. 링크와 QR 코드에 그대로 담겨 다니기 때문에, 기본적으로는 ID를 가진 누구나 어느 페이지에나 폼을 삽입할 수 있어요. Settings → Where it can be used에서 도메인 목록을 입력하면 이를 막을 수 있습니다:

  • 목록에 있는 사이트만 폼을 삽입할 수 있습니다(페이지는 일치하는 frame-ancestors 정책과 함께 제공됩니다)
  • Origin(또는 Referer)이 목록에 없는 제출은 403으로 거부됩니다
  • 폼 자체 링크는 설정과 관계없이 계속 동작합니다

URL이 아니라 호스트를 입력하세요: example.com, app.example.com, 모든 하위 도메인을 포함하려면 *.example.com, 개발 중이라면 localhost:3000. 최대 10개까지 입력할 수 있어요. www.은 무시되므로 example.com이 www.example.com도 포함합니다.

목록이 비어 있으면 "어디서나 허용"이며, 프로필 바이오에 공유하는 링크나 포스터에 넣는 QR 코드라면 이 설정이 알맞아요.

이 기능이 막는 것과 막지 못하는 것

Origin은 브라우저가 설정하며 페이지에서 위조할 수 없습니다. 하지만 API에 직접 요청하는 스크립트는 원하는 헤더를 무엇이든 보낼 수 있어요. 따라서 허용 목록은 폼이 다른 사이트에 삽입되는 것을 막아 줄 뿐, 의도적인 대량 요청을 막지는 못합니다. 그런 경우에는 아래의 요청 한도가 대응해요.

제출이 들어온 출처 ​

임베드된 폼에서 제출이 들어오면 IP 옆 메시지에 호스트가 기록됩니다:

Form: Contact (abc123)
Source: shop.example.com
IP: 203.0.113.10

폼 자체 페이지에서 온 제출에는 Source 줄이 없어요.

스팸 방지 ​

  • 사람은 절대 보지 못하는 허니팟 필드가 있습니다. 이 필드를 채우는 봇에는 정상처럼 보이는 성공 화면이 표시되지만, 실제로는 아무것도 전달되지 않아요.
  • 요청 한도: IP 하나당 1분에 10건, 폼 하나당 1분에 60건과 1시간에 300건입니다. 시간당 상한은 대량 요청이 몇 분 만에 하루치 메시지를 모두 소진하지 못하도록 두었어요.
  • 공개 폼 페이지에는 noindex가 적용되어 있어, 폼이 그 자체로 검색 결과에 노출되지 않습니다.

CAPTCHA는 현재 필요하지 않으며 폼에서도 제공하지 않아요.

플랜별 한도 ​

플랜폼
무료 플랜1
Starter10
Medium30
Large무제한

제출 건수 자체는 일일 메시지 할당량으로만 제한됩니다.

API ​

빌더에서 할 수 있는 모든 작업은 REST API로도 가능해요:

엔드포인트기능
GET /v1/forms내 폼 목록 조회
POST /v1/forms폼 생성
PUT /v1/forms/:tid필드, 디자인, 설정 전체 교체
DELETE /v1/forms/:tid폼 삭제
GET /v1/forms/:tid공개: 게시된 폼의 필드와 디자인 조회
POST /v1/forms/:tid/submit공개: 제출 접수

앞의 네 개는 일반 토큰을 사용하고, 마지막 두 개는 폼 페이지 자체가 호출하는 엔드포인트입니다.

Pocket Alert 문서