Ana içeriğe geç

Müşteri Adayı Kaynakları — Kurulum Kılavuzu

LeadHub 19 farklı kaynaktan müşteri adayı alabilir. Çoğu kaynak bir webhook aracılığıyla çalışır — LeadHub tarafından oluşturulan bir URL'yi harici platforma yapıştırırsınız ve müşteri adayları otomatik olarak akar.

Her Webhook Tabanlı Kaynağın Nasıl Çalıştığı​

  1. Entegrasyonlar → Müşteri Adayı Kaynakları'na gidin ve yeni bir bağlantı oluşturun.
  2. Kaynak türünü seçin ve alan eşleştirmelerini yapılandırın.
  3. Oluşturulan Gelen Webhook URL'sini kopyalayın.
  4. URL'yi harici platforma yapıştırın (her kaynak için aşağıdaki talimatlara bakın).
  5. Test müşteri adayı göndererek test edin — saniyeler içinde çalışma alanınızda görünür.

Facebook Lead Ads (Meta)​

Facebook Lead Ads, kullanıcıların uygulamadan çıkmadan Facebook/Instagram içinde form göndermesine olanak tanır.

Meta "Diğer" CRM seçeneğini kaldırdı

Meta, müşteri adayı formlarındaki CRM Entegrasyonu altında bulunan Diğer seçeneğini artık sunmuyor; bu nedenle form düzeyinde webhook URL'si yapıştırmak artık mümkün değil. Bunun yerine, aşağıda açıklandığı gibi OAuth ve uygulama düzeyinde bir webhook ile bağlanın.

Adım 1 — Meta Uygulamanızı Yapılandırın​

developers.facebook.com adresinde Business türünde bir uygulama oluşturun (veya mevcut uygulamanızı açın):

  1. Facebook Login ürününü ekleyin.

  2. Uygulama Ayarları → Temel → App Domains: LeadHub alan adınızı ekleyin (örn. crm.example.com).

  3. Facebook Login → Ayarlar → Valid OAuth Redirect URIs: şunu ekleyin

    https://YOUR-DOMAIN/oauth/meta/callback

    Bu değer, kurulumunuzun APP_URL değeriyle https dahil olmak üzere tam olarak eşleşmelidir.

ipucu

Alan adını ve yönlendirme URI'sini eklemek, "Can't load URL. The domain of this URL isn't included in the app's domains." hatasını da düzeltir.

Adım 2 — LeadHub'da Bağlanın​

  1. Müşteri Adayı Kaynağı Bağlantıları'na gidin ve bir Meta bağlantısı ekleyin.
  2. App ID ve App Secret değerlerinizi girin.
  3. OAuth ile Bağlan'a tıklayın, istenen izinleri onaylayın ve Sayfanızı seçin.
  4. LeadHub, Sayfa erişim token'ınızı bağlantıya otomatik olarak kaydeder.

Adım 3 — Leadgen Webhook'unu Kurun (Meta Uygulama Düzeyi)​

Bu adım, kaldırılan form düzeyindeki "Diğer" seçeneğinin yerini alır:

  1. Uygulama Panosu → Webhooks bölümünde Page nesnesini seçin.
  2. leadgen alanına abone olun.
  3. Geri Çağırma URL'si ve Doğrulama Token'ı: her ikisini de LeadHub'daki Meta bağlantı ekranından kopyalayın.
  4. Sayfanızı abone edin.

Yeni müşteri adayları artık otomatik olarak akar — Meta her müşteri adayını webhook'a gönderir ve LeadHub, Sayfa erişim token'ınızı kullanarak müşteri adayının tüm ayrıntılarını Graph API'den alır.

İzinler ve Uygulama İncelemesi​

OAuth bağlantısı şu kapsamları ister: leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.

Bu izinler, uygulamanın kendi Yöneticileri, Geliştiricileri veya Test Kullanıcıları dışındaki hesaplarda çalışmadan önce Meta Uygulama İncelemesi + İşletme Doğrulaması gerektirir.

