Langkau ke kandungan
WbizTool

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#

LaluanHubSpot → WhatsAppWhatsApp → HubSpotApa yang diperlukan
ZapierPencetus New Contact atau Updated Deal Stage, kemudian tindakan hantar WbizToolPencetus WbizTool Incoming WhatsApp Message, kemudian HubSpot Find Contact dan Create EngagementAkaun Zapier. Tiada webhook untuk disediakan.
MakeHubSpot CRM Watch Contacts, kemudian modul HTTPWebhook tersuai Make, kemudian permintaan HTTP ke API HubSpotAkaun Make. Tiada aplikasi WbizTool di Make: modul HTTP memanggil API WbizTool.
n8nHubSpot Trigger, kemudian WbizTool Send MessageNod Webhook, kemudian nod HubSpot dan permintaan HTTP ke HubSpotn8n dengan nod komuniti WbizTool. HubSpot Trigger memerlukan akaun pembangun dan aplikasi HubSpot.
Pabbly ConnectPencetus HubSpot, kemudian API (Pabbly)Webhook by Pabbly, kemudian permintaan API ke HubSpotAkaun Pabbly Connect. Ia berfungsi melalui langkah HTTP dan webhook Pabbly.
Aliran kerja HubSpotTindakan Send a webhook memanggil API WbizTool terusGunakan laluan lainData 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:

  1. Pencetus: HubSpot, New Contact

    Pilih HubSpot dan pencetus New Contact, dan sambungkan akaun HubSpot anda.

  2. Filter by Zapier

    Teruskan hanya apabila nombor telefon kenalan exists. Kenalan tanpa nombor akan gagal pada langkah seterusnya.

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

  4. Uji dan terbitkan

    Langkah yang berjaya bermakna mesej telah beratur. WbizTool kemudian menghantarnya dari nombor anda.

Apabila urus niaga berpindah ke sesuatu peringkat:

  1. Pencetus: HubSpot, Updated Deal Stage

    Pilih Updated Deal Stage dan pilih saluran paip dan peringkat, seperti Closed won.

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

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

  1. Import templat atau mulakan senario

    Import hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint dalam senario baharu), atau binanya dengan langkah di bawah.

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

  3. HTTP, Make a request

    Kaedah POST, URL https://wbiztool.com/api/v1/send_msg/. Tambah pengepala Authorization dengan nilai Bearer YOUR_API_KEY. Jenis badan application/x-www-form-urlencoded, dengan medan-medan ini:

    MedanNilai
    whatsapp_clientWhatsApp Client ID anda, seperti 678
    phonePhone number kenalan dari modul HubSpot
    country_codeHanya jika nombor anda disimpan tanpanya, seperti 1
    msgTeks anda, dengan medan seperti nama pertama dipetakan ke dalamnya
  4. 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": 1 bermakna 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.

  1. Pasang nod WbizTool

    Pasang n8n-nodes-wbiztool dan cipta kelayakan WbizTool API. Lihat Integrasi n8n.

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

  3. Import aliran kerja

    Dalam n8n, import fail itu dan pilih kelayakan anda dalam setiap nod HubSpot, HTTP Request dan WbizTool.

  4. Tetapkan peringkat dan mesej anda

    Dalam nod Deal stage is, gantikan closedwon dengan nilai dalaman peringkat anda. Edit teks dalam dua nod WbizTool Send Message, dan tetapkan Country Code di sana hanya jika nombor anda disimpan tanpanya.

  5. Aktifkan

    Pencetus kemudian mendaftarkan webhooknya dengan HubSpot.

