Integrasi Salesforce untuk Gravity Forms

Bagaimana cara mengaktifkan plugin ini?

Setelah membeli, Anda perlu menginstal plugin tersebut di situs web WordPress Anda. Berikut caranya.

Langkah 1: Instalasi

Masuk ke situs WordPress Anda dan navigasikan ke Plugin → Tambah Plugin → Unggah Plugin. Unggah file zip dan aktifkan.

Langkah 2: Daftarkan Plugin

Pada navigasi sebelah kiri, arahkan ke Formulir → Pengaturan → Salesforce. Di dalam Lisensi klik bagian Kelola Lisensi, masukkan kunci lisensi Anda dan klik Aktifkan Lisensi.

Langkah 3: Hubungkan Salesforce

Setelah mendapatkan lisensi, gulir ke bawah. Koneksi Salesforce bagian pada halaman pengaturan yang sama (berjudul Tambahkan Akun Salesforce setelah akun dibuat) dan hubungkan akun Salesforce pertama Anda (petunjuk lengkap di bawah)

Selesai! Anda siap untuk mulai memetakan formulir ke Salesforce.

Bagaimana cara menghubungkan akun Salesforce dengan OAuth?

Langkah 1: Memahami Jenis-Jenis Aplikasi

Di Salesforce, Anda dapat membuat Aplikasi Klien Eksternal (opsi modern, dan satu-satunya yang tersedia untuk organisasi baru yang dibuat sejak rilis Spring '26 Salesforce) atau Aplikasi Terhubung (opsi lama, masih didukung pada organisasi yang sudah ada yang mengizinkannya). Plugin ini berfungsi identik dengan keduanya.

Buka salah satu opsi berikut di Pengaturan Salesforce:

• Pengaturan → Manajer Aplikasi Klien Eksternal → Aplikasi Klien Eksternal Baru (direkomendasikan)

atau aplikasi terhubung lama (dinonaktifkan secara default pada organisasi yang lebih baru)

• Pengaturan → Manajer Aplikasi → Aplikasi Terhubung Baru

Sebelum Anda terhubung: pengguna Salesforce yang mengotorisasi koneksi memerlukan hak akses Buat (dan Edit, untuk feed yang diperbarui) pada setiap objek yang akan Anda sinkronkan. Plugin hanya mencantumkan objek yang benar-benar dapat dibuat oleh pengguna tersebut.

Langkah 2: Buat Aplikasi Klien Eksternal baru

CATATAN: Pada tangkapan layar di bawah ini, pengaturan yang tidak dicentang atau kosong memang dimaksudkan untuk dibiarkan apa adanya, jadi biarkan saja seperti itu.

Setelah masuk ke Salesforce, di pojok kanan atas layar Anda, klik ikon roda gigi:

Di sisi kiri layar Anda, di kotak pencarian yang bertuliskan “pencarian cepat”, cari “aplikasi klien eksternal” lalu pilih “Pengelola Aplikasi Klien Eksternal”:

Di sisi kanan layar Anda, klik tombol yang bertuliskan “Aplikasi Klien Eksternal Baru”:

Di bagian “Informasi Dasar”, masukkan hal berikut:

• Nama Aplikasi Klien Eksternal (nama API akan dibuat secara otomatis, biarkan saja)
• Email Kontak
• Biarkan Status Distribusi tetap "Lokal"“

Di bawah “API (Aktifkan Pengaturan OAuth)” lakukan hal berikut:

• Aktifkan OAuth
• Masukkan URL Callback Anda (URL ini terletak di pengaturan plugin di bawah Formulir > Pengaturan > Salesforce > URL Callback OAuth)
• Di bawah Cakupan OAuth, pilih yang berikut ini:
  • “Kelola data pengguna melalui API (api)”
  • “Lakukan permintaan kapan saja (refresh_token, offline_access)”

Biarkan pengaturan di bawah ini apa adanya:

Biarkan semua pengaturan lainnya di bawah ini tetap seperti semula:

Klik buat aplikasi dan Anda siap melanjutkan ke langkah 3:

Langkah 3: Edit Kebijakan Otorisasi Aplikasi

Setelah aplikasi dibuat, kita perlu mengedit kebijakan aplikasi. Klik kembali ke “Pengelola Aplikasi Klien Eksternal”.”

Kemudian pilih aplikasi yang baru saja Anda buat dan klik tombol “Edit” seperti yang Anda lihat di bawah ini:

Kemudian buka menu tarik-turun “Kebijakan OAuth” dan atur kebijakan token penyegaran agar kedaluwarsa “setelah waktu tertentu”, lalu atur menjadi 365 hari atau lebih. Plugin akan memperbarui token akses berumur pendek secara otomatis, tetapi setelah token penyegaran itu sendiri kedaluwarsa, Salesforce akan menolak koneksi dan Anda harus menghubungkan kembali akun tersebut melalui Formulir → Pengaturan → Salesforce. Kebijakan yang lebih lama berarti Anda melakukannya paling lama setahun sekali, bukan setiap 30 hari.

Kami menyarankan untuk mengatur pengingat untuk memeriksa koneksi sebagai tindakan pencegahan.

Langkah 4: Hubungkan Aplikasi Klien Eksternal yang baru ke Gravity Forms

Pengaturan Salesforce sudah selesai, sekarang kita perlu menghubungkan Gravity Forms ke aplikasi. Di Salesforce, kembali ke “External Client App Manager” dan pilih aplikasi Anda.

Klik “Pengaturan” dan gulir ke bawah ke “Pengaturan OAuth” lalu buka. Anda akan melihat tombol bertuliskan “Kunci dan Rahasia Konsumen”, klik tombol tersebut.

Anda kemungkinan besar akan melihat layar verifikasi identitas dan kode akan dikirimkan kepada Anda. Masukkan kode tersebut dan klik “Verifikasi”.”

Setelah verifikasi, Anda akan diperlihatkan Kunci Konsumen dan Rahasia Konsumen. Biarkan tab tersebut tetap terbuka dan di tab baru, buka pengaturan plugin kami di bawah Formulir > Pengaturan > Salesforce dan tambahkan kunci tersebut seperti yang dijelaskan pada tangkapan layar di bawah ini. Tombol akan muncul setelah kedua kolom terisi: klik Hubungkan Akun (tombol akan bertuliskan Tambah Akun setelah Anda sudah memiliki akun yang terhubung).

Anda akan melihat Gravity Forms sudah terhubung ke Salesforce sekarang dan kita dapat melanjutkan ke Langkah 5 (langkah terakhir):

Langkah 5: Tambahkan Salesforce Feed ke formulir Anda

Buka pengaturan Gravity Form yang ingin Anda hubungkan ke Salesforce dan tambahkan feed baru:

Dan terakhir, atur pengaturan feed Anda sesuai keinginan:

Sekarang Anda sudah siap! Jika Anda ingin menghubungkan akun Salesforce tambahan dan membuat feed untuk formulir lain, ulangi 5 langkah di atas.

Bagaimana cara saya terhubung dengan ID Organisasi? (Web-to-Lead / Web-to-Case)

Jika organisasi Salesforce Anda tidak memiliki akses API (beberapa edisi Essentials/Professional), Anda dapat menggunakan endpoint Web-to-Lead / Web-to-Case lama sebagai alternatif.

Langkah 1: Di Salesforce, temukan milik Anda ID Organisasi di bawah Pengaturan → Informasi Perusahaan.

Langkah 2: Di WordPress, pada halaman pengaturan Salesforce, alihkan Metode Koneksi Pilih “ID Organisasi (Web-to-Lead/Case)” dari menu tarik-turun.

Langkah 3: Tempelkan ID Organisasi Anda dan klik Simpan Akun ID Organisasi. Mulai versi 1.5.0, fitur ini membaca nilai yang diketikkan ke dalam formulir, jadi tidak perlu menyimpan pengaturan secara terpisah terlebih dahulu.

Perhatian: Mode ID Organisasi hanya mendukung Lead dan Case. Pembaruan, penghapusan, unggahan file, pengisian otomatis, dan pemetaan daftar pilihan memerlukan akun OAuth.

Bagaimana cara mengatur feed?

Langkah 1: Edit formulir → Pengaturan Formulir → Salesforce → Tambah Baru.

Langkah 2: Pilih Akun Salesforce, Objek Salesforce (Prospek, Kontak, Akun, objek kustom…), dan Mode Sinkronisasi (standar, Buat atau perbarui jika data sudah ada., (benar untuk sebagian besar kasus).

Langkah 3: Petakan kolom Gravity Forms Anda ke kolom Salesforce. Kolom Salesforce yang wajib diisi ditandai dengan tanda bintang agar Anda tidak melewatkannya.

Langkah 4 (opsional): Di bawah Pencocokan Duplikat, centang Aktifkan pencocokan duplikat kunci utama untuk memperbarui catatan yang sudah ada yang cocok berdasarkan Email, ID Eksternal, atau bidang lain yang dapat difilter.

Langkah 5 (opsional): Konfigurasikan logika bersyarat, pemeriksaan konflik, penetapan pemilik, unggahan file, catatan, atau keanggotaan kampanye.

Langkah 6: Simpan feed dan kirim entri uji. Periksa layar detail entri untuk sidebar Salesforce. Karena sinkronisasi berjalan di latar belakang, Anda mungkin akan melihat status Tertunda berwarna biru sebentar, kemudian ID catatan baru dan tautan langsung ke catatan tersebut di Salesforce.

Perilaku sinkronisasi mana yang perlu saya aktifkan?

Pembuatan catatan akan berjalan segera setelah feed disimpan. Perilaku siklus hidup bersifat opsional, di bawah Formulir → Pengaturan → Salesforce → Sinkronisasi Pengaturan, dan keempatnya akan nonaktif sampai Anda mencentangnya:

• Sinkronkan pembaruan saat entri diedit Mengirimkan perubahan entri ke catatan Salesforce yang terhubung.
• Hapus catatan Salesforce saat entri dihapus secara permanen. Menghapus data saat Anda mengosongkan tempat sampah. Memindahkan entri ke tempat sampah tidak pernah memengaruhi Salesforce.
• Sinkronkan ulang data entri saat entri dipulihkan dari tempat sampah/spam. Menerapkan perubahan apa pun yang dilakukan saat entri tersebut dihapus, dan membuat pengganti jika catatan tersebut telah dihapus di Salesforce.
• Kirim catatan entri Gravity Forms ke Salesforce sebagai catatan Note. Program ini mencerminkan catatan yang ditambahkan admin ke sebuah entri, dan menghapus salinan Salesforce saat catatan tersebut dihapus.

Detail Fitur

Metode Koneksi

Plugin ini mendukung dua cara untuk menghubungkan Gravity Forms ke Salesforce. Pilih salah satu yang sesuai dengan tingkat akses API organisasi Anda.

• OAuth 2.0 dengan PKCE (direkomendasikan). Otentikasi Salesforce modern menggunakan Aplikasi Terhubung atau Aplikasi Klien Eksternal (pengganti Spring '26+). Tidak ada kunci API statis yang tersimpan di server Anda, plugin memperbarui token akses secara otomatis, dan koneksi tetap aktif tanpa batas waktu selama kebijakan token penyegaran aplikasi tidak membuatnya kedaluwarsa. Cakupan yang diperlukan: api dan refresh_token / offline_access. Berfungsi dengan semua edisi Salesforce yang memiliki akses API (Enterprise, Unlimited, Performance, Developer, atau Professional dengan add-on akses API).
• Web-to-Lead / Web-to-Case (ID Organisasi). Endpoint pengiriman lama yang hanya menggunakan ID Organisasi Salesforce Anda. Berguna untuk organisasi tanpa akses API (beberapa edisi Essentials dan Professional). Keterbatasan: Hanya objek Lead dan Case, tidak ada pembaruan, tidak ada penghapusan, tidak ada unggahan file, tidak ada pengisian otomatis, tidak ada pemetaan daftar pilihan.

Kedua mode tersebut dapat digunakan pada situs WordPress yang sama. Anda dapat memiliki akun OAuth untuk organisasi utama Anda dan akun Org ID untuk organisasi sampingan, dan setiap feed secara independen memilih mana yang akan disinkronkan.

Dukungan Banyak Akun

Hubungkan sebanyak mungkin akun Salesforce yang Anda inginkan ke satu situs WordPress. Pengaturan umum:

• Lingkungan uji coba dan produksi: Uji coba feed terhadap lingkungan sandbox, lalu beralih ke lingkungan produksi hanya dengan mengubah satu menu dropdown.
• AgenSetiap organisasi klien mendapatkan koneksinya sendiri; setiap feed memilih klien mana yang akan disinkronkan.
• Perusahaan induk dan anak perusahaan: Berbagai formulir mengarah ke berbagai organisasi dalam struktur perusahaan Anda.

Satu akun selalu ditandai sebagai akun default sehingga situs sederhana tidak perlu memikirkan akun mana yang akan digunakan. Akun ini juga berfungsi sebagai cadangan: feed yang tidak memiliki akun yang ditetapkan, atau yang akunnya kemudian Anda hapus, akan disinkronkan ke akun default. Menghapus akun akan memberi Anda peringatan sebelum proses dilanjutkan, jadi arahkan feed yang terpengaruh ke akun lain terlebih dahulu jika organisasi default bukanlah tempat yang seharusnya.

Setiap akun juga memiliki status koneksinya sendiri. Plugin mencatat kapan setiap akun terakhir kali diperbarui, terakhir kali berhasil, dan terakhir kali gagal, dan daftar Akun melaporkan Terhubung dengan waktu verifikasi terakhir, Perlu perhatian, atau Perlu dihubungkan kembali, sehingga koneksi yang rusak terlihat sebelum pengiriman mulai gagal. Setiap akun menyimpan versi API Salesforce yang digunakan saat terhubung (koneksi baru secara default menggunakan versi baru). v63.0); hapus dan sambungkan kembali akun untuk memindahkannya ke versi yang lebih baru. Menghapus akun akan mencabut tokennya di Salesforce, bukan hanya melupakannya secara lokal.

Objek Salesforce yang Didukung

Anda dapat melakukan sinkronisasi ke objek Salesforce apa pun Pengguna yang terhubung dapat mengakses objek standar atau kustom. Menu tarik-turun Objek dibangun secara dinamis dari skema aktual organisasi Anda, sehingga Anda akan melihat setiap objek standar yang disertakan Salesforce (Akun, Kontak, Prospek, Peluang, Kasus, Kampanye, Tugas, Acara, Catatan, Pengguna, dan banyak lagi) ditambah setiap objek kustom yang telah Anda definisikan.

Untuk objek kustom, pilih “Kustom (ketik di bawah)” dan masukkan nama API (misalnya, My_Object__cNilai daftar pilihan, relasi pencarian, lampiran file, dan pengisian otomatis semuanya berfungsi dengan cara yang sama terhadap objek kustom seperti halnya objek standar.

Menghubungkan Data di Berbagai Feed

Satu pengiriman dapat membuat beberapa catatan terkait. Tambahkan feed per objek, lalu seret baris pada daftar feed ke urutan yang Anda inginkan. Feed berjalan dalam urutan tersebut, satu demi satu, di latar belakang. Pada feed berikutnya, petakan bidang pencarian (AccountId, ContactId, atau pencarian khusus lainnya) ke Nilai Kustom dan masuk {salesforce_id:FEED_ID}, di mana FEED_ID adalah ID feed sebelumnya. Tag tersebut mengarah ke catatan yang dibuat atau diperbarui oleh feed untuk entri ini, sehingga catatan baru tersebut terhubung dengannya. ID feed adalah fid= nilai di bilah alamat saat Anda mengedit umpan.

Rantai tipikalnya adalah umpan Akun terlebih dahulu, kemudian umpan Kontak dengan AccountId yang diatur ke {salesforce_id:12} (12 adalah ID feed Akun), kemudian feed Peluang dengan AccountId yang diatur dengan cara yang sama. Gunakan akun Salesforce yang sama pada setiap feed dalam rantai, karena ID catatan hanya ada di organisasi yang menerbitkannya. Jika feed sebelumnya tidak membuat catatan, karena logika kondisionalnya tidak cocok atau pemeriksaan konflik menghentikannya, tag tersebut kosong dan pencarian tetap tidak diatur alih-alih mengambil ID feed lain.

Pemetaan Daftar Pilihan Tingkat Bidang

Untuk kolom Drop Down, Multi Select, Radio Button, dan Checkbox, Anda dapat mengambil pilihan langsung dari daftar pilihan Salesforce alih-alih mengetiknya secara manual. Dua mode per kolom:

• Isi pilihan (dapat diedit) Menyalin nilai-nilai daftar pilihan ke dalam kolom Gravity Forms sekali saja. Admin dapat mengedit atau menghapus pilihan setelahnya. Cocok untuk situasi "Saya ingin titik awal tetapi mungkin akan memangkas daftar."“
• Sinkronisasi langsung (selalu cocokkan dengan Salesforce) Memperbarui pilihan pada setiap rendering formulir. Pilihan dikunci di editor formulir untuk mencegah perubahan. Gunakan ini ketika Salesforce adalah satu-satunya sumber kebenaran (kolom status, sumber prospek, daftar pilihan Negara Bagian/Negara, dll.).

Label Salesforce ditampilkan kepada pengguna formulir; nilai Salesforce dikirimkan. Jadi formulir tersebut menampilkan "California" tetapi entri tersebut terkirim CA, persis seperti yang diharapkan oleh daftar pilihan Negara Bagian/Negara di Salesforce, dan Anda tidak memerlukan tabel pemetaan.

Tipe Rekaman juga berupa daftar pilihan di sini. Untuk objek apa pun dengan tipe rekaman yang dapat dipilih, Tipe Rekaman muncul bersamaan dengan daftar pilihan sebenarnya di UI pemetaan bidang yang sama. Formulir menampilkan nama tipe rekaman kepada pengguna (misalnya, “Donor”); nilai yang dikirimkan adalah ID Tipe Rekaman Salesforce. Petakan bidang tersebut ke RecordTypeId di feed Anda dan tipe rekaman yang dipilih akan ditetapkan pada rekaman yang dibuat atau diperbarui. Hanya tipe rekaman yang benar-benar dapat ditetapkan oleh pengguna Salesforce yang terhubung yang tercantum (tipe Master implisit dan tipe yang tidak tersedia difilter), dan mode Populate dan Live Sync didukung.

Dropdown Objek Salesforce di sidebar pemetaan bidang menyematkan delapan objek standar yang paling sering digunakan (Akun, Kontak, Prospek, Peluang, Kasus, Kampanye, Tugas, Catatan) di bagian atas daftar, sehingga Anda tidak perlu menggulir melewati setiap objek kustom di organisasi untuk menemukannya. Pada layar pengaturan feed, ubah objek atau akun dan peta bidang, pencocokan bidang, dan pemilih objek akan langsung dimuat ulang dari Salesforce tanpa menunggu penyimpanan.

Pencocokan Kunci Utama (tanpa duplikat)

Sebagian besar admin Salesforce tidak ingin setiap pengiriman formulir membuat Lead baru. Aktifkan Pencocokan Kunci Utama untuk memperbarui catatan yang sudah ada ketika ada kecocokan.

• Pilih bidang filterable, idLookup, atau externalId apa pun sebagai kunci pencocokan (Email adalah yang paling umum).
• Jika ditemukan data yang cocok, data tersebut akan diperbarui. Jika tidak, data baru akan dibuat (ketika Mode Sinkronisasi diatur ke “Buat atau perbarui jika data sudah ada”).
• Gunakan ID eksternal khusus (Customer_Reference__c) untuk pencocokan antar sistem.
• Perlindungan bawaan terhadap kondisi persaingan "rekaman yang cocok telah dihapus di Salesforce". Jika Salesforce mengembalikan kode kesalahan 404 untuk ID yang tersimpan, plugin akan secara transparan membuat rekaman baru.

Pemeriksaan Konflik

Pencocokan Kunci Utama memperbarui catatan ketika menemukannya. Terkadang Anda lebih memilih agar umpan tersebut berhenti. pemeriksaan konflik Sebelum membuat feed, sistem akan mencari record Salesforce yang sudah ada, dan berhenti jika menemukannya.

Jika pencocokan duplikat hanya bekerja pada satu kunci, pemeriksaan konflik menggabungkan beberapa kolom menjadi satu pencarian. Petakan Nama Depan dan Nama Belakang bersama-sama dan Anda akan menemukan orang yang sama mengirimkan data dengan alamat email yang berbeda, yang mana jika hanya menggunakan Email saja, data tersebut akan langsung lolos. Setiap baris yang dipetakan harus cocok dengan catatan yang sama agar proses berhenti, sehingga tumpang tindih sebagian tidak akan memicu proses tersebut.

• Petakan sebanyak mungkin kolom Salesforce ke kolom Gravity Forms sesuai kebutuhan Anda, termasuk nilai kustom.
• Tetapkan pesan konflik Anda sendiri. Pesan tersebut akan dicatat pada entri dan dikirim dalam email kegagalan, sehingga Anda dapat mengetahui mengapa catatan tersebut tidak dibuat.
• Hanya berlaku jika feed akan membuat record baru. Record yang ditemukan melalui pencocokan duplikat tetap diperbarui seperti biasa.
• Per feed, dan tersedia di akun OAuth.

Unggahan Berkas

Kolom unggahan file Gravity Forms dapat dilampirkan ke catatan Salesforce sebagai berikut: Versi Konten / Tautan Dokumen Konten, sehingga muncul di daftar terkait File pada catatan tersebut. Ukuran file maksimum dapat dikonfigurasi, 1 hingga 25 MB per file, dengan nilai default 10 MB.

Untuk melampirkan file, petakan setiap kolom Unggah File ke Berkas — lampirkan ke catatan Salesforce Tambahkan baris di Peta Bidang Salesforce pada feed. Tambahkan baris sekali untuk setiap bidang unggahan. Setiap bidang yang dipetakan akan terlampir, dan bidang multi-file akan mengirimkan setiap file yang dikandungnya. File akan diunggah pertama kali saat feed menyinkronkan entri, dan Kirim Ulang ke Salesforce akan mengirimkannya lagi setelah terjadi kegagalan.

Sinkronisasi Catatan

Masukkan data formulir ke dalam Salesforce. Catatan Terlampir pada catatan induk. Baik judul catatan maupun isi catatan mendukung tag gabungan, sehingga Anda dapat memformatnya sesuai keinginan. Biarkan isi catatan kosong dan akan menggunakan tag gabungan. {all_fields}.

Secara opsional, salin catatan entri Gravity Forms yang ditambahkan admin ke Salesforce sebagai Catatan juga, yang menjaga riwayat percakapan di satu tempat. Hapus catatan di Gravity Forms dan salinan Salesforce akan ikut terhapus.

Keanggotaan Kampanye

Tambahkan prospek atau kontak yang dibuat oleh formulir ke Salesforce. Kampanye. Centang kotak tersebut, berikan ID Kampanye (tag gabungan dapat digunakan, sehingga kolom tersembunyi dapat memilih kampanye), dan plugin akan membuat catatan CampaignMember yang menghubungkan Prospek atau Kontak baru ke Kampanye. Tetapkan status anggota Anda sendiri, atau biarkan saja dan plugin akan menggunakannya. Responded.

Penugasan Kepemilikan

Per-pakan:

• Atur kustom ID Pemilik (mendukung tag gabungan, sehingga Anda dapat melakukan routing berdasarkan nilai formulir).
• Alihkan Sforce-Auto-Assign: FALSE Header untuk melewati aturan penugasan standar bila diperlukan.

Prapengisian dari Salesforce

Kirimkan formulir yang dipersonalisasi kepada pengguna lama, yang telah diisi sebelumnya dengan data Salesforce mereka. Formulir perpanjangan, formulir pembaruan akun, alur penyelesaian profil.

• Petakan bidang Salesforce apa pun ke bidang Gravity Forms apa pun untuk pengisian otomatis. Objek pengisian otomatis secara default adalah objek yang digunakan oleh feed untuk menulis data, tetapi Anda dapat membaca dari objek yang berbeda, misalnya mengisi otomatis dari Kontak sementara feed membuat Kasus.
• Fitur isi otomatis (prefill) berfungsi untuk admin yang sudah login segera setelah diaktifkan. Untuk menggunakannya pada formulir publik, centang Izinkan permintaan pengisian otomatis publik pada formulir antarmuka pengguna. demikian juga.
• URL yang ditandatangani HMAC dengan TTL Mencegah enumerasi ID catatan pada formulir publik, dan penandatanganan diaktifkan secara default dengan masa berlaku 15 menit. Tanpa tanda tangan, siapa pun dapat melakukan iterasi. ?sfid=001000... dan mengambil data yang seharusnya tidak mereka ambil.
• Itu Generator Tautan Pra-isi Bertanda Tangan Fitur ini terintegrasi dalam pengaturan feed. Tempelkan ID catatan, dapatkan URL bertanda tangan dengan masa berlaku. Gunakan dalam email pemasaran, portal pelanggan, atau alur layanan mandiri.
• Admin yang sudah login dapat menggunakan ID record mentah tanpa tanda tangan untuk pengujian.
• Parameter kueri per-umpan (default) ?sfid=) menjaga URL tetap bersih.

Sinkronisasi Siklus Hidup Entri

Pembuatan catatan dilakukan secara otomatis setelah feed disimpan. Siklus hidup selanjutnya dapat Anda aktifkan sendiri, di bawah Formulir → Pengaturan → Salesforce → Pengaturan Sinkronisasi, sehingga integrasi hanya akan menulis kembali sebanyak yang Anda minta.

• Sunting entri → Data Salesforce diperbarui setelah opsi “Sinkronkan pembaruan saat entri diedit” diaktifkan (gform_after_update_entry).
• Hapus entri → catatan Salesforce adalah dibiarkan tak tersentuh, Selalu. Penghapusan dapat dikembalikan di WordPress, jadi catatan tetap berada di tempatnya.
• Pulihkan dari sampah → Dengan opsi “Sinkronkan ulang data entri saat entri dipulihkan dari tempat sampah/spam” diaktifkan, setiap pengeditan yang dilakukan saat entri dipindahkan ke tempat sampah akan dikirim ke catatan tersebut. Jika catatan tersebut dihapus secara manual di Salesforce dan Mode Sinkronisasi feed adalah “Buat atau perbarui jika catatan sudah ada” (default), maka akan dibuat catatan pengganti yang baru.
• Hapus entri secara permanen (Kosongkan Sampah, atau “Hapus Secara Permanen”) → catatan Salesforce akan dihapus, jika Anda telah mengaktifkan “Hapus catatan Salesforce saat entri dihapus secara permanen”.

Sinkronisasi Latar Belakang

Panggilan API Salesforce tidak berjalan saat pengunjung menunggu. Feed diproses di latar belakang setelah pengiriman selesai, menggunakan pemrosesan feed asinkron milik Gravity Forms sendiri, sehingga respons Salesforce yang lambat tidak pernah berubah menjadi halaman terima kasih yang lambat.

Begitu proses latar belakang mengambil data, entri tersebut akan berwarna biru. Tertunda status, yang digantikan oleh hasil sukses atau error akhir segera setelah Salesforce menjawab. Buka entri uji coba langsung setelah mengirimkan dan "Tertunda" mungkin adalah hal pertama yang Anda lihat. Jika feed perlu diselesaikan sebelum halaman terima kasih, misalnya untuk menampilkan {salesforce_id} di atasnya, centang Proses feed ini selama pengiriman. pada siaran tersebut.

Sadar akan Add-on Pembayaran

Jika formulir Anda menerima pembayaran melalui add-on pembayaran Gravity Forms (Stripe, PayPal Standard, PayPal Commerce, Authorize.Net, Square, 2Checkout, Mollie, dan lainnya), aktifkan “Proses feed Salesforce hanya setelah pembayaran diterima.” di bawah Tindakan Setelah Pembayaran Pada pengaturan feed add-on pembayaran (opsi ini muncul setelah formulir memiliki feed Salesforce), tunda sinkronisasi Salesforce hingga pembayaran berhasil dikonfirmasi, sehingga checkout yang dibatalkan tidak akan meninggalkan prospek yang belum matang.

Saat pengajuan, sinkronisasi Salesforce akan ditunda jika entri tersebut memiliki pembayaran yang tertunda. Ketika add-on pembayaran mengkonfirmasi transaksi (melalui kerangka kerja umpan tertunda standar Gravity Forms), sinkronisasi Salesforce akan berjalan seperti biasa. Jika pembayaran gagal atau dibatalkan, sinkronisasi tidak akan pernah berjalan.

Berfungsi dengan semua add-on pembayaran yang dibangun di atas kerangka kerja add-on pembayaran standar Gravity Forms, yaitu semua add-on resmi.

Ekspor Log & CSV

Setiap sinkronisasi Salesforce, baik berhasil maupun gagal, dicatat beserta status sinkronisasi dan pesan persis yang dikembalikan oleh Salesforce. Log Salesforce Halaman (Formulir → Log Salesforce) menampilkan:

• ID entri, formulir, status, ID catatan, pesan, dan waktu sinkronisasi.
• Filter per-formulir, dan penomoran halaman dengan 50 baris per halaman.
• Ekspor CSV dari tampilan saat ini, sehingga pemfilteran berdasarkan formulir akan mengekspor formulir tersebut.

Aktifkan pencatatan log Gravity Forms dan Anda juga akan mendapatkan muatan permintaan keluar dan pesan kesalahan yang dikembalikan Salesforce yang ditulis ke log Gravity Forms, yang biasanya merupakan cara tercepat untuk melihat dengan tepat apa yang ditolak oleh Salesforce.

Jika Anda lebih memilih untuk tidak menyimpan riwayat sinkronisasi sama sekali, “Nonaktifkan penyimpanan log entri Salesforce (status/pesan/riwayat sinkronisasi)” menghentikan perekaman dan tetap wp_gf_entry_meta ringkas. Perlu diketahui sebelum Anda mencentangnya: halaman Log Salesforce membaca dari riwayat tersebut, sehingga akan menjadi senyap dan bilah sisi entri akan turun ke tautan catatan dan tombol Kirim Ulang, dan riwayat yang ada akan dihapus saat Anda mengaktifkan pengaturan ini. ID catatan tetap ada pada entri, sehingga tag gabungan dan tautan catatan tetap berfungsi.

Notifikasi Email jika Sinkronisasi Gagal

Dapatkan notifikasi saat Salesforce menolak payload, beserta ID entri dan pesan kesalahan persis yang dikembalikan Salesforce. Centang “Kirim email pemberitahuan kesalahan” Di bawah Pelaporan Kesalahan di pengaturan Salesforce plugin, kemudian atur penerima sekali saja. Email Pemberitahuan (Jika dibiarkan kosong, secara default akan menggunakan email admin WordPress Anda).

Berguna untuk menangkap:

• Sebuah kolom wajib di Salesforce yang tiba-tiba tidak lagi terhubung (seseorang mengedit formulir).
• Nilai daftar pilihan yang sudah tidak ada lagi di Salesforce.
• Batasan API, aturan validasi, atau aturan alur kerja yang menolak catatan tersebut.
• Aplikasi Terhubung yang memerlukan otorisasi ulang

Melebihi batas permintaan API Salesforce dilaporkan sebagai pembatasan laju (rate limiting) dan bukan sebagai kegagalan pengiriman yang misterius, sehingga Anda tahu untuk menunggu daripada mulai melakukan debugging pada field map Anda.

Perbaiki masalahnya, tekan Kirim ulang ke Salesforce pada entri yang terpengaruh, dan catatan pun masuk. Alternatifnya adalah mengetahui dua minggu kemudian bahwa 30 prospek tidak pernah sampai ke CRM.

Bilah Samping Salesforce Per Entri

Setiap layar detail entri Gravity Forms menampilkan informasi khusus. Salesforce Kotak sidebar dengan status sinkronisasi secara langsung:

• Status, diberi kode warna: hijau Berhasil, merah Kesalahan, biru Tertunda, abu-abu Dilewati
• Obyek, Objek Salesforce apa yang dibuat (Lead, Contact, objek kustom, dll.)
• ID Rekaman, dapat diklik, akan langsung membuka Salesforce di tab baru.
• Akun, yang menghubungkan akun Salesforce dan menangani sinkronisasi (berguna jika Anda memiliki beberapa akun)
• Tersinkronisasi, stempel waktu dari upaya sinkronisasi terbaru
• Pesan kesalahan, pesan kesalahan persis yang dikembalikan Salesforce, jika ada.
• Hasil Umpan, rincian per-feed ketika beberapa feed berjalan pada formulir yang sama

Ini adalah cara tercepat untuk memastikan formulir benar-benar mengirimkan data ke Salesforce, dan untuk menemukan entri mana yang gagal ketika terjadi kesalahan.

Kirim ulang ke Salesforce

Setiap entri membawa sebuah Kirim ulang ke Salesforce Tombol di layar detail entri, untuk pengguna yang dapat mengelola pengaturan plugin. Fungsinya lebih dari sekadar sinkronisasi ulang catatan utama: tombol ini menghapus bendera deduplikasi efek samping sehingga catatan, file, dan keanggotaan kampanye juga dicoba ulang. Gunakan saat:

• Salesforce sedang mengalami gangguan saat sinkronisasi awal dijalankan.
• Anda memperbaiki pemetaan feed setelah sejumlah pengiriman yang gagal.
• Anda ingin mengirim data uji ke lingkungan sandbox tanpa mengirim ulang formulir.

Tag Gabungan

{salesforce_id} adalah ID catatan Salesforce yang dibuat atau diperbarui oleh feed terbaru untuk entri ini. Feed yang menggunakan mode ID Organisasi (Web-to-Lead / Web-to-Case) mengirimkan data ke endpoint yang tidak mengembalikan ID catatan, sehingga feed tersebut tidak pernah mengatur tag ini atau varian per-feed-nya.

{salesforce_id:FEED_ID} adalah ID catatan Salesforce yang dibuat oleh feed tertentu. Gunakan ini ketika beberapa feed berjalan pada formulir yang sama.

Tag khusus feed juga berfungsi di dalam pengaturan feed. Petakan kolom pencarian ke Nilai Kustom dan masuk {salesforce_id:FEED_ID} untuk menghubungkan catatan tersebut dengan catatan yang dibuat sebelumnya di feed. Feed berjalan sesuai urutan daftar feed, dan ID feed adalah fid= Nilai dalam URL pengeditan feed. Tag untuk feed yang tidak membuat catatan apa pun akan menghasilkan nilai kosong.

{salesforce_link} adalah tautan langsung ke catatan Salesforce, yang dibangun dari URL instance akun tersebut dan ID catatan, misalnya. https://yourorg.my.salesforce.com/00Q5g00000ABCDE. Salesforce kemudian mengirimkannya ke halaman catatan Lightning.

{salesforce_link:FEED_ID} Ini adalah tautan langsung ke catatan yang dibuat oleh feed tertentu. Berguna ketika sebuah formulir memiliki beberapa feed yang menulis ke organisasi Salesforce yang berbeda, misalnya satu untuk sandbox dan satu untuk produksi, karena setiap varian menggunakan URL instance akun feed tersebut.

Kedua tag tersebut berfungsi di mana pun Gravity Forms mengevaluasi tag gabungan, dengan satu aturan waktu. Feed berjalan di latar belakang setelah pengiriman selesai, sehingga pesan konfirmasi dan pemberitahuan apa pun yang dikirim saat pengiriman formulir ditampilkan sebelum catatan ada, dan tag tersebut kosong di sana. Tag tersebut terisi di mana pun Gravity Forms mengevaluasi tag gabungan setelah sinkronisasi selesai. Untuk menampilkannya di halaman konfirmasi dan dalam pemberitahuan pengiriman, centang Proses feed ini selama pengiriman. pada beranda; pengunjung kemudian menunggu Salesforce merespons. Penggunaan umum:

• Menghubungkan catatan antar-feed: pada feed berikutnya, atur pencarian seperti AccountId atau ContactId ke Nilai Kustom. {salesforce_id:FEED_ID} dari feed yang membuat record induk.
• Notifikasi yang dikirim kemudian: “Prospek baru di Salesforce → {salesforce_link}” akan terisi saat Anda menggunakan fitur Kirim Ulang Notifikasi Gravity Forms pada entri setelah sinkronisasi berjalan.
• Kode tambahan atau kode kustom apa pun yang mengevaluasi tag gabungan setelah sinkronisasi, misalnya untuk meneruskan {salesforce_id} ke sistem hilir.

Terjemahan

Plugin ini siap diterjemahkan. Anda dapat menerjemahkannya ke bahasa apa pun menggunakan layanan terjemahan gratis. Terjemahan Loco plugin atau alat terjemahan WordPress lainnya.

Bahasa default: Inggris (en_US)

FAQ

Apakah ini membutuhkan Gravity Forms?

Ya. Gravity Forms 2.7 atau versi yang lebih baru harus terpasang dan aktif. Ini adalah add-on untuk Gravity Forms, jadi tidak berfungsi sendiri.

Versi WordPress dan PHP apa saja yang didukung?

WordPress 6.5+ dan PHP 8.0+. Diuji hingga WordPress 7.0.

Bisakah saya terhubung ke Salesforce Sandbox?

Ya. Gunakan https://test.salesforce.com Gunakan URL Login Anda saat menghubungkan akun. Anda dapat memiliki akun sandbox dan akun produksi yang terhubung ke situs WordPress yang sama secara bersamaan.

Apakah ini mendukung beberapa akun Salesforce di satu situs?

Ya. Hubungkan akun sebanyak yang Anda inginkan. Setiap feed memilih akun mana yang akan disinkronkan. Kasus penggunaan umum: lingkungan sandbox dan produksi, organisasi klien agensi, atau struktur perusahaan induk dan anak perusahaan.

Bisakah saya melakukan sinkronisasi ke objek Salesforce kustom?

Ya. Di menu tarik-turun Objek Salesforce pada feed, pilih “Kustom (ketik di bawah)” dan masukkan nama API dari objek kustom Anda (misalnya, My_Object__cDaftar pilihan, unggahan file, pencarian, dan pengisian otomatis semuanya berfungsi dengan cara yang sama terhadap objek kustom. Objek kustom memerlukan akun OAuth; mode ID Organisasi terbatas pada Prospek dan Kasus.

Bisakah satu formulir membuat Akun, Kontak, dan Peluang yang saling terkait?

Ya. Tambahkan satu feed per objek dan seret feed tersebut ke dalam daftar feed: Akun terlebih dahulu, kemudian Kontak, lalu Peluang. Feed akan berjalan sesuai urutan tersebut. Pada feed Kontak dan Peluang, petakan ID Akun ke Nilai Kustom dan masuk {salesforce_id:FEED_ID} dengan ID feed Akun, yaitu fid= nilai dalam URL pengeditannya. Setiap catatan tiba dengan pencarian yang sudah mengarah ke Akun dari pengajuan yang sama. Hal yang sama berlaku untuk bidang pencarian apa pun, standar atau kustom, selama feed menggunakan akun Salesforce yang sama.

Mengapa objek Salesforce saya hilang dari menu dropdown?

Daftar objek berasal dari Salesforce dan hanya mencakup objek yang dapat dibuat oleh pengguna yang terhubung. Jika Lead, Contact, atau objek kustom hilang, berarti pengguna yang berwenang tidak memiliki izin Buat pada objek tersebut, biasanya lisensi integrasi API saja tanpa set izin yang terlampir. Perbaiki di Salesforce, lalu tunggu hingga cache objek plugin diperbarui selama enam jam; menyambungkan kembali akun tidak akan menghapusnya. “Kustom (ketik di bawah)” berfungsi sebagai solusi sementara.

Apakah ini kompatibel dengan Salesforce Pardot (Account Engagement)?

Tidak secara langsung. Plugin ini menulis catatan Salesforce standar seperti Lead dan Contact melalui Salesforce REST API dan tidak memiliki kode khusus Pardot. Jika organisasi Anda menjalankan Salesforce-Pardot Connector, Pardot akan mengambil catatan tersebut dengan cara yang sama seperti catatan Salesforce lainnya. Apa yang dimaksud dengan plugin ini? tidak Lakukan: menulis langsung ke Prospek Pardot atau Daftar Pardot, melewati Salesforce, atau berinteraksi dengan objek khusus Pardot (Pengalihan Kustom, Formulir Pardot, dll.).

Bagaimana pemetaan daftar pilihan menangani kolom Negara Bagian dan Negara dengan kode?

Plugin ini menampilkan Salesforce. label kepada pengguna formulir (misalnya, "California") tetapi mengirimkan daftar pilihan. nilai (misalnya, CA), persis seperti yang dibutuhkan oleh daftar pilihan Negara Bagian/Negara di Salesforce, jadi Anda tidak memerlukan tabel terjemahan di pihak Anda.

Apa perbedaan antara mode Populate dan Live Sync untuk daftar pilihan?

• Mengisi Fungsi ini menyalin nilai-nilai picklist Salesforce ke dalam kolom formulir Anda sekali saja. Setelah itu, Anda dapat mengedit, memangkas, atau mengatur ulang pilihan-pilihan tersebut. Ini berguna ketika Anda menginginkan titik awal tetapi mungkin ingin menyempurnakan daftar tersebut.
• Sinkronisasi Langsung Plugin ini menerapkan kembali pilihan Salesforce pada setiap rendering formulir, sehingga perubahan di Salesforce akan muncul pada formulir secara otomatis setelah cache bidang plugin diperbarui setiap enam jam. Editor formulir mengunci pilihan untuk mencegah perubahan yang tidak disengaja. Ini berguna ketika Salesforce adalah satu-satunya sumber data yang akurat (bidang status, sumber prospek, daftar negara, dll.).

Bisakah saya mengizinkan pengguna formulir untuk memilih Tipe Rekaman Salesforce?

Ya. Buka bidang Drop Down / Multi Select / Radio / Checkbox, aktifkan Pemetaan Bidang Salesforce, pilih objek, dan pilih Tipe Rekaman dari daftar bidang. Formulir akan menampilkan nama tipe rekaman (misalnya, “Donor”) kepada pengguna; nilai yang dikirimkan adalah ID Tipe Rekaman Salesforce. Kemudian petakan bidang Gravity Forms tersebut ke RecordTypeId dalam pemetaan feed Anda sehingga tipe rekaman yang dipilih ditetapkan pada rekaman yang dibuat atau diperbarui. Hanya tipe rekaman yang tersedia untuk pengguna Salesforce yang terhubung yang akan tercantum.

Bisakah saya menghindari pembuatan data duplikat?

Ya, dengan dua cara. Aktifkan Pencocokan Kunci Utama Di pengaturan feed, pilih kolom unik (Email adalah yang paling umum, atau ID eksternal kustom lainnya). Feed akan memperbarui catatan yang sudah ada jika ada kecocokan, dan membuat yang baru jika tidak ada kecocokan.

Jika Anda lebih memilih agar umpan berhenti daripada menulis apa pun, gunakan pemeriksaan konflik Sebaliknya, fitur ini menggabungkan beberapa kolom menjadi satu pencarian, sehingga memetakan Nama Depan dan Nama Belakang bersama-sama akan mendeteksi orang yang sama yang mengirimkan data dengan alamat email yang berbeda. Ketika setiap baris yang dipetakan cocok dengan catatan yang sama, proses akan berhenti dan pesan konflik akan dicatat pada entri tersebut.

Apa perbedaan antara pencocokan kunci utama dan pengecekan konflik?

Pencocokan kunci utama menemukan sebuah catatan dan pembaruan Pemeriksaan konflik menemukan sebuah catatan dan berhenti. Gunakan pencocokan ketika pengiriman berulang harus menjaga satu catatan tetap terkini; gunakan pemeriksaan konflik ketika pengiriman kedua adalah masalah yang ingin Anda ketahui daripada ditangani. Keduanya bekerja bersama: pemeriksaan konflik hanya dijalankan ketika feed akan membuat catatan, sehingga catatan yang ditemukan oleh pencocokan duplikat tetap diperbarui seperti biasa.

Bisakah saya mengisi formulir secara otomatis dengan data Salesforce yang sudah ada?

Ya. Aktifkan Prapengisian dari Salesforce Pada feed, petakan kolom Salesforce yang ingin Anda tarik. Untuk formulir publik, centang juga Izinkan permintaan pengisian otomatis publik pada formulir antarmuka pengguna., jika tidak, pengisian otomatis hanya akan berjalan untuk admin yang sudah login. Kemudian kirimkan URL seperti ini kepada pengguna. ?sfid=001XXXXXXXXXXXX. Permintaan yang ditandatangani diperlukan secara default dengan masa berlaku 15 menit; gunakan fitur bawaan. Generator Tautan Pra-isi Bertanda Tangan untuk membuat URL tersebut untuk kampanye email atau alur layanan mandiri.

Apakah mengedit entri akan memperbarui catatan Salesforce?

Setelah Anda mengaktifkannya, ya. Pembaruan entri, penghapusan permanen, sinkronisasi ulang pemulihan dari tempat sampah, dan sinkronisasi catatan entri masing-masing memiliki kotak centang tersendiri di bawah Formulir → Pengaturan → Salesforce → Pengaturan Sinkronisasi, dan semuanya sudah aktif sejak awal. Membuat catatan tidak memerlukan pengaturan apa pun selain menyimpan feed; apa pun yang menulis kembali ke catatan yang sudah ada bersifat opsional, sehingga plugin tidak pernah menyentuh organisasi Anda dengan cara yang tidak Anda minta.

Apa yang terjadi jika saya menghapus sebuah entri, lalu memulihkannya?

Data Salesforce tetap tersimpan selama siklus penghapusan/pemulihan. Hanya penghapusan permanen Menghapus catatan Salesforce, dan hanya jika Anda telah mengaktifkan opsi tersebut di pengaturan plugin. Ini sesuai dengan perilaku asli WordPress: penghapusan dari tempat sampah dapat dikembalikan, penghapusan permanen tidak.

Mengapa entri saya menampilkan status "Tertunda" berwarna biru?

Itu normal, dan biasanya akan hilang saat Anda menyegarkan halaman. Proses feed berjalan di latar belakang sehingga panggilan API Salesforce tidak pernah menghambat pengiriman formulir. Tepat sebelum memanggil Salesforce, tugas latar belakang menandai entri sebagai Tertunda, lalu menimpa status tersebut dengan status berhasil atau kesalahan segera setelah Salesforce merespons. Status yang tetap Tertunda berarti tugas telah dimulai tetapi tidak pernah selesai, biasanya karena batas waktu PHP atau kesalahan fatal di tengah permintaan, jadi aktifkan pencatatan log Gravity Forms dan periksa log add-on. Jika feed seharusnya berjalan tetapi entri tidak menunjukkan status Salesforce sama sekali, antrean tidak pernah menjalankannya, yang biasanya berarti situs memblokir permintaan loopback ke admin-ajax.php dan WP-Cron, sebagai alternatif, dinonaktifkan.

Bisakah saya mencoba ulang sinkronisasi yang gagal?

Ya. Buka layar detail entri dan klik Kirim ulang ke Salesforce. Ini juga menghapus tanda deduplikasi efek samping, sehingga catatan, file, dan keanggotaan kampanye akan dicoba ulang bersamaan dengan catatan utama.

Apakah ini berfungsi dengan add-on pembayaran (Stripe, PayPal, dll.)?

Ya. Umpan add-on pembayaran (Stripe, PayPal, dan sebagainya) mendapatkan Tindakan Setelah Pembayaran bagian dengan “Proses feed Salesforce hanya setelah pembayaran diterima.” Kotak centang yang menunda sinkronisasi Salesforce hingga add-on pembayaran mengkonfirmasi transaksi yang berhasil, sehingga proses checkout yang dibatalkan tidak akan pernah meninggalkan prospek yang belum matang.

Apakah ini mendukung unggahan file dari Gravity Forms?

Ya. Kolom unggahan file Gravity Forms dapat dilampirkan ke catatan Salesforce sebagai ContentVersion / ContentDocumentLink, sehingga muncul di daftar terkait File catatan tersebut. Ukuran file maksimum dapat dikonfigurasi, 1 hingga 25 MB per file, defaultnya adalah 10 MB.

Bisakah saya menghentikan plugin untuk menyimpan riwayat sinkronisasi?

Ya. Centang “Nonaktifkan penyimpanan log entri Salesforce (status/pesan/riwayat sinkronisasi)” di pengaturan plugin dan tidak ada status, pesan, atau stempel waktu sinkronisasi yang ditulis ke wp_gf_entry_meta. Ada dua hal yang perlu diketahui terlebih dahulu: halaman Log Salesforce dibangun dari riwayat tersebut, jadi halaman tersebut berhenti menampilkan hasil dan bilah sisi entri turun ke tautan catatan dan tombol Kirim Ulang, dan riwayat yang ada akan dihapus saat Anda mengaktifkan pengaturan tersebut. ID catatan dan ID akun masih tersimpan, sehingga tag gabungan, tautan catatan, dan Kirim Ulang tetap berfungsi.

Bagaimana cara saya menyesuaikan payload Salesforce secara terprogram?

Gunakan pb_gfsf_payload menyaring:

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    // $context['feed'], ['entry'], ['form'], ['object'], ['account_id'], ['method']
    return $payload;
}, 10, 2 );

Informasi lengkap mengenai feed, entri, formulir, objek target, ID akun, dan metode koneksi (oauth atau org_id) tersedia di $context sehingga Anda dapat membuat keputusan berdasarkan salah satu dari pilihan tersebut.

Bagaimana jika organisasi Salesforce saya tidak memiliki akses API?

Menggunakan Mode ID Organisasi. Ini menggunakan endpoint Web-to-Lead / Web-to-Case lama dari Salesforce, bukan REST API. Keterbatasan: hanya objek Lead dan Case yang didukung, dan Anda tidak mendapatkan pembaruan, penghapusan, unggahan file, pengisian otomatis, atau pemetaan daftar pilihan. Untuk sebagian besar pengaturan produksi, OAuth (default) adalah pilihan yang tepat.

Kebijakan Salesforce OAuth apa saja yang didukung oleh plugin ini?

Plugin ini menggunakan alur Kode Otorisasi OAuth 2.0 dengan PKCE dan mendukung Rotasi Token Penyegaran, sehingga Anda dapat mengaktifkannya di Aplikasi Terhubung atau Aplikasi Klien Eksternal tanpa memutuskan koneksi. Satu-satunya Kebijakan Token Penyegaran yang tidak kompatibel adalah “Token penyegaran segera kedaluwarsa”, yang memaksa otorisasi ulang penuh setiap kali token akses kedaluwarsa dan tidak kompatibel dengan integrasi tanpa pengawasan apa pun.

Bagaimana koneksi OAuth tetap dalam keadaan login?

Plugin ini menggunakan OAuth 2.0 dengan PKCE dan memperbarui token akses secara otomatis menggunakan token penyegaran. Selama kebijakan token penyegaran Aplikasi Terhubung atau Aplikasi Klien Eksternal tidak membuatnya kedaluwarsa ('berlaku hingga dicabut', atau masa berlaku tetap yang lama seperti 365 hari dalam panduan pengaturan kami), koneksi tetap aktif. Ketika token penyegaran kedaluwarsa, Anda menghubungkan kembali akun sekali. Jika koneksi terputus, lihat pertanyaan berikutnya. Hampir selalu ini disebabkan oleh kebijakan atau pengaturan cakupan Aplikasi Terhubung. Rotasi Token Penyegaran didukung, sehingga administrator yang sadar akan keamanan juga dapat mengaktifkan kebijakan tersebut.

Koneksi Salesforce terus terputus dan saya harus menyambungkan kembali. Mengapa?

Hampir selalu ada tiga kemungkinan penyebab di sisi Salesforce. Kebijakan Token Refresh Aplikasi Terhubung diatur untuk kedaluwarsa, bukan "berlaku hingga dicabut". Aplikasi tersebut diatur ke "Akses penuh (full)", yang tidak pernah mengeluarkan token refresh. Atau rentang IP login memblokir server Anda, dalam hal ini Salesforce menolak setiap refresh dan menyambungkan kembali dari server yang sama tidak akan membantu. Mulai versi 1.3.0, layar Akun menyebutkan akun mana yang bermasalah, alih-alih menampilkan kesalahan sesi umum, dan mencatat kapan setiap akun terakhir kali di-refresh, terakhir kali berhasil, dan terakhir kali gagal.

Apakah data akan terhapus saat saya mencopot pemasangan plugin?

Hanya jika Anda memilih untuk ikut serta. Aktifkan “Hapus semua data plugin saat mencopot pemasangan” di pengaturan plugin sebelum menghapus instalasi. Secara default, log sinkronisasi dan pengaturan koneksi Anda akan dipertahankan (sehingga Anda tidak kehilangan riwayat jika Anda mengaktifkannya kembali nanti).

Apakah ini berfungsi dengan caching/CDN?

Ya. Plugin ini berjalan sepenuhnya di sisi server saat formulir dikirim, jadi pengaturan caching dan CDN tidak mengganggu sinkronisasi Salesforce. JavaScript editor formulir hanya dimuat di dalam admin WordPress (di mana caching biasanya dinonaktifkan).

Apakah ini berfungsi dengan jaringan WordPress Multisite?

Ringkasan singkat:

• Lisensi tak terbatas: Aktifkan Mode Jaringan sekali saja; satu tombol dapat mengelola pengaturan dan dukungan untuk setiap sub-situs.
• Mode Jaringan aktif: Setiap sub-situs mewarisi kunci jaringan, sehingga semuanya dapat menjalankan feed Salesforce dan menerima pembaruan secara langsung. Mengaktifkan plugin di jaringan saja tidak memberikan lisensi kepada sub-situs.
• Paket terbatas / tanpa lisensi sub-situs: Pengaturan Salesforce di sub-situs tersebut terkunci dan log feed-nya menampilkan pesan “Sinkronisasi Salesforce tidak tersedia hingga lisensi plugin aktif” alih-alih melakukan sinkronisasi.
• Dukungan mengikuti lisensi: Situs-situs yang tercakup oleh kunci aktif memenuhi syarat.

Jika Anda memiliki lisensi Unlimited, Anda dapat mengaktifkan Mode Jaringan dari situs utama dan mengirimkan kunci tunggal tersebut ke setiap sub-situs dalam satu batch (dengan kemajuan langsung). Sub-situs tersebut akan mewarisi pengaturan dan dukungan yang dikelola lisensi secara otomatis.

Kait

Filter

pb_gfsf_payload

Saring muatan data yang akan dikirim ke Salesforce. Proses ini berjalan untuk setiap pembuatan dan pembaruan di setiap feed, dengan konteks sinkronisasi lengkap (konfigurasi feed, entri, formulir, objek target, akun, dan metode koneksi). Proses ini dijalankan setelah pemetaan bidang dan ID pemilik diterapkan tetapi sebelum panggilan API, dan mengembalikan array kosong diperlakukan sama seperti feed tanpa bidang yang dipetakan.

Parameter:

• $payload (array): array asosiatif nama field Salesforce → nilai yang akan dikirim.
• $context (array): sinkronisasi konteks. Kunci: feed, entry, form, object, account_id, method (oauth untuk koneksi OAuth, org_id (untuk Web-to-Lead/Case).

Contoh: tetapkan LeadSource default pada setiap Lead.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    if ( $context['object'] === 'Lead' && ! isset( $payload['LeadSource'] ) ) {
        $payload['LeadSource'] = 'WordPress Form';
    }
    return $payload;
}, 10, 2 );

