# Forms

Form yang Anda buat di dasbor, publikasikan di tautannya sendiri, dan embed di mana saja. Setiap pengiriman masuk sebagai push notification ke ponsel Anda — jalurnya sama dengan webhook, jadi perutean, tingkat prioritas, dan riwayat pesan bekerja seperti yang sudah Anda kenal.

Tanpa kotak masuk email di tengah. Tanpa harus memantau spreadsheet.

## Membuat form

**Forms → Create.** Pembuat formulir memiliki lima tab dan pratinjau langsung di sebelahnya:

| Tab | Isinya |
|-----|--------|
| Fields | Judul, teks pengantar, field itu sendiri, teks footer |
| Design | Tema, warna, font, ukuran, radius sudut, tombol kirim |
| Settings | Judul push, perutean, prioritas, batas respons, pesan |
| Share | Tautan publik, kode QR, kode embed |
| Preview | Pratinjau langsung yang sama, untuk layar sempit |

Simpan, lalu tab Share akan memberi Anda tautannya: `https://frms.click/<id>`.

## Jenis field

| Grup | Jenis |
|------|-------|
| Text | Short text, long text, email, phone, number, URL, date |
| Choice | Dropdown, radio buttons, checkboxes, single checkbox (persetujuan) |
| Rating | Star rating (1–5), NPS (0–10) |
| Layout | Heading, paragraph, divider |
| Tracking | Hidden field |

Maksimal **30 field** per form, hingga 50 opsi dalam satu field pilihan. Field email, phone, number, dan URL divalidasi di browser dan juga di server — pengecekan di sisi klien hanya untuk kenyamanan, bukan pengaman.

Field layout hanya dekorasi: field ini tidak pernah muncul di pesan. Unggah file dan pembayaran tidak didukung.

### Hidden field

Hidden field membawa nilai dari tautan ke dalam pesan. Beri nama parameter, dan `?utm_source=newsletter` di URL akan muncul di notifikasi. Satu klik menambahkan kelima parameter UTM sekaligus.

Saat form di-embed, parameter dari **halaman host** diteruskan, sehingga halaman landing kampanye otomatis menandai pengirimannya sendiri tanpa usaha tambahan dari Anda.

## Tampilan pesannya

Jawaban ditampilkan lebih dulu, sesuai urutan kemunculan field:

```
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
```

Hidden field, IP pengunjung, dan timestamp berada di bagian bawah, setelah jawaban. Timestamp menggunakan zona waktu akun Anda. Semuanya dienkripsi saat disimpan dengan kunci pribadi Anda, sama seperti pesan lainnya.

## Judul push

Secara default notifikasi diberi judul `Form: <form name>`. Template membuatnya lebih berguna sekilas pandang:

```
New lead: {Name} ({Email})
```

Token merujuk ke field **berdasarkan labelnya**, tidak peka huruf besar-kecil, plus `{form}` untuk nama form. Jawaban kosong dihilangkan dari judul; jika tidak ada yang tersisa, judul default dipakai. Template ini tidak pernah ditampilkan di halaman publik.

## Badge Pocket Alert

Form yang dipublikasikan memiliki tautan kecil "Powered by Pocket Alert" di bawahnya. Pada paket berbayar, Anda dapat mematikannya di **Design → Branding**.

API yang menentukan, bukan browser: menyimpan flag ini di paket gratis akan meresetnya, dan jika paket berbayar berakhir, badge akan muncul kembali di halaman publik tanpa Anda perlu menyentuh form.

## Perutean dan prioritas

Form dapat diarahkan ke aplikasi dan perangkat tertentu, dan dapat membawa tingkat prioritas dari silent hingga critical — tingkat yang sama dengan API. Biarkan level di *Default* dan form akan mengikuti aturan pengiriman normal Anda.

Setiap pengiriman memakai satu pesan dari kuota harian Anda. Saat kuota habis, pengunjung melihat pesan netral "coba lagi nanti" tanpa menyebut paket Anda, dan Anda menerima email batas yang biasa.

## Menutup form

Tiga sakelar independen, salah satunya saja sudah cukup untuk menutupnya:

- **Accepting responses** — mematikannya langsung menutup form
- **Response limit** — menutup setelah N pengiriman; slot dicadangkan sebelum pesan dibuat, sehingga lonjakan trafik tidak bisa melebihinya
- **Close on** — tanggal dan jam dalam zona waktu Anda

