Cara Menggunakan API Papo untuk Membuat Formulir Pendaftaran dan Mengisi CRM Secara Otomatis

Q: Apakah atribut khusus bisa dibuat langsung saat kontak dibuat?

Ya. API Papo memungkinkan Anda menetapkan custom_attributes kontak pada saat pembuatan atau memperbaruinya kemudian. Lihat dokumentasi untuk format payload yang tepat dan untuk memastikan definisi atribut sudah ada di akun.

Q: Apa yang harus dilakukan jika API mengembalikan error?

API Papo mengembalikan respons terstandar dengan success: false dan objek error yang berisi kode dan pesan. Tangani error tersebut di kode Anda: validasi apakah field wajib sudah dikirim, periksa apakah kunci masih aktif dan format payload sudah benar. Dokumentasi mencantumkan kode error utama.

Dengan API REST Papo, Anda dapat membangun endpoint di situs Anda yang menerima data dari formulir pendaftaran dan memanggil API kontak untuk membuat catatan di CRM secara otomatis, termasuk atribut khusus — menghilangkan pengetikan manual dan mempercepat integrasi lead.

Alih-alih mengekspor spreadsheet atau menyalin data antar sistem, integrasi ini membuat setiap pendaftaran baru di situs Anda menjadi kontak di CRM Papo secara real time. Alurnya sederhana: formulir mengirim data ke backend yang Anda kendalikan, backend tersebut melakukan autentikasi ke API Papo dan membuat kontak dengan nama, email, telepon, serta field kustom apa pun yang dibutuhkan operasi Anda.

Ringkasan integrasi

Komponen	Fungsi	Contoh
Formulir di situs	Mengumpulkan nama, email, telepon, dan field tambahan lead.	Halaman capture, landing page, checkout.
Endpoint perantara	Menerima data formulir dan memanggil API Papo.	Skrip Node.js, Python, atau otomasi di n8n/Zapier.
API kontak Papo	Membuat kontak di CRM dengan data yang dikirim.	Permintaan POST terautentikasi dengan kunci rahasia.
Atribut khusus	Menambahkan field seperti sumber, minat, atau skor ke kontak.	`custom_attributes` dengan `"origem": "site"`, `"plano_interesse": "gold"`.

Cara kerjanya: langkah demi langkah

Buat kunci API di panel Papo
Akses area developer akun Papo Anda dan buat kunci rahasia. Kunci publik akun juga terlihat di layar ini. Kunci rahasia hanya muncul sekali; simpan di tempat aman dan jangan pernah mengeksposnya di frontend.
Buat formulir di situs Anda
Susun formulir dengan field yang ingin dikirim ke CRM: nama, email, telepon, dan data tambahan apa pun (minat, sumber, kota, dsb.). Formulir harus mengirim permintaan HTTP (POST) ke endpoint yang akan Anda bangun pada langkah berikutnya.
Bangun endpoint perantara
Di server Anda atau dalam fungsi serverless (Node.js, Python, PHP, dsb.), buat rute yang menerima data formulir. Kode ini bertanggung jawab untuk:
- Memvalidasi field yang diterima.
- Menyusun payload JSON untuk API Papo.
- Melakukan autentikasi dengan kunci rahasia (Bearer token) dan, opsional, mengirim kunci publik di header X-Papo-Public-Key.
- Memanggil endpoint pembuatan kontak Papo.
Panggil API kontak Papo
Gunakan endpoint pembuatan kontak (lihat dokumentasi resmi di https://papo.global/pt/docs untuk jalur yang tepat dan format payload). Kirim minimal nama dan email atau telepon. Respons API akan mengonfirmasi pembuatan dengan data kontak baru.
Tambahkan atribut khusus
Jika akun Anda memiliki definisi atribut kustom (seperti “origem”, “utm_source”, “score”), Anda dapat mengirimnya dalam payload yang sama atau dalam panggilan tambahan. API memungkinkan Anda menetapkan/menggabungkan custom_attributes pada kontak, sehingga tidak perlu lagi mengisi field tersebut secara manual setelahnya.
Tangani respons dan kembalikan ke pengguna
Setelah pembuatan berhasil, endpoint Anda dapat mengalihkan lead ke halaman terima kasih atau menampilkan pesan sukses. Jika terjadi error (kunci tidak valid, data kurang), catat log dan kembalikan pesan yang ramah.

Karena API Papo bersifat REST dan menggunakan JSON, bahasa apa pun yang mendukung HTTP dapat digunakan. Dokumentasi resmi menyediakan contoh dalam JavaScript, Python, dan curl, serta detail autentikasi dan kode error.

Untuk siapa integrasi ini cocok

Situs dan landing page yang menangkap lead dan ingin menghilangkan transfer data manual ke CRM.
E-commerce dan SaaS yang ingin membuat kontak secara otomatis pada saat pendaftaran atau pembelian.
Agensi dan konsultan yang menjalankan kampanye akuisisi dan membutuhkan lead masuk ke CRM secara real time untuk follow-up segera.
Reseller white label dan integrator yang membangun alur khusus untuk klien, menghubungkan formulir situs ke Papo tanpa intervensi manual.
Tim marketing dan sales yang menggunakan atribut khusus untuk segmentasi dan ingin field tersebut terisi otomatis di sumbernya.

Pertanyaan umum

Apakah saya perlu pengetahuan pemrograman tingkat lanjut untuk menerapkan integrasi ini?

Ya. Anda perlu membangun endpoint di server Anda atau menggunakan alat otomasi (n8n, Zapier) yang menjembatani formulir dan API Papo. Kodenya sendiri sederhana, tetapi membutuhkan dasar-dasar HTTP dan manipulasi JSON.

Bisakah saya menggunakan bahasa pemrograman apa pun?

Ya. API Papo bersifat REST dan merespons dalam JSON. Bahasa apa pun yang mendukung permintaan HTTP (Python, Node.js, PHP, Ruby, dsb.) dapat digunakan. Dokumentasi resmi menyediakan contoh dalam JavaScript dan Python.

Apakah atribut khusus bisa dibuat langsung saat kontak dibuat?

Ya. API Papo memungkinkan Anda menetapkan custom_attributes kontak pada saat pembuatan atau memperbaruinya kemudian. Lihat dokumentasi untuk format payload yang tepat dan untuk memastikan definisi atribut sudah ada di akun.

Bagaimana cara menjaga keamanan kunci rahasia?

Kunci rahasia tidak boleh diekspos di frontend (HTML/JavaScript publik). Kunci harus disimpan hanya di server, dalam variabel environment. Gunakan HTTPS pada semua komunikasi dan cabut kunci segera jika ada kecurigaan kebocoran.

Apa yang harus dilakukan jika API mengembalikan error?

API Papo mengembalikan respons terstandar dengan success: false dan objek error yang berisi kode dan pesan. Tangani error tersebut di kode Anda: validasi apakah field wajib sudah dikirim, periksa apakah kunci masih aktif dan format payload sudah benar. Dokumentasi mencantumkan kode error utama.

Bisakah saya menggunakan integrasi ini dengan formulir dari platform seperti WordPress, Typeform, atau RD Station?

Ya. Anda dapat mengonfigurasi webhook di platform tersebut untuk mengirim data formulir ke endpoint perantara Anda, yang kemudian memanggil API Papo. Alternatif lain adalah menggunakan integrasi siap pakai via Zapier atau n8n, dengan membuat alur yang menerima event formulir dan memicu pembuatan kontak di Papo.