WhatsApp + GoHighLevel Entegrasyonu: Whapi.Cloud ile Veri Çift Yönlü Senkronize Edin

WhatsApp + GoHighLevel Entegrasyonu Nasıl Çalışır

WhatsApp ve GoHighLevel Arasında Senkronize Edebileceğiniz Şeyler

• İletişimler: WhatsApp'tan telefon numarası → GHL iletişimi bulur veya oluşturur; ad, soyadı ve özel alanlar tek yönlü (WhatsApp → GHL) veya GHL giden webhook'u varsa çift yönlü senkronize edilir.
• Mesajlar: gelen WhatsApp mesajı → GHL konuşması oluşturulur veya güncellenir; GHL iş akışı "WhatsApp mesajı gönder" eylemine ulaşır → Whapi API çağrısı mesajı müşteriye geri gönderir.
• Grup olayları: üye WhatsApp grubuna katılır, üye ayrılır, üye terfi eder → Whapi webhook çalışır → GHL gelen webhook'u iş akışını tetikler (onları etiketle, sahip ata, hoş geldiniz gönder, görev oluştur).
• Etiketler ve özel alanlar: GHL, WhatsApp davranışına (örn. etiket "whatsapp-group-member") dayalı iletişimleri etiketleyebilir; bu etiketler, akış iş akışlarını tetikleyebilir (beslenme dizileri, atama kuralları, rapor filtreleri).
• İş akışı tetikleyicileri: herhangi bir GHL iş akışı gelen webhook olay türünü dinleyebilir ve yükü temel alan eylemler yürütebilir (koşullu mantık, API çağrıları, çok adımlı diziler).

Çift Yönlü Senkronizasyon Mimarisi

GELEN (WhatsApp → Whapi → GHL):

1. Müşteri WhatsApp'ta hareket eder
   (mesaj gönderir, gruba katılır, durumu günceller, vb.)

2. Whapi.Cloud olayı alır
   ve GHL gelen webhook URL'nize webhook çalıştırır
   Yük: { event, phone, name, group_id, timestamp, ... }

3. GHL Gelen Webhook Tetikleyicisi
   JSON yükünü alır
   Doğrular (isteğe bağlı imza kontrolü)
   Verileri çıkarır: telefon, ad, olay türü

4. GHL İş Akışı Yürütülür
   İletişim Bul veya Oluştur (telefona göre)
   Etiket Ekle (ör. "whatsapp-group-member")
   Özel Alanları Güncelle
   İç içe iş akışlarını Tetikle (e-posta, SMS, WhatsApp gönder, sahip ata)

GIDEN (GHL → Whapi → WhatsApp):

5. GHL İş Akışı Eylemi Çalışır
   (ör. "WhatsApp Mesajı Gönder" özel webhook)

6. Özel Webhook, Whapi API'sini Çağırır
   POST https://gate.whapi.cloud/messages/text
   Gövde: { to: phone, body: message_text }
   Başlıklar: Authorization: Bearer YOUR_WHAPI_TOKEN

7. Whapi, mesajı WhatsApp aracılığıyla gönderir
   müşterinin numarasına

8. Müşteri, WhatsApp'da mesajı alır
   (uygulama bildirimi yok, sadece sohbette belirir)

9. (İsteğe bağlı) Whapi webhook, GHL'ye geri çalışır
   mesajı teslim edildi/okundu olarak işaretler
   GHL konuşması teslim durumundan güncellenir
  

Adım 1: WhatsApp Olaylarını GoHighLevel'e Bağlayın

1. İş Akışları → yeni iş akışı oluşturun (veya varolan birini açın).
2. Tetikleyici ekleyin: "Gelen Webhook" arayın.
3. GHL, benzersiz bir webhook URL'si oluşturur — şöyle görünür: https://api.gohighlevel.com/webhooks/[WORKSPACE_ID]/[TRIGGER_ID]
4. Bu URL'yi kopyalayın. Whapi ayarlarına yapıştıracaksınız.

