Pendahuluan
Integrasi Close CRM membuat catatan di Close dari event Dodo Payments. Pembayaran yang berhasil dapat membuat kontak, dan langganan baru dapat membuat peluang, sehingga tim penjualan Anda dapat melihat aktivitas pendapatan di samping prospeknya.Integrasi ini memerlukan API key Close dengan izin untuk membuat kontak dan peluang. Untuk membuatnya di Close, buka Settings → Developer → API Keys dan klik New API Key.
Memulai
1
Open the Webhook Section
Di dashboard Dodo Payments, buka Developer → Webhooks lalu klik Add endpoint.

2
Select Close CRM
Di Integration, pilih CloseCRM.
3
Enter API Key
Di API key, tempel API key Close Anda. Dodo Payments mengirimkannya di header
Authorization pada setiap pengiriman.4
Select Events
Di Subscribed events, pilih event yang ditangani transformasi Anda. Contoh di halaman ini menggunakan
payment.succeeded dan subscription.active.5
Configure Transformation
Di bagian Transformation code, edit handler untuk memetakan data pembayaran ke objek Close. Mulai dari contoh.
6
Test & Create
Di bagian Test this code, klik Simulate untuk menjalankan handler terhadap payload contoh. Kemudian klik Create endpoint.
7
Done
Setiap event yang dilanggani kini membuat catatan di Close.
Contoh Kode Transformasi
Setiap handler menetapkanwebhook.url ke endpoint API Close dan mengganti webhook.payload dengan isi request. Close menetapkan field kustom melalui key custom.cf_<field_id>, jadi ganti key cf_ dalam contoh dengan ID field kustom Anda sendiri. Jumlah Dodo Payments menggunakan unit mata uang terkecil, misalnya sen untuk USD.
Membuat Kontak dari Pembayaran
Saat pembayaran berhasil, buat kontak. Close menerimaemails dan phones sebagai daftar objek. Jika request tidak memiliki lead_id, Close membuat prospek baru yang diberi nama sesuai kontak.
create_contact.js
Membuat Peluang dari Langganan
Saat langganan menjadi aktif, buat peluang. Close menerimavalue sebagai bilangan bulat dalam sen dan value_period sebagai one_time, monthly, atau annual, sehingga contoh ini memetakan payment_frequency_interval langganan ke suatu periode. lead_id harus berupa ID prospek Close, bukan ID pelanggan Dodo Payments. Contoh ini membacanya dari metadata langganan, jadi simpan ID prospek di sana saat Anda membuat langganan. Tanpa lead_id, Close membuat prospek baru tanpa nama.
create_opportunity.js
Tips
- Periksa nama dan tipe field dalam dokumentasi API Close sebelum memetakan field.
- Simpan data khusus pembayaran, seperti jumlah dan metode pembayaran, dalam field kustom. Buat field tersebut di Close terlebih dahulu, lalu gunakan ID-nya.
- Petakan
recurring_pre_tax_amountlangganan kevaluepeluang, dan interval penagihannya kevalue_period. - Gunakan ID untuk menghubungkan catatan: simpan
customer_idDodo Payments pada kontak Close, dan ID prospek Close padametadataDodo Payments. - Contoh kontak berjalan pada setiap
payment.succeeded, termasuk perpanjangan dan pembelian berulang, sehingga pelanggan yang kembali akan membuat kontak lain.
Pemecahan Masalah
Records Not Created in Close CRM
Records Not Created in Close CRM
- Pastikan API key memiliki izin tulis.
- Pastikan field yang diperlukan disertakan.
- Pastikan setiap alamat email valid.
- Tinjau batas rate API Close.
- Jika pengiriman gagal dengan
401, Close mungkin mengharapkan autentikasi Basic. Sesuaikan headerAuthorizationpada tab Advanced endpoint. - Buka upaya pengiriman endpoint pada tab Logs di Developer → Webhooks untuk melihat respons dari Close.
Transformation Errors
Transformation Errors
- Pastikan payload sesuai dengan format API Close.
- Pastikan semua field yang diperlukan tersedia.
- Pastikan nama field sama persis dengan skema Close, dan field kustom menggunakan ID
custom.cf_.