Entegrasyonlar
GoHighLevel ve WhatsApp
GoHighLevel'ı (HighLevel) WbizTool'a bağlayın; iş akışlarınız (workflow) kendi WhatsApp numaranızdan WhatsApp mesajları göndersin. Gelen WhatsApp mesajları da HighLevel'a geri dönebilir: kişiye not, etiket veya görev olarak.
Bu sayfadaki her şey iki tarafta da zaten var olan özellikleri kullanır: HighLevel'ın iş akışı webhook'ları ile WbizTool'un Mesaj gönderme API'si ve gelen mesaj webhook'ları. Hiçbir şey kurmazsınız.
Kimler yapabilir: WbizTool'da API anahtarını bir Sahip oluşturur (API anahtarları), gelen mesaj webhook'larını bir Sahip veya Editör ayarlar. HighLevel'da iş akışlarını alt hesapta (sub-account) iş akışı düzenleyebilen biri kurar. Ajansın HighLevel'ın premium iş akışı özelliklerini açması gerekir (bkz. Başlamadan önce).
Neler yapabilirsiniz#
| Yön | Örnek | Nasıl |
|---|---|---|
| HighLevel → WhatsApp | Bir form gönderilir, bir etiket eklenir veya bir randevu alınır ve kişiye bir WhatsApp mesajı gider. | Bir HighLevel iş akışındaki Custom Webhook eylemi WbizTool Mesaj gönderme API'sini çağırır. |
| WhatsApp → HighLevel | Bir müşteri WhatsApp numaranıza yazar ve mesaj, HighLevel'daki kişisine not olarak eklenir. Kişi henüz yoksa oluşturulur. | Bir WbizTool gelen kutusu numarası her mesajı HighLevel'ın Inbound Webhook tetikleyicisine gönderir. Unibox eklentisi gerekir. |
Başlamadan önce#
- WhatsApp numaraları sayfasında bağlı bir WhatsApp numarası ve onun WhatsApp Client ID'si (numaranın yanında gösterilen ID), örneğin
678. - Ayarlar → API anahtarları sayfasından bir WbizTool API anahtarı. HighLevel'da anahtar bir
Authorization: Bearerbaşlığına yazılır, bu yüzden Client ID gerekmez. Bkz. Anahtarı başlıkta gönderin. - HighLevel'ın premium iş akışı özellikleri. HighLevel, Custom Webhook ve Inbound Webhook eylemlerini premium iş akışı özellikleri arasında sayar. Her HighLevel planındaki ajanslar bunları açabilir: Agency View'da Settings → Company bölümüne gidin ve Workflow - Premium Features seçeneğini etkinleştirin. HighLevel her premium çalıştırmayı ücretlendirir ve her alt hesap 100 ücretsiz premium çalıştırma alır (her ay değil, bir kez). Ajans bu ücreti alt hesaba yansıtabilir (rebilling). HighLevel'ın fiyatları kendi yardım sayfasındadır.
- Yalnızca gelen mesajlar için: Unibox eklentisi, ücretli veya ömür boyu bir WbizTool planında (ücretsiz denemede değil). Gelen kutusundaki her WhatsApp numarası için ABD liste fiyatlarıyla aylık 20 $ veya yıllık 200 $ tutar. Bir Sahip eklentiyi Faturalandırma ve planlar sayfasında ekler (bkz. Eklentiler).
Bir yol seçin#
HighLevel iş akışı yolu en kısasıdır: HighLevel, arada başka bir araç olmadan WbizTool'u doğrudan çağırır. Bir otomasyon aracını yalnızca iş akışlarınız zaten orada çalışıyorsa kullanın.
| Yol | Gönderme (HighLevel → WhatsApp) | Alma (WhatsApp → HighLevel) | Gerekenler |
|---|---|---|---|
| HighLevel iş akışları (önerilen) | Custom Webhook eylemi → Mesaj gönderme API'si | WbizTool webhook'u → Inbound Webhook tetikleyicisi | HighLevel premium iş akışı özellikleri. Alma: Unibox eklentisi. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact veya Add Task | Bir Zapier hesabı. Alma: Unibox eklentisi. |
| Make | HighLevel Webhook eylemi → Make Webhooks → HTTP modülü | WbizTool webhook'u → Make Webhooks → HighLevel API'si | Bir Make hesabı. Alma: Unibox eklentisi. |
| n8n | HighLevel Webhook eylemi → n8n Webhook → WbizTool Send Message | WbizTool webhook'u → n8n Webhook → HighLevel node'u | WbizTool topluluk node'u kurulu n8n. Alma: Unibox eklentisi. |
| Pabbly Connect | HighLevel Webhook eylemi → Pabbly webhook tetikleyicisi → API (Pabbly) isteği | WbizTool webhook'u → Pabbly webhook tetikleyicisi → HighLevel adımınız | Bir Pabbly Connect hesabı. Alma: Unibox eklentisi. |
HighLevel iş akışından WhatsApp mesajı gönderin#
Bir iş akışı açın veya oluşturun
HighLevel alt hesabınızda Automation bölümünü açın ve bir iş akışı oluşturun ya da var olanı düzenleyin. Ona istediğiniz tetikleyiciyi verin: örneğin bir form gönderimi, yeni bir etiket veya alınan bir randevu.
Custom Webhook eylemini ekleyin
Mesajın gitmesi gereken yerde +'ya, ardından Send Data → Custom Webhook'a tıklayın (veya eylemlerde "webhook" arayıp Custom Webhook'u seçin). Basit Webhook eylemi bu API'nin gerektirdiği başlığı ve gövdeyi ayarlayamaz.
İsteği ayarlayın
Event değerini CUSTOM, Method değerini POST yapın. URL'yi
https://wbiztool.com/api/v1/send_msg/olarak ayarlayın. Authorization için Bearer Token'ı seçip WbizTool API anahtarınızı yapıştırın veya kimlik doğrulama olmadan devam edipBearer YOUR_API_KEYdeğeriyleAuthorizationbaşlığını ekleyin. Content-Type değeriniapplication/jsonyapın.Gövdeyi yapıştırın
Kopyala-yapıştır bloklarından birini Raw Body alanına yapıştırın ve
678yerine kendi WhatsApp Client ID'nizi yazın. Mesaja başka kişi alanları eklemek için HighLevel'ın etiket simgesini kullanın.Test edin ve yayımlayın
Eylemi kaydedin ve iş akışını yayımlayın. Kendi telefon numaranızla bir test kişisi üzerinde çalıştırın. Her çalıştırma iş akışının yürütme günlüklerinde (execution logs) görünür. WbizTool mesajı kabul ettiğinde
"status": 1yanıtını verir. Ardından mesaj WhatsApp numaranızdan gider.
Telefon numarası alanı#
{{contact.phone}} değil, {{contact.phone_raw}} kullanın. HighLevel'ın {{contact.phone}} alanı okunmak için biçimlendirilmiştir, örneğin (515) 555-2345, ve ülke kodu içermez. {{contact.phone_raw}} aynı numaranın uluslararası biçimidir, örneğin +15155552345.
WbizTool + işaretini, boşlukları, tireleri ve parantezleri sizin için kaldırır. + ile yazılmış bir numara ülke kodunu zaten içerir, bu yüzden country_code göndermeniz gerekmez. Bazı kişileriniz ülke kodu olmadan kaydedildiyse gövdeye "country_code": "1" (ülkenizin telefon kodu) ekleyin. Bu kod yalnızca + olmadan yazılmış numaralara eklenir. Bkz. Mesaj gönderme → phone.
Kopyala-yapıştır blokları#
URL: https://wbiztool.com/api/v1/send_msg/ · Method: POST · Headers: Authorization: Bearer YOUR_API_KEY ve 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: gönderimin yapılacağı numaranın ID'si. Yalnızca çalışma alanınızda tam olarak bir bağlı numara varsa boş bırakabilirsiniz.msg: en fazla 3.000 karakter. WhatsApp biçimlendirmesi çalışır:*bold*,_italic_. Yeni satır için metnin içine\nyazın. Gerçek bir satır sonu JSON'u geçersiz kılar.- Görseller ve dosyalar: bağlantılar herkese açık olmalıdır.
msgaçıklama olur. Bkz. Görsel ve dosya gönderme. expire_after_seconds: mesaj bu süre içinde gitmezse, örneğin numara bağlı olmadığı için, süresi dolmuş olarak işaretlenir ve gönderilmez.- Gruplar:
group_name, numaranızın üyesi olduğu bir WhatsApp grubunun tam adıdır.group_nameveyaphonegönderin, asla ikisini birden değil. Bkz. Gruba gönderme.
Gelen WhatsApp mesajlarını HighLevel'a kaydedin#
Bu yön Unibox eklentisi gerektirir. WhatsApp numaranızın aldığı her mesaj HighLevel'ın Inbound Webhook tetikleyicisine gönderilir. İş akışı ardından kişiyi bulur veya oluşturur ve mesajı not, etiket veya görev olarak ekler. Mesajlar HighLevel'da başka hiçbir yerde görünmez.
Inbound Webhook tetikleyicili bir iş akışı oluşturun
HighLevel'da bir iş akışı oluşturun ve Inbound Webhook tetikleyicisini seçin. Gösterilen webhook URL'sini kopyalayın.
WhatsApp numaranızı ona yönlendirin
WbizTool'da Gelen kutusu numaraları sayfasını açın. Gelen kutusuna numara ekle'ye tıklayın, numarayı seçin ve HighLevel URL'sini Webhook URL’si (isteğe bağlı) altına yapıştırın. Zaten gelen kutusunda olan bir numara için URL'yi numaranın Webhook ayarları bölümüne yapıştırın. Gönderilecek mesajlar altında yalnızca Alınan mesajlar'ı işaretleyin. Her gönderim HighLevel'da bir premium çalıştırmadır, bu yüzden ihtiyacınız yoksa Gönderilen mesajlar'ı kapalı bırakın.
Test mesajı gönderin
Başka bir telefondan WhatsApp numaranıza bir mesaj gönderin. Mesaj bir sonraki kontrolden sonra, genellikle bir iki dakika içinde gönderilir. HighLevel'da Test Trigger'a tıklayın, Mapping Reference altından isteği seçin ve tetikleyiciyi kaydedin. Alanlar İçerik (payload) bölümünde listelenir.
Grupları ve gizli numaraları atlayın
Yalnızca
eventdeğerimessage_received,contact.is_groupdeğerifalseise vecontact.phoneboş değilse devam eden bir If/Else adımı ekleyin. WhatsApp bazen göndericinin numarasını gizler; grup mesajları ise telefon numarası yerine grubun ID'sini taşır.Kişiyi bulun veya oluşturun
Create/Update Contact eyleminde Phone alanını
+ve ardından Inbound Webhook değerlerindeki contact → phone olarak ayarlayın. WbizTool numarayı+olmadan gönderir;+ise HighLevel'a numaranın ülke kodunu içerdiğini söyler. contact → name alanını da eşleyebilirsiniz. Bu, göndericinin WhatsApp adıdır ve HighLevel'da düzenlediğiniz bir adın yerine geçebilir.Mesajı kişiye ekleyin
Bir Add to Notes eylemi ekleyin. "WhatsApp mesajı:" gibi bir not yazın ve Inbound Webhook değerlerinden message → content ile message → timestamp alanlarını seçin. Ayrıca Add Contact Tag (örneğin
whatsapp), bir görev veya ekibiniz için dahili bir bildirim ekleyebilirsiniz.Yayımlayın
İş akışını yayımlayın ve bir test mesajı daha gönderin.
| Inbound Webhook değeri | Ne için kullanılır |
|---|---|
contact.phone | Kişinin telefonu. Başına + ekleyin. |
contact.name | Göndericinin WhatsApp adı. Boş olabilir. |
message.content | Metin. Fotoğraf, sesli mesaj ve dosyalarda 📸 Image gibi bir etikettir; açıklamalar dahil değildir. |
message.timestamp | Mesajın WhatsApp'ta gönderildiği zaman (ISO 8601, UTC). |
message.media.url | Fotoğraf veya dosya için bir indirme bağlantısı. 3½ ila 7 gün sonra geçerliliğini yitirir, bu yüzden notta ona güvenmeyin. |
whatsapp_phone | Birden fazla numara aynı iş akışına gönderiyorsa, mesajı numaralarınızdan hangisinin aldığı. |
event | message_received veya message_sent. |
- Yalnızca yeni mesajlar webhook ayarlandığı andan itibaren gönderilir. Eski sohbetler içe aktarılmaz.
- Numara başına bir webhook. Her gelen kutusu numarası tek bir URL'ye gönderir. Bir Zapier Zap'i aynı numara için Incoming WhatsApp Message tetikleyicisini kullanıyorsa, Zap açık olduğu sürece webhook'u devralır.
- HighLevel'dan yanıtlayın: aynı iş akışından WhatsApp'ta yanıt vermek için
"phone": "{{contact.phone_raw}}"ile Custom Webhook eylemini ekleyin. - URL'yi gizli tutun. HighLevel'ın Inbound Webhook'u WbizTool'un imzasını kontrol etmez, bu yüzden URL'ye sahip olan herkes ona istek gönderebilir. Sızarsa yeni bir tetikleyici oluşturun ve onun URL'sini WbizTool'a yapıştırın.
Zapier#
HighLevel'ın Zapier uygulamasının adı LeadConnector'dır. Tek bir tetikleyicisi vardır: Pipeline Stage Changed. Eylemleri arasında Add/Update Contact ve Add Task bulunur. WbizTool'u bağlamak için bkz. Zapier entegrasyonu.
- Gönderme: LeadConnector Pipeline Stage Changed tetikleyicisi, ardından istediğiniz aşama için bir Filter by Zapier adımı, ardından WbizTool Send Text-Only WhatsApp Message. Numarayı WhatsApp Number altından seçin, kişinin telefonunu Phone Number ile eşleyin ve Message'ı yazın. Diğer HighLevel olayları için bunun yerine Custom Webhook eylemini kullanın.
- Alma: WbizTool Incoming WhatsApp Message tetikleyicisi (Unibox eklentisi gerekir), ardından yalnızca Contact Phone Hidden ve Is Group false olduğunda devam eden bir Filter by Zapier adımı. Ardından telefonu
+ve Contact Phone olarak ayarlanmış LeadConnector Add/Update Contact, ardından Message Content ile LeadConnector Add Task.
Make#
HighLevel'ın Make uygulamasının adı GoHighLevel'dır. Bu şablonlar yalnızca Make'in genel Webhooks, JSON ve HTTP modüllerini kullanır, bu yüzden Make'te bir GoHighLevel bağlantısına ihtiyacınız yoktur. Alma şablonu bunun yerine bir HighLevel Private Integration token'ı ve location ID'nizi ister (aşağıya bakın).
Blueprint'i içe aktarın
Aşağıdan bir şablon indirin. Make'te bir senaryo oluşturun, … menüsünü açın ve Import blueprint'i seçin.
Webhook'u oluşturun
Webhooks modülünü açın, webhook oluşturmak için Add'e tıklayın ve adresini kopyalayın.
Yer tutucuları doldurun
HTTP modüllerinde büyük harfle yazılmış her yer tutucuyu, örneğin
YOUR_WBIZTOOL_API_KEYveYOUR_WHATSAPP_CLIENT_IDdeğerlerini değiştirin.Webhook'u bağlayın
Gönderme: HighLevel'da iş akışınıza, URL'si Make adresi olan bir Webhook eylemi ekleyin. Custom Data altına
{{contact.phone_raw}}değeriylephone_rawanahtarını ekleyin. Alma: Make adresini Gelen kutusu numaraları sayfasında numaranın webhook URL'si olarak yapıştırın; yalnızca Alınan mesajlar işaretli olsun.Bir kez çalıştırın
Make'te Run once'a tıklayın ve iş akışını tetikleyin ya da numaranıza bir WhatsApp mesajı gönderin.
Alma şablonu HighLevel'a API'si üzerinden yazar: alt hesabınızın ayarlarından alınan, contacts.write kapsamlı bir Private Integration token'ı ve alt hesabınızın location ID'si ile. Bunun yerine GoHighLevel uygulamasının Create a Contact ve Add a Note to the Contact modüllerini de kullanabilirsiniz.
n8n#
n8n'de yerleşik bir HighLevel node'u vardır. Contact → Create or Update işlemi bir kişiyi telefon veya e-postayla bulur ya da oluşturur ve bir Note ekleyebilir. Önce WbizTool topluluk node'unu kurun: bkz. n8n entegrasyonu.
İş akışını içe aktarın
Aşağıdan bir şablon indirin. n8n'de bir iş akışı oluşturun ve dosyayı içe aktarın (… menüsü → Import from File veya JSON'u tuvale yapıştırın).
Kimlik bilgilerinizi ekleyin
WbizTool Send Message node'unu açın ve bir WbizTool API kimlik bilgisi seçin veya oluşturun. Alma iş akışında HighLevel node'unu açın ve bir HighLevel kimlik bilgisi seçin veya oluşturun.
Webhook'u bağlayın
Webhook node'unun production URL'sini kopyalayın. Gönderme: onu bir HighLevel Webhook eyleminin URL'si olarak kullanın; Custom Data anahtarı
phone_rawdeğeri{{contact.phone_raw}}olsun. Alma: onu Gelen kutusu numaraları sayfasında numaranın webhook URL'si olarak yapıştırın; yalnızca Alınan mesajlar işaretli olsun.Etkinleştirin
İş akışını etkinleştirin ve bir test çalıştırın.
Pabbly Connect#
Pabbly Connect'in kendi webhook tetikleyicisini ve API (Pabbly) eylemini, Herhangi bir otomasyon aracından WhatsApp mesajı gönderin sayfasındaki gibi ayarlayarak kullanın. Gönderme yönü için bir HighLevel Webhook eylemini Pabbly webhook URL'sine yönlendirin ve phone_raw değerini phone ile eşleyin. Gelen mesajlar için Pabbly webhook URL'sini Gelen kutusu numaraları sayfasında numaranın webhook URL'si olarak yapıştırın.
Şablonlar#
| Dosya | Ne yapar |
|---|---|
| ghl-blocks.md | Bu sayfadaki kopyala-yapıştır blokları, tek dosyada. |
| gohighlevel-to-whatsapp.make.json | Make: HighLevel webhook'u → WhatsApp mesajı. |
| whatsapp-to-gohighlevel.make.json | Make: gelen WhatsApp mesajı → HighLevel kişisi ve not. |
| gohighlevel-to-whatsapp.n8n.json | n8n: HighLevel webhook'u → WhatsApp mesajı. |
| whatsapp-to-gohighlevel.n8n.json | n8n: gelen WhatsApp mesajı → notlu HighLevel kişisi. |
Şablonlarda anahtar yoktur. İçe aktardıktan sonra kendi anahtarlarınızı yer tutuculara veya kimlik bilgilerine ekleyin.
Sorun giderme#
| Sorun | Ne yapmalı |
|---|---|
Mesaj yanlış numaraya gidiyor veya Invalid phone number | {{contact.phone}} değil, {{contact.phone_raw}} kullanın. Kişinin numarasında HighLevel'da ülke kodu yoksa gövdeye country_code ekleyin veya kişiyi düzeltin. |
Either phone or group_name parameter is required | Kişinin telefon numarası yok. Eylemden önce bir If/Else adımı ekleyin. |
Auth Error: invalid api key | Authorization başlığını kontrol edin: Bearer, bir boşluk, ardından tırnaksız anahtar. Anahtar silinmiş olabilir. Bkz. API anahtarları. |
Invalid whatsapp client veya Invalid whatsapp client id. | WhatsApp numaraları sayfasındaki WhatsApp Client ID'yi kullanın. Birden fazla numaranız varsa zorunludur. |
Invalid JSON format: … | Gövde geçerli bir JSON değil: eksik bir virgül, sonda fazladan bir virgül, msg içinde gerçek bir satır sonu veya çift tırnak içeren birleştirilmiş bir değer. |
"status": 1, ama hiçbir şey gelmiyor | Mesaj, WhatsApp numaranız bağlanana kadar sırada bekler. WhatsApp numaraları sayfasını ve Mesaj durumu'nu kontrol edin. |
| Custom Webhook veya Inbound Webhook eylemi yok | Ajans premium iş akışı özelliklerini (Workflow - Premium Features) açmamış ya da alt hesap ücretsiz çalıştırmalarını kullanmış ve ücret yansıtılmıyor. Ajansınıza sorun. |
| Gelen mesajlar HighLevel'a ulaşmıyor | Numara Gelen kutusu numaraları sayfasında doğru URL ve işaretli Alınan mesajlar ile Senkronize ediliyor göstermelidir. Alıcı 8 saniye içinde 2xx ile yanıt vermelidir. Bir güvenlik duvarı buna göre filtreliyorsa diye: istekler WbizTool-Webhooks/1 (+https://wbiztool.com) User-Agent'ıyla gelir. Daha fazlası: Gelen mesaj webhook'ları. |
| Unibox eklentisi gerekli | Gelen mesajlar, ücretli veya ömür boyu bir planda Unibox eklentisi gerektirir. Bkz. Planlar ve faturalandırma. |
| Her mesaj için yeni bir kişi oluşturuluyor | HighLevel'ın mevcut kişiyi eşleştirmesi için Phone'u başında + ile eşleyin. |
| Grup sohbetleri tuhaf kişiler oluşturuyor | Bir If/Else adımında contact.is_group değeri true olan mesajları atlayın. |
| Bir Zap açıldıktan sonra gelen mesajlar durdu | WbizTool Incoming WhatsApp Message tetikleyicili bir Zap, açık olduğu sürece numaranın webhook'unu devralır. Zap'i kapatın veya başka bir numara kullanın. |
İlgili sayfalar#
- Mesaj gönderme API'si: tüm alanlar ve hatalar
- Gelen mesaj webhook'ları: gelen kutusu numaraları, teslimat, içerik
- API anahtarları ve Client ID
- Zapier entegrasyonu
- n8n entegrasyonu
- Herhangi bir otomasyon aracından gönderin: Make, Pabbly Connect ve diğerleri

