# フォーム

ダッシュボードで作成し、専用のリンクで公開して、どこにでも埋め込めるフォームです。送信された内容は、すべてスマホにプッシュ通知として届きます。配信経路は Webhook と同じなので、ルーティング、優先度、メッセージ履歴もこれまでどおり使えます。

メールボックスを経由する必要はありません。スプレッドシートを確認し続ける必要もありません。

## フォームを作成する

**フォーム → 作成** を開きます。ビルダーには 5 つのタブがあり、横にライブプレビューが表示されます:

| タブ | 内容 |
|-----|---------------|
| 項目 | タイトル、導入文、入力項目、フッターのテキスト |
| デザイン | テーマ、色、フォント、サイズ、角の丸み、送信ボタン |
| 設定 | プッシュ通知のタイトル、ルーティング、優先度、回答の上限、メッセージ |
| 共有 | 公開リンク、QR コード、埋め込みコード |
| プレビュー | 同じライブプレビュー（画面幅が狭い場合用） |

保存すると、共有タブにリンクが表示されます: `https://frms.click/<id>`。

## 項目の種類

| グループ | 種類 |
|-------|-------|
| テキスト | 短いテキスト、長いテキスト、メールアドレス、電話番号、数値、URL、日付 |
| 選択 | ドロップダウン、ラジオボタン、チェックボックス、単一のチェックボックス（同意） |
| 評価 | 星評価（1〜5）、NPS（0〜10） |
| レイアウト | 見出し、段落、区切り線 |
| トラッキング | 非表示項目 |

1 つのフォームには最大 **30 項目** まで設定でき、選択項目の選択肢は最大 50 個です。メールアドレス、電話番号、数値、URL の項目はブラウザーとサーバーの両方で検証されます。ブラウザー側のチェックは利便性のためのもので、防御にはなりません。

レイアウト項目は装飾用で、メッセージには表示されません。ファイルのアップロードと決済はサポートしていません。

### 非表示項目

非表示項目は、リンクから値をメッセージに渡します。パラメータ名を設定すると、URL の `?utm_source=newsletter` が通知に届きます。ワンクリックで UTM パラメータ 5 種類をまとめて追加できます。

フォームを埋め込んだ場合は、**ホストページ**のパラメータも引き継がれます。そのため、キャンペーンのランディングページは、お客様側で何もしなくても自身の送信内容にタグを付けられます。

## メッセージの表示例

回答が先に、項目の並び順どおりに表示されます:

```
Name: Jane Doe
Email: jane@example.com
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」という小さなリンクが表示されます。有料プランでは、**デザイン → ブランディング** でオフにできます。

表示の判断はブラウザーではなく API が行います。無料プランでこの設定を保存すると、設定はリセットされます。有料プランが失効した場合は、フォームを変更しなくても、公開ページにバッジが再び表示されます。

## ルーティングと優先度

フォームは、アプリケーションと特定のデバイスを指定できます。また、サイレントから重要までの優先度を設定できます。優先度は API と同じレベルです。レベルを *Default* のままにすると、通常の配信ルールに従います。

送信は 1 件ごとに、1 日の上限のメッセージ数を 1 つ消費します。上限に達すると、訪問者には「しばらくしてから再度お試しください」という中立的なメッセージが表示されます。プランには触れません。お客様には、通常の上限メールが届きます。

## フォームを締め切る

独立した 3 つのスイッチがあり、いずれかをオンにすると締め切られます:

- **回答を受け付ける** — オフにすると、すぐに締め切られます
- **回答の上限** — N 件の送信後に締め切られます。メッセージを作成する前に枠を確保するため、アクセスが急増しても上限を超えることはありません
- **締め切り日時** — お客様のタイムゾーンでの日時を指定します

締め切られたフォームも引き続き表示されます。訪問者には、項目の代わりに締め切りメッセージが表示されます。送信はサーバー側で拒否されます。

## 埋め込み

共有タブでは、スクリプトによる埋め込みを使えます:

```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 を知っている人なら誰でも、どのページにもフォームを埋め込めます。**設定 → 使用できる場所** でドメインのリストを指定すると、これを制限できます:

- 指定したサイトだけがフォームを埋め込めます（ページは対応する `frame-ancestors` ポリシーとともに配信されます）
- `Origin`（または `Referer`）がリストにない送信は、`403` で拒否されます
- フォームの公開リンクは、この設定に関係なく引き続き使えます

URL ではなくホストを入力します。例: `example.com`、`app.example.com`、すべてのサブドメインを対象にする `*.example.com`、開発中の `localhost:3000`。入力できるのは最大 10 件です。`www.` は無視されるため、`example.com` で `www.example.com` も対象になります。

リストが空の場合は「どこでも可」になります。プロフィールに載せるリンクや、ポスターに貼る QR コードには、この設定が適しています。

> **Warning: この設定でできること・できないこと**
>
> `Origin` はブラウザーが設定するもので、ページから偽装することはできません。ただし、API に直接リクエストを送るスクリプトは、任意のヘッダーを送信できます。そのため、許可リストで防げるのは、お客様のフォームが他のサイトに埋め込まれることだけです。悪意のある大量送信を防ぐ仕組みではありません。その対策には、後述のレート制限を使ってください。

## 送信元の記録

埋め込みフォームから送信があると、IP の横にホストが記録されます:

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

フォームの公開ページからの送信には、`Source` の行は表示されません。

## スパム対策

- 人間には見えないハニーポット項目を用意しています。これに入力するボットには、正常に見える完了画面が表示されますが、メッセージは配信されません。
- レート制限: 1 つの IP から 1 分あたり 10 件、フォームごとに 1 分あたり 60 件、1 時間あたり 300 件です。1 時間の上限は、大量送信によって数分のうちに 1 日分のメッセージを使い切られるのを防ぐためのものです。
- 公開フォームのページには `noindex` を設定しています。そのため、フォームが自動的に検索結果に表示されることはありません。

CAPTCHA は必須ではなく、フォームではまだ提供していません。

## プランごとの上限

| プラン | フォーム |
|------|-------|
| 無料 | 1 |
| スターター | 10 |
| ミディアム | 30 |
| ラージ | 無制限 |

送信件数は、1 日のメッセージ上限によってのみ制限されます。

## API

ビルダーで行える操作は、すべて REST API から利用できます:

| エンドポイント | 内容 |
|----------|--------------|
| [`GET /v1/forms`](https://info.pocketalert.app/api/forms/get-forms.md) | フォームの一覧を取得する |
| [`POST /v1/forms`](https://info.pocketalert.app/api/forms/create.md) | フォームを作成する |
| [`PUT /v1/forms/:tid`](https://info.pocketalert.app/api/forms/update.md) | 項目、デザイン、設定を置き換える |
| [`DELETE /v1/forms/:tid`](https://info.pocketalert.app/api/forms/delete.md) | フォームを削除する |
| [`GET /v1/forms/:tid`](https://info.pocketalert.app/api/forms/get-form.md) | 公開: 公開中のフォームの項目とデザインを取得する |
| [`POST /v1/forms/:tid/submit`](https://info.pocketalert.app/api/forms/submit.md) | 公開: 送信を受け付ける |

最初の 4 つは通常のトークンを使います。最後の 2 つは、フォームのページ自身が呼び出すものです。