1. Ayarlar → Webhook'lar bölümüne gidin.
2. Yeni webhook URL'si ekleyin. Yukarıda kopyaladığınız GHL gelen webhook URL'sini yapıştırın.
3. Almak istediğiniz olay türlerini seçin:
   • message.created (gelen mesajlar)
   • group.member.joined (grup üyeliği olayları)
   • contact.status_changed (çevrimiçi/çevrimdışı, yazıyor, vb.)
4. Kaydedin. Whapi, test olayı göndererek webhook'u test eder.
5. GHL alırsa, yeşil onay işareti göreceksiniz. Yoksa, GHL iş akışı tetikleyicisinin etkin olup olmadığını kontrol edin.

Adım 2: WhatsApp'tan GHL İletişimleri Oluşturun ve Güncelleyin

1. Eylem ekleyin: İletişim Bul veya Oluştur.
2. Eşleştirme alanını Telefon olarak ayarlayın.
3. Gelen webhook yükü telefon numarasını iletişim telefon alanına eşleştirin.
   • Yük yolu: ${trigger.body.data.phone} (Whapi webhook yükü şekline göre ayarlayın)
4. Bu telefona sahip iletişim varsa, GHL bulur. Yoksa, GHL yeni iletişim oluşturur:
   • Telefon: ${trigger.body.data.phone}
   • Ad: ${trigger.body.data.name} (isteğe bağlı; sağlanmazsa "WhatsApp İletişimi" gibi varsayılana ayarlayın)

Adım 3: WhatsApp Mesajlarını GHL Konuşmalarıyla Senkronize Edin

1. Özel Webhook (veya "HTTP İsteği Gönder").
2. Yöntemi POST olarak ayarlayın.
3. URL: https://gate.whapi.cloud/messages/text
4. Başlıklar:
   • Authorization: Bearer YOUR_WHAPI_TOKEN
   • Content-Type: application/json
5. Gövde (JSON):
   • to: iletişim telefon numarası (ör. ${contact.phone})
   • body: mesaj metni (ör. "Gruba hoş geldiniz!")

{
  "to": "+1234567890",
  "body": "Gruba hoş geldiniz, John! Sizi aramızda görmekten çok mutluyuz. Önemli güncellemeler için sabitlenmiş mesajları kontrol edin."
}
  

Gerçek Örnek: WhatsApp Grup Katılışı → GHL İş Akışı → Hoş Geldiniz Mesajı

{
  "event": "group.member.joined",
  "phone": "+1987654321",
  "name": "Sarah Martinez",
  "group_id": "[email protected]",
  "group_name": "Gayrimenkul Ekibi - Kuzey Bölgesi",
  "timestamp": 1695283200
}
  

1. Tetikleyici: Gelen Webhook, group.member.joined olayını alır.
2. İletişim Bul veya Oluştur: Telefon +1987654321 arayın. Sarah yeni, GHL "Sarah Martinez" adıyla iletişim oluşturur.
3. Etiket Ekle: Sarah'nın iletişimine "whatsapp-group-member" ve "realtor-north-region" etiketleri ekleyin.
4. Sahip Ata: Kuzey Bölgesi yöneticisine yönlendirin (ör. iş akışı kuralı: etiket = "realtor-north-region", sahip = "[email protected]" olarak ata).
5. Görev Oluştur: "Sarah'yı takıma karşıla — ekleme belgelerini gönder".
6. Özel Webhook (WhatsApp Gönder): Whapi API'sini çağırıp Sarah'nın numarasına kişisel karşılama mesajı gönderin.
   • Mesaj: "${contact.firstName}, hoş geldiniz! Gayrimenkul Ekibinin parçasısınız. Ekleme belgeleri için e-postanızı kontrol edin. Sorular? Buraya yanıt verin."
