Integrasi
GoHighLevel dan WhatsApp
Sambungkan GoHighLevel (HighLevel) kepada WbizTool dan aliran kerja anda menghantar mesej WhatsApp dari nombor WhatsApp anda sendiri. Mesej WhatsApp masuk juga boleh kembali ke HighLevel, sebagai nota, tag atau tugasan pada kenalan.
Semua yang ada di halaman ini menggunakan ciri yang sudah wujud di kedua-dua belah: webhook aliran kerja HighLevel, serta API Hantar mesej dan webhook mesej masuk WbizTool. Anda tidak perlu memasang apa-apa.
Siapa yang boleh melakukannya: Dalam WbizTool, Pemilik mencipta kunci API (Kunci API), dan Pemilik atau Editor menyediakan webhook mesej masuk. Dalam HighLevel, seseorang yang boleh mengedit aliran kerja dalam sub-akaun membinanya. Agensi mesti menghidupkan ciri aliran kerja premium HighLevel (lihat Sebelum anda bermula).
Apa yang boleh anda lakukan#
| Arah | Contoh | Cara |
|---|---|---|
| HighLevel → WhatsApp | Borang dihantar, tag ditambah atau temu janji ditempah, dan kenalan menerima mesej WhatsApp. | Tindakan Custom Webhook dalam aliran kerja HighLevel memanggil API Hantar mesej WbizTool. |
| WhatsApp → HighLevel | Pelanggan menghantar mesej ke nombor WhatsApp anda, dan mesej itu ditambah sebagai nota pada kenalan HighLevel mereka. Kenalan dicipta jika belum wujud. | Nombor peti masuk WbizTool menghantar setiap mesej ke pencetus Inbound Webhook HighLevel. Ia memerlukan tambahan Unibox. |
Sebelum anda bermula#
- Nombor WhatsApp yang disambungkan di Nombor WhatsApp, dan WhatsApp Client IDnya (ID yang ditunjukkan untuk nombor itu), contohnya
678. - Kunci API WbizTool dari Tetapan → Kunci API. Dalam HighLevel ia diletakkan dalam pengepala
Authorization: Bearer, jadi anda tidak memerlukan Client ID. Lihat Hantar kunci dalam pengepala. - Ciri aliran kerja premium HighLevel. HighLevel menyenaraikan Custom Webhook dan Inbound Webhook sebagai ciri aliran kerja premium. Agensi pada mana-mana pelan HighLevel boleh menghidupkannya: dalam Agency View, pergi ke Settings → Company dan dayakan Workflow - Premium Features. HighLevel mengenakan bayaran bagi setiap larian premium, dan setiap sub-akaun mendapat 100 larian premium percuma (sekali sahaja, bukan setiap bulan). Agensi boleh mengenakan semula bayaran ini kepada sub-akaun. Harga HighLevel ada di halaman bantuannya sendiri.
- Untuk mesej masuk sahaja: tambahan Unibox pada pelan WbizTool berbayar atau seumur hidup (bukan percubaan percuma). Harganya $20 sebulan atau $200 setahun pada harga senarai AS bagi setiap nombor WhatsApp dalam peti masuk. Pemilik menambahnya di Bil & pelan (lihat Tambahan).
Pilih laluan#
Laluan aliran kerja HighLevel ialah yang paling ringkas: HighLevel memanggil WbizTool terus, tanpa alat lain di tengah. Gunakan alat automasi hanya jika aliran kerja anda sudah berjalan di sana.
| Laluan | Hantar (HighLevel → WhatsApp) | Terima (WhatsApp → HighLevel) | Pelan yang anda perlukan |
|---|---|---|---|
| Aliran kerja HighLevel (disyorkan) | Tindakan Custom Webhook → API Hantar mesej | Webhook WbizTool → pencetus Inbound Webhook | Ciri aliran kerja premium HighLevel. Terima: tambahan Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact atau Add Task | Akaun Zapier. Terima: tambahan Unibox. |
| Make | Tindakan Webhook HighLevel → Make Webhooks → modul HTTP | Webhook WbizTool → Make Webhooks → API HighLevel | Akaun Make. Terima: tambahan Unibox. |
| n8n | Tindakan Webhook HighLevel → n8n Webhook → WbizTool Send Message | Webhook WbizTool → n8n Webhook → nod HighLevel | n8n dengan nod komuniti WbizTool. Terima: tambahan Unibox. |
| Pabbly Connect | Tindakan Webhook HighLevel → pencetus webhook Pabbly → permintaan API (Pabbly) | Webhook WbizTool → pencetus webhook Pabbly → langkah HighLevel anda | Akaun Pabbly Connect. Terima: tambahan Unibox. |
Hantar mesej WhatsApp dari aliran kerja HighLevel#
Buka atau cipta aliran kerja
Dalam sub-akaun HighLevel anda, buka Automation dan cipta aliran kerja, atau edit yang sedia ada. Berikan pencetus yang anda mahu, seperti penghantaran borang, tag baharu atau temu janji yang ditempah.
Tambah tindakan Custom Webhook
Klik + di tempat mesej patut dihantar, kemudian Send Data → Custom Webhook (atau cari "webhook" dalam senarai tindakan dan pilih Custom Webhook). Tindakan Webhook biasa tidak boleh menetapkan pengepala dan badan yang diperlukan oleh API ini.
Tetapkan permintaan
Tetapkan Event kepada CUSTOM dan Method kepada POST. Tetapkan URL kepada
https://wbiztool.com/api/v1/send_msg/. Untuk Authorization, pilih Bearer Token dan tampal kunci API WbizTool anda, atau pilih tanpa pengesahan dan tambah pengepalaAuthorizationdengan nilaiBearer YOUR_API_KEY. Tetapkan Content-Type kepadaapplication/json.Tampal badan
Tampal salah satu blok salin-tampal ke dalam Raw Body dan gantikan
678dengan WhatsApp Client ID anda. Gunakan ikon tag HighLevel untuk menambah lebih banyak medan kenalan ke dalam mesej.Uji dan terbitkan
Simpan tindakan dan terbitkan aliran kerja. Jalankannya pada kenalan ujian dengan nombor telefon anda sendiri. Setiap larian ditunjukkan dalam log pelaksanaan aliran kerja. Apabila WbizTool menerima mesej itu, ia menjawab
"status": 1. Mesej itu kemudian dihantar dari nombor WhatsApp anda.
Medan nombor telefon#
Gunakan {{contact.phone_raw}}, bukan {{contact.phone}}. {{contact.phone}} HighLevel diformat untuk dibaca, seperti (515) 555-2345, tanpa kod negara. {{contact.phone_raw}} ialah nombor yang sama dalam format antarabangsa, seperti +15155552345.
WbizTool membuang +, ruang, sengkang dan kurungan untuk anda. Nombor yang ditulis dengan + sudah mengandungi kod negaranya, jadi anda tidak perlu menghantar country_code. Jika sesetengah kenalan anda disimpan tanpa kod negara, tambah "country_code": "1" (kod panggilan negara anda) pada badan. Ia hanya ditambah pada nombor yang ditulis tanpa +. Lihat Hantar mesej → phone.
Blok salin-tampal#
URL: https://wbiztool.com/api/v1/send_msg/ · Kaedah: POST · Pengepala: Authorization: Bearer YOUR_API_KEY dan Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: ID nombor yang menghantar. Anda boleh meninggalkannya hanya apabila ruang kerja anda mempunyai tepat satu nombor yang disambungkan.msg: sehingga 3,000 aksara. Format WhatsApp berfungsi:*bold*,_italic_. Untuk baris baharu, taip\ndi dalam teks. Pemisah baris sebenar menjadikan JSON tidak sah.- Imej dan fail: pautan mesti awam.
msgmenjadi kapsyen. Lihat Menghantar imej dan fail. expire_after_seconds: jika mesej belum dihantar dalam tempoh ini, contohnya kerana nombor itu terputus, ia ditandakan tamat tempoh dan tidak dihantar.- Kumpulan:
group_nameialah nama tepat kumpulan WhatsApp yang disertai nombor anda. Hantargroup_nameatauphone, jangan kedua-duanya. Lihat Hantar ke kumpulan.
Rekod mesej WhatsApp masuk dalam HighLevel#
Arah ini memerlukan tambahan Unibox. Setiap mesej yang diterima oleh nombor WhatsApp anda dihantar ke pencetus Inbound Webhook HighLevel. Aliran kerja kemudian mencari atau mencipta kenalan dan menambah mesej itu sebagai nota, tag atau tugasan. Mesej tidak muncul di tempat lain dalam HighLevel.
Cipta aliran kerja dengan pencetus Inbound Webhook
Dalam HighLevel, cipta aliran kerja dan pilih pencetus Inbound Webhook. Salin URL webhook yang ditunjukkannya.
Halakan nombor WhatsApp anda kepadanya
Dalam WbizTool, buka Nombor peti masuk. Klik Tambah nombor ke peti masuk, pilih nombor dan tampal URL HighLevel di bawah URL webhook (pilihan). Untuk nombor yang sudah berada dalam peti masuk, tampalnya dalam Tetapan webhook nombor itu. Di bawah Mesej untuk dihantar, tandakan Mesej diterima sahaja. Setiap penghantaran ialah satu larian premium dalam HighLevel, jadi biarkan Mesej dihantar tidak bertanda melainkan anda memerlukannya.
Hantar mesej ujian
Dari telefon lain, hantar mesej ke nombor WhatsApp anda. Ia dihantar selepas semakan seterusnya, biasanya dalam masa satu atau dua minit. Dalam HighLevel, klik Test Trigger, pilih permintaan di bawah Mapping Reference dan simpan pencetus. Medan-medannya disenaraikan dalam Payload.
Langkau kumpulan dan nombor tersembunyi
Tambah langkah If/Else yang hanya diteruskan apabila
eventialahmessage_received,contact.is_groupialahfalsedancontact.phonetidak kosong. WhatsApp kadangkala menyembunyikan nombor pengirim, dan mesej kumpulan membawa ID kumpulan dan bukannya nombor telefon.Cari atau cipta kenalan
Dalam tindakan Create/Update Contact, tetapkan Phone kepada
+diikuti contact → phone daripada nilai Inbound Webhook. WbizTool menghantar nombor tanpa+, dan+memberitahu HighLevel bahawa ia mengandungi kod negara. Anda juga boleh memetakan contact → name. Ia ialah nama WhatsApp pengirim, dan ia mungkin menggantikan nama yang telah anda edit dalam HighLevel.Tambah mesej pada kenalan
Tambah tindakan Add to Notes. Tulis nota seperti "Mesej WhatsApp:" dan pilih message → content dan message → timestamp daripada nilai Inbound Webhook. Anda juga boleh menambah Add Contact Tag (contohnya
whatsapp), tugasan atau pemberitahuan dalaman untuk pasukan anda.Terbitkan
Terbitkan aliran kerja dan hantar satu lagi mesej ujian.
| Nilai Inbound Webhook | Gunakan untuk |
|---|---|
contact.phone | Telefon kenalan. Tambah + di hadapan. |
contact.name | Nama WhatsApp pengirim. Boleh kosong. |
message.content | Teks. Untuk foto, nota suara dan fail ia ialah label seperti 📸 Image, dan kapsyen tidak disertakan. |
message.timestamp | Masa mesej dihantar di WhatsApp (ISO 8601, UTC). |
message.media.url | Pautan muat turun untuk foto atau fail. Ia tamat tempoh selepas 3½ hingga 7 hari, jadi jangan bergantung padanya dalam nota. |
whatsapp_phone | Nombor anda yang mana menerimanya, jika beberapa nombor menghantar ke aliran kerja yang sama. |
event | message_received atau message_sent. |
- Hanya mesej baharu dihantar, dari saat webhook ditetapkan. Sembang lama tidak diimport.
- Satu webhook bagi setiap nombor. Setiap nombor peti masuk menghantar ke satu URL. Jika Zap Zapier menggunakan pencetus Incoming WhatsApp Message untuk nombor yang sama, Zap itu mengambil alih webhook selagi ia hidup.
- Jawab dari HighLevel: untuk membalas di WhatsApp dari aliran kerja yang sama, tambah tindakan Custom Webhook dengan
"phone": "{{contact.phone_raw}}". - Rahsiakan URL. Inbound Webhook HighLevel tidak menyemak tandatangan WbizTool, jadi sesiapa yang mempunyai URL itu boleh menghantar kepadanya. Jika ia bocor, cipta pencetus baharu dan tampal URLnya dalam WbizTool.
Zapier#
Aplikasi HighLevel di Zapier dipanggil LeadConnector. Ia mempunyai satu pencetus, Pipeline Stage Changed. Tindakannya termasuk Add/Update Contact dan Add Task. Lihat Integrasi Zapier untuk menyambungkan WbizTool.
- Hantar: cetuskan LeadConnector Pipeline Stage Changed, kemudian langkah Filter by Zapier untuk peringkat yang anda mahu, kemudian WbizTool Send Text-Only WhatsApp Message. Pilih nombor di bawah WhatsApp Number, petakan telefon kenalan ke Phone Number dan tulis Message. Untuk peristiwa HighLevel lain, gunakan tindakan Custom Webhook sebaliknya.
- Terima: cetuskan WbizTool Incoming WhatsApp Message (memerlukan tambahan Unibox), kemudian langkah Filter by Zapier yang hanya diteruskan apabila Contact Phone Hidden dan Is Group ialah false. Kemudian LeadConnector Add/Update Contact dengan telefon ditetapkan kepada
+dan Contact Phone, kemudian LeadConnector Add Task dengan Message Content.
Make#
Aplikasi HighLevel di Make dipanggil GoHighLevel. Templat ini hanya menggunakan modul generik Make Webhooks, JSON dan HTTP, jadi anda tidak memerlukan sambungan GoHighLevel dalam Make. Templat terima memerlukan token Private Integration HighLevel dan ID lokasi anda sebaliknya (lihat di bawah).
Import blueprint
Muat turun templat di bawah. Dalam Make, cipta senario, buka menu … dan pilih Import blueprint.
Cipta webhook
Buka modul Webhooks, klik Add untuk mencipta webhook dan salin alamatnya.
Isi pemegang tempat
Gantikan setiap pemegang tempat dalam huruf besar dalam modul HTTP, seperti
YOUR_WBIZTOOL_API_KEYdanYOUR_WHATSAPP_CLIENT_ID.Sambungkan webhook
Hantar: dalam HighLevel, tambah tindakan Webhook pada aliran kerja anda dengan alamat Make sebagai URLnya. Di bawah Custom Data, tambah kunci
phone_rawdengan nilai{{contact.phone_raw}}. Terima: tampal alamat Make sebagai URL webhook nombor itu di Nombor peti masuk, dengan hanya Mesej diterima ditandakan.Jalankan sekali
Klik Run once dalam Make dan cetuskan aliran kerja, atau hantar mesej WhatsApp ke nombor anda.
Templat terima menulis ke HighLevel melalui APInya dengan token Private Integration dari tetapan sub-akaun anda, dengan skop contacts.write, dan ID lokasi sub-akaun anda. Anda boleh menggunakan modul Create a Contact dan Add a Note to the Contact aplikasi GoHighLevel sebaliknya.
n8n#
n8n mempunyai nod HighLevel terbina dalam. Operasi Contact → Create or Updatenya mencari kenalan melalui telefon atau e-mel, atau menciptanya, dan boleh menambah Note. Pasang nod komuniti WbizTool dahulu: lihat Integrasi n8n.
Import aliran kerja
Muat turun templat di bawah. Dalam n8n, cipta aliran kerja dan import fail itu (menu … → Import from File, atau tampal JSON pada kanvas).
Tambah kelayakan anda
Buka nod WbizTool Send Message dan pilih atau cipta kelayakan WbizTool API. Dalam aliran kerja terima, buka nod HighLevel dan pilih atau cipta kelayakan HighLevel.
Sambungkan webhook
Salin URL pengeluaran nod Webhook. Hantar: gunakannya sebagai URL tindakan Webhook HighLevel, dengan kunci Custom Data
phone_rawditetapkan kepada{{contact.phone_raw}}. Terima: tampalnya sebagai URL webhook nombor itu di Nombor peti masuk, dengan hanya Mesej diterima ditandakan.Aktifkan
Aktifkan aliran kerja dan jalankan ujian.
Pabbly Connect#
Gunakan pencetus webhook Pabbly Connect sendiri dan tindakan **API (Pabbly)**nya, disediakan seperti dalam Hantar mesej WhatsApp dari mana-mana alat automasi. Untuk arah hantar, halakan tindakan Webhook HighLevel ke URL webhook Pabbly dan petakan phone_raw ke phone. Untuk mesej masuk, tampal URL webhook Pabbly sebagai URL webhook nombor itu di Nombor peti masuk.
Templat#
| Fail | Apa yang dilakukannya |
|---|---|
| ghl-blocks.md | Blok salin-tampal di halaman ini, dalam satu fail. |
| gohighlevel-to-whatsapp.make.json | Make: webhook HighLevel → mesej WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: mesej WhatsApp masuk → kenalan dan nota HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook HighLevel → mesej WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: mesej WhatsApp masuk → kenalan HighLevel dengan nota. |
Templat tidak mengandungi sebarang kunci. Tambah kunci anda sendiri dalam pemegang tempat atau kelayakan selepas mengimport.
Penyelesaian masalah#
| Masalah | Apa yang perlu dilakukan |
|---|---|
Mesej pergi ke nombor yang salah, atau Invalid phone number | Gunakan {{contact.phone_raw}}, bukan {{contact.phone}}. Jika nombor kenalan tiada kod negara dalam HighLevel, tambah country_code pada badan atau betulkan kenalan itu. |
Either phone or group_name parameter is required | Kenalan tiada nombor telefon. Tambah langkah If/Else sebelum tindakan. |
Auth Error: invalid api key | Semak pengepala Authorization: Bearer, satu ruang, kemudian kunci, tanpa tanda petik. Kunci itu mungkin telah dipadam. Lihat Kunci API. |
Invalid whatsapp client atau Invalid whatsapp client id. | Gunakan WhatsApp Client ID dari Nombor WhatsApp. Ia diperlukan apabila anda mempunyai lebih daripada satu nombor. |
Invalid JSON format: … | Badan bukan JSON yang sah: koma tertinggal, koma berlebihan di hujung, pemisah baris sebenar dalam msg, atau nilai gabungan yang mengandungi tanda petik berganda. |
"status": 1, tetapi tiada apa yang sampai | Mesej beratur sehingga nombor WhatsApp anda disambungkan. Semak Nombor WhatsApp dan Status mesej. |
| Tindakan Custom Webhook atau Inbound Webhook tiada | Agensi belum menghidupkan ciri aliran kerja premium (Workflow - Premium Features), atau sub-akaun telah menggunakan larian percumanya dan tidak dikenakan bayaran semula. Tanya agensi anda. |
| Tiada mesej masuk sampai ke HighLevel | Nombor itu mesti menunjukkan Sedang menyegerak di Nombor peti masuk, dengan URL yang betul dan Mesej diterima ditandakan. Penerima mesti menjawab 2xx dalam masa 8 saat. Permintaan datang dengan User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), sekiranya tembok api menapis berdasarkannya. Maklumat lanjut dalam Webhook mesej masuk. |
| Tambahan Unibox diperlukan | Mesej masuk memerlukan tambahan Unibox pada pelan berbayar atau seumur hidup. Lihat Pelan dan bil. |
| Kenalan baharu dicipta untuk setiap mesej | Petakan Phone dengan + di hadapan, supaya HighLevel memadankan kenalan sedia ada. |
| Sembang kumpulan mencipta kenalan yang pelik | Langkau mesej yang contact.is_groupnya ialah true dalam langkah If/Else. |
| Mesej masuk berhenti selepas Zap dihidupkan | Zap dengan pencetus WbizTool Incoming WhatsApp Message mengambil alih webhook nombor itu selagi ia hidup. Matikan Zap, atau gunakan nombor lain. |
Berkaitan#
- API Hantar mesej: setiap medan dan ralat
- Webhook mesej masuk: nombor peti masuk, penghantaran, payload
- Kunci API dan Client ID
- Integrasi Zapier
- Integrasi n8n
- Hantar dari mana-mana alat automasi: Make, Pabbly Connect dan lain-lain

