Ana içeriğe geç

Sorun Giderme

Sorun mu yaşıyorsunuz? Endişelenmeyin — çoğu sorunun basit çözümleri var. Aşağıda sorununuzu bulun ve çözümü uygulayın.

Webhook Doğrulaması Başarısız​

Hata: "The callback URL or verify token couldn't be validated."

Olası Nedenler ve Düzeltmeler:​

#CauseFix
1URL HTTPS değilSunucuya SSL sertifikası yükleyin
2Callback URL'de yazım hatasıModül ayarlarından doğrudan kopyalayıp yapıştırın
3Verify token'da yazım hatasıModül ayarlarından doğrudan kopyalayıp yapıştırın
4Sunucu istekleri engelliyorGüvenlik duvarı / güvenlik eklentilerini kontrol edin
5.htaccess yönlendirme sorunlarıURL'nin yönlendirmediğinden emin olun (www ↔ non-www yönlendirme sorunları yok)
6"User" yerine "Page" seçildiFacebook webhook'larında açılır menüyü "Page" olarak değiştirin

Nasıl Hata Ayıklanır:​

  1. Tarayıcıda webhook URL'nize doğrudan gidin: 
    https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123
  2. Düzgün çalışıyorsa sayfada test123 görünmelidir
  3. Hata sayfası görüyorsanız sorun sunucu tarafındadır
ipucu

Hâlâ çalışmıyor mu? Sunucunuzun hata günlüklerini kontrol edin: /path/to/your/crm/application/logs/

Facebook Girişi Sırasında "Invalid Scopes" Hatası​

Hata: "Invalid Scopes: pages_manage_metadata"

Düzeltme:​

Bu, modülün kullanımdan kaldırılmış bir izin istediği anlamına gelir. Doğru izinleri kullanan en son sürüm (v2.0.0+) modülünü kullandığınızdan emin olun:

  • pages_show_list
  • pages_read_engagement
  • leads_retrieval
  • pages_manage_ads
  • ads_management

Modülü en son sürüme güncelleyin.

"Error Accessing App" / "App Not Active"​

Hata: Facebook ile bağlanmaya çalışırken "Error Accessing App" veya "The app is not active." görünüyor

Olası Nedenler ve Düzeltmeler:​

#CauseFix
1Modül ayarlarında yanlış App IDApp ID'nin Meta App ile eşleştiğini kontrol edin
2Uygulama silindi veya devre dışı bırakıldıdevelopers.facebook.com/apps adresinde uygulamanızı kontrol edin
3Uygulamanın yöneticisi/geliştiricisi değilsinizApp Roles → Roles bölümünde kendinizi ekleyin
4Uygulama kısıtlamalarıApp Settings → Basic → App Restrictions kontrol edin

Test Lead Çalışıyor ama Gerçek Lead'ler Gelmiyor​

Modülün "Send Test Lead" düğmesi çalışıyor ama Facebook'tan gerçek lead'ler görünmüyor.

Şunları Kontrol Edin:​

#CheckHow
1Sayfanız abone mi?Settings → Connected Pages → "Monitoring" göstermeli
2Webhook doğrulandı mı?Settings → Connection Status → Webhook yeşil olmalı
3"leadgen" abone mi?Meta App → Webhooks → Page → "leadgen" işaretli olmalı
4Reklam doğru sayfayı kullanıyor mu?Ads Manager → Ad Set → abone olunan sayfanın kullanıldığından emin olun
5Reklam çalışıyor mu?Ads Manager → Kampanya durumu "Active" olmalı

Facebook'un Aracıyla Test:​

Gerçek webhook test lead'i göndermek için Lead Ads Testing Tool kullanın. Bu çalışıyorsa ama gerçek reklamlar çalışmıyorsa sorun muhtemelen reklam kampanyası kurulumunuzdadır.

Modül Sayfalarında 500 Hatası​

Belirti: Modül sayfaları boş sayfa veya "500 Internal Server Error" gösteriyor

Düzeltmeler:​

  1. PHP hata günlüklerini kontrol edin:

    /path/to/your/crm/application/logs/log-YYYY-MM-DD.php

  2. Yaygın nedenler:

    • PHP sürümü çok eski (7.4+ gerekli)
    • Eksik PHP uzantıları (cURL, JSON)
    • Yanlış dosya izinleri
    • Yükleme sırasında modül dosyaları bozulmuş

  3. Dosya izinlerini düzeltin:

    find /path/to/modules/facebookleadsintegration -type f -exec chmod 644 {} \;
    find /path/to/modules/facebookleadsintegration -type d -exec chmod 755 {} \;

  4. Dosyalar bozulmuş olabilirse modülü yeniden yükleyin

Kopyala Düğmesi Çalışmıyor​

