# Formulir dan Isian

Form dipakai untuk menampung data pengunjung landing page: lead, kontak, pendaftaran, atau isian lain. Definisi form disimpan terpisah dari kiriman form, jadi satu form bisa dipakai berkali-kali.

## Bagian aplikasi yang terlibat

| Area | Fungsi |
| --- | --- |
| `Forms` | Kelola form dan baca kiriman. |
| Builder | Menautkan form ke bagian di landing page. |
| Halaman publik | Menerima kiriman dari pengunjung. |

## Isi sebuah form

Setiap form punya:

- Nama
- Slug (nama pendek untuk alamat)
- Daftar field
- Pengaturan form
- Status aktif atau nonaktif

Setiap field punya jenis, label, status wajib diisi, placeholder, dan pilihan (untuk field berpilihan).

Jenis field yang didukung:

- `text`
- `textarea`
- `email`
- `tel`
- `number`
- `select`
- `radio`
- `checkbox`
- `date`
- `hidden`

Field `hidden` bisa berisi nilai tetap atau nilai yang diambil dari parameter di alamat halaman. Anda juga bisa mengisi nilai cadangan kalau parameter itu kosong.

## Isi sebuah kiriman

Setiap kiriman form memuat:

| Data | Fungsi |
| --- | --- |
| Workspace | Workspace pemilik form. |
| Halaman | Halaman tempat form dipakai, jika ada. |
| Bagian | Bagian asal kiriman, jika tersedia. |
| Form | Form yang menerima data. |
| Isian | Nilai setiap field yang dikirim pengunjung. |
| Info tambahan | Keterangan tambahan tentang kiriman. |
| Status | `new`, `reviewed`, `archived`, atau `spam`. |

## Alur kiriman form publik

1. Pengunjung mengisi form di landing page.
2. Pengunjung menekan tombol kirim.
3. Biver mengenali workspace dan halaman dari domain tempat form dibuka.
4. Jika custom domain belum terverifikasi, kiriman bisa ditolak.
5. Biver memeriksa isian. Field asing, field wajib yang kosong, pilihan yang salah, dan tipe isian yang salah akan ditolak.
6. Nilai field `hidden` yang diambil dari alamat halaman dihitung ulang oleh Biver. Kalau parameternya kosong, Biver memakai nilai cadangan.
7. Kiriman masuk ke menu `Forms` di workspace Anda.

## Kirim form dari sistem lain

Anda bisa membuat form, mengubah form, membaca kiriman, dan mengirim form lewat integrasi API memakai kunci API workspace. Cara ini cocok untuk sistem eksternal, otomasi, dan agen AI. Lihat [REST API](/docs/rest-api) atau [Hubungkan ke Asisten AI](/docs/mcp-ai-assistant).

Untuk menerima kiriman langsung dari landing page, pasang form di builder. Anda tidak perlu integrasi tambahan.

## Notifikasi

Setiap kiriman baru dapat dikirim ke tim lewat email. Penerimanya adalah anggota workspace dengan peran owner, admin, atau staf yang sudah memverifikasi email.

- Email memuat nama form, halaman, waktu, dan hingga enam isian pertama. Isian tersembunyi tidak ikut dikirim.
- Jika form punya isian nomor telepon yang valid, email memuat tautan "Balas lewat WhatsApp".
- Atur di **Pengaturan > Notifikasi**: matikan jenis email, senyapkan form atau halaman tertentu, atau matikan email untuk akun Anda sendiri.
- Riwayat pengiriman (dengan alamat yang disamarkan) tersedia untuk owner dan admin di halaman yang sama.
- Jika form dibanjiri spam, email berlebih dibatasi dan tercatat sebagai "Dibatasi".
- Kiriman dari integrasi API tidak memicu email.

## Praktik yang disarankan

- Beri nama form yang mudah dikenali. Nama itu yang muncul di daftar dashboard.
- Simpan bagian asal kiriman kalau Anda butuh tahu form berasal dari bagian mana.
- Pisahkan form lead, form kontak, dan form registrasi supaya kirimannya lebih mudah dibaca.