Cara Mengirim Proyek dari Home Planner ke CRM Anda

Hubungkan HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets, atau sistem Anda sendiri, lalu kirim proyek beserta ruangan, produk, harga, dan denah lantai dalam satu langkah mudah.

Setiap proyek yang Anda kirim akan masuk ke CRM sebagai satu entri data: tautan proyek, ruangan, produk beserta SKU, jumlah, harga, total biaya, dan denah lantai berbentuk PDF. Tidak perlu menyalin dari tangkapan layar atau mengetik ulang estimasi biaya.
Panduan ini menjelaskan cara menghubungkan HubSpot, Pipedrive, Bitrix24, Salesforce, atau Google Sheets melalui Zapier, serta cara menghubungkan sistem lain menggunakan URL sistem tersebut.
Cara kerja
- Cukup hubungkan sekali. Tambahkan koneksi di dalam aplikasi: pilih CRM Anda atau tempel URL sistem yang Anda miliki.
- Desain. Rancang tata letak ruangan bersama klien, lalu lengkapi dengan produk dan harga.
- Kirim. Buka proyek, lalu pilih Bagikan → Kirim ke …. Proyek akan masuk ke CRM Anda dalam hitungan detik.
Sebelum memulai
| Persyaratan | Alasan |
|---|---|
| Paket PRO++ atau uji coba gratis | Fitur pengiriman proyek ke CRM adalah bagian dari paket PRO++. Jika belum berlangganan PRO++, pembuatan koneksi pertama akan otomatis memulai uji coba gratis selama 14 hari tanpa perlu membayar. |
| Akun Home Planner | Data koneksi tersimpan di akun Anda dan berlaku di semua perangkat. Aplikasi akan meminta Anda masuk (sign in) saat menyimpan koneksi pertama. |
| Proyek tersimpan di cloud | Proyek yang hanya tersimpan di perangkat ini tidak dapat dikirim, karena entri CRM memerlukan tautan ke salinan proyek versi daring. |
| Akun Zapier (khusus HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets) | Zapier berfungsi meneruskan data proyek ke CRM Anda. Zapier menyediakan paket gratis dan berbayar. Per Oktober 2026, integrasi Salesforce memerlukan paket Zapier berbayar (lihat harga Zapier). |
Menghubungkan CRM melalui Zapier
Langkahnya sama untuk semua sistem. Perbedaannya hanya terletak pada tindakan (action) CRM pada langkah ke-5 di Zapier — lihat tabel di bawah.
Di aplikasi Home Planner
- Buka Pengaturan → Bisnis → CRM & lembar kerja. Atau, buka proyek apa saja lalu pilih Bagikan → CRM & lembar kerja.
- Pilih Tambah koneksi, lalu pilih sistem yang Anda gunakan.
- Pilih Salin kunci. Kunci ini menghubungkan Zapier ke akun Home Planner Anda. Jika Anda belum berlangganan PRO++, tindakan ini akan memulai masa uji coba gratis selama 14 hari.
Di Zapier
- Tambahkan Home Planner ke akun Zapier Anda. Saat ini aplikasi Home Planner sedang dalam proses peninjauan di Zapier. Sebelum resmi terdaftar, kirim email kepada kami untuk meminta undangan — kami akan membalasnya dengan tautan. Jika aplikasi menampilkan tombol Buka Zap siap pakai, pilih tombol tersebut karena pemicu (trigger) dan langkah CRM Anda sudah terkonfigurasi.
- Buat Zap baru dengan pemicu Home Planner → Project Sent.
- Hubungkan akun baru, lalu tempel kunci ke kolom Connection key. Zapier akan menampilkan nama koneksi dari aplikasi.
- Uji pemicu tersebut. Zapier akan memuat contoh proyek agar Anda dapat memetakan kolom data sebelum melakukan pengiriman pertama.
- Tambahkan tindakan untuk CRM Anda dan petakan kolom datanya (lihat tabel).
- Aktifkan Zap. Kembali ke aplikasi, status koneksi akan berubah menjadi Bekerja. Jika status masih menampilkan "Zap belum aktif", matikan Zap lalu aktifkan kembali.
| Sistem | Tindakan Zapier | Saran pemetaan |
|---|---|---|
| HubSpot | Buat deal | Project name → deal name; totals.sum → amount; Project link, Products (text), dan PDF link → description |
| Pipedrive | Buat deal | Project name → title; totals.sum dan totals.currency → value; Products (text) → note |
| Bitrix24 | Create Deal atau Create Lead | Nama proyek → judul; totals.sum → jumlah; Products (text) → komentar |
| Salesforce | Buat record → opportunity | Project name → name; totals.sum → amount; Project link → description. Memerlukan paket Zapier berbayar (per Oktober 2026). |
| Google Sheets | Buat baris spreadsheet | Project name, totals.sum, Project link, dan updated → kolom terpisah, satu baris per proyek terkirim |
Mengirim proyek
- Buka proyek. Pastikan estimasi biaya sudah siap: produk, jumlah, dan harga sudah sesuai dengan yang akan dilihat oleh klien.
- Pilih Bagikan → Kirim ke …. Setiap koneksi yang aktif memiliki barisnya sendiri, misalnya Kirim ke HubSpot.
- Periksa hasilnya. Aplikasi akan menampilkan pesan Proyek terkirim ke HubSpot beserta jumlah ruangan dan produk. Jika sistem Anda tidak merespons, aplikasi akan menampilkan pesan Akan dicoba lagi secara otomatis: Home Planner akan mencoba mengirim ulang setelah 1 menit, 10 menit, dan 1 jam.
Mengirim proyek yang sama dua kali? Proyek tanpa perubahan yang dikirim ulang dalam waktu 24 jam tidak akan terduplikasi. Jika ada perubahan (harga, jumlah, atau denah), pengiriman berikutnya akan membuat entri data baru.
Isi entri data
Kolom data yang sama akan dikirim ke Zapier maupun ke URL sistem Anda. Harga dan total biaya akan disesuaikan dengan estimasi biaya proyek di aplikasi.
| Kolom | Isi data |
|---|---|
| namaPlan | Nama proyek |
| revisionUrl | Tautan ke proyek versi daring. Klien Anda dapat membukanya melalui peramban atau aplikasi. |
| pdfUrl | Denah lantai berbentuk PDF. Tersedia jika denah Anda mendukung ekspor gambar; berkas disimpan selama 7 hari — simpan berkas ini ke CRM Anda. |
| totals.sum, totals.currency, totals.items | Total estimasi biaya, mata uang, dan jumlah baris rincian |
| teksProduk | Seluruh rincian estimasi dalam bentuk teks yang mudah dibaca: ruangan, produk, SKU, serta jumlah × harga. Cocok untuk kolom catatan atau deskripsi. |
| ruangan[] | Setiap ruangan: nama, tipe, luas, ukuran, dan item di dalamnya |
| ruangan[].items[] | Setiap produk atau material: itemNumber (SKU), nama, jumlah, harga, total, imageURL, dan komponen |
| client_reference_id | ID unik untuk pengiriman ini |
| created, updated | Waktu saat proyek dibuat dan terakhir disimpan |
Contoh productsText:
Living room:
- Sofa Oslo (SOFA-1042): 1 × 899.00 = 899.00 USD
- Cushion (CUSH-17): 2 × 25.00 = 50.00 USD
- Oak flooring (Floor_Oak_01): 1 × 540.00 = 540.00 USD
Total: 1489.00 USDMenghubungkan sistem Anda menggunakan URL (webhook)
Fitur ini digunakan untuk sistem yang tidak ada di dalam daftar atau untuk server Anda sendiri. Home Planner akan mengirimkan entri data berformat JSON ke alamat HTTPS Anda.
- Pilih Tambah koneksi → Sistem lain (URL Anda). Masukkan nama tombol (maksimal 24 karakter) dan URL sistem. Alamat URL harus diawali dengan https://.
- Aplikasi akan mengirimkan permintaan uji coba dan menampilkan pesan, misalnya Terverifikasi: respons 200 dalam 0,4 d.
- Disarankan: salin Rahasia penandatanganan dan gunakan untuk memverifikasi setiap permintaan yang masuk ke server Anda.
Struktur permintaan
| Bagian | Nilai |
|---|---|
| Metode, isi (body) | POST, Content-Type: application/json, entri data seperti yang dijelaskan di atas |
| X-HomePlanner-Signature | t=<waktu unix>,v1=<heksadesimal>, dengan v1 = HMAC-SHA256(secret, t + "." + body) |
| X-HomePlanner-Delivery | ID pengiriman. Nilai ini tidak berubah saat percobaan ulang — gunakan untuk mengabaikan pengiriman ganda. |
Verifikasi tanda tangan menggunakan isi permintaan mentah (raw request body) persis seperti yang diterima, sebelum melakukan penguraian (parsing) JSON. Isi permintaan yang sudah diurai lalu diserialisasi ulang tidak akan cocok dengan tanda tangan.
const crypto = require('crypto');
// rawBody: the request body exactly as received (Buffer or string), before JSON parsing.
// Express: app.post('/home-planner', express.raw({ type: 'application/json' }), handler)
function isFromHomePlanner(rawBody, header, secret) {
if (!header) return false;
const parts = Object.fromEntries(header.split(',').map(p => p.split('=', 2)));
if (!parts.t || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
const expected = Buffer.from(
crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex'), 'hex');
const received = Buffer.from(parts.v1, 'hex');
return expected.length === received.length && crypto.timingSafeEqual(expected, received);
}Respons server Anda
- Kode status 2xx apa pun yang diterima dalam 15 detik dianggap berhasil terkirim.
- Jika tidak ada respons, atau menerima kode 5xx, 408, atau 429: Home Planner akan mencoba mengirim ulang setelah 1 menit, 10 menit, dan 1 jam, lalu berhenti setelah 2 jam.
- Kode 4xx lainnya, pengalihan (redirect), atau kesalahan sertifikat bersifat permanen: status koneksi akan berubah menjadi Gagal. Pengalihan alamat tidak akan diikuti.
- Alamat dalam jaringan pribadi atau lokal tidak diizinkan, misalnya localhost, 127.*, 10.*, 172.16–31.*, 192.168.*, dan 169.254.*.
Google Sheets tanpa Zapier. Aplikasi web Google Apps Script dapat digunakan sebagai URL. Respons status 302 yang umum ke script.googleusercontent.com tetap dihitung sebagai terkirim.
Status dan pesan kesalahan
| Di aplikasi | Arti | Tindakan |
|---|---|---|
| Bekerja | Proyek berhasil terkirim ke Zapier atau ke URL Anda. | Tidak ada. |
| Terhubung | Skenario sudah terhubung; proyek akan masuk selama skenario aktif. | Biarkan skenario tetap aktif. |
| Zap belum aktif | Zapier belum berlangganan ke kunci ini. | Aktifkan Zap. Jika sudah aktif, matikan lalu aktifkan kembali. |
| Nonaktif | Anda mematikan koneksi ini. Baris pada menu Bagikan akan disembunyikan. | Aktifkan kembali melalui pengaturan koneksi. |
| Gagal | Pengiriman terakhir gagal. Alasan kegagalan ditampilkan di bawah status. | Perbaiki masalahnya, lalu kirim ulang dari menu Bagikan. |
| Server tidak merespons | Tidak ada respons dalam waktu 15 detik. | Pastikan server Anda berjalan dengan baik. |
| Respons server: 404 | Sistem Anda menolak permintaan. | Periksa kembali URL dan log server Anda. |
| Sertifikat situs gagal diverifikasi | Sertifikat HTTPS kedaluwarsa atau tidak valid. | Perbarui sertifikat Anda. |
| Gagal mengirimkan selama 2 jam, pengiriman dihentikan | Semua percobaan ulang gagal. | Perbaiki sistem penerima, lalu kirim ulang. |
| Proyek ini hanya tersimpan di perangkat ini | Proyek belum tersimpan di cloud. | Aktifkan penyimpanan cloud untuk proyek ini. |
Tanya jawab
Berapa biayanya?
Fitur pengiriman ke CRM sudah termasuk dalam paket PRO++. Jika Anda belum pernah berlangganan PRO++, pembuatan koneksi pertama akan memulai masa uji coba gratis selama 14 hari. Zapier menyediakan paket gratis dan berbayar. Per Oktober 2026, integrasi Salesforce memerlukan paket Zapier berbayar: periksa harga Zapier.
Apa yang terjadi jika masa uji coba atau paket PRO++ habis?
Baris Kirim ke … akan hilang dari menu Bagikan. Data koneksi Anda tetap tersimpan; Anda masih dapat mematikan atau menghapusnya. Jika Anda berlangganan PRO++ kembali, koneksi akan langsung berfungsi tanpa perlu pengaturan ulang.
Berapa banyak koneksi yang bisa saya buat?
Hingga 3 koneksi, misalnya HubSpot untuk kesepakatan (deal) dan Google Sheets untuk pencatatan harga.
Saya membuat kunci baru. Mengapa proyek berhenti terkirim?
Kunci baru akan langsung menonaktifkan kunci lama secara otomatis. Tempel kunci baru ke Zapier, lalu matikan dan aktifkan kembali Zap Anda.
Beberapa produk tidak memiliki SKU. Data apa yang dikirimkan?
Produk tersebut akan dikirimkan menggunakan kode produk bawaan Home Planner. Aplikasi akan memberi tahu jumlahnya setelah pengiriman selesai.
Apakah klien saya dapat melihat data ini?
Tidak. Entri data hanya dikirim ke koneksi yang Anda atur (Zapier atau URL Anda). Klien hanya dapat melihat proyek jika Anda membagikan tautannya secara langsung.
Apakah data CRM saya aman?
Home Planner hanya mengirimkan data — aplikasi tidak pernah membaca data di CRM Anda. Anda dapat memperbarui kunci atau rahasia penandatanganan kapan saja dengan memilih Kunci baru atau Rahasia baru.
Pemberitahuan merek dagang. Home Planner adalah entitas independen dari HubSpot, Inc. serta tidak didukung, disponsori, atau terafiliasi dengan HubSpot, Inc. Home Planner juga independen dari merek lain yang disebutkan di halaman ini serta tidak didukung, disponsori, atau terafiliasi dengan merek-merek tersebut.
Coba pada proyek Anda sendiri
Aplikasi desain interior dan perencana ruangan gratis


