Integrasi
HubSpot dan WhatsApp
Sambungkan HubSpot kepada nombor WhatsApp anda dalam kedua-dua arah:
- HubSpot → WhatsApp: apabila kenalan dicipta atau urus niaga berpindah ke sesuatu peringkat, hantar mesej WhatsApp kepada orang itu dari nombor anda sendiri.
- WhatsApp → HubSpot: apabila seseorang menghantar mesej ke nombor WhatsApp anda, tambah mesej itu sebagai nota pada kenalan HubSpot mereka, dan cipta kenalan itu jika belum wujud.
WbizTool tiada aplikasi HubSpot. Resipi ini menyambungkan kedua-duanya melalui Zapier, Make, n8n, Pabbly Connect atau aliran kerja HubSpot, dengan templat siap sedia untuk Make dan n8n.
Siapa yang boleh melakukannya: Dalam WbizTool, Pemilik mencipta kunci API di Tetapan → Kunci API (lihat Kunci API); Pemilik dan Editor menyediakan Nombor peti masuk untuk arah WhatsApp → HubSpot. Dalam HubSpot, anda memerlukan hak untuk menyambung aplikasi atau mengedit aliran kerja; setiap laluan di bawah menyatakan apa yang diperlukannya.
Sebelum anda bermula#
- Nombor WhatsApp yang disambungkan di Nombor WhatsApp. Lihat Sambungkan nombor WhatsApp anda.
- Kunci API anda, dan bagi sesetengah alat Client ID anda, dari Tetapan → Kunci API, serta WhatsApp Client ID nombor yang menghantar (IDnya di Nombor WhatsApp).
- Untuk WhatsApp → HubSpot sahaja: tambahan Unibox. Mesej masuk sampai ke HubSpot melalui webhook Nombor peti masuk, yang memerlukan tambahan Unibox: $20 sebulan atau $200 setahun pada harga senarai AS bagi setiap nombor peti masuk, pada pelan berbayar atau seumur hidup (bukan percubaan percuma). Menghantar mesej tidak memerlukannya.
Pilih laluan#
| Laluan | HubSpot → WhatsApp | WhatsApp → HubSpot | Apa yang diperlukan |
|---|---|---|---|
| Zapier | Pencetus New Contact atau Updated Deal Stage, kemudian tindakan hantar WbizTool | Pencetus WbizTool Incoming WhatsApp Message, kemudian HubSpot Find Contact dan Create Engagement | Akaun Zapier. Tiada webhook untuk disediakan. |
| Make | HubSpot CRM Watch Contacts, kemudian modul HTTP | Webhook tersuai Make, kemudian permintaan HTTP ke API HubSpot | Akaun Make. Tiada aplikasi WbizTool di Make: modul HTTP memanggil API WbizTool. |
| n8n | HubSpot Trigger, kemudian WbizTool Send Message | Nod Webhook, kemudian nod HubSpot dan permintaan HTTP ke HubSpot | n8n dengan nod komuniti WbizTool. HubSpot Trigger memerlukan akaun pembangun dan aplikasi HubSpot. |
| Pabbly Connect | Pencetus HubSpot, kemudian API (Pabbly) | Webhook by Pabbly, kemudian permintaan API ke HubSpot | Akaun Pabbly Connect. Ia berfungsi melalui langkah HTTP dan webhook Pabbly. |
| Aliran kerja HubSpot | Tindakan Send a webhook memanggil API WbizTool terus | Gunakan laluan lain | Data Hub Professional atau Enterprise. Tiada alat lain diperlukan. |
Nombor telefon#
Kedua-dua arah menulis nombor secara berbeza, jadi semak perkara ini sebelum anda memetakan medan.
HubSpot → WhatsApp. Petakan Phone number (atau Mobile phone number) kenalan ke phone penerima. WbizTool membuang ruang, sengkang, titik dan kurungan untuk anda, jadi +1 (212) 555-0120 berfungsi. Nombor yang disimpan dengan + atau 00 membawa kod negaranya. Nombor yang disimpan tanpanya, seperti 2125550120, memerlukan kod negara: isi Country Code dalam Zapier dan n8n, atau country_code dalam permintaan HTTP, seperti 1 atau 91. Nombor yang disimpan dengan kod negara tetapi tanpa +, seperti 12125550120, berfungsi seadanya. Lihat phone dan country_code di Hantar mesej.
WhatsApp → HubSpot. Webhook memberikan pengirim sebagai digit antarabangsa tanpa +, dalam contact.phone, seperti 12125550120. HubSpot mencari nombor telefon melalui kod kawasan dan nombor tempatan sahaja, tanpa kod negara. Jadi sebelum anda mencari, buang kod negara anda dari hadapan: 12125550120 menjadi 2125550120. Templat melakukan ini untuk satu kod negara yang anda tetapkan. Apabila anda mencipta kenalan, simpan nombor sebagai + diikuti digit, seperti +12125550120, supaya HubSpot tahu negaranya.
Hantar mesej WhatsApp dari HubSpot#
Dengan Zapier#
Gunakan pencetus HubSpot yang anda perlukan, kemudian tindakan WbizTool. Sambungkan WbizTool dengan Client ID dan kunci API anda (lihat Integrasi Zapier).
Apabila kenalan dicipta:
Pencetus: HubSpot, New Contact
Pilih HubSpot dan pencetus New Contact, dan sambungkan akaun HubSpot anda.
Filter by Zapier
Teruskan hanya apabila nombor telefon kenalan exists. Kenalan tanpa nombor akan gagal pada langkah seterusnya.
Tindakan: WbizTool, Send Text-Only WhatsApp Message
Pilih nombor yang menghantar di bawah WhatsApp Number. Petakan Phone Number ke nombor telefon kenalan. Isi Country Code hanya jika nombor HubSpot anda disimpan tanpanya. Tulis Message, contohnya
Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.Uji dan terbitkan
Langkah yang berjaya bermakna mesej telah beratur. WbizTool kemudian menghantarnya dari nombor anda.
Apabila urus niaga berpindah ke sesuatu peringkat:
Pencetus: HubSpot, Updated Deal Stage
Pilih Updated Deal Stage dan pilih saluran paip dan peringkat, seperti Closed won.
Cari kenalan urus niaga
Urus niaga tidak menyimpan nombor telefon: kenalannya yang menyimpan. Tambah HubSpot Get Contact dengan ID kenalan yang dikaitkan dengan urus niaga itu. Jika data pencetus tiada ID kenalan, tambah HubSpot Find Associations dahulu untuk mendapatkan kenalan urus niaga itu.
Tapis, kemudian hantar
Tambah langkah Filter by Zapier yang diteruskan apabila nombor telefon wujud, kemudian Send Text-Only WhatsApp Message seperti di atas. Anda boleh menggunakan medan urus niaga dalam teks, seperti nama urus niaga.
Dengan Make#
Tiada aplikasi WbizTool di Make. Modul HTTP Make memanggil API Hantar mesej. Daripada dua templat Make, yang ini menggunakan sambungan HubSpot Make (Watch Contacts); templat WhatsApp → HubSpot hanya menggunakan modul terbina dalam Make dan kunci perkhidmatan HubSpot.
Import templat atau mulakan senario
Import hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint dalam senario baharu), atau binanya dengan langkah di bawah.
HubSpot CRM, Watch Contacts
Tambah modul HubSpot CRM Watch Contacts dan sambungkan HubSpot. Super Admin akaun HubSpot anda perlu meluluskan aplikasi Make dahulu. Make bertanya dari mana hendak bermula: pilih From now on untuk menghantar mesej kepada kenalan baharu sahaja.
HTTP, Make a request
Kaedah
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Tambah pengepalaAuthorizationdengan nilaiBearer YOUR_API_KEY. Jenis badan application/x-www-form-urlencoded, dengan medan-medan ini:Medan Nilai whatsapp_clientWhatsApp Client ID anda, seperti 678phonePhone number kenalan dari modul HubSpot country_codeHanya jika nombor anda disimpan tanpanya, seperti 1msgTeks anda, dengan medan seperti nama pertama dipetakan ke dalamnya Tambah penapis dan jalankan sekali
Pada pautan antara kedua-dua modul, tambah penapis yang hanya meluluskan apabila nombor telefon wujud. Jalankan senario sekali: respons dengan
"status": 1bermakna mesej telah beratur.
Medan borang terus berfungsi apabila nilai yang dipetakan mengandungi tanda petik atau pemisah baris, yang boleh merosakkan badan JSON mentah. JSON juga berfungsi; lihat Medan badan. Untuk peringkat urus niaga dalam Make, gunakan aliran kerja HubSpot yang menghantar ke webhook tersuai Make, atau laluan Zapier atau n8n.
Dengan n8n#
Templat hubspot-to-whatsapp.n8n.json mengendalikan kedua-dua peristiwa dalam satu aliran kerja: kenalan baharu, dan urus niaga yang berpindah ke sesuatu peringkat.
Pasang nod WbizTool
Pasang
n8n-nodes-wbiztooldan cipta kelayakan WbizTool API. Lihat Integrasi n8n.Cipta kelayakan HubSpot
HubSpot Trigger memerlukan kelayakan HubSpot Developer API: akaun pembangun HubSpot, aplikasi dengan skop baca untuk kenalan dan urus niaga, dan URL ubah hala n8n dalam aplikasi itu (lihat halaman kelayakan HubSpot n8n). Langkah HubSpot yang lain menggunakan kelayakan HubSpot Service Key: dalam HubSpot, pergi ke Development → Keys → Service keys, klik Create service key dan tambah skop baca kenalan dan urus niaga.
Import aliran kerja
Dalam n8n, import fail itu dan pilih kelayakan anda dalam setiap nod HubSpot, HTTP Request dan WbizTool.
Tetapkan peringkat dan mesej anda
Dalam nod Deal stage is, gantikan
closedwondengan nilai dalaman peringkat anda. Edit teks dalam dua nod WbizTool Send Message, dan tetapkan Country Code di sana hanya jika nombor anda disimpan tanpanya.Aktifkan
Pencetus kemudian mendaftarkan webhooknya dengan HubSpot.
Apa yang dilakukan oleh aliran kerja:
- HubSpot Trigger dengan dua peristiwa: Contact Created, dan Deal Property Changed untuk sifat Deal Stage.
- Nod IF menghantar peristiwa kenalan ke satu arah dan peristiwa urus niaga ke arah yang lain.
- Untuk urus niaga, ia menyemak peringkat baharu, kemudian membaca urus niaga dan kenalan yang dikaitkan dengannya melalui HTTP Request ke HubSpot.
- HubSpot → Search Contacts membaca nama pertama dan nombor telefon kenalan.
- WbizTool Send Message menghantar teks ke nombor telefon, atau ke nombor mudah alih apabila telefon kosong.
Dengan aliran kerja HubSpot#
Dengan Data Hub Professional atau Enterprise, aliran kerja boleh memanggil API WbizTool sendiri dengan tindakan Send a webhook. Tiada alat lain terlibat.
Cipta aliran kerja berasaskan kenalan
Dalam HubSpot, pergi ke Automation → Workflows dan cipta aliran kerja pada kenalan, dengan pencetus yang anda mahu, seperti kenalan dicipta atau peringkat kitaran hayatnya berubah.
Tambah Send a webhook
Klik +, dan di bawah Data ops pilih Send a webhook. Kaedah
POST, URL webhookhttps://wbiztool.com/api/v1/send_msg/.Tetapkan pengesahan
Pilih API key sebagai jenis pengesahan. Tambah rahsia yang nilainya
Bearer YOUR_API_KEY(dengan kunci WbizTool anda), tetapkan nama kunci API kepadaAuthorizationdan lokasi kepada Request header.Sesuaikan badan permintaan
Pilih Customize request body dan tambah:
Kunci Nilai phoneSifat: Phone number whatsapp_clientNilai statik: WhatsApp Client ID anda, seperti 678msgNilai statik: mesej anda country_codeNilai statik, hanya jika nombor anda disimpan tanpanya Ujinya
Uji tindakan dengan kenalan yang mempunyai nombor anda sendiri. WbizTool menjawab
{"status": 1, "message": "Created", "msg_id": …}apabila ia telah meletakkan mesej dalam baris gilir.
- Mesej tidak boleh mengandungi nama kenalan. Dalam Customize request body, setiap kunci mengambil sama ada satu sifat HubSpot atau satu nilai statik, jadi
msgialah teks tetap, sama untuk setiap kenalan. Untuk ucapan peribadi, gunakan laluan Zapier, Make atau n8n. - Cubaan semula: HubSpot mencuba semula webhook yang gagal sehingga tiga hari. Ia tidak mencuba semula jawapan
4xxkecuali429, jadi mesej yang ditolak, sepertiInvalid phone number, tidak dihantar semula. Untuk menghalang cubaan semula selepas tamat masa daripada menghantar mesej dua kali, tambah kunciidempotency_keydengan sifat Record ID, jika aliran kerja menghantar mesej kepada setiap kenalan paling banyak sekali sehari. Lihat Mencuba semula dengan selamat. - Urus niaga: langkah ini menggunakan aliran kerja berasaskan kenalan, kerana nombor telefon berada pada kenalan, bukan urus niaga. Untuk mesej pada peringkat urus niaga, gunakan laluan Zapier atau n8n.
Dengan Pabbly Connect#
Pabbly Connect memulakan aliran kerja daripada peristiwa HubSpot seperti New Contact Added atau Deal Updated. Kemudian tambah API (Pabbly) → Execute API Request dengan POST ke https://wbiztool.com/api/v1/send_msg/, seperti di Hantar mesej WhatsApp dari mana-mana alat automasi, dan petakan nombor telefon kenalan ke phone.
Rekod mesej WhatsApp masuk dalam HubSpot#
Setiap mesej yang dihantar seseorang ke nombor anda menjadi nota pada kenalan HubSpot mereka. Arah ini memerlukan tambahan Unibox ($20 sebulan atau $200 setahun pada harga senarai AS bagi setiap nombor peti masuk, pada pelan berbayar atau seumur hidup), kerana mesej keluar dari WbizTool melalui webhook Nombor peti masuk.
Resipinya sama dalam setiap alat:
- Langkau sembang kumpulan (
contact.is_groupialahtrue) dan kenalan yang nombornya disembunyikan oleh WhatsApp (contact.phone_hiddenialahtrue). - Buang kod negara anda dari hadapan
contact.phone(lihat Nombor telefon). - Cari kenalan HubSpot yang Phone number atau Mobile phone numbernya sama dengan nombor itu.
- Jika tiada, cipta kenalan dengan Phone number
+dancontact.phone, dan First namecontact.name. - Cipta nota pada kenalan dengan mesej:
message.content, padamessage.timestamp.
Dengan Zapier#
Anda tidak menetapkan URL webhook di mana-mana: pencetus WbizTool bersambung ke Zapier apabila anda menerbitkan Zap.
Pencetus: WbizTool, Incoming WhatsApp Message
Pilih nombor di bawah WhatsApp Number. Zap mengambil salah satu nombor peti masuk anda (lihat Keperluan pencetus). Hanya mesej yang dihantar orang kepada anda memulakannya.
Filter by Zapier
Teruskan hanya apabila Contact Phone Hidden ialah false dan Is Group ialah false.
Formatter by Zapier: buang kod negara
Pilih Formatter, peristiwa tindakan Numbers, transformasi Format Phone Number. Input:
+diikuti Contact Phone. Pilih format kebangsaan tanpa simbol di bawah To Format, supaya+12125550120menjadi2125550120.HubSpot, Find Contact
Cari mengikut Phone Number dengan output Formatter. Tandakan pilihan untuk mencipta kenalan jika tidak dijumpai, dengan Phone Number
+dan Contact Phone, dan First Name daripada Contact Name.HubSpot, Create Engagement
Jenis Note, dikaitkan dengan ID kenalan daripada langkah Find Contact. Badan:
WhatsApp fromContact Name: Message Content.
Dengan Make#
Import templat
Import hubspot-whatsapp-to-note.make.json dalam senario baharu.
Tambah kunci perkhidmatan HubSpot anda
Dalam HubSpot, pergi ke Development → Keys → Service keys, klik Create service key dan tambah skop baca dan tulis kenalan. Dalam setiap modul HTTP senario itu, gantikan
YOUR_HUBSPOT_SERVICE_KEYdalam pengepalaAuthorizationdengan kunci tersebut.Cipta webhook
Dalam modul Webhooks → Custom webhook, klik Add, namakannya dan salin alamatnya.
Tambah alamat pada nombor peti masuk anda
Dalam WbizTool, buka Nombor peti masuk, klik Tetapan webhook pada kad nombor itu (atau Tambah nombor ke peti masuk), tampal alamat di bawah URL webhook (pilihan) dan klik Simpan. Biarkan Mesej diterima bertanda; tandakan juga Mesej dihantar jika anda mahu balasan anda dalam HubSpot.
Tetapkan kod negara anda
Dalam modul Search the contact by phone, templat membuang
1dari hadapan nombor (/^1/, dua kali). Gantikan1dengan kod negara anda, seperti91.Hidupkan senario
Hantar mesej ke nombor WhatsApp anda dari telefon lain. Ia sampai dalam masa satu atau dua minit, dan Make mempelajari medan webhook daripadanya: semak pemetaan sekali.
Senario itu: Custom webhook → permintaan HTTP ke carian kenalan HubSpot → penghala. Apabila kenalan dijumpai, permintaan HTTP menambah nota padanya. Apabila tiada, satu permintaan mencipta kenalan dan satu lagi menambah nota. Langkah JSON → Transform to JSON menukar mesej dan nama kepada teks JSON, supaya tanda petik dan pemisah baris tidak merosakkan permintaan.
Dengan n8n#
Import aliran kerja
Import hubspot-whatsapp-to-note.n8n.json dan pilih kelayakan HubSpot Service Key dalam nod HubSpot dan HTTP Request. Kunci itu memerlukan skop baca dan tulis kenalan.
Tetapkan kod negara anda
Dalam nod National number, tetapkan
countryCodekepada kod anda, seperti91.Aktifkan dan salin alamat
Aktifkan aliran kerja dan salin Production URL nod WbizTool webhook.
Tambah alamat pada nombor peti masuk anda
Tampalnya sebagai webhook nombor itu di Nombor peti masuk, seperti dalam langkah Make di atas.
Nod HubSpot n8n tiada tindakan nota, jadi aliran kerja mencipta kenalan dan nota dengan nod HTTP Request yang menggunakan kelayakan HubSpot yang sama. Nod Webhook menjawab serta-merta, jauh dalam lingkungan 8 saat yang ditunggu oleh WbizTool.
Dengan Pabbly Connect#
Mulakan dengan Webhook by Pabbly dan tampal URLnya sebagai webhook nombor itu di Nombor peti masuk. Kemudian panggil API HubSpot dengan API (Pabbly) → Execute API Request, dengan kunci perkhidmatan HubSpot sebagai token Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search untuk mencari kenalan, POST …/contacts untuk menciptanya, dan POST …/notes untuk menambah nota (lihat Permintaan yang dibuat oleh pelayan anda).
Pada pelayan anda sendiri#
Terima webhook seperti yang diterangkan dalam Webhook mesej masuk, sahkan tandatangannya, jawab 200 serta-merta, kemudian buat panggilan API HubSpot ini dengan kunci perkhidmatan.
Permintaan yang dibuat oleh pelayan anda
| Langkah | Permintaan | Badan |
|---|---|---|
| Cari kenalan | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups dengan phone EQ nombor tanpa kod negaranya, dan kumpulan kedua dengan mobilephone; limit 1 |
| Cipta jika tiada | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname daripada contact.name |
| Tambah nota | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: hs_timestamp daripada message.timestamp, hs_note_body dengan teks; associations ke kenalan dengan associationCategory HUBSPOT_DEFINED dan associationTypeId 202 (nota ke kenalan) |
{
"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 }]
}
]
}
Titik akhir carian HubSpot membenarkan lima permintaan sesaat bagi setiap akaun. Langkau message.id yang sudah anda rekod: WbizTool boleh, walaupun jarang, menghantar sesuatu mesej dua kali.
Templat#
| Fail | Alat | Apa yang dilakukannya |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Kenalan HubSpot baharu → mesej WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp masuk → nota pada kenalan (memerlukan tambahan Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Kenalan baharu atau peringkat urus niaga → mesej WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp masuk → nota pada kenalan (memerlukan tambahan Unibox) |
Templat tidak mengandungi sebarang kunci. Selepas mengimport, pilih sambungan atau kelayakan anda sendiri dalam setiap langkah, dan gantikan YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, WhatsApp Client ID 678 dan kod negara dengan milik anda.
Penyelesaian masalah#
| Masalah | Apa yang perlu disemak |
|---|---|
Invalid phone number | Telefon kenalan kosong, mengandungi huruf, atau mempunyai kurang daripada 6 atau lebih daripada 17 digit. Tambah penapis yang melangkau kenalan tanpa nombor. |
| Mesej pergi ke nombor yang salah | Nombor itu disimpan tanpa kod negaranya dan tiada kod dihantar. Isi Country Code atau country_code, atau simpan nombor dalam HubSpot dengan +. |
Auth Error: invalid api key | Kunci itu telah dipadam atau tersalah taip. Dalam aliran kerja HubSpot, nilai rahsia mesti Bearer diikuti kunci, dan nama kunci API Authorization. |
Invalid whatsapp client | Gunakan ID nombor itu dari Nombor WhatsApp. |
| Send a webhook tiada dalam tindakan aliran kerja | Ia memerlukan Data Hub Professional atau Enterprise. Gunakan Zapier, Make, n8n atau Pabbly Connect sebaliknya. |
| Make tidak dapat bersambung ke HubSpot | Super Admin akaun HubSpot perlu meluluskan aplikasi Make dahulu. |
| Tiada nota muncul dalam HubSpot | Semak bahawa nombor itu menunjukkan Sedang menyegerak di Nombor peti masuk, bahawa URL webhook ialah URL daripada alat anda dan Mesej diterima ditandakan. Hantar mesej dari telefon lain: balasan dari peti masuk Unibox tidak dihantar. |
| Webhook tidak sampai, atau hos anda menolaknya | Penerima anda mesti menjawab 2xx dalam masa 8 saat dan tidak boleh mengubah hala. Sesetengah tembok api pengehosan menyekat klien yang tidak dikenali: webhook WbizTool datang dengan User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), jadi benarkannya. |
| Kenalan baharu dicipta untuk seseorang yang sudah ada dalam HubSpot | HubSpot tidak menemui nombor itu. Semak bahawa kod negara yang anda buang adalah betul dan nombor kenalan berada dalam Phone number atau Mobile phone number. Untuk pelanggan di banyak negara, lihat Nombor telefon. |
| Mesej direkod dua kali | WbizTool boleh, walaupun jarang, menghantar sesuatu mesej dua kali. Langkau message.id yang sudah anda rekod. |
| Tiada nota untuk sesetengah mesej | Sembang kumpulan dan kenalan yang nombornya disembunyikan oleh WhatsApp dilangkau dengan sengaja. Mesej dari tempoh nombor itu dihentikan tidak dihantar. |

