Integrasi
Pipedrive dan WhatsApp
Sambungkan Pipedrive kepada nombor WhatsApp yang telah anda pautkan ke WbizTool. Hantar mesej kepada seseorang apabila urus niaganya berpindah ke sesuatu peringkat, dan rekod mesej WhatsApp yang mereka hantar kepada anda sebagai nota dalam Pipedrive.
WbizTool tiada aplikasi Pipedrive. Anda menyambungkan kedua-duanya dengan alat yang mungkin sudah anda gunakan: Automations Pipedrive sendiri, Zapier, Make, n8n atau Pabbly Connect. Halaman ini menunjukkan setiap laluan langkah demi langkah, dengan templat siap sedia untuk Make dan n8n.
Siapa yang boleh melakukannya: sesiapa yang mempunyai kunci API WbizTool boleh menghantar mesej. Merekod mesej masuk memerlukan tambahan Unibox ($20 sebulan atau $200 setahun pada harga senarai AS bagi setiap nombor peti masuk, pada pelan berbayar atau seumur hidup) dan Pemilik atau Editor untuk menyediakan webhook. Dalam Pipedrive, anda memerlukan hak yang diminta oleh laluan anda (lihat Pilih laluan).
Apa yang boleh anda lakukan#
| Arah | Contoh | Apa yang diperlukan dalam WbizTool |
|---|---|---|
| Pipedrive → WhatsApp | Urus niaga berpindah ke Proposal sent: orang itu menerima "Hi Emma, your proposal is in your inbox." Orang baharu ditambah: mereka menerima mesej alu-aluan. | Kunci API dan nombor WhatsApp yang disambungkan. |
| WhatsApp → Pipedrive | Pelanggan menulis ke nombor WhatsApp anda: mesej itu ditambah sebagai nota pada orang dengan nombor telefon tersebut, dan orang itu dicipta jika Pipedrive belum mempunyainya. | Tambahan Unibox, dan nombor itu ditambah di Nombor peti masuk. |
Mesej dihantar dari nombor WhatsApp anda sendiri, jadi peraturan WhatsApp terpakai: hantar mesej kepada orang yang menjangka untuk mendengar daripada anda, seperti bakal pelanggan dan pelanggan anda.
Sebelum anda bermula#
- Nombor WhatsApp yang disambungkan di Nombor WhatsApp, dan WhatsApp Client IDnya dari halaman yang sama.
- Client ID dan kunci API anda dari Tetapan → Kunci API. Cipta kunci khas untuk Pipedrive, supaya anda boleh memadamnya secara berasingan kemudian. Lihat Kunci API.
- Nombor telefon dengan kod negaranya dalam Pipedrive, seperti
+44 20 7946 0018. Lihat Nombor telefon. - Untuk mesej masuk: tambahan Unibox dengan nombor peti masuk yang masih kosong. Lihat Nombor peti masuk dan webhook mesej masuk.
Pilih laluan#
| Laluan | Pipedrive → WhatsApp | WhatsApp → Pipedrive | Pelan dan hak Pipedrive |
|---|---|---|---|
| Pipedrive Automations | Ya, tanpa alat lain: tindakan webhook automasi memanggil API WbizTool. | Tidak | Automations dan tindakan webhooknya ada pada pelan Growth dan lebih tinggi. Hanya pentadbir global mencipta automated webhook. |
| Zapier | Ya, dengan tindakan aplikasi WbizTool. | Ya, dengan pencetus WbizTool Incoming WhatsApp Message. | Mana-mana pelan dengan akses Zapier. |
| Make | Ya, dengan modul HTTP Make. Blueprint di bawah. | Ya, dengan webhook Make. Blueprint di bawah. | Mana-mana pelan. Blueprint menggunakan webhook Pipedrive (semua pelan) dan token API Pipedrive. |
| n8n | Ya, dengan Pipedrive Trigger dan nod WbizTool. Aliran kerja di bawah. | Ya, dengan nod Webhook dan nod Pipedrive. Aliran kerja di bawah. | Mana-mana pelan. n8n memerlukan token API Pipedrive. |
| Pabbly Connect | Ya, dengan tindakan permintaan **API (Pabbly)**nya. | Ya, dengan pencetus webhooknya. | Mana-mana pelan. |
Webhooks Pipedrive sendiri (semua pelan) menghantar badan tetap yang tidak dapat dibaca oleh API WbizTool, jadi ia tidak memanggil WbizTool secara terus. Ia memulakan aliran kerja Make, n8n atau Pabbly sebaliknya, seperti dalam resipi Make.
Nombor telefon#
Kedua-dua belah menulis nombor secara berbeza. Ingat peraturan ini apabila anda memetakan medan:
- Untuk menghantar, hantar telefon Pipedrive seadanya. API Hantar mesej membuang ruang, sengkang, titik, kurungan dan
+. Nombor yang ditulis dengan+, seperti+44 20 7946 0018, mengekalkan kod negaranya sendiri. Nombor tempatan, seperti020 7946 0018, memerlukancountry_code(di sini44), atau ia pergi ke nombor yang salah atau gagal. - Mesej masuk memberikan digit sahaja. Dalam webhook,
contact.phoneialah nombor tanpa+, seperti442079460018. Cari dalam Pipedrive dengan digit ini, dan tambah+di hadapan apabila anda mencipta orang. - Pipedrive menyimpan telefon seperti yang ditaip. Cariannya menemui orang melalui digit nombor mereka, tetapi nombor yang disimpan tanpa kod negaranya boleh terlepas. Simpan nombor dengan kod negara.
- Nombor tersembunyi dan kumpulan. WhatsApp kadangkala menyembunyikan nombor pengirim: ketika itu
contact.phonekosong dancontact.phone_hiddenialahtrue. Sembang kumpulan mempunyaicontact.is_groupditetapkan kepadatrue. Resipi di bawah melangkau kedua-duanya.
Pipedrive Automations#
Automations Pipedrive boleh menghantar permintaan webhook sebagai tindakan. Halakan ia ke API Hantar mesej WbizTool dan automasi itu menghantar mesej WhatsApp sendiri, tanpa alat lain.
Dalam Pipedrive: pelan Growth atau lebih tinggi. Hanya pentadbir global boleh mencipta automated webhook; mencipta automasi memerlukan hak untuk menggunakan Automations.
Cipta automated webhook
Dalam Pipedrive, buka menu akaun dan pergi ke Tools and apps → Webhooks. Klik + Webhooks dan pilih Automated webhook. Namakannya "WbizTool", dan masukkan
https://wbiztool.com/api/v1/sebagai URL titik akhir. URL mesti berakhir dengan/, kerana automasi menambah laluan. Biarkan pengesahan kosong: kelayakan WbizTool diletakkan dalam badan.Cipta automasi
Buka menu akaun di bahagian atas kanan, pergi ke Tools and apps → Automations dan klik + Automation. Pilih Event trigger, pilih deal sebagai item dan tetapkan peristiwa pencetus kepada Updated. Pilih peringkat urus niaga sebagai medan untuk dipantau bagi perubahan, dan klik Apply trigger. Kemudian tambah syarat yang menyatakan nama peringkat urus niaga, supaya automasi hanya berjalan apabila urus niaga berpindah ke peringkat itu.
Untuk mesej alu-aluan, pilih person sebagai item dan peristiwa Added sebaliknya.
Tambah tindakan webhook
Tambah tindakan webhook dan pilih webhook "WbizTool". Tetapkan kaedah kepada POST dan tambah laluan
send_msg/.Isi badan
Pilih badan Key-value dan tambah medan di bawah. Gunakan butang medan untuk memasukkan telefon dan nama orang itu.
Kunci Nilai client_idClient ID anda. api_keyKunci API anda. whatsapp_clientWhatsApp Client ID nombor yang menghantar. phoneTelefon orang hubungan, daripada butang medan. country_codeHanya jika nombor Pipedrive anda tempatan, tanpa kod negara: kod panggilan, seperti 44.msgMesej anda, seperti Hi [person's first name], your proposal is in your inbox. Reply here if you have questions.Anda juga boleh memilih Raw dan menulis medan yang sama sebagai JSON. Dengan Key-value anda tidak perlu berhati-hati dengan tanda petik dalam nama.
Ujinya
Simpan automasi, tetapkannya kepada aktif dan pindahkan urus niaga ujian ke peringkat itu. Buka Automations → History dan lariannya: ia menunjukkan badan yang dihantar. WbizTool menjawab
"status": 1apabila mesej beratur; ralat dijawab dengan HTTP400danmessage, sepertiInvalid phone number.
Zapier#
Gunakan aplikasi WbizTool di Zapier dengan aplikasi Zapier Pipedrive.
Urus niaga bertukar peringkat: hantar mesej WhatsApp#
Pencetus: Pipedrive Updated Deal Stage
Pilih Pipedrive dan pencetus Updated Deal Stage. Untuk mesej alu-aluan, gunakan New Person sebaliknya.
Penapis: hanya peringkat anda
Tambah Filter by Zapier dan teruskan hanya apabila peringkat urus niaga ialah yang anda mahu. Pencetus berjalan untuk setiap perubahan peringkat.
Cari telefon orang itu
Jika data pencetus tiada telefon untuk orang urus niaga itu, tambah carian Get Person Pipedrive dengan ID orang urus niaga itu.
Tindakan: WbizTool Send Text-Only WhatsApp Message
Pilih nombor yang menghantar di bawah WhatsApp Number. Petakan telefon orang itu ke Phone Number, isi Country Code hanya jika nombor Pipedrive anda tempatan, dan tulis Message dengan nama orang itu.
Uji dan terbitkan
Langkah yang berjaya bermakna mesej telah beratur. Jika WbizTool tidak dapat menerimanya, langkah itu gagal dengan sebabnya, seperti
WbizTool: Invalid phone number.
Mesej WhatsApp tiba: tambah nota dalam Pipedrive#
Memerlukan tambahan Unibox. Lihat Keperluan pencetus.
Pencetus: WbizTool Incoming WhatsApp Message
Pilih nombor di bawah WhatsApp Number. Apabila anda menerbitkan Zap, WbizTool menambah nombor itu ke peti masuk dan menghantar mesej yang diterimanya ke Zapier.
Penapis: orang, bukan kumpulan
Tambah Filter by Zapier: teruskan hanya apabila Is Group ialah false dan Contact Phone Hidden ialah false.
Cari atau cipta orang
Tambah Find or Create Person Pipedrive: ia mencari orang pada sesuatu medan (pilih medan telefon, dengan Contact Phone) dan mencipta orang apabila tiada yang dijumpai. Untuk orang baharu, tetapkan nama kepada Contact Name dan telefon kepada
+diikuti Contact Phone.Cipta nota
Tambah Create Note Pipedrive. Pautkannya kepada orang daripada langkah sebelumnya, dan tulis kandungan, contohnya:
WhatsApp from Contact Name: Message Content, dengan Message Time jika anda mahukan masanya.
Make#
Tiada aplikasi WbizTool di Make. Dua blueprint ini menggunakan modul Webhooks, HTTP dan JSON Make sendiri: modul HTTP memanggil API WbizTool dan API Pipedrive.
| Blueprint | Apa yang dilakukannya |
|---|---|
| pipedrive-deal-stage-to-whatsapp.blueprint.json | Webhook Pipedrive (urus niaga berubah) → tapis pada peringkat anda → dapatkan orang urus niaga → hantar mesej WhatsApp kepada mereka. |
| whatsapp-to-pipedrive-note.blueprint.json | Webhook mesej masuk WbizTool → cari orang melalui telefon → tambah nota, atau cipta orang itu dahulu. |
Blueprint dibina pada modul generik Make, jadi ia berfungsi pada mana-mana pelan Make dan tidak memerlukan sambungan Pipedrive dalam Make.
Anda memerlukan token API Pipedrive anda (dalam Pipedrive, Settings → Personal preferences → API) dan alamat syarikat Pipedrive anda, seperti yourcompany.pipedrive.com.
Urus niaga bertukar peringkat: hantar mesej WhatsApp#
Import blueprint
Cipta senario dalam Make, klik tiga titik di bar bawah, pilih Import Blueprint dan pilih fail itu.
Cipta webhook
Buka modul pertama (Webhooks → Custom webhook), klik Add, simpan, dan salin alamat yang ditunjukkan oleh Make.
Isi pemegang tempat
- Dalam penapis selepas webhook, gantikan
YOUR_STAGE_IDdengan ID peringkat anda. Untuk mencarinya, pindahkan urus niaga ujian ke peringkat itu sekali dan bacadata.stage_iddalam output webhook. - Dalam modul Get the person, gantikan
YOUR_COMPANYdanYOUR_PIPEDRIVE_API_TOKEN. - Dalam modul Send WhatsApp, gantikan
YOUR_WBIZTOOL_API_KEYdalam pengepalaAuthorization,YOUR_WHATSAPP_CLIENT_IDdalam badan, dan teks mesej.
- Dalam penapis selepas webhook, gantikan
Halakan webhook Pipedrive ke Make
Dalam Pipedrive, pergi ke Settings → Tools and apps → Webhooks dan cipta webhook: event action change (updated dalam versi lama), event object deal, dan alamat Make sebagai URL titik akhir.
Hidupkannya
Hidupkan senario dan pindahkan urus niaga ujian ke peringkat itu. Output modul HTTP menunjukkan jawapan WbizTool:
"status": 1bermakna mesej telah beratur.
Untuk membinanya dengan modul Pipedrive Make sebaliknya, gunakan Watch New Events (atau Custom webhook seperti di atas), Get a Person, dan modul HTTP dengan permintaan yang sama seperti modul Send WhatsApp blueprint. Modul Pipedrive Make mengembalikan orang urus niaga sebagai ID sahaja, jadi anda memerlukan Get a Person untuk telefonnya.
Mesej WhatsApp tiba: tambah nota dalam Pipedrive#
Import blueprint
Import
whatsapp-to-pipedrive-note.blueprint.jsondalam senario baharu.Cipta webhook
Buka Webhooks → Custom webhook, klik Add, simpan dan salin alamatnya.
Isi pemegang tempat
Gantikan
YOUR_COMPANYdanYOUR_PIPEDRIVE_API_TOKENdalam empat modul HTTP Pipedrive (carian, mencipta orang, dan dua nota).Tambah alamat dalam WbizTool
Di Nombor peti masuk, tambah nombor anda ke peti masuk, atau buka Tetapan webhook pada kadnya. Tampal alamat Make di bawah URL webhook, biarkan hanya Mesej diterima bertanda, dan simpan.
Hidupkan dan uji
Hidupkan senario dan hantar mesej ke nombor WhatsApp anda dari telefon lain. Dalam masa satu atau dua minit nota muncul pada orang itu dalam Pipedrive.
Blueprint melangkau sembang kumpulan, nombor tersembunyi dan mesej yang dihantar. Untuk membinanya dengan modul Pipedrive Make sebaliknya, gunakan Search Persons pada medan telefon, penghala, Create a Person dan Create a Note.
n8n#
Gunakan nod Pipedrive Trigger dan Pipedrive n8n dengan nod komuniti WbizTool (n8n-nodes-wbiztool). Pasang nod komuniti dahulu.
| Aliran kerja | Apa yang dilakukannya |
|---|---|
| pipedrive-deal-stage-to-whatsapp.n8n.json | Pipedrive Trigger (urus niaga berubah) → If urus niaga berpindah ke peringkat anda → Pipedrive Get orang → WbizTool Send Message. |
| whatsapp-to-pipedrive-note.n8n.json | Webhook (mesej masuk WbizTool) → If ia mesej daripada seseorang → Pipedrive Search orang melalui telefon → Create nota, dengan mencipta orang dahulu apabila tiada yang dijumpai. |
Import aliran kerja
Dalam n8n, cipta aliran kerja, buka menu ⋯ dan pilih Import from File. Anda juga boleh menampal kandungan fail pada kanvas.
Tambah kelayakan
Buka setiap nod Pipedrive dan cipta kelayakan Pipedrive API dengan token API Pipedrive anda (Settings → Personal preferences → API dalam Pipedrive). Buka nod WbizTool Send Message dan pilih kelayakan WbizTool API anda (Client ID, kunci API dan WhatsApp Client ID yang menghantar).
Tetapkan peringkat dan mesej anda
Dalam aliran kerja pertama, gantikan
YOUR_STAGE_IDdalam nod If dengan ID peringkat anda (pindahkan urus niaga ujian ke peringkat itu dan bacadata.stage_iddalam output pencetus), dan edit Message Text. Biarkan Country Code kosong apabila nombor Pipedrive anda mengandungi kod negara.Aktifkan
Aktifkan aliran kerja. Pipedrive Trigger mencipta webhooknya dalam Pipedrive dengan sendirinya.
Untuk aliran kerja kedua, salin Production URL nod Webhook dan tampalnya di bawah URL webhook di Nombor peti masuk, dengan hanya Mesej diterima ditandakan.
Nod Pipedrive dalam fail ini ialah versi 2 nod Pipedrive n8n. Jika n8n anda lebih lama dan menunjukkannya sebagai tidak dikenali, kemas kini n8n atau gantikannya dengan nod Pipedrive versi anda, menggunakan tetapan yang sama.
Pabbly Connect#
Tiada aplikasi WbizTool di Pabbly Connect: gunakan modul umumnya.
- Pipedrive → WhatsApp: mulakan aliran kerja dengan pencetus Pipedrive Pabbly, atau dengan pencetus webhooknya yang disuap oleh webhook Pipedrive. Kemudian tambah API (Pabbly) dengan Execute API Request ke
https://wbiztool.com/api/v1/send_msg/, disediakan seperti dalam Pabbly Connect, dan petakan telefon dan nama orang itu. - WhatsApp → Pipedrive: mulakan dengan pencetus webhook Pabbly, tampal alamatnya di bawah URL webhook di Nombor peti masuk, dan hantar mesej ujian ke nombor anda supaya Pabbly melihat medan-medannya. Kemudian tambah langkah Pipedrive Pabbly: cari orang melalui
contact.phone, cipta mereka jika perlu, dan tambah nota denganmessage.content.
Apa yang tiba dari WhatsApp#
Setiap mesej masuk ialah satu permintaan JSON. Medan yang digunakan oleh resipi:
| Medan | Contoh | Gunakan untuk |
|---|---|---|
event | message_received | Langkau message_sent jika anda turut menandakan Mesej dihantar. |
contact.phone | 12125550120 | Carian Pipedrive, dan telefon orang baharu (dengan +). |
contact.name | Emma Thompson | Nama orang baharu. Boleh kosong: gunakan telefon dalam keadaan itu. |
contact.is_group, contact.phone_hidden | false | Langkau sembang kumpulan dan nombor tersembunyi. |
message.content | Can I add a gift note to it? | Nota. Foto dan fail tiba sebagai label, seperti 📸 Image. |
message.timestamp | 2026-10-15T10:30:04+00:00 | Masa ia dihantar, dalam UTC. |
Semua medan, tandatangan dan cubaan semula ada di Nombor peti masuk dan webhook mesej masuk.
Penyelesaian masalah#
| Masalah | Apa yang perlu disemak |
|---|---|
Auth Error: invalid api key | Kunci itu telah dipadam atau tersalah taip, atau bukan milik ruang kerja Client ID itu. Dalam Make dan n8n, semak pengepala Authorization: Bearer atau kelayakan. |
Invalid phone number | Medan telefon kosong atau mengandungi sesuatu yang lain, seperti nama. Semak bahawa orang itu mempunyai telefon dalam Pipedrive dan anda telah memetakan medan telefon. |
| Mesej pergi ke nombor yang salah | Pipedrive menyimpan nombor itu tanpa kod negaranya. Simpannya dengan kod, seperti +44 20 7946 0018, atau hantar country_code. |
Invalid JSON format: … | Badan JSON mentah rosak, selalunya pada tanda petik atau pemisah baris dalam medan yang dipetakan. Dalam Pipedrive Automations gunakan badan Key-value; dalam Make kekalkan modul JSON blueprint. |
| Larian automasi menyatakan "Maximum retry limit reached" | WbizTool menjawab dengan ralat. Buka larian dalam Automations → History dan baca badan yang dihantar. |
| Tiada webhook tiba dari WbizTool | Nombor itu mesti menunjukkan Sedang menyegerak di Nombor peti masuk, dengan Mesej diterima ditandakan, pada tambahan Unibox. Make, n8n dan Pabbly mesti menjawab 2xx dalam masa 8 saat: hidupkan senario atau aliran kerja. Mesej dihantar dalam masa satu atau dua minit. |
| Pelayan atau tembok api anda menolak webhook WbizTool | Benarkan permintaan dengan User-Agent WbizTool-Webhooks/1. Sesetengah hos menyekat klien yang tidak dikenali dengan 403. |
| Nota ditambah tetapi orang itu tidak dijumpai, jadi orang pendua dicipta | Nombor orang itu dalam Pipedrive disimpan dalam bentuk lain, seperti tanpa kod negara. Simpannya dengan kod, kemudian gabungkan kedua-dua orang itu dalam Pipedrive. |
| Tiada apa berlaku untuk mesej kumpulan | Itu memang disengajakan: resipi melangkau sembang kumpulan dan nombor tersembunyi, yang tiada telefon untuk dipadankan. |
Berkaitan#
- API Hantar mesej: setiap medan yang boleh anda hantar
- Nombor peti masuk dan webhook mesej masuk
- Kunci API
- Integrasi Zapier
- Integrasi n8n
- Hantar mesej WhatsApp dari mana-mana alat automasi: Make, Pabbly Connect dan lain-lain