Apa yang dilakukan oleh aliran kerja:

  1. HubSpot Trigger dengan dua peristiwa: Contact Created, dan Deal Property Changed untuk sifat Deal Stage.
  2. Nod IF menghantar peristiwa kenalan ke satu arah dan peristiwa urus niaga ke arah yang lain.
  3. Untuk urus niaga, ia menyemak peringkat baharu, kemudian membaca urus niaga dan kenalan yang dikaitkan dengannya melalui HTTP Request ke HubSpot.
  4. HubSpot → Search Contacts membaca nama pertama dan nombor telefon kenalan.
  5. 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.

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

  2. Tambah Send a webhook

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

  3. Tetapkan pengesahan

    Pilih API key sebagai jenis pengesahan. Tambah rahsia yang nilainya Bearer YOUR_API_KEY (dengan kunci WbizTool anda), tetapkan nama kunci API kepada Authorization dan lokasi kepada Request header.

  4. Sesuaikan badan permintaan

    Pilih Customize request body dan tambah:

    KunciNilai
    phoneSifat: Phone number
    whatsapp_clientNilai statik: WhatsApp Client ID anda, seperti 678
    msgNilai statik: mesej anda
    country_codeNilai statik, hanya jika nombor anda disimpan tanpanya
  5. 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 msg ialah 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 4xx kecuali 429, jadi mesej yang ditolak, seperti Invalid phone number, tidak dihantar semula. Untuk menghalang cubaan semula selepas tamat masa daripada menghantar mesej dua kali, tambah kunci idempotency_key dengan 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:

  1. Langkau sembang kumpulan (contact.is_group ialah true) dan kenalan yang nombornya disembunyikan oleh WhatsApp (contact.phone_hidden ialah true).
  2. Buang kod negara anda dari hadapan contact.phone (lihat Nombor telefon).
  3. Cari kenalan HubSpot yang Phone number atau Mobile phone numbernya sama dengan nombor itu.
  4. Jika tiada, cipta kenalan dengan Phone number + dan contact.phone, dan First name contact.name.
  5. Cipta nota pada kenalan dengan mesej: message.content, pada message.timestamp.

Dengan Zapier#

Anda tidak menetapkan URL webhook di mana-mana: pencetus WbizTool bersambung ke Zapier apabila anda menerbitkan Zap.

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

  2. Filter by Zapier

    Teruskan hanya apabila Contact Phone Hidden ialah false dan Is Group ialah false.

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

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

  5. HubSpot, Create Engagement

    Jenis Note, dikaitkan dengan ID kenalan daripada langkah Find Contact. Badan: WhatsApp from Contact Name: Message Content.

Dengan Make#

  1. Import templat

    Import hubspot-whatsapp-to-note.make.json dalam senario baharu.

  2. 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_KEY dalam pengepala Authorization dengan kunci tersebut.

  3. Cipta webhook

    Dalam modul Webhooks → Custom webhook, klik Add, namakannya dan salin alamatnya.

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

  5. Tetapkan kod negara anda

    Dalam modul Search the contact by phone, templat membuang 1 dari hadapan nombor (/^1/, dua kali). Gantikan 1 dengan kod negara anda, seperti 91.

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

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

  2. Tetapkan kod negara anda

    Dalam nod National number, tetapkan countryCode kepada kod anda, seperti 91.

  3. Aktifkan dan salin alamat

    Aktifkan aliran kerja dan salin Production URL nod WbizTool webhook.

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

LangkahPermintaanBadan
Cari kenalanPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups dengan phone EQ nombor tanpa kod negaranya, dan kumpulan kedua dengan mobilephone; limit 1
Cipta jika tiadaPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname daripada contact.name
Tambah notaPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: 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#

FailAlatApa yang dilakukannya
hubspot-new-contact-to-whatsapp.make.jsonMakeKenalan HubSpot baharu → mesej WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp masuk → nota pada kenalan (memerlukan tambahan Unibox)
hubspot-to-whatsapp.n8n.jsonn8nKenalan baharu atau peringkat urus niaga → mesej WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp 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#

MasalahApa yang perlu disemak
Invalid phone numberTelefon 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 salahNombor 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 keyKunci itu telah dipadam atau tersalah taip. Dalam aliran kerja HubSpot, nilai rahsia mesti Bearer diikuti kunci, dan nama kunci API Authorization.
Invalid whatsapp clientGunakan ID nombor itu dari Nombor WhatsApp.
Send a webhook tiada dalam tindakan aliran kerjaIa memerlukan Data Hub Professional atau Enterprise. Gunakan Zapier, Make, n8n atau Pabbly Connect sebaliknya.
Make tidak dapat bersambung ke HubSpotSuper Admin akaun HubSpot perlu meluluskan aplikasi Make dahulu.
Tiada nota muncul dalam HubSpotSemak 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 menolaknyaPenerima 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 HubSpotHubSpot 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 kaliWbizTool boleh, walaupun jarang, menghantar sesuatu mesej dua kali. Langkau message.id yang sudah anda rekod.
Tiada nota untuk sesetengah mesejSembang kumpulan dan kenalan yang nombornya disembunyikan oleh WhatsApp dilangkau dengan sengaja. Mesej dari tempoh nombor itu dihentikan tidak dihantar.

Berkaitan#