Belirti: Webhook URL veya verify token yanındaki "Copy" düğmesine tıklamak hiçbir şey yapmıyor.

Düzeltme:​

  • CRM'inize HTTPS üzerinden erişildiğinden emin olun — Pano API güvenli bağlam gerektirir
  • Metni manuel olarak seçip Ctrl+C deneyin
  • JavaScript hatalarını kontrol edin (F12 → Console sekmesi)

Lead'ler "Pending Retry"da Takılı​

Belirti: Sync History "Pending" durumunda işlenmeyen lead'ler gösteriyor.

Düzeltmeler:​

  1. Manuel işleme: Sync History → "Process Retry Queue" tıklayın
  2. Cron'u kontrol edin: Yeniden deneme kuyruğu Perfex CRM'in cron işi ile otomatik işlenir
    • Cron işinin çalıştığından emin olun: Setup → Settings → Cron Job
    • Cron URL'si her 5 dakikada bir çağrılmalıdır
  3. Sync History'deki hata mesajını kontrol edin — lead'in başlangıçta neden başarısız olduğu

Erişim Token'ı Süresi Doldu​

Belirti: Bağlantı testi "Token expired" ile başarısız oluyor veya lead'ler gelmeyi durdurdu.

Düzeltme:​

Modül kısa ömürlü token'ları uzun ömürlü tokenlarla (~60 gün geçerli) değiştirir. Yenilemek için:

  1. Meta Leads → Settings bölümüne gidin
  2. Connected Pages bölümüne kaydırın
  3. Yeniden "Connect with Facebook" tıklayın
  4. Giriş yapın ve izinleri verin
  5. Token otomatik olarak yenilenir
ipucu

Token'ı taze tutmak için 50 günde bir yeniden bağlanma hatırlatıcısı ayarlayın!

Alanlar Doğru Eşlenmiyor​

Belirti: Lead verisi yanlış alanlarda görünüyor veya eksik.

Hata Ayıklama Adımları:​

  1. Sync History → Ham veriyi görmek için bir lead girişine tıklayın
  2. Facebook'un gönderdiği alan adlarını kontrol edin
  3. Field Mapping → Facebook alan adının eşleştiğinden emin olun
  4. Unutmayın: Standart alanlar (email, full_name, phone_number) otomatik eşlenir

Yaygın Alan Adı Sorunları:​

What You ExpectWhat Facebook SendsSolution
namefull_nameZaten otomatik eşleniyor
phonephone_numberZaten otomatik eşleniyor
companycompany_nameZaten otomatik eşleniyor
budgetcustom_question_1Özel eşleştirme oluşturun

Kurulumdan Sonra Modül Görünmüyor​

Düzeltmeler:​

  1. Dosya konumunu kontrol edin: Modül klasörü modules/facebookleadsintegration/ konumunda olmalı
  2. Dosya adını kontrol edin: Ana dosya facebookleadsintegration.php (tüm küçük harf) olmalı
  3. Modülü etkinleştirin: Setup → Modules → Activate tıklayın
  4. İzinleri kontrol edin: Dosyalar web sunucusu tarafından okunabilir olmalı (dosyalar 644, dizinler 755)

Sunucuya Özel Sorunlar​

Cloudflare Kullanıcıları​

Cloudflare kullanıyorsanız Facebook'un webhook IP'lerini beyaz listeye ekleyin:

  1. Cloudflare → WAF (Web Application Firewall)
  2. Facebook'tan gelen istekleri Allow eden bir kural oluşturun
  3. Veya güvenlik duvarı beyaz listenize ekleyin:
    • Facebook webhook IP'leri: https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Nginx Kullanıcıları​

Nginx yapılandırmanızın webhook URL'sine POST isteklerine izin verdiğinden ve Facebook'un User-Agent'ını engellemediğinden emin olun.

Paylaşımlı Barındırma​

Çoğu paylaşımlı barındırma sorunsuz çalışır. Sorun varsa:

  • PHP'de allow_url_fopen etkin mi kontrol edin
  • cURL uzantısı yüklü mü kontrol edin
  • Barındırıcınızın gelen webhook'ları engelleyip engellemediğini kontrol edin (bazı güvenlik odaklı barındırıcılar engeller)

Hâlâ Yardıma İhtiyacınız mı Var?​

Yukarıdakilerden hiçbiri sorununuzu çözmediyse:

  1. Perfex CRM hata günlüklerini kontrol edin
  2. Modülün Sync History'sinde hata mesajlarını kontrol edin
  3. Herhangi bir hata mesajının ekran görüntüsünü alın
  4. Şunlarla birlikte [email protected] ile iletişime geçin:
    • Perfex CRM sürümünüz
    • PHP sürümü
    • Hata mesajı
    • Sorunu yeniden oluşturma adımları

Daha fazla cevap için SSS'yi kontrol edin FAQ