Onaydan önce test etmek için şunlardan birini yapın:

  • Meta uygulamasına kendinizi Yönetici / Geliştirici / Test Kullanıcısı olarak ekleyin, veya
  • Bağlantının Page Access Token alanına bir Page Access Token yapıştırın (Meta'nın Graph API Explorer aracında leads_retrieval kapsamıyla oluşturulur) — LeadHub müşteri adaylarını bu token ile doğrudan okur.

Alan Eşleştirme Örneği​

Facebook AlanıLeadHub Alanı
full_namefirst_name
emailemail
phone_numberphone

Alternatif olarak, veri yükü (payload) üzerinde daha fazla kontrole ihtiyacınız varsa köprü olarak Zapier veya n8n kullanın.

Instagram Müşteri Adayları​

Instagram Lead Ads, Facebook Lead Ads ile aynı Meta Ads altyapısını paylaşır. Yukarıdaki adımları takip edin — Instagram ve Facebook reklamlarının ikisi de aynı webhook uç noktasına teslim eder.

TikTok Müşteri Adayı Oluşturma​

  1. LeadHub'da Müşteri Adayı Kaynağı Bağlantısı oluşturun: Tür → TikTok Müşteri Adayı Oluşturma.
  2. Webhook URL'sini kopyalayın.
  3. TikTok Ads Manager → Varlıklar → Müşteri Adayı Oluşturma → Webhook'ta:
    • Webhook Oluştur'a tıklayın.
    • LeadHub Webhook URL'sini yapıştırın.

LinkedIn Lead Gen Formları​

  1. LeadHub'da Müşteri Adayı Kaynağı Bağlantısı oluşturun: Tür → LinkedIn Lead Gen Formları.
  2. Webhook URL'sini kopyalayın.
  3. LinkedIn Campaign Manager → Hesap Varlıkları → Lead Gen Formları → Entegrasyonlar'da yapıştırın.

WhatsApp Business​

  1. LeadHub'da Müşteri Adayı Kaynağı Bağlantısı oluşturun: Tür → WhatsApp Business.
  2. Webhook URL'sini kopyalayın.
  3. Meta Business → WhatsApp → Yapılandırma → Webhook'ta Geri Çağırma URL'sini ayarlayın.

Telegram​

  1. @BotFather aracılığıyla bir Telegram botu oluşturun ve Bot Token'ını kopyalayın.
  2. LeadHub'da Tür → Telegram ile bir bağlantı oluşturun.
  3. Bot Token'ını girin — LeadHub Telegram API'sine webhook'u otomatik olarak kaydeder.

Typeform​

  1. LeadHub'da Tür → Typeform ile Müşteri Adayı Kaynağı Bağlantısı oluşturun.
  2. Typeform → Formunuz → Bağlan → Webhook'lar'da LeadHub Webhook URL'sini ekleyin.

JotForm​

  1. LeadHub'da Tür → JotForm ile Müşteri Adayı Kaynağı Bağlantısı oluşturun.
  2. JotForm → Formunuz → Ayarlar → Entegrasyonlar → Webhook'lar'da URL'yi yapıştırın.

Calendly​

  1. LeadHub'da Tür → Calendly ile Müşteri Adayı Kaynağı Bağlantısı oluşturun.
  2. Calendly → Entegrasyonlar → Webhook'lar → Yeni Webhook Oluştur'da invitee.created olayını seçin.

LeadHub Web Formu​

LeadHub Form Oluşturucu ile oluşturduğunuz bir formu birisi gönderdiğinde, müşteri adayı otomatik olarak oluşturulur — webhook kurulumu gerekmez.

E-posta (IMAP)​

  1. Müşteri adayı yakalama için özel bir e-posta adresi oluşturun.
  2. Entegrasyonlar → Müşteri Adayı Kaynakları'nda Tür → E-posta (IMAP) ile yeni bir bağlantı oluşturun.
  3. IMAP Ana Bilgisayarı, Port, Kullanıcı Adı, Şifre ve Klasörü girin.

Genel Webhook (Herhangi Bir Platform)​

Yukarıda listelenmeyen herhangi bir platform için Genel Webhook bağlantı türünü kullanın:

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'