GHL'i Her Şeye Bağlayın: API, Webhook ve n8n ile Sınırsız Entegrasyon

GHL güçlü bir platform ama bazen dış sistemlerle konuşması gerekiyor. Muhasebe yazılımınız, e-ticaret siteniz, özel CRM'iniz veya başka bir araç olabilir.

İyi haber: GHL'in API ve webhook altyapısı sayesinde neredeyse her şeyle entegre olabilirsiniz. Üstelik n8n gibi araçlarla kod yazmadan.

Entegrasyon Neden Önemli?

Gerçek Senaryo: E-ticaret + GHL

Bir e-ticaret siteniz var. Müşteri sipariş verdiğinde:

• Sipariş bilgisi WooCommerce/Shopify'da
• Müşteri bilgisi GHL CRM'de olmalı
• Kargo takip numarası müşteriye SMS ile gitmeli
• Teslimat sonrası yorum talebi gönderilmeli

Manuel mi yapacaksınız? Hayır. Entegrasyon ile otomatik.

Gerçek Senaryo: Muhasebe Senkronizasyonu

Her satış sonrası:

• Fatura Parasut/Logo'da oluşmalı
• Ödeme kaydı muhasebe sistemine düşmeli
• Müşteri kartı güncellenmeli

Entegrasyon olmadan: Saatler süren manuel iş. Entegrasyon ile: Saniyeler içinde otomatik.

GHL Entegrasyon Seçenekleri

Webhook: Gerçek Zamanlı Veri Akışı

Webhook, GHL'de bir olay olduğunda dış sisteme anlık bildirim gönderir.

Webhook Nasıl Çalışır?

GHL'de olay oldu (form dolduruldu, randevu alındı, vs.)
                    ↓
        Webhook URL'sine POST request
                    ↓
        Dış sistem veriyi alır ve işler

Webhook Kurulumu

1. Settings → Integrations → Webhooks gidin
2. Add Webhook tıklayın
3. Webhook URL'nizi girin (n8n, Zapier veya kendi sunucunuz)
4. Tetiklenecek olayları seçin:
   • Contact Created
   • Contact Updated
   • Appointment Booked
   • Form Submitted
   • Invoice Paid
   • ve daha fazlası...

Webhook Veri Örneği

Form doldurulduğunda giden veri:

{
  "type": "form_submission",
  "contact": {
    "id": "abc123",
    "email": "musteri@example.com",
    "firstName": "Ahmet",
    "lastName": "Yılmaz",
    "phone": "+905551234567"
  },
  "form": {
    "id": "form123",
    "name": "İletişim Formu"
  },
  "submission": {
    "mesaj": "Fiyat bilgisi almak istiyorum"
  },
  "timestamp": "2025-01-21T10:30:00Z"
}

Bu veriyi alıp istediğiniz sisteme aktarabilirsiniz.

n8n ile Kod Yazmadan Entegrasyon

n8n, açık kaynaklı bir otomasyon platformu. Zapier'in ücretsiz ve sınırsız alternatifi.

Neden n8n?

n8n Kurulumu (VPS'te)

# Docker ile kurulum
docker run -d --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Veya n8n.cloud kullanarak hosted versiyon.

GHL + n8n Örnek: Form → Google Sheets

Senaryo: GHL'de form dolduran herkes Google Sheets'e eklensin.

n8n Workflow:

[Webhook Trigger] → [Set Node] → [Google Sheets Node]
        ↑
   GHL Webhook

Adımlar:

1. n8n'de yeni workflow oluştur
2. Webhook node ekle, URL'yi kopyala
3. GHL'de bu URL'yi webhook olarak ekle
4. Google Sheets node ekle, spreadsheet seç
5. Alanları eşleştir (email, ad, telefon)
6. Workflow'u aktifleştir

Artık her form dolduran kişi otomatik olarak Google Sheets'e eklenir.

GHL + n8n Örnek: Sipariş → SMS Bildirimi

Senaryo: WooCommerce'de sipariş geldiğinde GHL'den müşteriye SMS gitsin.

n8n Workflow:

[WooCommerce Trigger] → [HTTP Request to GHL API] → [SMS gönderildi]

Adımlar:

1. WooCommerce webhook'u n8n'e bağla
2. HTTP Request node ile GHL API'ye istek at
3. Müşteri contact olarak ekle veya güncelle
4. SMS workflow'u tetikle

GHL API Kullanımı

API, tam kontrol isteyenler için. Kod yazmanız gerekir ama sınırsız esneklik sağlar.

API Erişimi

1. Settings → Integrations → API Keys gidin
2. Create API Key tıklayın
3. Key'i güvenli bir yerde saklayın

API Endpoint'leri

GHL API ana URL: https://services.leadconnectorhq.com

API Örneği: Contact Oluşturma

const response = await fetch('https://services.leadconnectorhq.com/contacts/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Version': '2021-07-28'
  },
  body: JSON.stringify({
    firstName: 'Ahmet',
    lastName: 'Yılmaz',
    email: 'ahmet@example.com',
    phone: '+905551234567',
    locationId: 'YOUR_LOCATION_ID',
    tags: ['website-lead']
  })
});