Form yang sudah ditutup tetap bisa dibuka: pengunjung melihat pesan penutupan Anda, bukan field, dan pengiriman ditolak di sisi server.

## Embed

Tab Share menyediakan embed berbasis script:

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

Form dimuat dalam iframe yang melaporkan tingginya sendiri, sehingga tidak ada scrollbar di dalam dan tidak perlu mengelola tinggi tetap. Latar belakang halaman tetap terlihat — atur warna kartu form ke nada yang ramah transparansi agar menyatu.

Setelah pengiriman, container memicu event `pocketalert:submit` yang bisa Anda hubungkan ke analitik:

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

Jika script tidak diizinkan, tersedia juga snippet `<iframe>` biasa — tinggi tetap, dan parameter URL tidak diteruskan.

## Membatasi tempat form dapat digunakan

ID form bersifat publik — ID ini ikut dalam tautan dan kode QR — sehingga secara default siapa pun yang memilikinya dapat meng-embed form di halaman mana pun. **Settings → Where it can be used** menerima daftar domain dan membatasinya:

- hanya situs tersebut yang boleh meng-embed form (halaman disajikan dengan kebijakan `frame-ancestors` yang sesuai);
- pengiriman yang `Origin`-nya (atau `Referer`) tidak ada di daftar akan ditolak dengan `403`;
- tautan form itu sendiri tetap berfungsi.

Tulis host, bukan URL: `example.com`, `app.example.com`, `*.example.com` untuk semua subdomain, `localhost:3000` saat pengembangan. Maksimal 10 entri. `www.` diabaikan, jadi `example.com` mencakup `www.example.com`.

Daftar kosong berarti "di mana saja", yang merupakan pengaturan tepat untuk tautan yang Anda bagikan di bio atau kode QR di poster.

> **Warning: Apa yang bisa dan tidak bisa dicegah**
>
> `Origin` diatur oleh browser dan tidak bisa dipalsukan oleh halaman. Script yang berkomunikasi langsung dengan API bisa mengirim header apa pun, jadi daftar izin hanya mencegah form Anda di-embed di situs orang lain — ini bukan pertahanan terhadap penyerang yang gigih. Batas laju di bawah ini menangani kasus tersebut.

## Asal pengiriman

Ketika pengiriman datang dari form yang di-embed, host dicatat di pesan di samping IP:

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

Pengiriman dari halaman form itu sendiri tidak memiliki baris `Source`.

## Perlindungan spam

- Field honeypot yang tidak pernah dilihat manusia. Bot yang mengisinya mendapat layar sukses yang tampak normal, dan tidak ada yang dikirim.
- Batas laju: 10 pengiriman per menit dari satu IP, 60 per menit dan 300 per jam per form. Batas per jam ada agar banjir pengiriman tidak menghabiskan kuota pesan sehari dalam beberapa menit.
- Halaman form publik menggunakan `noindex`, sehingga form tidak muncul di hasil pencarian dengan sendirinya.

CAPTCHA belum diwajibkan dan belum tersedia di form.

## Batas paket

| Paket | Form |
|-------|------|
| Free | 1 |
| Starter | 10 |
| Medium | 30 |
| Large | Tanpa batas |

Pengiriman itu sendiri hanya dibatasi oleh kuota pesan harian Anda.

## API

Semua yang bisa dilakukan pembuat formulir tersedia melalui REST API:

| Endpoint | Fungsinya |
|----------|-----------|
| [`GET /v1/forms`](https://info.pocketalert.app/api/forms/get-forms.md) | Daftar form Anda |
| [`POST /v1/forms`](https://info.pocketalert.app/api/forms/create.md) | Buat form |
| [`PUT /v1/forms/:tid`](https://info.pocketalert.app/api/forms/update.md) | Ganti field, desain, dan pengaturannya |
| [`DELETE /v1/forms/:tid`](https://info.pocketalert.app/api/forms/delete.md) | Hapus form |
| [`GET /v1/forms/:tid`](https://info.pocketalert.app/api/forms/get-form.md) | Publik: field dan desain form yang aktif |
| [`POST /v1/forms/:tid/submit`](https://info.pocketalert.app/api/forms/submit.md) | Publik: menerima pengiriman |

Empat endpoint pertama memakai token normal Anda; dua terakhir dipanggil oleh halaman form itu sendiri.
