Langsung ke konten
WbizTool

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#

JalurHubSpot → WhatsAppWhatsApp → HubSpotYang diperlukan
ZapierPemicu New Contact atau Updated Deal Stage, lalu action kirim WbizToolPemicu WbizTool Incoming WhatsApp Message, lalu HubSpot Find Contact dan Create EngagementAkun Zapier. Tidak ada webhook yang perlu diatur.
MakeHubSpot CRM Watch Contacts, lalu modul HTTPCustom webhook Make, lalu request HTTP ke API HubSpotAkun Make. Tidak ada aplikasi WbizTool di Make: modul HTTP memanggil API WbizTool.
n8nHubSpot Trigger, lalu WbizTool Send MessageNode Webhook, lalu node HubSpot dan request HTTP ke HubSpotn8n dengan community node WbizTool. HubSpot Trigger memerlukan akun developer HubSpot dan sebuah aplikasi.
Pabbly ConnectPemicu HubSpot, lalu API (Pabbly)Webhook by Pabbly, lalu request API ke HubSpotAkun Pabbly Connect. Bekerja melalui langkah HTTP dan webhook Pabbly.
Workflow HubSpotAction Send a webhook memanggil API WbizTool secara langsungGunakan jalur lainData 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:

  1. Pemicu: HubSpot, New Contact

    Pilih HubSpot dan pemicu New Contact, lalu hubungkan akun HubSpot Anda.

  2. Filter by Zapier

    Lanjutkan hanya jika nomor telepon kontak exists. Kontak tanpa nomor akan gagal di langkah berikutnya.

  3. 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.

  4. Uji dan publikasikan

    Langkah yang berhasil berarti pesan sudah masuk antrean. WbizTool lalu mengirimnya dari nomor Anda.

Saat deal berpindah ke suatu tahap:

  1. Pemicu: HubSpot, Updated Deal Stage

    Pilih Updated Deal Stage, lalu pilih pipeline dan tahapnya, seperti Closed won.

  2. 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.

  3. 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.

  1. 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.

  2. 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.

  3. HTTP, Make a request

    Method POST, URL https://wbiztool.com/api/v1/send_msg/. Tambahkan header Authorization dengan nilai Bearer YOUR_API_KEY. Body type application/x-www-form-urlencoded, dengan field berikut:

    FieldNilai
    whatsapp_clientWhatsApp Client ID Anda, seperti 678
    phonePhone number kontak dari modul HubSpot
    country_codeHanya jika nomor Anda disimpan tanpanya, seperti 1
    msgTeks Anda, dengan field seperti nama depan yang dipetakan
  4. 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": 1 berarti 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.

  1. Pasang node WbizTool

    Pasang n8n-nodes-wbiztool dan buat kredensial WbizTool API. Lihat Integrasi n8n.

  2. 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.

  3. Impor alur kerja

    Di n8n, impor file-nya dan pilih kredensial Anda di setiap node HubSpot, HTTP Request, dan WbizTool.

  4. Atur tahap dan pesan Anda

    Di node Deal stage is, ganti closedwon dengan nilai internal tahap Anda. Edit teks di dua node WbizTool Send Message, dan atur Country Code di sana hanya jika nomor Anda disimpan tanpanya.

  5. Aktifkan

    Pemicu lalu mendaftarkan webhook-nya di HubSpot.

