Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Bir Facebook Sayfasını webhook'lara abone etmek: subscribed_apps uç noktası

Bir Facebook Sayfası, POST /{page-id}/subscribed_apps isteğiyle bir uygulamanın webhook'larına abone edilir; bu istekte subscribed_fields olarak feed,messages gibi alanlar ve CREATE_CONTENT, MANAGE ya da MODERATE görevine sahip birinden alınmış bir Sayfa erişim token'ı gönderilir. pages_manage_metadata ve pages_show_list izinleri verilmiş olmalıdır. Meta, bir alanın olaylarını ancak uygulama da o alana abone olduğunda gönderir; GET aboneliği listeler, DELETE ise kaldırır.

easyCoexistence, bağladığınız her Sayfayı subscribed_apps üzerinden feed, messages ve mention alanlarına abone eder, kaldırdığınızda aboneliği iptal eder ve Sayfanın olaylarını, Sayfaya özel bir gizli anahtarla imzalanmış olarak HTTPS uç noktanıza iletir; bu işlem tek bir MCP bağlayıcısından ya da Partner API'den yapılır.

Both levels

Webhook üretmek için alanın hem Sayfa hem de uygulama düzeyinde abone edilmiş olması gerekir; bir Sayfa, uygulamadan daha fazla alan listeleyebilir.

CREATE_CONTENT, MANAGE or MODERATE

Sayfa görevleri; token'ın arkasındaki kişinin aboneliği okumak ya da oluşturmak için bunlardan birine sahip olması gerekir.

messaging_success

Bir uygulama DELETE ile webhook aboneliğini bir Sayfadan kaldırdığında, başarı yanıtının yanında döner.

App access token

/{app-id}/subscriptions üzerinde uygulama düzeyindeki aboneliği okumak, oluşturmak veya silmek için gereken şey.

1 hour

Meta, uygulamayı Sayfadan abonelikten çıkarmadan önce Messenger teslimatlarının ne kadar süre başarısız olabileceği.

subscribed_apps uç noktası ne yapar?

Uygulamayı Sayfaya kurar ve Sayfanın hangi webhook alanlarını uygulamanın alacağını belirler. Meta, bildirimleri yalnızca Sayfada uygulama kuruluyken ve Sayfanın ayarlarında uygulama platformu kapatılmamışsa gönderir; ayrıca yalnızca iki düzeyde de abone edilmiş alanlar için: bu uç nokta üzerinden Sayfa düzeyinde, bir de App Dashboard'da ya da /{app-id}/subscriptions üzerinden ayarlanan uygulama düzeyinde. Bir Sayfa, uygulamadan daha fazla alana abone olabilir.

Bir Sayfaya nasıl abone olunur?

Uygulamanın alanlarını virgülle ayırarak subscribed_fields içinde listeleyen bir POST isteğiyle ve Sayfanın erişim token'ıyla. Başarılı bir çağrı success: true döndürür; messages listeleyen bir çağrı için token'da ayrıca pages_messaging izni de gerekir:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Hangi token, görevler ve izinler gerekir?

Çağrıyı tek bir Sayfaya bağlayan Sayfa erişim token'ı, bu Sayfa adına işlem yapabilen birinden. Meta'nın referansları ve rehberleri bu gereksinimleri belirler:

  • Herhangi bir alan: CREATE_CONTENT, MANAGE ya da MODERATE görevine sahip bir kişi; ayrıca pages_manage_metadata ile pages_show_list.
  • messages ve diğer Messenger alanları: ayrıca pages_messaging; MESSAGING görevini yerine getirebilen birinin token'ı.
  • leadgen: ADVERTISE görevi; leads_retrieval, pages_read_engagement ve ads_management ile birlikte.
  • Aboneliği GET ile okumak, oluşturmakla aynı görev ve izinleri gerektirir.

Alanların hangi erişim düzeyine ihtiyacı var?

Advanced Access, Sayfalar ve uygulamanın kendi rolleri dışındaki kişiler için gerekir. Standard Access ile Messenger bildirimleri yalnızca uygulamada rolü olan kişilerden gelir; örneğin yöneticiler, geliştiriciler ve test kullanıcıları. Advanced Access ise her izin için App Review üzerinden ve Business Verification gerektirerek, bildirimleri uygulamanın müşterilerine açar. Meta'nın Messenger rehberi, uygulamanın yayımlanmasını da ön koşullar arasında sayar.

