Facebook Sayfası API bağlantısı neden çalışmaz olur ve nasıl canlı tutulur
Facebook Sayfası bağlantısı, Meta token'ı kabul etmeyi veya olaylarını göndermeyi bıraktığında çalışmaz: token kısa ömürlü bir oturum açmadan gelmiş olabilir; kişi şifresini değiştirmiş (hata 190, alt kod 460), Sayfadaki rolünü kaybetmiş (492) ya da uygulamayı İşletme Entegrasyonları altından kaldırmış (458) olabilir; bir izin 90 gün kullanılmamış, uygulama uzun süre hareketsiz kalmış ya da Meta Sayfayı kısıtlamış olabilir.
easyCoexistence her Sayfanın token'ını uzun ömürlü bir oturum açmadan alır, Sayfayı her 6 saatte bir kontrol eder ve Meta token'ı reddettiğinde size e-posta gönderir.
Meta'nın varsayılan kullanıcı ve Sayfa token'larının geçerlilik süresi; uzun ömürlü bir kullanıcı token'ından alınan Sayfa token'ının son kullanma tarihi yoktur.
Bu süre boyunca hiç oturum açılmaz, API çağrısı yapılmaz ya da webhook gelmezse Meta uygulamayı hareketsiz sayar ve tüm token'larını geçersiz kılar.
pages_manage_posts ve read_insights gibi Sayfa izinleri, 90 günlük veri erişimi süresiyle sona ermez.
Sayfanın Messenger Platform API üzerinden mesaj göndermesini engelleyen Sayfa Bütünlüğü kısıtlaması.
easyCoexistence, bağlı her Sayfayı ne sıklıkta hafif bir Graph çağrısıyla kontrol eder ve Meta token'ı reddederse sahibine e-posta gönderir.
Bir Sayfa bağlantısını hangi etmenler çalışmaz hale getirebilir?
Dört düzeyde nedenler vardır: kişinin oturumu, uygulamanın izinleri ve durumu, Sayfanın kendisi ve webhook aboneliği. Her biri kendi biçiminde ortaya çıkar; çoğu, nedenini adlandıran bir alt kodla birlikte 190 hatası olarak döner:
Bir Sayfa token'ı neden saatler içinde sona erer?
Çünkü /me/accounts üzerinden kısa ömürlü bir kullanıcı token'ıyla okunmuştur ve o da kısa ömürlüdür. Meta'nın varsayılan kullanıcı ve Sayfa token'ları saatler içinde sona erer; kısa ömürlü bir token için bu yaklaşık bir ila iki saattir. Sunucuda fb_exchange_token ile değiştirildiğinde kullanıcı token'ı yaklaşık 60 gün geçerli kalır ve bununla okunan bir Sayfa token'ının son kullanma tarihi yoktur. Meta, zaten süresi dolmuş bir token'ı uzatmaz: hata “Session has expired” mesajını verir, alt kod 463'tür ve kişinin yeniden oturum açması gerekir.
Şifre değişikliği ya da güvenlik kontrolünden sonra ne olur?
Meta, kişinin token'larını geçersiz kılar. Oturumu kapatma ya da şifre değiştirme, 460 alt koduyla 190 hatası döndürür: “The session is invalid because the user logged out”. Meta ayrıca güvenlik olaylarının token'ları beklenen son kullanma tarihinden önce geçersiz kılabileceği konusunda uyarır. 459 ve 464 alt kodları ise hesabın ilgilenilmesi gerektiğini gösterir: kişinin bir sorunu düzeltmek için facebook.com'da oturum açması, ardından uygulamaya yeniden giriş yapması gerekir. Aksi halde çözüm, o kişinin ya da Sayfada rolü olan başka birinin yeni bir oturum açmasıdır.
Kişi Sayfadaki rolünü kaybederse ne olur?
Sayfa token'ı 190 hatası ve 492 alt koduyla çalışmayı bırakır; Meta bunu, Sayfa erişim token'ıyla ilişkili kullanıcının Sayfada uygun bir role sahip olmadığı şeklinde açıklar. Token'lar Sayfa, kişi ve uygulama bazında verildiği için rolü olan diğer kişilerin token'ları çalışmaya devam eder. Çözüm, Sayfayı hâlâ tam yetkiye ya da görev erişimine sahip bir hesapla yeniden bağlamaktır; tercihen işletmeden ayrılmak üzere olmayan bir hesapla.
Biri İşletme entegrasyonları altından uygulamayı kaldırırsa ne olur?
Meta, uygulamanın o kişi için tuttuğu kullanıcı erişim token'larını geçersiz kılar; bunlarla okunan Sayfa token'ları da 458 alt koduyla 190 hatası vererek çalışmayı bırakır: “the user has not authorized the application”. Kişiler uygulamayı Facebook ayarlarında, İşletme entegrasyonları altından kaldırır; Meta bunun ardından uygulamanın deauthorize geri çağırma adresini (callback) tetikler. Sistem kullanıcısı token'ı da İşletme Yöneticisi'nde İşletme Ayarları, Entegrasyonlar, Bağlı uygulamalar yolunda aynı şekilde sonlandırılır; bir uygulama kendi erişimini DELETE /{user-id}/permissions ile sonlandırabilir.
Sayfa izinleri 90 gün sonra sona erer mi?
İki farklı 90 günlük kural vardır ve yalnızca biri Sayfa izinlerine dokunur. Veri erişimi süresi, kişinin son etkinliğinden 90 gün sonra uygulamayı keser; bu kural pages_show_list, pages_manage_posts, pages_messaging, read_insights ve Meta'nın sona ermediğini belirttiği diğer Sayfa izinleri için geçerli değildir. İzin süresi ise geçerlidir: uygulamanın 90 gün kullanmadığı bir izin, App Review'dan onaylanmış olsa bile sona erebilir ve kişinin bunu yeniden vermesi gerekir. İzne ihtiyaç duyan çağrılar, yeni bir oturum açma izni verene kadar 10 kodu ya da 200 serisinden bir kodla başarısız olur.
Uygulamanın tamamı erişimini kaybedebilir mi?
Evet; Meta bunu, App Dashboard'un uyarı kutusunda acil bildirimle önceden duyurur ve belgelenmiş üç yol vardır. 90 gün boyunca hiç oturum açılmayan, Graph API ya da Marketing API çağrısı yapılmayan ve webhook bildirimi gelmeyen uygulama hareketsiz sayılır ve Meta tüm token'larını geçersiz kılar; uygulamayı App Dashboard'dan geri yüklemek onu en son sürüme yükseltir, ancak eski token'lar geçersiz kalır ve kullanılmadığı için düşen izinler App Review'dan yeniden geçmelidir. Yıllık Veri Kullanım Kontrolü tamamlanmalıdır; Meta'nın koşul ve politikalarını ihlal etmek ise API erişimini sınırlayabilir ya da izinleri iptal edebilir.
Meta Sayfayı kısıtladığında ne olur?
Kısıtlanan işlemler başarısız olur: politika ihlalleri nedeniyle geçici engellemede 368 hatası, mesajlarda ise 1893063 alt koduyla 10 kodu döner. Hangisinin geçerli olduğunu Meta'nın Sayfa Bütünlüğü API'si söyler: pages_manage_metadata izniyle GET /{page-id}/page_status, durum olarak ok, warning, restricted ya da suspended döner; her etkin kısıtlamayı (page_publish, page_read_only, page_messaging ya da page_messaging_api gibi) expiration_time değeriyle ve FILE_APPEAL gibi önerilen işlemlerle birlikte listeler. business_integrity webhook alanı değişiklikleri oluştukça bildirir.
API çağrıları çalışırken olaylar neden durur?
Çünkü webhook'lar kendi kurallarıyla başarısız olur. Bir saat boyunca başarısız teslimatlardan sonra Meta, bir Webhooks Disabled uyarısı gönderir ve uygulamanın aboneliğini, yeniden abone olana kadar Sayfadan kaldırır; App platform'unu ayarlarda kapatmış bir Sayfa için ise hiç bildirim göndermez. Token bu iki durumda da geçerli kalabilir; bu nedenle bir kesintiden sonra GET /{page-id}/subscribed_apps çağrısını yapın ve uç nokta yeniden yanıt verdiğinde Sayfa token'ıyla ona POST gönderin.
Gönderi başarısız olmadan kopuk bağlantıyı nasıl yakalarsınız?
Düzenli kontrolle, çünkü Meta bir token geçersiz olduğunda uygulamaya bildirim göndermez. Sayfa token'ıyla yapılan GET /{page-id}?fields=id,name gibi hafif bir çağrı, bir gönderinin de başarısız olacağı şekilde başarısız olur. Uygulamanın kimliği ve gizli anahtarıyla erişim token'ı olarak çağrılan debug_token; is_valid, expires_at ve verilen kapsamları, ayrıca artık çalışmayan bir token için hata kodu ve alt kodunu döndürür. page_status kısıtlamaları bildirir, deauthorize geri çağırması ise kaldırılan uygulamayı duyurur.
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=$PAGE_TOKEN" \
--data-urlencode "access_token=$APP_ID|$APP_SECRET"
# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops workingBir Sayfayı nasıl yeniden bağlarsınız?
Sayfayı ilk bağlayan akışın aynısıyla, Sayfada hâlâ bir role sahip biri tarafından yapılır; varsa nedeni önce giderin: kontrol noktasına alınmış bir hesap facebook.com'da oturum açar, bir kısıtlama önerilen işlemiyle çözülür ve başarısız uç nokta yeniden 200 yanıtı verir. Yeni oturum açma yeni token dizileri döndürür, bu yüzden her ikisini tutmak yerine kayıtlı olanları değiştirin:
Bir Sayfa bağlantısı koptuğunda easyCoexistence ne yapar?
Gördüğü kopmaları izler ve sizi bilgilendirir. Her 6 saatte bir bağlı her Sayfayı GET /{page-id}?fields=id,name ile kontrol eder; bu kontrolde ya da herhangi bir araç çağrısında Meta token'ı 190 veya 102 hatasıyla reddederse Sayfa Yeniden bağlanma gerekli durumuna alınır, sahibine tek bir e-posta gönderilir ve bir ortak platform channel.disconnected olayını alır. Eksik bir izin ya da politika engeli gibi diğer reddetmeler, aracın sonucunda Meta'nın kodu ve mesajıyla birlikte döner.
Biri İşletme entegrasyonları altından uygulamayı kaldırdığında, Meta'nın deauthorize geri çağırması easyCoexistence'a ulaşır; bu da o kişinin bağladığı Sayfaları kaldırır, token'larını ve olay hedeflerini siler, faturadan çıkarır ve channel.removed olayını gönderir. Panelden yeniden oturum açmak, Sayfayı yorum kuralları ve otomasyonlarıyla birlikte aynı bağlantı olarak geri getirir; feed, messages ve mention için yeniden abone olur. Yeniden bağlanma gerekli durumundan sonra olay hedefi de kalır; kaldırmadan sonra ise set_social_webhook_destination onu yeni bir gizli anahtarla yeniden ayarlar.
Yaygın hatalar
- 190 hatasını yeniden denemek. Reddedilen bir token her çağrıda aynı şekilde başarısız olur; yalnızca Sayfada rolü olan biri tarafından yapılan yeni bir oturum açma geçerli bir token üretir.
- Bir kısıtlamayı kaldırmak için yeniden bağlanmak. Yeni bir token Sayfanın durumunu değiştirmez; page_status içindeki önerilen işlemler, örneğin bir itiraz, durumu değiştirir.
- Ürünün nadiren kullandığı bir izni istemek. 90 gün kullanılmazsa sona erebilir ve ona ihtiyaç duyan çağrılar başarısız olur; izni özellik yayınlandığında isteyin.
- Yeniden bağlandıktan sonra eski token'ı tutmak. Yeni oturum açma farklı bir token dizisi döndürür; hâlâ eskisini tutan bir iş 190 hatasıyla başarısız olmaya devam eder.
Tek bir Facebook oturum açması Sayfayı yorum kuralları ve otomasyonlarıyla birlikte aynı bağlantı olarak geri getirir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı sayısı arttıkça düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
60 günlük kullanıcı token'ı sona erdiğinde Sayfa token'ı çalışmayı bırakır mı?
/me/accounts üzerinden o uzun ömürlü kullanıcı token'ıyla okunmuşsa hayır: böyle bir Sayfa token'ının son kullanma tarihi yoktur, ancak bu sayfadaki nedenler yine de onu sonlandırabilir.
Bir Sayfa token'ı çalışmayı bıraktığında Meta bana haber verir mi?
Geçersiz hale gelen bir token için hayır: bir sonraki çağrı hatayı döndürür. Biri uygulamayı kaldırdığında Meta uygulamanın deauthorize geri çağırmasını tetikler ve uygulama genelindeki riskleri App Dashboard'un uyarı kutusunda bildirir.
Başka bir kişinin token'ı Sayfayı bağlı tutabilir mi?
Evet. Sayfa token'ları Sayfa, kişi ve uygulama bazında verildiği için Sayfada hâlâ rolü olan başka birinin token'ı, bir kişinin erişimi sona erdiğinde de çalışmaya devam eder.
easyCoexistence bir Facebook Sayfası için ne kadar tutar?
Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bu tutar sahip olduğunuz bağlantı sayısına göre belirlenir, her Sayfa bir bağlantı sayılır ve ilk 3 gün ücretsizdir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi