Formulir dan lead

Bangun formulir di Studio, render di situs web Anda, blokir spam dengan Turnstile, dan terima setiap pertanyaan masuk sebagai lead.

Halaman ini diterjemahkan dari bahasa Inggris. Jika ada perbedaan, versi bahasa Inggris yang berlaku. Baca dalam bahasa Inggris

Formulir Atlas mengumpulkan pertanyaan masuk di situs web Anda dan mengubah setiap kiriman menjadi lead yang dapat ditugaskan, ditindaklanjuti, dan diekspor oleh tim Anda. Formulir berfungsi di situs web Development Anda dan, setelah Production live, di situs web live Anda.

Cara kerjanya

Bangun formulir di Studio. Bidang, label, teks persetujuan, label tombol kirim, dan pesan sukses, di Forms & leads.
Situs web Anda merendernya. Situs mengambil definisi formulir dan menggambar bidangnya dengan komponennya sendiri, sehingga formulir sesuai dengan desain Anda.
Pengunjung mengirim. Browser mengirim langsung ke Atlas. Tidak ada token yang terlibat: Atlas hanya menerima permintaan yang Origin-nya adalah alamat terdaftar situs web Anda.
Atlas memeriksa dan menyimpannya. Pemeriksaan spam dan penyalahgunaan berjalan lebih dulu, lalu lead disimpan, diemailkan ke tim Anda, dan dikirim ke webhook Anda.

Development dan situs web live

	Situs web Development	Situs web live (Production)
Kapan formulir menjawab	Selalu	Ketika Production aktif dan rilis bertanda tangan sedang live
Versi formulir mana	Draf terbit terbaru	Versi yang ada di dalam rilis live
Origin yang diterima	Alamat Development Anda	Hanya `https://` domain Production Anda
Tempat lead muncul	Leads → Development	Leads → Live website (“Leads from the live website”)
Email lead	Nonaktif secara bawaan	Aktif secara bawaan; dapat dijeda

Formulir ikut ke Production di dalam rilis, sama seperti halaman. Formulir yang Anda ubah di Development sampai ke situs web live bersama rilis tersetujui berikutnya, dan formulir yang dihapus dari rilis berhenti menjawab di sana.

Selama Production nonaktif, alamat formulirnya menjawab 404 CP_NOT_FOUND. Jika Production aktif tetapi belum ada rilis bertanda tangan yang live, alamat tersebut menjawab 403 CP_PRODUCTION_LOCKED.

Render formulir

// GET /v1/public/environments/{environmentId}/forms/{formKey}
// → { key, name, version, fields, settings: { submitLabel, successMessage, consentText },
//     challenge: { provider: 'turnstile', action, siteKey } }

Render fields dengan input Anda sendiri. Jika challenge.provider adalah turnstile, render widget Cloudflare Turnstile dengan siteKey dan action yang diberikan, dan izinkan Turnstile di Content-Security-Policy Anda.

Kirim

// POST /v1/public/environments/{environmentId}/forms/{formKey}/submissions
{
  "idempotencyKey": "<new UUID per attempt>",
  "sessionId": "<16–128 chars, A–Z a–z 0–9 _ ->",
  "startedAt": 1761210000000,       // when the visitor opened the form, in ms
  "challengeToken": "<Turnstile token>",
  "website": "",                    // hidden honeypot field; leave empty
  "consent": true,
  "fields": { "name": "…", "email": "…", "message": "…" }
}

Respons	Arti
`201 { status: 'received' }`	Diterima. Tampilkan `settings.successMessage`
`422 SUBMISSION_INVALID`	Sebuah bidang gagal validasi. Tampilkan galat bidang
`400 SUBMISSION_REJECTED`	Ditolak, misalnya karena tantangan gagal
`429`	Terlalu banyak kiriman. Minta pengunjung mencoba lagi nanti

Kiriman yang mencurigakan dikarantina tetapi tetap mendapat 201, sehingga penyerang tidak dapat mengetahui apa yang ditandai.

Perlindungan spam dan penyalahgunaan

Tantangan Turnstile dari Cloudflare, per situs.
Bidang honeypot dan waktu pengisian minimum.
Deteksi duplikat dalam 10 menit.
Batas laju per situs, formulir, sesi pengunjung, dan alamat IP. Lihat Batas.

Tab Spam review di Studio menampilkan kiriman yang dikarantina dari Development. Kiriman yang dikarantina dari situs web live belum dapat ditinjau di Studio.

Email lead

Pemilik situs menambahkan koneksi email (SMTP atau penyedia email) di Integrations → Email. Kata sandi dan kunci API disimpan terenkripsi dan tidak pernah ditampilkan lagi atau dicatat dalam log.

Kartu Email for enquiries and leads memiliki dua sakelar:

Live website: aktif secara bawaan setelah Production live. Atur ke “emails paused” untuk menghentikan email tanpa menyentuh formulir.
Development: nonaktif secara bawaan, sehingga kiriman uji tidak mengirim email ke siapa pun. Kiriman uji ditandai [Test].

Hanya admin situs yang dapat mengubah sakelar ini. Balasan otomatis ke pengunjung nonaktif kecuali Anda mengaktifkannya.

Yang perlu dibaca selanjutnya

Bekerja dengan leadTugaskan, gabungkan, ekspor, dan bersihkan lead, lalu kirim ke CRM Anda.Go liveTerbitkan rilis dan aktifkan Production agar formulir menjawab pengunjung sungguhan.