const contact = await response.json();
console.log('Contact oluşturuldu:', contact.id);

API Örneği: SMS Gönderme

const response = await fetch('https://services.leadconnectorhq.com/conversations/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Version': '2021-07-28'
  },
  body: JSON.stringify({
    type: 'SMS',
    contactId: 'CONTACT_ID',
    message: 'Merhaba! Siparişiniz kargoya verildi.'
  })
});

Popüler Entegrasyon Senaryoları

1. E-ticaret Entegrasyonu

WooCommerce/Shopify → GHL

Sipariş geldi
     ↓
n8n/Zapier webhook alır
     ↓
GHL'de contact oluştur/güncelle
     ↓
"Müşteri" tag'i ekle
     ↓
Teşekkür SMS'i gönder
     ↓
3 gün sonra: Yorum talebi

2. Muhasebe Entegrasyonu

GHL → Parasut/Logo

GHL'de fatura ödendi
     ↓
Webhook tetiklenir
     ↓
n8n fatura bilgilerini alır
     ↓
Parasut API'ye fatura oluştur
     ↓
Muhasebe kaydı otomatik

3. Takvim Senkronizasyonu

GHL ↔ Google Calendar

GHL'de randevu alındı
     ↓
Google Calendar'a etkinlik ekle
     ↓
(veya tersi)
     ↓
Google Calendar'dan randevu
     ↓
GHL'e senkronize et

4. Slack/Teams Bildirimleri

GHL → Slack

Yeni lead geldi
     ↓
Webhook → n8n
     ↓
Slack kanalına mesaj
     ↓
Satış ekibi anında görür

5. Custom CRM Senkronizasyonu

Mevcut CRM ↔ GHL

Mevcut CRM'de güncelleme
     ↓
Webhook → n8n
     ↓
GHL API ile senkronize
     ↓
(ve tersi)

Pratik İpuçları

1. Webhook Güvenliği

Webhook URL'lerinizi koruyun:

// Webhook'ta secret key doğrulama
const secret = request.headers['x-ghl-signature'];
if (secret !== process.env.WEBHOOK_SECRET) {
  return res.status(401).send('Unauthorized');
}

2. Rate Limiting

GHL API'nin rate limit'i var. Çok fazla istek atmayın:

• Dakikada 100 istek limiti
• Bulk işlemler için batch endpoint kullanın
• İstekler arası 100ms bekleyin

3. Hata Yönetimi

Entegrasyonlar bazen başarısız olur. Hazırlıklı olun:

Webhook başarısız
     ↓
n8n'de retry mekanizması
     ↓
3 deneme sonra hâlâ başarısız
     ↓
Slack'e hata bildirimi
     ↓
Manuel kontrol

4. Veri Eşleştirme

Farklı sistemlerde farklı alan isimleri olabilir:

n8n'de Set node ile alanları dönüştürün.

Adım Adım: İlk Entegrasyonunuz

n8n + GHL Webhook Kurulumu

1. n8n'de Webhook Oluşturun:

• n8n'e giriş yapın
• Yeni workflow oluşturun
• Webhook node ekleyin
• "Test URL"yi kopyalayın

2. GHL'de Webhook Ekleyin:

• Settings → Integrations → Webhooks
• Add Webhook
• n8n URL'sini yapıştırın
• "Contact Created" seçin
• Kaydedin

3. Test Edin:

• GHL'de test contact oluşturun
• n8n'de webhook'un tetiklendiğini görün
• Gelen veriyi inceleyin

4. İşlem Ekleyin:

• Google Sheets node ekleyin
• Veya Slack notification
• Veya başka bir sistem

5. Aktifleştirin:

• Workflow'u aktif yapın
• Production URL'ye geçin
• GHL webhook'u güncelleyin

Hazır Entegrasyon Şablonları

n8n Şablonları

n8n topluluğunda hazır GHL şablonları var:

• GHL to Google Sheets
• GHL to Slack notifications
• WooCommerce to GHL
• GHL to Mailchimp

Zapier Zap'leri

Zapier'de popüler GHL entegrasyonları:

• New GHL Contact → Add to Mailchimp
• New GHL Appointment → Create Google Calendar Event
• New Typeform Entry → Create GHL Contact

Kontrol Listesi

• GHL API key oluşturdum
• n8n kurdum (veya Zapier hesabı açtım)
• İlk webhook'u test ettim
• Veri akışını doğruladım
• Hata bildirimi kurdum
• Production'a geçtim
• Dokümantasyon hazırladım

GHL Destek

How to Use Webhooks

GHL'in resmi dokümantasyonu.