Integrasi
GoHighLevel dan WhatsApp
Hubungkan GoHighLevel (HighLevel) ke WbizTool, dan alur kerja (workflow) Anda akan mengirim pesan WhatsApp dari nomor WhatsApp Anda sendiri. Pesan WhatsApp masuk juga bisa kembali ke HighLevel, sebagai catatan, tag, atau tugas di kontak.
Semua yang ada di halaman ini memakai fitur yang sudah tersedia di kedua sisi: webhook alur kerja HighLevel, serta API Kirim pesan dan webhook pesan masuk WbizTool. Anda tidak perlu memasang apa pun.
Siapa yang dapat melakukannya: Di WbizTool, Pemilik membuat kunci API (Kunci API), dan Pemilik atau Editor menyiapkan webhook pesan masuk. Di HighLevel, alur kerjanya dibuat oleh orang yang dapat mengedit alur kerja di sub-akun. Agensi harus mengaktifkan fitur alur kerja premium HighLevel (lihat Sebelum memulai).
Yang dapat Anda lakukan#
| Arah | Contoh | Caranya |
|---|---|---|
| HighLevel → WhatsApp | Formulir dikirim, tag ditambahkan, atau janji temu dipesan, dan kontak menerima pesan WhatsApp. | Action Custom Webhook di alur kerja HighLevel memanggil API Kirim pesan WbizTool. |
| WhatsApp → HighLevel | Pelanggan mengirim pesan ke nomor WhatsApp Anda, dan pesan itu ditambahkan sebagai catatan di kontak HighLevel-nya. Kontak dibuat jika belum ada. | Nomor kotak masuk WbizTool mengirim setiap pesan ke pemicu Inbound Webhook HighLevel. Memerlukan add-on Unibox. |
Sebelum memulai#
- Nomor WhatsApp yang terhubung di Nomor WhatsApp, beserta WhatsApp Client ID-nya (ID yang tampil di nomor tersebut), misalnya
678. - Kunci API WbizTool dari Pengaturan → Kunci API. Di HighLevel, kunci ini dimasukkan di header
Authorization: Bearer, jadi Anda tidak memerlukan Client ID. Lihat Mengirim kunci di header. - Fitur alur kerja premium HighLevel. HighLevel menggolongkan Custom Webhook dan Inbound Webhook sebagai fitur alur kerja premium. Agensi di paket HighLevel mana pun dapat mengaktifkannya: di Agency View, buka Settings → Company dan aktifkan Workflow - Premium Features. HighLevel menagih setiap eksekusi premium, dan setiap sub-akun mendapat 100 eksekusi premium gratis (sekali, bukan setiap bulan). Agensi dapat menagihkan ulang biaya ini ke sub-akun (rebilling). Harga HighLevel ada di halaman bantuannya sendiri.
- Khusus pesan masuk: add-on Unibox di paket WbizTool berbayar atau lifetime (bukan uji coba gratis). Biayanya $20 per bulan atau $200 per tahun dengan harga daftar AS untuk setiap nomor WhatsApp di kotak masuk. Pemilik menambahkannya di Tagihan & paket (lihat Add-on).
Memilih jalur#
Jalur alur kerja HighLevel adalah yang paling singkat: HighLevel memanggil WbizTool secara langsung, tanpa alat lain di antaranya. Gunakan alat otomatisasi hanya jika alur kerja Anda sudah berjalan di sana.
| Jalur | Kirim (HighLevel → WhatsApp) | Terima (WhatsApp → HighLevel) | Yang Anda perlukan |
|---|---|---|---|
| Alur kerja HighLevel (disarankan) | Action Custom Webhook → API Kirim pesan | Webhook WbizTool → pemicu Inbound Webhook | Fitur alur kerja premium HighLevel. Terima: add-on Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact atau Add Task | Akun Zapier. Terima: add-on Unibox. |
| Make | Action HighLevel Webhook → Make Webhooks → modul HTTP | Webhook WbizTool → Make Webhooks → API HighLevel | Akun Make. Terima: add-on Unibox. |
| n8n | Action HighLevel Webhook → n8n Webhook → WbizTool Send Message | Webhook WbizTool → n8n Webhook → node HighLevel | n8n dengan community node WbizTool. Terima: add-on Unibox. |
| Pabbly Connect | Action HighLevel Webhook → pemicu webhook Pabbly → request API (Pabbly) | Webhook WbizTool → pemicu webhook Pabbly → langkah HighLevel Anda | Akun Pabbly Connect. Terima: add-on Unibox. |
Mengirim pesan WhatsApp dari alur kerja HighLevel#
Buka atau buat alur kerja
Di sub-akun HighLevel Anda, buka Automation lalu buat alur kerja, atau edit yang sudah ada. Beri pemicu yang Anda inginkan, misalnya pengiriman formulir, tag baru, atau janji temu yang dipesan.
Tambahkan action Custom Webhook
Klik + di titik pesan harus dikirim, lalu Send Data → Custom Webhook (atau cari "webhook" di daftar action dan pilih Custom Webhook). Action Webhook biasa tidak dapat mengatur header dan body yang diperlukan API ini.
Atur request-nya
Atur Event ke CUSTOM dan Method ke POST. Atur URL ke
https://wbiztool.com/api/v1/send_msg/. Untuk Authorization, pilih Bearer Token dan tempel kunci API WbizTool Anda, atau pilih tanpa autentikasi lalu tambahkan headerAuthorizationdengan nilaiBearer YOUR_API_KEY. Atur Content-Type keapplication/json.Tempel body-nya
Tempel salah satu blok siap salin ke Raw Body dan ganti
678dengan WhatsApp Client ID Anda. Gunakan ikon tag HighLevel untuk menambahkan field kontak lain ke pesan.Uji dan publikasikan
Simpan action dan publikasikan alur kerja. Jalankan pada kontak uji dengan nomor telepon Anda sendiri. Setiap eksekusi tampil di log eksekusi (execution logs) alur kerja. Saat WbizTool menerima pesan, ia menjawab
"status": 1. Pesan lalu dikirim dari nomor WhatsApp Anda.
Field nomor telepon#
Gunakan {{contact.phone_raw}}, bukan {{contact.phone}}. {{contact.phone}} di HighLevel diformat agar mudah dibaca, seperti (515) 555-2345, tanpa kode negara. {{contact.phone_raw}} adalah nomor yang sama dalam format internasional, seperti +15155552345.
WbizTool menghapus +, spasi, tanda hubung, dan tanda kurung untuk Anda. Nomor yang ditulis dengan + sudah menyertakan kode negaranya, jadi Anda tidak perlu mengirim country_code. Jika sebagian kontak Anda disimpan tanpa kode negara, tambahkan "country_code": "1" (kode telepon negara Anda) ke body. Kode ini hanya ditambahkan ke nomor yang ditulis tanpa +. Lihat Kirim pesan → phone.
Blok siap salin#
URL: https://wbiztool.com/api/v1/send_msg/ · Method: POST · Headers: 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 nomor pengirim. Anda hanya dapat menghilangkannya jika workspace Anda memiliki tepat satu nomor yang terhubung.msg: maksimal 3.000 karakter. Format WhatsApp berfungsi:*bold*,_italic_. Untuk baris baru, ketik\ndi dalam teks. Jeda baris sungguhan membuat JSON tidak valid.- Gambar dan file: tautannya harus publik.
msgmenjadi keterangan (caption). Lihat Mengirim gambar dan file. expire_after_seconds: jika pesan belum terkirim dalam waktu ini, misalnya karena nomor terputus, pesan ditandai kedaluwarsa dan tidak dikirim.- Grup:
group_nameadalah nama persis grup WhatsApp tempat nomor Anda bergabung. Kirimgroup_nameatauphone, jangan keduanya. Lihat Kirim ke grup.
Mencatat pesan WhatsApp masuk di HighLevel#
Arah ini memerlukan add-on Unibox. Setiap pesan yang diterima nomor WhatsApp Anda dikirim ke pemicu Inbound Webhook HighLevel. Alur kerja lalu mencari atau membuat kontak dan menambahkan pesan sebagai catatan, tag, atau tugas. Pesan tidak muncul di tempat lain di HighLevel.
Buat alur kerja dengan pemicu Inbound Webhook
Di HighLevel, buat alur kerja dan pilih pemicu Inbound Webhook. Salin URL webhook yang ditampilkan.
Arahkan nomor WhatsApp Anda ke sana
Di WbizTool, buka Nomor kotak masuk. Klik Tambahkan nomor ke kotak masuk, pilih nomornya, dan tempel URL HighLevel di bawah URL webhook (opsional). Untuk nomor yang sudah ada di kotak masuk, tempel di Pengaturan webhook nomor tersebut. Di bawah Pesan yang dikirim ke webhook, centang hanya Pesan diterima. Setiap kiriman adalah satu eksekusi premium di HighLevel, jadi biarkan Pesan dikirim tidak tercentang kecuali Anda memerlukannya.
Kirim pesan uji
Dari ponsel lain, kirim pesan ke nomor WhatsApp Anda. Pesan dikirim setelah pengecekan berikutnya, biasanya dalam satu atau dua menit. Di HighLevel, klik Test Trigger, pilih request di bawah Mapping Reference, dan simpan pemicu. Daftar field ada di Payload.
Lewati grup dan nomor tersembunyi
Tambahkan langkah If/Else yang hanya berlanjut jika
eventbernilaimessage_received,contact.is_groupbernilaifalse, dancontact.phonetidak kosong. WhatsApp kadang menyembunyikan nomor pengirim, dan pesan grup membawa ID grup, bukan nomor telepon.Cari atau buat kontak
Di action Create/Update Contact, atur Phone ke
+diikuti contact → phone dari nilai Inbound Webhook. WbizTool mengirim nomor tanpa+, dan+memberi tahu HighLevel bahwa nomor itu menyertakan kode negara. Anda juga dapat memetakan contact → name. Itu adalah nama WhatsApp pengirim, dan dapat menggantikan nama yang sudah Anda ubah di HighLevel.Tambahkan pesan ke kontak
Tambahkan action Add to Notes. Tulis catatan seperti "Pesan WhatsApp:" lalu pilih message → content dan message → timestamp dari nilai Inbound Webhook. Anda juga dapat menambahkan Add Contact Tag (misalnya
whatsapp), tugas, atau notifikasi internal untuk tim Anda.Publikasikan
Publikasikan alur kerja dan kirim satu pesan uji lagi.
| Nilai Inbound Webhook | Kegunaan |
|---|---|
contact.phone | Nomor telepon kontak. Tambahkan + di depannya. |
contact.name | Nama WhatsApp pengirim. Bisa kosong. |
message.content | Teksnya. Untuk foto, pesan suara, dan file, isinya label seperti 📸 Image, dan keterangan tidak disertakan. |
message.timestamp | Kapan pesan dikirim di WhatsApp (ISO 8601, UTC). |
message.media.url | Tautan unduhan untuk foto atau file. Tautan ini kedaluwarsa setelah 3½ hingga 7 hari, jadi jangan mengandalkannya di catatan. |
whatsapp_phone | Nomor Anda yang menerimanya, jika beberapa nomor mengirim ke alur kerja yang sama. |
event | message_received atau message_sent. |
- Hanya pesan baru yang dikirim, sejak webhook diatur. Chat lama tidak diimpor.
- Satu webhook per nomor. Setiap nomor kotak masuk mengirim ke satu URL. Jika sebuah Zap Zapier memakai pemicu Incoming WhatsApp Message untuk nomor yang sama, Zap mengambil alih webhook selama Zap itu aktif.
- Membalas dari HighLevel: untuk membalas di WhatsApp dari alur kerja yang sama, tambahkan action Custom Webhook dengan
"phone": "{{contact.phone_raw}}". - Jaga kerahasiaan URL. Inbound Webhook HighLevel tidak memeriksa tanda tangan WbizTool, jadi siapa pun yang memiliki URL-nya dapat mengirim ke sana. Jika URL bocor, buat pemicu baru dan tempel URL-nya di WbizTool.
Zapier#
Aplikasi HighLevel di Zapier bernama LeadConnector. Aplikasi ini memiliki satu pemicu, Pipeline Stage Changed. Action-nya antara lain Add/Update Contact dan Add Task. Lihat Integrasi Zapier untuk menghubungkan WbizTool.
- Kirim: pemicu LeadConnector Pipeline Stage Changed, lalu langkah Filter by Zapier untuk tahap yang Anda inginkan, lalu WbizTool Send Text-Only WhatsApp Message. Pilih nomor di bawah WhatsApp Number, petakan nomor telepon kontak ke Phone Number, dan tulis Message. Untuk event HighLevel lainnya, gunakan action Custom Webhook.
- Terima: pemicu WbizTool Incoming WhatsApp Message (memerlukan add-on Unibox), lalu langkah Filter by Zapier yang hanya berlanjut jika Contact Phone Hidden dan Is Group bernilai false. Lalu LeadConnector Add/Update Contact dengan nomor telepon berisi
+dan Contact Phone, lalu LeadConnector Add Task dengan Message Content.
Make#
Aplikasi HighLevel di Make bernama GoHighLevel. Template ini hanya memakai modul umum Make Webhooks, JSON, dan HTTP, jadi Anda tidak memerlukan koneksi GoHighLevel di Make. Template penerimaan memerlukan token Private Integration HighLevel dan location ID Anda sebagai gantinya (lihat di bawah).
Impor blueprint
Unduh template di bawah. Di Make, buat skenario, buka menu …, dan pilih Import blueprint.
Buat webhook
Buka modul Webhooks, klik Add untuk membuat webhook, dan salin alamatnya.
Isi placeholder
Ganti setiap placeholder berhuruf kapital di modul HTTP, seperti
YOUR_WBIZTOOL_API_KEYdanYOUR_WHATSAPP_CLIENT_ID.Hubungkan webhook
Kirim: di HighLevel, tambahkan action Webhook ke alur kerja Anda dengan alamat Make sebagai URL-nya. Di bawah Custom Data, tambahkan key
phone_rawdengan nilai{{contact.phone_raw}}. Terima: tempel alamat Make sebagai URL webhook nomor di Nomor kotak masuk, dengan hanya Pesan diterima yang tercentang.Jalankan sekali
Klik Run once di Make lalu picu alur kerja, atau kirim pesan WhatsApp ke nomor Anda.
Template penerimaan menulis ke HighLevel melalui API-nya dengan token Private Integration dari pengaturan sub-akun Anda, dengan scope contacts.write, dan location ID sub-akun Anda. Anda juga dapat memakai modul Create a Contact dan Add a Note to the Contact dari aplikasi GoHighLevel.
n8n#
n8n memiliki node HighLevel bawaan. Operasi Contact → Create or Update-nya mencari kontak berdasarkan nomor telepon atau email, atau membuatnya, dan dapat menambahkan Note. Pasang community node WbizTool terlebih dahulu: lihat Integrasi n8n.
Impor alur kerja
Unduh template di bawah. Di n8n, buat alur kerja dan impor file-nya (menu … → Import from File, atau tempel JSON-nya di kanvas).
Tambahkan kredensial Anda
Buka node WbizTool Send Message lalu pilih atau buat kredensial WbizTool API. Di alur kerja penerimaan, buka node HighLevel lalu pilih atau buat kredensial HighLevel.
Hubungkan webhook
Salin production URL node Webhook. Kirim: gunakan sebagai URL action HighLevel Webhook, dengan key Custom Data
phone_rawbernilai{{contact.phone_raw}}. Terima: tempel sebagai URL webhook nomor di Nomor kotak masuk, dengan hanya Pesan diterima yang tercentang.Aktifkan
Aktifkan alur kerja dan jalankan pengujian.
Pabbly Connect#
Gunakan pemicu webhook milik Pabbly Connect sendiri dan action API (Pabbly)-nya, yang diatur seperti di Kirim pesan WhatsApp dari alat otomatisasi apa pun. Untuk arah kirim, arahkan action HighLevel Webhook ke URL webhook Pabbly dan petakan phone_raw ke phone. Untuk pesan masuk, tempel URL webhook Pabbly sebagai URL webhook nomor di Nomor kotak masuk.
Template#
| File | Fungsinya |
|---|---|
| ghl-blocks.md | Blok siap salin di halaman ini, dalam satu file. |
| gohighlevel-to-whatsapp.make.json | Make: webhook HighLevel → pesan WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: pesan WhatsApp masuk → kontak dan catatan HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook HighLevel → pesan WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: pesan WhatsApp masuk → kontak HighLevel dengan catatan. |
Template tidak berisi kunci apa pun. Tambahkan kunci Anda sendiri di placeholder atau kredensial setelah mengimpor.
Pemecahan masalah#
| Masalah | Yang harus dilakukan |
|---|---|
Pesan terkirim ke nomor yang salah, atau Invalid phone number | Gunakan {{contact.phone_raw}}, bukan {{contact.phone}}. Jika nomor kontak di HighLevel tidak memiliki kode negara, tambahkan country_code ke body atau perbaiki kontaknya. |
Either phone or group_name parameter is required | Kontak tidak memiliki nomor telepon. Tambahkan langkah If/Else sebelum action. |
Auth Error: invalid api key | Periksa header Authorization: Bearer, spasi, lalu kuncinya, tanpa tanda kutip. Kunci mungkin sudah dihapus. Lihat Kunci API. |
Invalid whatsapp client atau Invalid whatsapp client id. | Gunakan WhatsApp Client ID dari Nomor WhatsApp. Ini wajib jika Anda memiliki lebih dari satu nomor. |
Invalid JSON format: … | Body bukan JSON yang valid: koma yang hilang, koma berlebih di akhir, jeda baris sungguhan di msg, atau nilai gabungan yang berisi tanda kutip ganda. |
"status": 1, tetapi tidak ada yang sampai | Pesan masuk antrean sampai nomor WhatsApp Anda terhubung. Periksa Nomor WhatsApp dan Status pesan. |
| Action Custom Webhook atau Inbound Webhook tidak ada | Agensi belum mengaktifkan fitur alur kerja premium (Workflow - Premium Features), atau sub-akun sudah memakai eksekusi gratisnya dan tidak ditagihkan ulang. Tanyakan ke agensi Anda. |
| Pesan masuk tidak sampai ke HighLevel | Nomor harus menampilkan Menyinkronkan di Nomor kotak masuk, dengan URL yang benar dan Pesan diterima tercentang. Penerima harus menjawab 2xx dalam 8 detik. Request datang dengan User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), jika firewall menyaringnya. Selengkapnya di Webhook pesan masuk. |
| Add-on Unibox diperlukan | Pesan masuk memerlukan add-on Unibox di paket berbayar atau lifetime. Lihat Paket dan tagihan. |
| Kontak baru dibuat untuk setiap pesan | Petakan Phone dengan + di depannya, agar HighLevel mencocokkan kontak yang sudah ada. |
| Chat grup membuat kontak yang aneh | Lewati pesan dengan contact.is_group bernilai true di langkah If/Else. |
| Pesan masuk berhenti setelah sebuah Zap diaktifkan | Zap dengan pemicu WbizTool Incoming WhatsApp Message mengambil alih webhook nomor selama Zap itu aktif. Nonaktifkan Zap, atau gunakan nomor lain. |
Terkait#
- API Kirim pesan: setiap field dan error
- Webhook pesan masuk: nomor kotak masuk, pengiriman, payload
- Kunci API dan Client ID
- Integrasi Zapier
- Integrasi n8n
- Kirim dari alat otomatisasi apa pun: Make, Pabbly Connect, dan lainnya

