Skip to main content

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.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
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 menetapkan webhook.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 menerima emails 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 menerima value 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_amount langganan ke value peluang, dan interval penagihannya ke value_period.
  • Gunakan ID untuk menghubungkan catatan: simpan customer_id Dodo Payments pada kontak Close, dan ID prospek Close pada metadata Dodo Payments.
  • Contoh kontak berjalan pada setiap payment.succeeded, termasuk perpanjangan dan pembelian berulang, sehingga pelanggan yang kembali akan membuat kontak lain.

Pemecahan Masalah

  • 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 header Authorization pada tab Advanced endpoint.
  • Buka upaya pengiriman endpoint pada tab Logs di Developer → Webhooks untuk melihat respons dari Close.
  • 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_.
Terakhir diubah pada 26 September 2026