Yang dilakukan alur kerja ini:

  1. HubSpot Trigger dengan dua event: Contact Created, dan Deal Property Changed untuk properti Deal Stage.
  2. Node IF mengarahkan event kontak ke satu jalur dan event deal ke jalur lain.
  3. Untuk deal, alur kerja memeriksa tahap barunya, lalu membaca deal dan kontak terkaitnya dengan HTTP Request ke HubSpot.
  4. HubSpot → Search Contacts membaca nama depan dan nomor telepon kontak.
  5. 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.

  1. 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.

  2. Tambahkan Send a webhook

    Klik +, lalu di bawah Data ops pilih Send a webhook. Method POST, URL webhook https://wbiztool.com/api/v1/send_msg/.

  3. Atur autentikasi

    Pilih API key sebagai jenis autentikasi. Tambahkan secret dengan nilai Bearer YOUR_API_KEY (dengan kunci WbizTool Anda), atur nama API key ke Authorization dan lokasinya ke Request header.

  4. Sesuaikan body request

    Pilih Customize request body dan tambahkan:

    KeyNilai
    phoneProperti: Phone number
    whatsapp_clientNilai statis: WhatsApp Client ID Anda, seperti 678
    msgNilai statis: pesan Anda
    country_codeNilai statis, hanya jika nomor Anda disimpan tanpanya
  5. 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 msg adalah 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 4xx kecuali 429, jadi pesan yang ditolak, seperti Invalid phone number, tidak dikirim lagi. Agar pengulangan setelah timeout tidak mengirim pesan dua kali, tambahkan key idempotency_key dengan 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:

  1. Lewati chat grup (contact.is_group bernilai true) dan kontak yang nomornya disembunyikan WhatsApp (contact.phone_hidden bernilai true).
  2. Hapus kode negara Anda dari depan contact.phone (lihat Nomor telepon).
  3. Cari kontak HubSpot yang Phone number atau Mobile phone number-nya sama dengan nomor itu.
  4. Jika tidak ada, buat kontak dengan Phone number + dan contact.phone, dan First name contact.name.
  5. Buat catatan di kontak dengan pesannya: message.content, pada waktu message.timestamp.

Dengan Zapier#

Anda tidak perlu mengatur URL webhook di mana pun: pemicu WbizTool terhubung ke Zapier saat Anda memublikasikan Zap.

  1. 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.

  2. Filter by Zapier

    Lanjutkan hanya jika Contact Phone Hidden bernilai false dan Is Group bernilai false.

  3. 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 +12125550120 menjadi 2125550120.

  4. 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.

  5. HubSpot, Create Engagement

    Tipe Note, terkait dengan ID kontak dari langkah Find Contact. Body: WhatsApp from Contact Name: Message Content.

Dengan Make#

  1. Impor template

    Impor hubspot-whatsapp-to-note.make.json di skenario baru.

  2. 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_KEY di header Authorization dengan key tersebut.

  3. Buat webhook

    Di modul Webhooks → Custom webhook, klik Add, beri nama, dan salin alamatnya.

  4. 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.

  5. Atur kode negara Anda

    Di modul Search the contact by phone, template menghapus 1 dari depan nomor (/^1/, dua kali). Ganti 1 dengan kode negara Anda, seperti 91.

  6. 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#

  1. 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.

  2. Atur kode negara Anda

    Di node National number, atur countryCode ke kode negara Anda, seperti 91.

  3. Aktifkan dan salin alamatnya

    Aktifkan alur kerja dan salin Production URL dari node WbizTool webhook.

  4. 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

LangkahRequestBody
Mencari kontakPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups dengan phone EQ nomor tanpa kode negaranya, dan grup kedua dengan mobilephone; limit 1
Membuatnya jika belum adaPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname dari contact.name
Menambahkan catatanPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: 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#

FileAlatFungsinya
hubspot-new-contact-to-whatsapp.make.jsonMakeKontak HubSpot baru → pesan WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp masuk → catatan di kontak (memerlukan add-on Unibox)
hubspot-to-whatsapp.n8n.jsonn8nKontak baru atau tahap deal → pesan WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp 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#

MasalahYang perlu diperiksa
Invalid phone numberNomor 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 salahNomor 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 keyKunci sudah dihapus atau salah ketik. Di workflow HubSpot, nilai secret harus Bearer diikuti kuncinya, dan nama API key Authorization.
Invalid whatsapp clientGunakan ID nomor dari Nomor WhatsApp.
Send a webhook tidak ada di daftar action workflowAction ini memerlukan Data Hub Professional atau Enterprise. Gunakan Zapier, Make, n8n, atau Pabbly Connect sebagai gantinya.
Make tidak dapat terhubung ke HubSpotSuper Admin akun HubSpot harus menyetujui aplikasi Make terlebih dahulu.
Tidak ada catatan yang muncul di HubSpotPastikan 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 menolaknyaPenerima 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 HubSpotHubSpot 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 kaliDalam kasus jarang, WbizTool dapat mengirim pesan dua kali. Lewati message.id yang sudah Anda catat.
Tidak ada catatan untuk beberapa pesanChat grup dan kontak yang nomornya disembunyikan WhatsApp sengaja dilewati. Pesan dari saat nomor dihentikan tidak dikirim.

Terkait#