Giden Webhook'lar

Giden Webhook'lar, bir müşteri adayı olayı gerçekleştiğinde LeadHub'dan harici bir URL'ye müşteri adayı verilerini iletir. Bunu müşteri adaylarını bir CRM ile senkronize etmek, Zapier iş akışlarını tetiklemek veya harici sistemleri bilgilendirmek için kullanın.

---

Giden Webhook'lar Nasıl Çalışır

1. Hedef URL ve dinlenecek olaylarla bir giden webhook oluşturursunuz.
2. Seçilen olay gerçekleştiğinde (örn. yeni müşteri adayı oluşturuldu), LeadHub URL'nize bir HTTP POST isteği gönderir.
3. Yük, tam müşteri adayı verilerini içeren bir JSON nesnesidir.

---

Giden Webhook Oluşturma

1. Entegrasyonlar → Giden Webhook'lar'a gidin.
2. Yeni Giden Webhook'a tıklayın.
3. Yapılandırın:

Alan	Açıklama
Ad	Dahili ad (örn. "HubSpot'a Senkronize Et")
URL	POST'u alan harici uç nokta
Olaylar	Bu webhook'u tetikleyecek olaylar (aşağıya bakın)
Gizli	İstek imzası doğrulaması için isteğe bağlı HMAC sırrı
Aktif	Etkinleştirmek veya devre dışı bırakmak için geçiş yapın

4. Kaydet'e tıklayın.

---

Mevcut Olaylar

Olay	Ne Zaman Tetiklenir
lead.created	Yeni bir müşteri adayı kaydı oluşturulur
lead.updated	Bir müşteri adayı değiştirilir
lead.deleted	Bir müşteri adayı silinir
lead.stage_changed	Bir müşteri adayı yeni bir huni aşamasına geçer
lead.assigned	Bir müşteri adayı bir kullanıcıya atanır
form.submitted	Form gönderimi alınır

---

Yük Formatı

Tüm giden webhook'lar bir JSON gövdesi POST'lar:

{
  "event": "lead.created",
  "occurred_at": "2026-04-29T10:30:00Z",
  "lead": {
    "id": 123,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "+1-555-000-0000",
    "source": "web_form",
    "status": "new",
    "lead_score": 45,
    "pipeline": "Sales Pipeline",
    "stage": "New Lead",
    "assigned_to": "[email protected]",
    "tags": ["vip", "from-webinar"],
    "created_at": "2026-04-29T10:30:00Z"
  }
}

---

HMAC İmza Doğrulaması

Bir Gizli belirlerseniz LeadHub her isteği HMAC-SHA256 imzasıyla imzalar. İmza X-LeadHub-Signature başlığında gönderilir.

PHP'de doğrulamak için:

$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

---

Webhook Teslimi ve Yeniden Denemeler

LeadHub webhook'ları kuyruk aracılığıyla eşzamansız olarak teslim eder. Harici uç nokta 2xx olmayan bir yanıt döndürürse, üstel geri çekilmeyle en fazla 3 kez yeniden denenir.

Teslimat geçmişini incelemek için Webhook Günlüğü sayfasına bakın.

---

Devre Dışı Bırakma ve Silme

• Devre Dışı Bırakma: Aktif'i kapatın — hiçbir olay gönderilmez, ancak webhook korunur.
• Silme: Webhook yapılandırmasını kalıcı olarak kaldırır.