Ana içeriğe geç

Webhook'ları Yapılandırma

Şimdi Facebook'a potansiyel müşteri verilerini nereye göndereceğini söyleyeceğiz. Buna "webhook" denir - Facebook'a CRM'nizin posta adresini vermek gibidir.

Webhook Nedir?​

Basit bir ifadeyle:

Birisi Facebook/Instagram'da Potansiyel Müşteri Formunuzu doldurur
         ↓
Facebook der ki: "Hey, yeni bir potansiyel müşterim var!"
         ↓
Facebook potansiyel müşteri verilerini SİZİN webhook URL'nize gönderir
         ↓
Modülünüz bunu alır ve Perfex CRM'de potansiyel müşteriyi oluşturur

Webhook, Facebook'un veri gönderdiği sunucunuzdaki bir URL'dir. Modül bu URL'yi otomatik olarak oluşturur - sadece Facebook'a bunu bildirmeniz gerekir.

Perfex'ten Webhook Bilgilerinizi Alın​

Facebook'a gitmeden önce, modülünüzden bilgileri alalım:

  1. Perfex CRM'ye giriş yapın
  2. Kenar çubuğunda Meta Leads → Ayarlar bölümüne gidin
  3. Önce App ID ve App Secret bilgilerinizi (Adım 1'den) girin ve Ayarları Kaydet düğmesine tıklayın
  4. Webhook Ayarları bölümüne kaydırın
  5. İki değer göreceksiniz:
AlanÖrnekNe Olduğu
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookFacebook'un veri gönderdiği yer
Verify Tokena1b2c3d4e5f6g7h8i9j0Bağlantıyı doğrulamak için gizli bir kod
  1. Her değerin yanındaki Kopyala düğmesine tıklayın
uyarı

Callback URL https:// ile başlaMALIDIR - Facebook SSL gerektirir! URL'niz http:// ile başlıyorsa, önce bir SSL sertifikası yüklemeniz gerekir.

Meta Uygulamanıza Webhook Ekleme​

1. Meta Uygulama Kontrol Panelinizi Açın​

Şu adresten uygulamanıza gidin:

👉 https://developers.facebook.com/apps/

Açmak için uygulamanıza tıklayın.

2. Webhooks Ürününü Ekleyin​

  1. Sol kenar çubuğunda "Ürün Ekle" seçeneğini arayın veya kontrol panelinde aşağı kaydırın
  2. Ürün listesinde "Webhooks" bulun
  3. "Kur" veya "Yapılandır" düğmesine tıklayın
ipucu

Zaten sol kenar çubuğunda "Webhooks" görüyorsanız, doğrudan üzerine tıklayın - tekrar eklemenize gerek yok.

3. Nesne Türü Olarak "Page" Seçin​

  1. Webhooks sayfasında varsayılan olarak "User" yazan bir açılır menü göreceksiniz
  2. Bu açılır menüyü "Page" olarak değiştirin
uyarı

Bu kritik! "Page" seçMELİSİNİZ - "User" değil, "Application" değil, başka bir şey değil. Potansiyel müşteri verileri Page abonelikleri aracılığıyla gelir.

4. Webhook'a Abone Olun​

  1. "Bu nesneye abone ol" düğmesine tıklayın (veya zaten yapılandırılmışsa "Aboneliği Düzenle")
  2. İki değer isteyen bir iletişim kutusu görünecektir:
AlanNe Girilecek
Callback URLModülden Webhook URL'nizi yapıştırın (ör. https://yourcrm.com/facebookleadsintegration/webhook)
Verify TokenModülden Verify Token'ınızı yapıştırın
  1. "Doğrula ve Kaydet" düğmesine tıklayın

5. "Doğrula ve Kaydet"e Tıkladığınızda Ne Olur​

Facebook webhook URL'nize hemen bir doğrulama isteği gönderecektir:

Facebook: "Hey, bu gerçekten senin sunucun mu?"
Modülünüz: "Evet! İşte bunu kanıtlayan verify token!"
Facebook: "Harika, doğrulandı!"

Çalışırsa: Başarı mesajı göreceksiniz ve iletişim kutusu kapanır.

Başarısız olursa: Yaygın çözümler için Sorun Giderme bölümüne bakın.

6. "leadgen" Olaylarına Abone Olun​

Doğrulamadan sonra, Facebook'a hangi olayları göndereceğini söylemeniz gerekir:

  1. "Page" abonelikleri altında olay türlerinin bir listesini göreceksiniz
  2. Listede "leadgen" bulun (kaydırmanız gerekebilir)
  3. "leadgen" yanındaki "Abone Ol" geçiş/onay kutusuna tıklayın
ipucu

"leadgen" ihtiyacınız olan TEK olaydır. Başka olaylara ("messages" veya "feed" gibi) abone olmanıza gerek yok. Sadece "leadgen".

Doğrulama Başarılı!​

Webhook yapılandırmanız şimdi şöyle görünmelidir:

Webhooks
├── Nesne: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Doğrulandı
└── Abonelikler:
    └── ✅ leadgen (abone olundu)

Perfex CRM modülünüze geri döndüğünüzde, webhook durum göstergesi artık yeşil/Doğrulandı olarak görünmelidir!

Webhook'u Test Etme​

Webhook'un çalıştığından emin olmak mı istiyorsunuz?

  1. Perfex CRM → Meta Leads → Ayarlar bölümüne gidin
  2. "Bağlantıyı Test Et" düğmesine tıklayın
  3. Tüm yeşil onay işaretlerini görmelisiniz

Daha kapsamlı testi daha sonra Potansiyel Müşterileri Test Etme bölümünde yapacağız.

Kaçınılması Gereken Yaygın Hatalar​

HataDüzeltme
"Page" yerine "User" seçildiAçılır menüyü "Page" olarak değiştirin
"leadgen"e abone olmayı unutmaListede "leadgen" bulun ve abone olun
HTTPS yerine HTTP kullanmaSunucunuza SSL sertifikası yükleyin
Callback URL'de yazım hatasıModül ayarlarından doğrudan kopyala-yapıştır yapın
"Callback URL doğrulanamadı"Sorun Giderme bölümünü kontrol edin

Webhook yapılandırıldı mı? Sayfalarınızı Bağlayın