Integrasi
HubSpot dan WhatsApp
Hubungkan HubSpot ke nomor WhatsApp Anda dalam dua arah:
- HubSpot → WhatsApp: saat kontak dibuat atau deal berpindah ke suatu tahap, kirim pesan WhatsApp ke orang tersebut dari nomor Anda sendiri.
- WhatsApp → HubSpot: saat seseorang mengirim pesan ke nomor WhatsApp Anda, tambahkan pesan itu sebagai catatan di kontak HubSpot-nya, dan buat kontaknya jika belum ada.
WbizTool tidak memiliki aplikasi HubSpot. Resep ini menghubungkan keduanya melalui Zapier, Make, n8n, Pabbly Connect, atau workflow HubSpot, dengan template siap pakai untuk Make dan n8n.
Siapa yang dapat melakukannya: Di WbizTool, Pemilik membuat kunci API di Pengaturan → Kunci API (lihat Kunci API); Pemilik dan Editor menyiapkan Nomor kotak masuk untuk arah WhatsApp → HubSpot. Di HubSpot, Anda memerlukan hak untuk menghubungkan aplikasi atau mengedit workflow; setiap jalur di bawah menyebutkan apa yang diperlukannya.
Sebelum memulai#
- Nomor WhatsApp yang terhubung di Nomor WhatsApp. Lihat Hubungkan nomor WhatsApp Anda.
- Kunci API Anda, dan untuk beberapa alat juga Client ID Anda, dari Pengaturan → Kunci API, serta WhatsApp Client ID nomor pengirim (ID-nya di Nomor WhatsApp).
- Khusus WhatsApp → HubSpot: add-on Unibox. Pesan masuk sampai ke HubSpot melalui webhook Nomor kotak masuk, yang memerlukan add-on Unibox: $20 per bulan atau $200 per tahun dengan harga daftar AS untuk setiap nomor kotak masuk, di paket berbayar atau lifetime (bukan uji coba gratis). Mengirim pesan tidak memerlukannya.
Memilih jalur#
| Jalur | HubSpot → WhatsApp | WhatsApp → HubSpot | Yang diperlukan |
|---|---|---|---|
| Zapier | Pemicu New Contact atau Updated Deal Stage, lalu action kirim WbizTool | Pemicu WbizTool Incoming WhatsApp Message, lalu HubSpot Find Contact dan Create Engagement | Akun Zapier. Tidak ada webhook yang perlu diatur. |
| Make | HubSpot CRM Watch Contacts, lalu modul HTTP | Custom webhook Make, lalu request HTTP ke API HubSpot | Akun Make. Tidak ada aplikasi WbizTool di Make: modul HTTP memanggil API WbizTool. |
| n8n | HubSpot Trigger, lalu WbizTool Send Message | Node Webhook, lalu node HubSpot dan request HTTP ke HubSpot | n8n dengan community node WbizTool. HubSpot Trigger memerlukan akun developer HubSpot dan sebuah aplikasi. |
| Pabbly Connect | Pemicu HubSpot, lalu API (Pabbly) | Webhook by Pabbly, lalu request API ke HubSpot | Akun Pabbly Connect. Bekerja melalui langkah HTTP dan webhook Pabbly. |
| Workflow HubSpot | Action Send a webhook memanggil API WbizTool secara langsung | Gunakan jalur lain | Data Hub Professional atau Enterprise. Tidak perlu alat lain. |
Nomor telepon#
Kedua arah menulis nomor secara berbeda, jadi periksa hal ini sebelum Anda memetakan field.
HubSpot → WhatsApp. Petakan Phone number (atau Mobile phone number) kontak ke phone penerima. WbizTool menghapus spasi, tanda hubung, titik, dan tanda kurung untuk Anda, jadi +1 (212) 555-0120 bisa dipakai. Nomor yang disimpan dengan + atau 00 membawa kode negaranya. Nomor yang disimpan tanpanya, seperti 2125550120, memerlukan kode negara: isi Country Code di Zapier dan n8n, atau country_code di request HTTP, seperti 1 atau 91. Nomor yang disimpan dengan kode negara tetapi tanpa +, seperti 12125550120, bisa dipakai apa adanya. Lihat phone dan country_code di Kirim pesan.
WhatsApp → HubSpot. Webhook memberikan pengirim sebagai digit internasional tanpa +, di contact.phone, seperti 12125550120. HubSpot mencari nomor telepon hanya berdasarkan kode area dan nomor lokal, tanpa kode negara. Jadi sebelum mencari, hapus kode negara Anda dari depan: 12125550120 menjadi 2125550120. Template melakukan ini untuk satu kode negara yang Anda tetapkan. Saat membuat kontak, simpan nomor sebagai + diikuti digitnya, seperti +12125550120, agar HubSpot mengetahui negaranya.
Mengirim pesan WhatsApp dari HubSpot#
Dengan Zapier#
Gunakan pemicu HubSpot yang Anda perlukan, lalu action WbizTool. Hubungkan WbizTool dengan Client ID dan kunci API Anda (lihat Integrasi Zapier).
Saat kontak dibuat:
Pemicu: HubSpot, New Contact
Pilih HubSpot dan pemicu New Contact, lalu hubungkan akun HubSpot Anda.
Filter by Zapier
Lanjutkan hanya jika nomor telepon kontak exists. Kontak tanpa nomor akan gagal di langkah berikutnya.
Action: WbizTool, Send Text-Only WhatsApp Message
Pilih nomor pengirim di bawah WhatsApp Number. Petakan Phone Number ke nomor telepon kontak. Isi Country Code hanya jika nomor HubSpot Anda disimpan tanpanya. Tulis Message, misalnya
Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.Uji dan publikasikan
Langkah yang berhasil berarti pesan sudah masuk antrean. WbizTool lalu mengirimnya dari nomor Anda.
Saat deal berpindah ke suatu tahap:
Pemicu: HubSpot, Updated Deal Stage
Pilih Updated Deal Stage, lalu pilih pipeline dan tahapnya, seperti Closed won.
Temukan kontak deal
Deal tidak menyimpan nomor telepon; kontaknya yang menyimpan. Tambahkan HubSpot Get Contact dengan ID kontak yang terkait dengan deal. Jika data pemicu tidak berisi ID kontak, tambahkan HubSpot Find Associations terlebih dahulu untuk mendapatkan kontak deal tersebut.
Filter, lalu kirim
Tambahkan langkah Filter by Zapier yang berlanjut jika nomor telepon ada, lalu Send Text-Only WhatsApp Message seperti di atas. Anda dapat memakai field deal di teks, seperti nama deal.
Dengan Make#
Tidak ada aplikasi WbizTool di Make. Modul HTTP Make memanggil API Kirim pesan. Dari dua template Make, template ini memakai koneksi HubSpot di Make (Watch Contacts); template WhatsApp → HubSpot hanya memakai modul bawaan Make dan service key HubSpot.
Impor template atau mulai skenario
Impor hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint di skenario baru), atau buat sendiri dengan langkah di bawah.
HubSpot CRM, Watch Contacts
Tambahkan modul HubSpot CRM Watch Contacts dan hubungkan HubSpot. Super Admin akun HubSpot Anda harus menyetujui aplikasi Make terlebih dahulu. Make menanyakan titik mulainya: pilih From now on agar hanya kontak baru yang dikirimi pesan.
HTTP, Make a request
Method
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Tambahkan headerAuthorizationdengan nilaiBearer YOUR_API_KEY. Body type application/x-www-form-urlencoded, dengan field berikut:Field Nilai whatsapp_clientWhatsApp Client ID Anda, seperti 678phonePhone number kontak dari modul HubSpot country_codeHanya jika nomor Anda disimpan tanpanya, seperti 1msgTeks Anda, dengan field seperti nama depan yang dipetakan Tambahkan filter dan jalankan sekali
Pada tautan antara kedua modul, tambahkan filter yang hanya meloloskan jika nomor telepon ada. Jalankan skenario sekali: respons dengan
"status": 1berarti pesan sudah masuk antrean.
Field formulir tetap berfungsi saat nilai yang dipetakan berisi tanda kutip atau jeda baris, yang dapat merusak body JSON mentah. JSON juga bisa dipakai; lihat Field body. Untuk tahap deal di Make, gunakan workflow HubSpot yang mengirim ke custom webhook Make, atau jalur Zapier atau n8n.
Dengan n8n#
Template hubspot-to-whatsapp.n8n.json menangani kedua event dalam satu alur kerja: kontak baru, dan deal yang berpindah ke suatu tahap.
Pasang node WbizTool
Pasang
n8n-nodes-wbiztooldan buat kredensial WbizTool API. Lihat Integrasi n8n.Buat kredensial HubSpot
HubSpot Trigger memerlukan kredensial HubSpot Developer API: akun developer HubSpot, aplikasi dengan scope baca untuk kontak dan deal, serta redirect URL n8n di aplikasi tersebut (lihat halaman kredensial HubSpot dari n8n). Langkah HubSpot lainnya memakai kredensial HubSpot Service Key: di HubSpot, buka Development → Keys → Service keys, klik Create service key, dan tambahkan scope baca untuk kontak dan deal.
Impor alur kerja
Di n8n, impor file-nya dan pilih kredensial Anda di setiap node HubSpot, HTTP Request, dan WbizTool.
Atur tahap dan pesan Anda
Di node Deal stage is, ganti
closedwondengan nilai internal tahap Anda. Edit teks di dua node WbizTool Send Message, dan atur Country Code di sana hanya jika nomor Anda disimpan tanpanya.Aktifkan
Pemicu lalu mendaftarkan webhook-nya di HubSpot.
Yang dilakukan alur kerja ini:
- HubSpot Trigger dengan dua event: Contact Created, dan Deal Property Changed untuk properti Deal Stage.
- Node IF mengarahkan event kontak ke satu jalur dan event deal ke jalur lain.
- Untuk deal, alur kerja memeriksa tahap barunya, lalu membaca deal dan kontak terkaitnya dengan HTTP Request ke HubSpot.
- HubSpot → Search Contacts membaca nama depan dan nomor telepon kontak.
- WbizTool Send Message mengirim teks ke nomor telepon, atau ke nomor ponsel jika nomor telepon kosong.
Dengan workflow HubSpot#
Dengan Data Hub Professional atau Enterprise, workflow dapat memanggil API WbizTool sendiri dengan action Send a webhook. Tidak ada alat lain yang terlibat.
Buat workflow berbasis kontak
Di HubSpot, buka Automation → Workflows dan buat workflow pada kontak, dengan pemicu yang Anda inginkan, seperti kontak dibuat atau tahap lifecycle-nya berubah.
Tambahkan Send a webhook
Klik +, lalu di bawah Data ops pilih Send a webhook. Method
POST, URL webhookhttps://wbiztool.com/api/v1/send_msg/.Atur autentikasi
Pilih API key sebagai jenis autentikasi. Tambahkan secret dengan nilai
Bearer YOUR_API_KEY(dengan kunci WbizTool Anda), atur nama API key keAuthorizationdan lokasinya ke Request header.Sesuaikan body request
Pilih Customize request body dan tambahkan:
Key Nilai phoneProperti: Phone number whatsapp_clientNilai statis: WhatsApp Client ID Anda, seperti 678msgNilai statis: pesan Anda country_codeNilai statis, hanya jika nomor Anda disimpan tanpanya Uji
Uji action dengan kontak yang memiliki nomor Anda sendiri. WbizTool menjawab
{"status": 1, "message": "Created", "msg_id": …}saat pesan sudah masuk antrean.
- Pesan tidak dapat menyertakan nama kontak. Di Customize request body, setiap key menerima satu properti HubSpot atau satu nilai statis, jadi
msgadalah teks tetap yang sama untuk setiap kontak. Untuk sapaan personal, gunakan jalur Zapier, Make, atau n8n. - Pengulangan: HubSpot mengulang webhook yang gagal hingga tiga hari. HubSpot tidak mengulang jawaban
4xxkecuali429, jadi pesan yang ditolak, sepertiInvalid phone number, tidak dikirim lagi. Agar pengulangan setelah timeout tidak mengirim pesan dua kali, tambahkan keyidempotency_keydengan properti Record ID, jika workflow mengirim pesan ke setiap kontak paling banyak sekali sehari. Lihat Mencoba lagi dengan aman. - Deal: langkah ini memakai workflow berbasis kontak, karena nomor telepon ada di kontak, bukan di deal. Untuk pesan pada tahap deal, gunakan jalur Zapier atau n8n.
Dengan Pabbly Connect#
Pabbly Connect memulai alur kerja dari event HubSpot seperti New Contact Added atau Deal Updated. Lalu tambahkan API (Pabbly) → Execute API Request dengan POST ke https://wbiztool.com/api/v1/send_msg/, seperti di Kirim pesan WhatsApp dari alat otomatisasi apa pun, dan petakan nomor telepon kontak ke phone.
Mencatat pesan WhatsApp masuk di HubSpot#
Setiap pesan yang dikirim seseorang ke nomor Anda menjadi catatan di kontak HubSpot-nya. Arah ini memerlukan add-on Unibox ($20 per bulan atau $200 per tahun dengan harga daftar AS untuk setiap nomor kotak masuk, di paket berbayar atau lifetime), karena pesan keluar dari WbizTool melalui webhook Nomor kotak masuk.
Resepnya sama di setiap alat:
- Lewati chat grup (
contact.is_groupbernilaitrue) dan kontak yang nomornya disembunyikan WhatsApp (contact.phone_hiddenbernilaitrue). - Hapus kode negara Anda dari depan
contact.phone(lihat Nomor telepon). - Cari kontak HubSpot yang Phone number atau Mobile phone number-nya sama dengan nomor itu.
- Jika tidak ada, buat kontak dengan Phone number
+dancontact.phone, dan First namecontact.name. - Buat catatan di kontak dengan pesannya:
message.content, pada waktumessage.timestamp.
Dengan Zapier#
Anda tidak perlu mengatur URL webhook di mana pun: pemicu WbizTool terhubung ke Zapier saat Anda memublikasikan Zap.
Pemicu: WbizTool, Incoming WhatsApp Message
Pilih nomor di bawah WhatsApp Number. Zap memakai salah satu nomor kotak masuk Anda (lihat Persyaratan pemicu). Hanya pesan yang dikirim orang kepada Anda yang memulainya.
Filter by Zapier
Lanjutkan hanya jika Contact Phone Hidden bernilai false dan Is Group bernilai false.
Formatter by Zapier: hapus kode negara
Pilih Formatter, action event Numbers, transform Format Phone Number. Input:
+diikuti Contact Phone. Pilih format nasional tanpa simbol di bawah To Format, sehingga+12125550120menjadi2125550120.HubSpot, Find Contact
Cari berdasarkan Phone Number dengan output Formatter. Centang opsi untuk membuat kontak jika tidak ditemukan, dengan Phone Number
+dan Contact Phone, serta First Name dari Contact Name.HubSpot, Create Engagement
Tipe Note, terkait dengan ID kontak dari langkah Find Contact. Body:
WhatsApp fromContact Name: Message Content.
Dengan Make#
Impor template
Impor hubspot-whatsapp-to-note.make.json di skenario baru.
Tambahkan service key HubSpot Anda
Di HubSpot, buka Development → Keys → Service keys, klik Create service key, dan tambahkan scope baca dan tulis untuk kontak. Di setiap modul HTTP skenario, ganti
YOUR_HUBSPOT_SERVICE_KEYdi headerAuthorizationdengan key tersebut.Buat webhook
Di modul Webhooks → Custom webhook, klik Add, beri nama, dan salin alamatnya.
Tambahkan alamat ke nomor kotak masuk Anda
Di WbizTool, buka Nomor kotak masuk, klik Pengaturan webhook di kartu nomor (atau Tambahkan nomor ke kotak masuk), tempel alamatnya di bawah URL webhook (opsional) dan klik Simpan. Biarkan Pesan diterima tercentang; centang juga Pesan dikirim jika Anda ingin balasan Anda ada di HubSpot.
Atur kode negara Anda
Di modul Search the contact by phone, template menghapus
1dari depan nomor (/^1/, dua kali). Ganti1dengan kode negara Anda, seperti91.Aktifkan skenario
Kirim pesan ke nomor WhatsApp Anda dari ponsel lain. Pesan tiba dalam satu atau dua menit, dan Make mempelajari field webhook dari pesan itu: periksa pemetaannya sekali.
Skenarionya: Custom webhook → request HTTP ke pencarian kontak HubSpot → router. Jika kontak ditemukan, satu request HTTP menambahkan catatan ke kontak itu. Jika tidak, satu request membuat kontak dan request lain menambahkan catatan. Langkah JSON → Transform to JSON mengubah pesan dan nama menjadi teks JSON, agar tanda kutip dan jeda baris tidak merusak request.
Dengan n8n#
Impor alur kerja
Impor hubspot-whatsapp-to-note.n8n.json dan pilih kredensial HubSpot Service Key di node HubSpot dan HTTP Request. Key tersebut memerlukan scope baca dan tulis untuk kontak.
Atur kode negara Anda
Di node National number, atur
countryCodeke kode negara Anda, seperti91.Aktifkan dan salin alamatnya
Aktifkan alur kerja dan salin Production URL dari node WbizTool webhook.
Tambahkan alamat ke nomor kotak masuk Anda
Tempel sebagai webhook nomor di Nomor kotak masuk, seperti pada langkah Make di atas.
Node HubSpot di n8n tidak memiliki action catatan, jadi alur kerja membuat kontak dan catatan dengan node HTTP Request yang memakai kredensial HubSpot yang sama. Node Webhook langsung menjawab, jauh di bawah 8 detik yang ditunggu WbizTool.
Dengan Pabbly Connect#
Mulai dengan Webhook by Pabbly dan tempel URL-nya sebagai webhook nomor di Nomor kotak masuk. Lalu panggil API HubSpot dengan API (Pabbly) → Execute API Request, memakai service key HubSpot sebagai token Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search untuk mencari kontak, POST …/contacts untuk membuatnya, dan POST …/notes untuk menambahkan catatan (lihat Request yang dibuat server Anda).
Di server Anda sendiri#
Terima webhook seperti dijelaskan di Webhook pesan masuk, verifikasi tanda tangannya, langsung jawab 200, lalu lakukan panggilan API HubSpot berikut dengan service key.
Request yang dibuat server Anda
| Langkah | Request | Body |
|---|---|---|
| Mencari kontak | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups dengan phone EQ nomor tanpa kode negaranya, dan grup kedua dengan mobilephone; limit 1 |
| Membuatnya jika belum ada | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname dari contact.name |
| Menambahkan catatan | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: hs_timestamp dari message.timestamp, hs_note_body berisi teks; associations ke kontak dengan associationCategory HUBSPOT_DEFINED dan associationTypeId 202 (catatan ke kontak) |
{
"properties": {
"hs_timestamp": "2026-10-15T10:30:04+00:00",
"hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
},
"associations": [
{
"to": { "id": "CONTACT_ID" },
"types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
}
]
}
Endpoint pencarian HubSpot mengizinkan lima request per detik per akun. Lewati message.id yang sudah Anda catat: dalam kasus jarang, WbizTool dapat mengirim pesan dua kali.
Template#
| File | Alat | Fungsinya |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Kontak HubSpot baru → pesan WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp masuk → catatan di kontak (memerlukan add-on Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Kontak baru atau tahap deal → pesan WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp masuk → catatan di kontak (memerlukan add-on Unibox) |
Template tidak berisi kunci apa pun. Setelah mengimpor, pilih koneksi atau kredensial Anda sendiri di setiap langkah, dan ganti YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, WhatsApp Client ID 678, dan kode negara dengan milik Anda.
Pemecahan masalah#
| Masalah | Yang perlu diperiksa |
|---|---|
Invalid phone number | Nomor telepon kontak kosong, berisi huruf, atau memiliki kurang dari 6 atau lebih dari 17 digit. Tambahkan filter yang melewati kontak tanpa nomor. |
| Pesan terkirim ke nomor yang salah | Nomor disimpan tanpa kode negaranya dan tidak ada kode yang dikirim. Isi Country Code atau country_code, atau simpan nomor di HubSpot dengan +. |
Auth Error: invalid api key | Kunci sudah dihapus atau salah ketik. Di workflow HubSpot, nilai secret harus Bearer diikuti kuncinya, dan nama API key Authorization. |
Invalid whatsapp client | Gunakan ID nomor dari Nomor WhatsApp. |
| Send a webhook tidak ada di daftar action workflow | Action ini memerlukan Data Hub Professional atau Enterprise. Gunakan Zapier, Make, n8n, atau Pabbly Connect sebagai gantinya. |
| Make tidak dapat terhubung ke HubSpot | Super Admin akun HubSpot harus menyetujui aplikasi Make terlebih dahulu. |
| Tidak ada catatan yang muncul di HubSpot | Pastikan nomor menampilkan Menyinkronkan di Nomor kotak masuk, URL webhook adalah URL dari alat Anda, dan Pesan diterima tercentang. Kirim pesan dari ponsel lain: balasan dari kotak masuk Unibox tidak dikirim. |
| Webhook tidak sampai, atau host Anda menolaknya | Penerima Anda harus menjawab 2xx dalam 8 detik dan tidak boleh melakukan redirect. Beberapa firewall hosting memblokir klien yang tidak dikenal: webhook WbizTool datang dengan User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), jadi izinkan User-Agent tersebut. |
| Kontak baru dibuat untuk orang yang sudah ada di HubSpot | HubSpot tidak menemukan nomornya. Pastikan kode negara yang Anda hapus sudah benar dan nomor kontak ada di Phone number atau Mobile phone number. Untuk pelanggan di banyak negara, lihat Nomor telepon. |
| Satu pesan tercatat dua kali | Dalam kasus jarang, WbizTool dapat mengirim pesan dua kali. Lewati message.id yang sudah Anda catat. |
| Tidak ada catatan untuk beberapa pesan | Chat grup dan kontak yang nomornya disembunyikan WhatsApp sengaja dilewati. Pesan dari saat nomor dihentikan tidak dikirim. |