Contoh: mengarahkan feed yang berbeda ke RecordType yang berbeda.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    $feed_id = (int) ( $context['feed']['id'] ?? 0 );
    if ( $feed_id === 12 ) {
        $payload['RecordTypeId'] = '0125g000000XYZAAA';
    }
    return $payload;
}, 10, 2 );

Contoh: tulis ulang LeadSource berdasarkan ID formulir.

add_filter( 'pb_gfsf_payload', function ( $payload, $context ) {
    $form_id = (int) ( $context['form']['id'] ?? 0 );
    $payload['LeadSource'] = match ( $form_id ) {
        7  => 'Webinar Signup',
        12 => 'Demo Request',
        default => 'Website',
    };
    return $payload;
}, 10, 2 );

pb_gfsf_multi_value_delimiter

Ubah pemisah yang digunakan untuk menggabungkan pilihan pada kolom Pilihan Ganda atau Kotak Centang. Secara default menggunakan titik koma yang dipersyaratkan oleh daftar pilihan ganda Salesforce. Ganti pengaturan ini jika salah satu kolom tersebut dipetakan ke kolom teks biasa yang membutuhkan pemisah lain.

Parameter:

• $delimiter (rangkaian): pemisah, ; secara default.
• $sf_field (rangkaian): Nama API field Salesforce sedang ditulis.
• $raw_value (rangkaian): ID kolom Gravity Forms yang dipetakan atau tag gabungan.
• $feed (array)Objek umpan Gravity Forms.

