Dokumentasi
Bagaimana cara mengaktifkan plugin ini?
Setelah membeli Integrasi Hello Bonsai untuk Gravity Forms, Anda perlu menginstal plugin tersebut di situs web WordPress Anda. Mari kita bahas prosesnya.
Langkah 1: Instalasi
Masuk ke situs WordPress Anda dan navigasikan ke Plugin → Tambah Plugin → Unggah Plugin → Instal file zip dan aktifkan.
Langkah 2: Daftarkan Plugin
Buka Formulir → Pengaturan → Hello Bonsai dan klik Aktifkan Lisensi Di bagian Lisensi, masukkan kunci lisensi Anda dan aktifkan.
Langkah 3: Hubungkan Akun Hello Bonsai Anda
Di akun Hello Bonsai Anda, buka Pengaturan → Akun Saya → Integrasi → API Bonsai (baru) dan buat kunci API (dimulai dengan bonsai_at_). Kembali ke WordPress, tempelkan ke bagian Koneksi Hello Bonsai dan klik Simpan Pengaturan – kunci akan diverifikasi terhadap Hello Bonsai dan akun akan ditambahkan dalam satu langkah.
Langkah 4: Buat Umpan
Buka formulir yang ingin Anda gunakan untuk mengumpulkan prospek, masuk ke Pengaturan → tab Hello Bonsai, dan tambahkan feed. Petakan kolom Nama dan Email Anda, lalu aktifkan bagian Perusahaan dan Kesepakatan jika Anda menginginkannya. Selesai – pengajuan berikutnya akan masuk ke Hello Bonsai.
Detail Fitur
Apa yang dibuat di Hello Bonsai?
Setiap feed menjalankan serangkaian hingga empat langkah pada setiap pengajuan:
- Perusahaan (opsional) – dicocokkan berdasarkan domain dan/atau nama, atau dibuat jika tidak ada yang cocok.
- Kontak (selalu) – ditemukan berdasarkan email yang tepat dan diperbarui, atau dibuat dan dihubungkan ke perusahaan.
- Kesepakatan (opsional) – dibuka di tahap pipeline yang Anda pilih, ditugaskan, dinilai, dan dilampirkan ke kontak dan perusahaan.
- Komentar (opsional) – pengajuan yang diposting pada kesepakatan baru sebagai bukti tertulis.
Jika langkah selanjutnya tidak dapat diselesaikan, langkah-langkah sebelumnya tetap dihitung – entri tersebut ditandai. sebagian tersinkronisasi dengan penjelasan sederhana tentang langkah mana yang perlu diperhatikan, dan Re-send melanjutkan dari titik terakhir.
Bidang kontak yang dipetakannya
- Nama (Wajib) – Kolom Nama di Gravity Forms digabungkan secara otomatis (Nama Depan + Nama Belakang).
- Surel (wajib) – kunci unik Hello Bonsai mencocokkan kontak berdasarkan.
- Jabatan
- Nomor telepon
Ini adalah kolom-kolom yang diterima API Hello Bonsai pada kontak saat ini. Seiring dengan perluasan API Hello Bonsai (kolom kustom ada dalam rencana mereka), plugin ini akan berkembang bersamanya.
Jika kontak sudah ada, Anda dapat memilih perilaku per feed: memperbarui kontak yang sudah ada dengan nilai yang dikirimkan (default), atau membiarkannya tidak berubah. Dalam kedua kasus, pengiriman tersebut akan terhubung ke kontak yang sudah ada – tidak akan pernah ada duplikat yang dibuat, dan kolom opsional kosong tidak akan pernah menimpa data sebenarnya di Hello Bonsai.
Pencocokan Perusahaan
Hello Bonsai memperlakukan domain situs web sebagai unik di seluruh akun Anda – sebuah domain hanya dapat dimiliki oleh satu perusahaan – yang membuat pencocokan domain sangat andal. Bagian Perusahaan di setiap feed memberi Anda tiga mode pencocokan:
- Nama domain, lalu nama perusahaan (default) – coba domain terlebih dahulu, jika gagal, akan menggunakan pencocokan nama yang persis sama (tidak peka huruf besar/kecil).
- Hanya domain
- Hanya nama perusahaan
Petakan kolom Situs Web/Domain dan plugin akan menormalkan apa pun yang diketik pengunjung – https://www.acme.com/contact menjadi acme.com sebelum pencocokan. Jika tidak ada kolom domain yang dipetakan, domain kontak tersebut alamat email Daftar tersebut digunakan secara otomatis, dan penyedia email gratis (gmail.com, outlook.com, yahoo.com, icloud.com, dan puluhan lainnya) diabaikan sehingga Anda tidak akan pernah mendapatkan email dari perusahaan "Gmail". Pengembang dapat menyesuaikan daftar penyedia gratis dengan filter.
Ketika tidak ada yang cocok, Anda dapat memilih per feed: membuat perusahaan (default) atau melewatinya. Perusahaan yang dibuat diberi nama dari kolom Nama Perusahaan yang dipetakan, atau dari domainnya jika tidak ada nama yang dikirimkan – konvensi yang sama yang digunakan Hello Bonsai sendiri.
Mencocokkan dengan perusahaan yang sudah ada tidak akan mengeditnya. Dan ketika kontak yang sudah ada mengirimkan data melalui perusahaan yang belum terhubung dengannya, plugin akan membuat tautan tanpa mengubah kontak utama perusahaan – sesuatu yang secara mengejutkan sulit dilakukan oleh API Hello Bonsai, dan ditangani untuk Anda.
Penawaran
Aktifkan bagian Kesepakatan dan setiap prospek yang tertangkap dapat membuka kesepakatan di papan kesepakatan Hello Bonsai Anda. Hello Bonsai mengharuskan setiap kesepakatan dimiliki oleh sebuah perusahaan, jadi bagian Perusahaan perlu diaktifkan dan diisi – editor umpan dan hasil entri akan memperjelas hal ini jika belum diaktifkan.
- Judul Kesepakatan – mendukung tag gabungan Gravity Forms, misalnya.
Website lead – {Name:1}. Secara default menggunakan judul formulir. - Nilai Kesepakatan – Memetakan setiap kolom formulir yang berisi jumlah uang. Kolom produk dibaca dengan mempertimbangkan mata uang (harga, bukan label), dan kolom angka juga berfungsi dengan baik.
- Tahapan Saluran Pipa – Pemilih langsung dari tahapan papan kesepakatan Anda yang sebenarnya, diambil dari akun Hello Bonsai Anda. Secara default menampilkan tahapan pertama Anda.
- Tetapkan Kepada – tidak ditugaskan, anggota akun yang terhubung, atau anggota tim aktif mana pun (juga diambil secara langsung).
- Buat kesepakatan – pada setiap pengajuan, atau hanya ketika kontak tersebut baru. Opsi kedua mencegah klien lama menumpuk kesepakatan ganda.
Komentar kesepakatan
Aktifkan opsi komentar dan plugin akan memposting kiriman pada kesepakatan yang baru dibuat – templat defaultnya adalah {form_title} diikuti oleh {all_fields}, dan Anda dapat menyesuaikannya dengan tag gabungan apa pun. Siapa pun yang mengambil kesepakatan di Hello Bonsai akan melihat permintaan lengkap tanpa meninggalkan papan kesepakatan. (Komentar Hello Bonsai berupa teks biasa; format dihilangkan oleh Hello Bonsai.)
Hasil Entri & Pengiriman Ulang
Setiap entri mendapatkan Halo Bonsai kotak pada halaman detailnya yang menunjukkan persis apa yang terjadi:
- Tersinkronisasi – setiap langkah yang diminta telah diselesaikan.
- Sebagian tersinkronisasi – Kontak aman di Hello Bonsai, tetapi langkah selanjutnya (perusahaan, kesepakatan, atau komentar) perlu diperhatikan. Pesan tersebut menjelaskan secara tepat langkah mana dan alasannya.
- Sinkronisasi gagal – tidak ada yang bisa ditulis; pesan tersebut berisi kesalahan dari Hello Bonsai sendiri.
ID Kontak, Perusahaan, dan Kesepakatan yang dibuat adalah tautan yang dapat diklik langsung menuju akun Hello Bonsai Anda, dan ID permintaan Hello Bonsai akan ditampilkan untuk setiap percakapan dukungan.
Itu Kirim ulang ke Hello Bonsai Tombol ini mencoba kembali sinkronisasi yang gagal atau sebagian dengan aman: perusahaan dan kontak dicocokkan ulang alih-alih diduplikasi, kesepakatan yang sudah dibuat tidak akan pernah dibuat ulang, dan komentar yang sudah diposting tidak akan pernah diposting dua kali. Ini juga berfungsi pada entri yang ada sebelum plugin – buka entri lama mana pun dan klik Kirim ke Hello Bonsai untuk menimbunnya kembali.
Tag Gabungan
{bonsai_contact_id} – ID kontak Hello Bonsai yang terhubung dengan entri ini.
{bonsai_company_id} – ID perusahaan Hello Bonsai yang terhubung dengan entri ini.
{bonsai_deal_id} – ID penawaran Hello Bonsai dibuka untuk entri ini.
Gunakan ID tersebut dalam notifikasi, konfirmasi, dan payload webhook. Feed diproses secara sinkron selama pengiriman, sehingga ID sudah diselesaikan saat Gravity Forms mengirimkan notifikasi pengiriman yang sama – tidak ada kondisi persaingan (race condition). Tag untuk catatan yang tidak dibuat (misalnya, tidak ada kesepakatan pada pengirim berulang) akan muncul kosong.
Beberapa Akun
Agensi dan tim multi-merek dapat menghubungkan lebih dari satu akun Hello Bonsai. Setiap akun diverifikasi saat ditambahkan, tercantum dalam tabel Akun Terhubung dengan tindakan uji dan hapus, dan setiap feed memilih akun mana yang akan digunakan untuk mengirim konten – dengan akun default yang digunakan jika feed tidak menentukan. Kredensial disimpan di sisi server dalam basis data WordPress Anda dan tidak pernah ditampilkan kembali ke halaman setelah disimpan.
Notifikasi Kesalahan & Sinkronisasi Ulang
Pemberitahuan kesalahan – Tambahkan alamat email di bawah Formulir → Pengaturan → Hello Bonsai → Pelaporan Kesalahan dan Anda akan menerima email setiap kali sinkronisasi gagal atau hanya sebagian berhasil. Email tersebut berisi feed, pesan hasil yang tepat, ID permintaan Hello Bonsai, dan tautan langsung ke entri sehingga Anda dapat menyelidiki dan mengirim ulang hanya dalam dua klik.
Sinkronisasi ulang pengeditan entri – Secara opsional, jalankan ulang feed formulir saat entri diedit di admin WordPress, sehingga kontak dan perusahaan Hello Bonsai yang terhubung akan mengambil nilai yang telah dikoreksi. Kesepakatan tidak akan pernah dibuat dua kali untuk entri yang sama, berapa pun banyaknya sinkronisasi ulang yang dilakukan.
FAQ
Di mana saya bisa mendapatkan kunci API Hello Bonsai?
Di akun Hello Bonsai Anda di bawah Pengaturan → API, buat kunci API – dimulai dengan bonsai_at_. Tempelkan di halaman pengaturan plugin dan kunci API akan diverifikasi dan disimpan dalam satu langkah. Akun Hello Bonsai apa pun yang dapat membuat kunci API di sana dapat digunakan dengan plugin ini.
Mengapa tidak ada kesepakatan yang dibuat untuk pengajuan saya?
Hello Bonsai mengharuskan setiap transaksi tergabung dalam sebuah perusahaan, jadi bagian Perusahaan pada feed harus diaktifkan dan harus sesuai atau membuat perusahaan baru. Kotak Hello Bonsai pada entri tersebut memberi tahu Anda dengan tepat apa yang terjadi pada setiap langkah – jika perusahaan dilewati atau tidak dapat diselesaikan, pesan transaksi akan menyatakannya dalam bahasa Inggris yang mudah dipahami.
Apa yang terjadi jika orang yang sama mengirimkan lamaran dua kali?
Plugin ini menemukan kontak yang sudah ada berdasarkan email – tidak akan pernah ada duplikat yang dibuat. Per feed, Anda dapat memilih apakah pengiriman memperbarui detail kontak atau membiarkannya tidak berubah, dan apakah itu membuka kesepakatan lain atau hanya kesepakatan pada kontak pertama. Perusahaan melakukan pencocokan ulang dengan cara yang sama.
Bisakah saya mengirimkan entri yang dikirim sebelum saya memasang plugin ini?
Ya. Buka entri mana pun dan klik Kirim ke Hello Bonsai di kotak Hello Bonsai. Sistem ini menjalankan feed formulir terhadap entri tersebut dengan perlindungan duplikasi penuh, sehingga pengisian data lama tetap aman meskipun beberapa orang tersebut sudah ada di Hello Bonsai Anda.
Bisakah saya memetakan kolom kustom, atau mengirim unggahan file?
Belum – API publik Hello Bonsai saat ini belum mendukung kolom kustom, lampiran file, atau webhook. Plugin ini memetakan semua yang diterima API saat ini, dan seiring dengan perluasan API oleh Hello Bonsai, plugin ini juga akan ikut berkembang. Sementara itu, opsi komentar kesepakatan adalah cara yang bagus untuk menampilkan seluruh pengajuan (setiap kolom) kepada siapa pun yang menangani prospek tersebut.
Apakah saya hanya bisa mengirimkan kiriman tertentu ke Hello Bonsai?
Ya – setiap feed mendukung logika kondisional Gravity Forms (“Kirim ke Hello Bonsai jika…”), sehingga Anda dapat membatasi sinkronisasi pada bidang apa pun: hanya anggaran yang memenuhi syarat, hanya pilihan layanan tertentu, hanya yang bukan spam, apa pun yang sesuai dengan formulir Anda.
Data apa yang keluar dari situs saya?
Hanya nilai yang Anda petakan dalam feed (ditambah templat komentar, jika diaktifkan) yang dikirim langsung ke API resmi Hello Bonsai melalui HTTPS. Tidak ada yang dikirim ke pihak ketiga lainnya, dan tidak ada yang dikirim sama sekali kecuali jika kondisi feed terpenuhi.
Apakah ini berfungsi dengan caching/CDN dan optimasi skrip?
Ya, tanpa perlu konfigurasi apa pun. Semua sinkronisasi terjadi di sisi server saat formulir dikirimkan – tidak ada skrip front-end, jadi tidak ada yang perlu dikecualikan dari plugin caching, minifikasi, atau penundaan.
Apakah ini berfungsi dengan Gravity Forms yang mendukung AJAX?
Ya. Ini berfungsi dengan Formulir AJAX dan pengiriman formulir Gravity Forms standar (non-AJAX).
Apa yang terjadi jika Hello Bonsai lambat atau tidak dapat diakses selama proses pengiriman?
Pengunjung Anda terlindungi: plugin akan mencoba kembali kegagalan sementara dalam waktu singkat, tetapi membatasi total waktu yang akan dihabiskan selama satu pengiriman (40 detik secara default, dapat disesuaikan melalui filter) sehingga API yang lambat tidak akan pernah membuat formulir Anda macet. Apa pun yang tidak dapat diselesaikan akan dicatat secara jujur pada entri sebagai gagal atau sebagian – dan jika Anda telah mengatur email pemberitahuan kesalahan, Anda akan mengetahuinya – kemudian satu klik pada Kirim Ulang akan menyelesaikan pekerjaan setelah Hello Bonsai kembali berfungsi normal.
Apakah ini berfungsi dengan jaringan WordPress Multisite?
Ya. Setiap sub-situs menghubungkan akun Hello Bonsai-nya sendiri (atau beberapa akun) dan mengkonfigurasi feed-nya sendiri, dan penghapusan instalasi akan membersihkan seluruh jaringan. Dengan lisensi Unlimited, Mode Jaringan memungkinkan Anda mengirimkan satu kunci lisensi ke setiap sub-situs dalam satu batch.
Apakah sudah siap diterjemahkan?
Ya – setiap string dapat diterjemahkan. Anda dapat menggunakan yang gratis. Plugin Loco Translate untuk membuat terjemahan untuk bahasa/lokal situs Anda. Jika Anda belum pernah menggunakan Loco Translate sebelumnya, berikut caranya. tutorial yang ramah bagi pemula.
Kait
Filter
pb_gfhellobonsai_contact_payload
Saring isi kontak sebelum dikirim ke Hello Bonsai – sesuaikan nama, email, jabatan, atau nomor telepon saat mengirim.
Parameter:
$contact_body(array) – Kolom kontak yang telah diisi (nama, email, jabatan, nomor telepon).$feed(array) – Umpan Gravity Forms.$entry(array) – Entri saat ini.$form(array) – Bentuk saat ini.
// Title-case every contact name on its way into Hello Bonsai.
add_filter( 'pb_gfhellobonsai_contact_payload', function( $contact_body, $feed, $entry, $form ) {
if ( isset( $contact_body['name'] ) ) {
$contact_body['name'] = ucwords( strtolower( $contact_body['name'] ) );
}
return $contact_body;
}, 10, 4 );pb_gfhellobonsai_company_payload
Saring isi perusahaan sebelum perusahaan didirikan – sesuaikan nama atau domainnya.
Parameter:
$body(array) – Kolom perusahaan (nama, domain).$feed(array) – Umpan Gravity Forms.$entry(array) – Entri saat ini.$form(array) – Bentuk saat ini.
// Prefix companies created from forms so they're easy to spot in Hello Bonsai.
add_filter( 'pb_gfhellobonsai_company_payload', function( $body, $feed, $entry, $form ) {
$body['name'] = 'Lead: ' . $body['name'];
return $body;
}, 10, 4 );pb_gfhellobonsai_deal_payload
Saring isi kesepakatan sebelum dikirim – sesuaikan judul, nilai, tahapan, atau penerima tugas secara terprogram.
Parameter:
$deal(array) – Kolom kesepakatan (judul, company_id, contact_id, board_group_id, assignee_member_id, deal_value).$feed(array) – Umpan Gravity Forms.$entry(array) – Entri saat ini.$form(array) – Bentuk saat ini.
// Route big-budget leads into a different pipeline stage.
add_filter( 'pb_gfhellobonsai_deal_payload', function( $deal, $feed, $entry, $form ) {
if ( isset( $deal['deal_value'] ) && (float) $deal['deal_value'] >= 10000 ) {
$deal['board_group_id'] = 'your-priority-stage-uuid';
}
return $deal;
}, 10, 4 );pb_gfhellobonsai_free_email_domains
Saring daftar domain email gratis yang dikecualikan dari pencocokan perusahaan berbasis email (gmail.com, outlook.com, yahoo.com, icloud.com, dan puluhan lainnya secara default).
Parameter:
$free_domains(array) – Domain yang akan dikecualikan menggunakan huruf kecil.
// Also treat a local ISP's addresses as personal email.
add_filter( 'pb_gfhellobonsai_free_email_domains', function( $free_domains ) {
$free_domains[] = 'myisp.example';
return $free_domains;
} );pb_gfhellobonsai_record_url
Saring URL aplikasi Hello Bonsai yang digunakan untuk tautan catatan yang disinkronkan di kotak entri. Kembalikan string kosong untuk menampilkan ID biasa tanpa tautan.
Parameter:
$url(rangkaian) – URL aplikasi default untuk catatan tersebut.$type(rangkaian) – Salah satu dari kontak, perusahaan, kesepakatan.$id(int) – ID rekaman Hello Bonsai.
pb_gfhellobonsai_run_time_budget
Sesuaikan anggaran waktu nyata (dalam detik) yang dibagi oleh setiap permintaan Hello Bonsai dalam satu kali pemrosesan feed. Feed diproses secara sinkron selama pengiriman, jadi ini adalah batas maksimal berapa lama API yang mengalami penurunan kinerja dapat menahan pengunjung Anda. Nilai default adalah 40.
Parameter:
$seconds(mengambang) – Anggaran dalam hitungan detik. Nilai default 40.
// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
return 20.0;
} );pb_gfhellobonsai_runtime_allowed
Mengesampingkan gerbang lisensi pemrosesan feed. Terutama berguna di lingkungan staging dan pengembangan.
Parameter:
$allowed(bool) – Apakah pengolahan pakan saat ini diizinkan oleh izin yang diberikan.
pb_gfhellobonsai_api_base_url
Mengganti URL dasar API Hello Bonsai. Hanya berguna untuk pengembangan dan pengujian terhadap API tiruan – Anda tidak akan pernah membutuhkannya di lingkungan produksi.
Parameter:
$url(rangkaian) – URL dasar API. Defaulthttps://app.hellobonsai.com/public-api/v1.