İçeriğe geç
WbizTool

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ÖrnekNasıl
HighLevel → WhatsAppBir 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 → HighLevelBir 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: Bearer baş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.

YolGönderme (HighLevel → WhatsApp)Alma (WhatsApp → HighLevel)Gerekenler
HighLevel iş akışları (önerilen)Custom Webhook eylemi → Mesaj gönderme API'siWbizTool webhook'u → Inbound Webhook tetikleyicisiHighLevel premium iş akışı özellikleri. Alma: Unibox eklentisi.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact veya Add TaskBir Zapier hesabı. Alma: Unibox eklentisi.
MakeHighLevel Webhook eylemi → Make Webhooks → HTTP modülüWbizTool webhook'u → Make Webhooks → HighLevel API'siBir Make hesabı. Alma: Unibox eklentisi.
n8nHighLevel Webhook eylemi → n8n Webhook → WbizTool Send MessageWbizTool webhook'u → n8n Webhook → HighLevel node'uWbizTool topluluk node'u kurulu n8n. Alma: Unibox eklentisi.
Pabbly ConnectHighLevel Webhook eylemi → Pabbly webhook tetikleyicisi → API (Pabbly) isteğiWbizTool webhook'u → Pabbly webhook tetikleyicisi → HighLevel adımınızBir Pabbly Connect hesabı. Alma: Unibox eklentisi.

HighLevel iş akışından WhatsApp mesajı gönderin#

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

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

  3. İ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 edip Bearer YOUR_API_KEY değeriyle Authorization başlığını ekleyin. Content-Type değerini application/json yapın.

  4. Gövdeyi yapıştırın

    Kopyala-yapıştır bloklarından birini Raw Body alanına yapıştırın ve 678 yerine kendi WhatsApp Client ID'nizi yazın. Mesaja başka kişi alanları eklemek için HighLevel'ın etiket simgesini kullanın.

  5. 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": 1 yanı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

Custom Webhook eylemi için Raw Body
{
  "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: 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 \n yazı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. msg açı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_name veya phone gö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.

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

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

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

  4. Grupları ve gizli numaraları atlayın

    Yalnızca event değeri message_received, contact.is_group değeri false ise ve contact.phone boş 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.

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

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

  7. Yayımlayın

    İş akışını yayımlayın ve bir test mesajı daha gönderin.

Inbound Webhook değeriNe için kullanılır
contact.phoneKişinin telefonu. Başına + ekleyin.
contact.nameGöndericinin WhatsApp adı. Boş olabilir.
message.contentMetin. Fotoğraf, sesli mesaj ve dosyalarda 📸 Image gibi bir etikettir; açıklamalar dahil değildir.
message.timestampMesajın WhatsApp'ta gönderildiği zaman (ISO 8601, UTC).
message.media.urlFotoğ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_phoneBirden fazla numara aynı iş akışına gönderiyorsa, mesajı numaralarınızdan hangisinin aldığı.
eventmessage_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).

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

  2. Webhook'u oluşturun

    Webhooks modülünü açın, webhook oluşturmak için Add'e tıklayın ve adresini kopyalayın.

  3. Yer tutucuları doldurun

    HTTP modüllerinde büyük harfle yazılmış her yer tutucuyu, örneğin YOUR_WBIZTOOL_API_KEY ve YOUR_WHATSAPP_CLIENT_ID değerlerini değiştirin.

  4. 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ğeriyle phone_raw anahtarı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.

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

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

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

  3. 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_raw değ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.

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

DosyaNe yapar
ghl-blocks.mdBu sayfadaki kopyala-yapıştır blokları, tek dosyada.
gohighlevel-to-whatsapp.make.jsonMake: HighLevel webhook'u → WhatsApp mesajı.
whatsapp-to-gohighlevel.make.jsonMake: gelen WhatsApp mesajı → HighLevel kişisi ve not.
gohighlevel-to-whatsapp.n8n.jsonn8n: HighLevel webhook'u → WhatsApp mesajı.
whatsapp-to-gohighlevel.n8n.jsonn8n: 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#

SorunNe 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 requiredKişinin telefon numarası yok. Eylemden önce bir If/Else adımı ekleyin.
Auth Error: invalid api keyAuthorization 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 gelmiyorMesaj, 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 yokAjans 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ıyorNumara 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 gerekliGelen 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şturuluyorHighLevel'ın mevcut kişiyi eşleştirmesi için Phone'u başında + ile eşleyin.
Grup sohbetleri tuhaf kişiler oluşturuyorBir If/Else adımında contact.is_group değeri true olan mesajları atlayın.
Bir Zap açıldıktan sonra gelen mesajlar durduWbizTool 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#