add_filter( 'pb_gfsf_multi_value_delimiter', function ( $delimiter, $sf_field ) {
    return 'Interests__c' === $sf_field ? ', ' : $delimiter;
}, 10, 2 );

pb_gfsf_allowed_salesforce_domains

Add-on ini memeriksa setiap URL login, URL instance, dan URL Web-to-Lead terhadap domain Salesforce sendiri sebelum mengirimkan kredensial atau data entri ke sana. Daftar defaultnya adalah salesforce.com, force.com, cloudforce.com dan salesforce.mil, dicocokkan berdasarkan batas titik. Tambahkan jika organisasi Anda diakses melalui domain Salesforce kustom.

Parameter:

• $domains (array): akhiran yang dapat didaftarkan, dicocokkan pada batas titik.
• $url (rangkaian): URL yang sedang diperiksa.

add_filter( 'pb_gfsf_allowed_salesforce_domains', function ( $domains ) {
    $domains[] = 'example-crm.com';
    return $domains;
} );

pb_gfsf_http_timeout

Ubah batas waktu, dalam detik, yang diterapkan pada setiap permintaan ke Salesforce. Nilai default adalah 20. Situs dengan jaringan lambat atau yang mengirimkan unggahan file besar mungkin memerlukan waktu lebih lama; waktu kurang dari satu atau dua detik akan mengganggu operasi normal.

add_filter( 'pb_gfsf_http_timeout', function () {
    return 45;
} );