Langkau ke kandungan
WbizTool

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#

ArahContohCara
HighLevel → WhatsAppBorang 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 → HighLevelPelanggan 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.

LaluanHantar (HighLevel → WhatsApp)Terima (WhatsApp → HighLevel)Pelan yang anda perlukan
Aliran kerja HighLevel (disyorkan)Tindakan Custom Webhook → API Hantar mesejWebhook WbizTool → pencetus Inbound WebhookCiri aliran kerja premium HighLevel. Terima: tambahan Unibox.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact atau Add TaskAkaun Zapier. Terima: tambahan Unibox.
MakeTindakan Webhook HighLevel → Make Webhooks → modul HTTPWebhook WbizTool → Make Webhooks → API HighLevelAkaun Make. Terima: tambahan Unibox.
n8nTindakan Webhook HighLevel → n8n Webhook → WbizTool Send MessageWebhook WbizTool → n8n Webhook → nod HighLeveln8n dengan nod komuniti WbizTool. Terima: tambahan Unibox.
Pabbly ConnectTindakan Webhook HighLevel → pencetus webhook Pabbly → permintaan API (Pabbly)Webhook WbizTool → pencetus webhook Pabbly → langkah HighLevel andaAkaun Pabbly Connect. Terima: tambahan Unibox.

Hantar mesej WhatsApp dari aliran kerja HighLevel#

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

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

  3. 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 pengepala Authorization dengan nilai Bearer YOUR_API_KEY. Tetapkan Content-Type kepada application/json.

  4. Tampal badan

    Tampal salah satu blok salin-tampal ke dalam Raw Body dan gantikan 678 dengan WhatsApp Client ID anda. Gunakan ikon tag HighLevel untuk menambah lebih banyak medan kenalan ke dalam mesej.

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

Raw Body untuk tindakan Custom Webhook
{
  "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: 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 \n di dalam teks. Pemisah baris sebenar menjadikan JSON tidak sah.
  • Imej dan fail: pautan mesti awam. msg menjadi 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_name ialah nama tepat kumpulan WhatsApp yang disertai nombor anda. Hantar group_name atau phone, 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.

  1. Cipta aliran kerja dengan pencetus Inbound Webhook

    Dalam HighLevel, cipta aliran kerja dan pilih pencetus Inbound Webhook. Salin URL webhook yang ditunjukkannya.

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

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

  4. Langkau kumpulan dan nombor tersembunyi

    Tambah langkah If/Else yang hanya diteruskan apabila event ialah message_received, contact.is_group ialah false dan contact.phone tidak kosong. WhatsApp kadangkala menyembunyikan nombor pengirim, dan mesej kumpulan membawa ID kumpulan dan bukannya nombor telefon.

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

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

  7. Terbitkan

    Terbitkan aliran kerja dan hantar satu lagi mesej ujian.

Nilai Inbound WebhookGunakan untuk
contact.phoneTelefon kenalan. Tambah + di hadapan.
contact.nameNama WhatsApp pengirim. Boleh kosong.
message.contentTeks. Untuk foto, nota suara dan fail ia ialah label seperti 📸 Image, dan kapsyen tidak disertakan.
message.timestampMasa mesej dihantar di WhatsApp (ISO 8601, UTC).
message.media.urlPautan muat turun untuk foto atau fail. Ia tamat tempoh selepas 3½ hingga 7 hari, jadi jangan bergantung padanya dalam nota.
whatsapp_phoneNombor anda yang mana menerimanya, jika beberapa nombor menghantar ke aliran kerja yang sama.
eventmessage_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).

  1. Import blueprint

    Muat turun templat di bawah. Dalam Make, cipta senario, buka menu … dan pilih Import blueprint.

  2. Cipta webhook

    Buka modul Webhooks, klik Add untuk mencipta webhook dan salin alamatnya.

  3. Isi pemegang tempat

    Gantikan setiap pemegang tempat dalam huruf besar dalam modul HTTP, seperti YOUR_WBIZTOOL_API_KEY dan YOUR_WHATSAPP_CLIENT_ID.

  4. Sambungkan webhook

    Hantar: dalam HighLevel, tambah tindakan Webhook pada aliran kerja anda dengan alamat Make sebagai URLnya. Di bawah Custom Data, tambah kunci phone_raw dengan nilai {{contact.phone_raw}}. Terima: tampal alamat Make sebagai URL webhook nombor itu di Nombor peti masuk, dengan hanya Mesej diterima ditandakan.

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

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

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

  3. Sambungkan webhook

    Salin URL pengeluaran nod Webhook. Hantar: gunakannya sebagai URL tindakan Webhook HighLevel, dengan kunci Custom Data phone_raw ditetapkan kepada {{contact.phone_raw}}. Terima: tampalnya sebagai URL webhook nombor itu di Nombor peti masuk, dengan hanya Mesej diterima ditandakan.

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

FailApa yang dilakukannya
ghl-blocks.mdBlok salin-tampal di halaman ini, dalam satu fail.
gohighlevel-to-whatsapp.make.jsonMake: webhook HighLevel → mesej WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake: mesej WhatsApp masuk → kenalan dan nota HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n: webhook HighLevel → mesej WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n: 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#

MasalahApa yang perlu dilakukan
Mesej pergi ke nombor yang salah, atau Invalid phone numberGunakan {{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 requiredKenalan tiada nombor telefon. Tambah langkah If/Else sebelum tindakan.
Auth Error: invalid api keySemak 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 sampaiMesej beratur sehingga nombor WhatsApp anda disambungkan. Semak Nombor WhatsApp dan Status mesej.
Tindakan Custom Webhook atau Inbound Webhook tiadaAgensi 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 HighLevelNombor 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 diperlukanMesej masuk memerlukan tambahan Unibox pada pelan berbayar atau seumur hidup. Lihat Pelan dan bil.
Kenalan baharu dicipta untuk setiap mesejPetakan Phone dengan + di hadapan, supaya HighLevel memadankan kenalan sedia ada.
Sembang kumpulan mencipta kenalan yang pelikLangkau mesej yang contact.is_groupnya ialah true dalam langkah If/Else.
Mesej masuk berhenti selepas Zap dihidupkanZap dengan pencetus WbizTool Incoming WhatsApp Message mengambil alih webhook nombor itu selagi ia hidup. Matikan Zap, atau gunakan nombor lain.

Berkaitan#