7. Not Yaz: Sarah'nın iletişisine not ekleyin: "[tarih] WhatsApp grubuna katıldı. İş akışı yürütüldü."

WhatsApp Tetikleyicileriyle Daha Fazla GoHighLevel İş Akışı Oluşturun

• Yeni müşteri mesajı → bilet oluştur: gelen WhatsApp mesajı bilet oluşturmayı tetikler; açık bilet yoksa destek kuyruğuna yönlendir ve otomatik yanıt gönder: "Mesajınızı aldık. Destek 2 saat içinde yanıt verir."
• İletişim terki iş akışı: iletişim 30 gün WhatsApp'ta etkin değilse → GHL yeniden katılım WhatsApp mesajı gönder, e-posta ile takip et, satış görevi oluştur.
• Sipariş durum güncellemeleri: iletişi etiketli "aktif-sipariş-var" → GHL günlük WhatsApp gönderir: "Siparişiniz yarın gönderilir. İzleme: [URL]."
• Potansiyel müşteri niteliği akışı: yeni iletişi grup katıl → GHL WhatsApp aracılığıyla niteliği belirleyen sorular sor → cevaplara göre etiketle "sıcak-potansiyel" veya "soğuk-potansiyel" → uygun satış iş akışına yönlendir.
• İzin tabanlı mesajlaşma: iletişi alanı "marketing-izni-var" = doğru → GHL promosyon WhatsApp gönder; yanlışsa, sadece işlem mesajları. Uyumluğu iş akışına yerleştirin.

Senkronizasyon Problemlerini ve Yinelenen Olayları Önleyin

WhatsApp + GoHighLevel Entegrasyon Kontrol Listesi

• Whapi webhook URL'si GHL'de canlı — başka numaradan WhatsApp mesajı göndererek test edin; GHL webhook günlüklerinde webhook'u aldığını doğrulayın (GHL webhook günlüklerini kontrol edin).
• İletişim eşleştirmesi çalışıyor — GHL'de bilinen telefonla test iletişimi oluşturun, o telefondan WhatsApp mesajı gönderin, GHL'nin varolan iletişimi bulduğunu doğrulayın (yineleme oluşturmamak).
• Giden WhatsApp mesajları başarıyla gönderiliyor — GHL'de "WhatsApp Gönder" webhook eylemini çalıştırın, mesajın WhatsApp'ta vardığını doğrulayın. 401 veya 403 hatalarını izleyin (yetkilendirme tokeni sorunu) ve 404 hatalarını izleyin (telefon Whapi'de bağlı değil).
• İş akışları etkisizdir — aynı webhook yükünü elle iki kez tetikleyin; görevlerin, etiketlerin ve mesajların çoğaltılmadığını doğrulayın.
• Telefon numarası biçimi tutarlı — GHL'deki tüm telefon numaraları aynı biçimi kullanır (ör. +1234567890 ile + öneki). Birkaç iletişiyi sorgulayıp Whapi webhook yükleriyle karşılaştırarak kontrol edin.
• Hata işleme yerde — GHL iş akışı, "webhook başarısız olursa" için koşulu içerir (ör. Whapi tokeni süresi doldı, WhatsApp numarası bağlı değil); "SMS gönder" veya "hata günlüğü ve yöneticiyi uyar" gibi geri dönüş eylemi ekleyin.
• Oran sınırları saygı gösteriliyor — saatte 100+ mesaj gönderiyorsanız, aralık verin (GHL'de gönderiler arasına 1 saniyelik gecikme ekleyin veya sıra kullanın). Whapi panosunda API çağrı sayımlarını ve WhatsApp oran sınırı uyarılarını izleyin.
• Günlüğe kaydetme ve izleme etkinleştirildi — GHL, her gelen webhook ve giden mesaj eylemini günlüğe kaydeder (GHL yürütme günlüklerini kontrol edin); Whapi panosu webhook teslim durumunu ve mesaj teslim onaylarını gösterir.