Uygulama düzeyindeki abonelik nedir?

Diğer yarısı: uygulamanın kendisinin dinlediği alanlar ve geri çağrı URL'si. App Dashboard'da ya da uygulama erişim token'ıyla POST /{app-id}/subscriptions çağrısıyla ayarlanır; burada object=page, callback_url, fields, include_values ve verify_token gönderilir ve bu, Meta'nın doğrulama isteğini tetikler. Aynı uç noktada GET her nesnenin callback_url, fields alanlarını ve aboneliğin etkin olup olmadığını gösterir; yeni bir POST, diğerlerinin üzerine yazmadan alanları günceller; DELETE ise hepsini ya da belirtilen alanları kaldırır.

Bir Sayfanın hangi aboneliklere sahip olduğu nasıl kontrol edilir?

Aynı uç noktaya Sayfanın token'ıyla GET isteği göndererek. data dizisi, Sayfanın kurduğu her uygulamayı adı, ID'si ve subscribed_fields alanıyla listeler; Sayfada hiçbir uygulama kurulu değilse boş döner:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Bir abonelik nasıl kaldırılır?

DELETE /{page-id}/subscribed_apps ile; bu, uygulamayı Sayfadan ayırır. Bir uygulama kendi aboneliğini uygulama erişim token'ıyla kaldırabilir ve yanıt success ile messaging_success içerir. Meta da kendiliğinden kaldırabilir: bir saat süren başarısız Messenger teslimatlarından sonra uygulama Sayfadan abonelikten çıkarılır ve uç noktası çalıştığında yeniden abone olmak zorunda kalır.

easyCoexistence bağlanırken ne yapar?

Kişi her Sayfayı seçtiğinde, o Sayfanın token'ını kaydettikten hemen sonra abone olur: subscribed_fields değeri feed,messages,mention olan POST /{page-id}/subscribed_apps. Meta reddederse Sayfa bağlı kalır ve list_social_accounts nedeni last_error alanında gösterir. Sayfa kaldırıldığında, token silinmeden önce DELETE /{page-id}/subscribed_apps gönderilir; hiçbir araç subscribed_apps veya token yollarına ulaşmaz, böylece abonelik yalnızca easyCoexistence tarafından yönetilir.

Yaygın hatalar

  • Uç noktayı bir kullanıcı erişim token'ıyla çağırmak. Abone edilecek Sayfanın Sayfa erişim token'ını ister.
  • Sayfaya abone olup uygulamaya abone olmamak. Bir alan, ancak uygulamanın kendi aboneliği de o alanı içerdiğinde geri çağrıya ulaşır.
  • messages'a abone olurken pages_messaging iznini eklememek. Meta bunu ister; MESSAGING görevini yerine getirebilen birinin token'ında bulunmalıdır.
  • Kesintiden sonra yeniden abone olmayı unutmak. Bir saatlik başarısız Messenger teslimatı uygulamanın aboneliğini kaldırır ve POST yeniden gönderilene kadar olaylar durur.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9'dan başlayıp US$ 0.75'e kadar düşen fiyatla, bağlantı ekledikçe fiyat düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Her Sayfaya ayrı ayrı abone olmam gerekir mi?

Evet. subscribed_apps her Sayfa için ayrı çalışır ve o Sayfanın kendi token'ını kullanır; object=page için uygulama düzeyindeki abonelik ise uygulamayı kuran Sayfalar için geçerlidir.

subscribed_apps neden hata 200 döndürüyor?

Meta bu uç nokta için 200'ü bir izin hatası olarak listeler. Token'ın pages_manage_metadata ve pages_show_list izinlerini taşıdığını ve CREATE_CONTENT, MANAGE ya da MODERATE görevine sahip birinden geldiğini kontrol edin.

Bir Sayfaya Graph API Explorer'dan abone olunabilir mi?

Evet. Meta'nın rehberi uygulamayı seçer, pages_manage_metadata izniyle bir kullanıcı token'ı alır, bunu Sayfa token'ıyla değiştirir ve {page-id}/subscribed_apps adresine POST isteği gönderir.

easyCoexistence'a bağlı bir Sayfaya webhook alanı ekleyebilir miyim?

Kendi araçlarıyla hayır: hiçbiri subscribed_apps yollarına ulaşmaz ve Sayfa, easyCoexistence'ın ilettiği alanlar olan feed, messages ve mention'a abone kalır.

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