Facebook Sayfası webhook alanları: tam liste
Meta'nın Sayfa webhook referansı 64 abonelik alanını belgeler: gönderiler, yorumlar ve tepkiler için feed, Sayfadan bahsedildiğinde mention, messages, message_echoes, messaging_postbacks ve message_reads gibi Messenger alanları ve name, picture, hours ve website gibi profil alanları. Her biri pages_manage_metadata iznini gerektirir; bir uygulama, bir alanı hem uygulama düzeyinde hem de Sayfa tarafından subscribed_apps üzerinden abone olduktan sonra alır.
easyCoexistence, bağladığınız her Sayfaya feed, messages ve mention alanlarına abone olur ve bu olayları geldikleri anda HTTPS uç noktanıza, X-EC-Signature ile imzalanmış olarak iletir; yorum kuralları ve otomasyonlar ise yeni yorumlar ve mesajlar üzerinde çalışır.
Meta'nın Sayfa webhook referansında belgelenen abonelik alanları; feed ve mention'dan Messenger ve profil alanlarına kadar.
Sayfa webhook'larının bir uygulamaya ulaşabilmesi için, MODERATE yetkisine sahip bir Sayfa yöneticisinin vermesi gereken izin.
Sayfanın gönderdiği mesajlar için ayrı bir Messenger alanı; yalnızca Messenger konuşmalarında kullanılabilir.
leadgen'e abone olmak için gereken Sayfa görevi; leads_retrieval, ads_management, pages_read_engagement ve pages_manage_metadata ile.
Yalnızca hem Sayfa hem de uygulama düzeyinde abone olunan alanlar webhook üretir.
Sayfa webhook alanları nasıl düzenlenmiştir?
Meta bunları Sayfa nesnesi için tek bir referans sayfasında belgeler ve üç aileye ayrılırlar: Sayfa üzerindeki ve çevresindeki etkinlik, Messenger konuşmaları ve Sayfanın kendi bilgilerindeki düzenlemeler. Feed, mention ve profil değişiklikleri entry.changes içinde, her biri alanını adlandırarak, ya da uygulama Include Values seçeneğini kapattığında changed_fields olarak gelir; Messenger olayları entry.messaging içinde, ya da konuşmanın sahibi olmayan bir uygulama için entry.standby içinde gelir.
Hangi alanlar Sayfadaki etkinliği bildirir?
Konuşmalar yerine içeriği ve etkinliği kapsayan on iki alan vardır. Örneğin yeni bir yorum, item değeri comment, verb değeri add olarak ayarlanmış bir değişiklik olarak feed üzerinden gelir; tepkiler, paylaşımlar ve Sayfanın kendi gönderileriyle birlikte. Meta'nın referansında her birinin ilettikleri:
Hangi alanlar Messenger olaylarını taşır?
Messenger'ın listesi en uzunudur ve Meta'nın Messenger webhook rehberi her alanın ne gönderdiğini anlatır. Bu on üç alan bir Sayfanın konuşmalarını kapsar; konuşmanın sahibi olmayan bir uygulamaya mesaj taşıyan standby ise Sayfa referansında değil, o rehberde belgelenir:
Hangi diğer Messenger alanları var?
On tanesi belirli ürünlere hizmet eder; aramadan ticarete ve bütünlük bildirimlerine kadar:
send_cart: sepet veya sipariş bilgisi taşıyan bir mesaj;message_context: Meta'nın modellerinin bir mesaj üzerinde yaptığı tespitler, bir olay adı ve bir puanla birlikte.- calls,
call_settings_updatevecall_permission_reply: Messenger sesli aramaları, Sayfanın arama ayarlarındaki değişiklikler ve bir kişinin arama izni isteğine verdiği yanıt. messaging_customer_information: bir kişinin müşteri bilgisi ekranına girdiği bilgiler;messaging_in_thread_lead_form_submit: konuşma içinde gönderilen bir potansiyel müşteri formu.message_template_status_update: bir yardımcı mesaj şablonunun inceleme durumu değiştiğinde.business_integrityvemessaging_integrity: bütünlük güncellemeleri;business_integrityiçinde ihlaller, kısıtlamalar ve işlem olayları.
Hangi alanlar Sayfanın profilindeki değişiklikleri bildirir?
Yirmi dokuz alan, Sayfanın kendi bilgilerindeki düzenlemeleri bildirir; her ayrıntı için bir alan, her biri ayrıntıyı adlandıran bir değişiklik olarak gelir:
- Kimlik: name, picture, category (en fazla üç kategori barındırır) ve description, yani Story Description.
- İşletme ayrıntıları:
company_overview, mission, founded, products,general_info,general_manager, members, awards ve affiliation. - İletişim ve yer: email, phone, website, location, hours,
current_location, hometown, parking vepublic_transit. - Mekân:
price_range,payment_options, attire veculinary_team. - Kişisel: birthday,
personal_infovepersonal_interests.
Her alan hangi izni gerektirir?
Hepsi için pages_manage_metadata gerekir ve bunu MODERATE yetkisine sahip bir Sayfa yöneticisi verir; bazıları için daha fazlası gerekir. Sayfa subscribed_apps üzerinden abone edilir ve Meta'nın rehberleri erişim token'ını ve izinleri alan türüne göre belirler; uygulamanın kendi rolleri dışındaki kişilerle ilgili olaylar almak için izinlerin ayrıca Advanced Access'e de ihtiyacı vardır:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
easyCoexistence hangi alanlara abone olur?
Üç tane: feed, messages ve mention. Bir Sayfa bağlandığında easyCoexistence bu alanlarla ve Sayfanın token'ıyla POST /{page-id}/subscribed_apps isteği gönderir, ardından o Sayfanın her girdisini sizin belirlediğiniz uç noktaya, X-EC-Signature ile imzalanmış olarak iletir. Yorum kuralları ve otomasyonlar feed'den gelen yeni yorumlar ve messages üzerinde çalışır; mention'lar olduğu gibi iletilir. Başka hiçbir alana abone olunmaz; bu yüzden echo'lar, postback'ler, okundu bildirimleri, devirler, standby ve profil değişiklikleri iletilmez.
Yaygın hatalar
- Sayfayı, uygulamanın abone olmadığı bir alana abone etmek. Meta, yalnızca hem Sayfa hem de uygulama düzeyinde abone olunan alanları iletir.
- Messenger olaylarını changes olarak ayrıştırmak. Bunlar entry.messaging içinde gelir; her girdide bir messaging nesnesi bulunur, entry.changes içinde değil.
- Sayfanın kendi yanıtlarının messages üzerinde gelmesini beklemek. Sayfanın gönderdiği mesajlar, ayrı bir alan olan message_echoes üzerinde gelir.
- Büyük bir Sayfada beğeniler için feed'e güvenmek. Meta, beğeni bildirimlerini yalnızca 10,000'den az beğenisi olan Sayfalar için gönderir.
Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
Feed alanı reklamlardaki yorumları içerir mi?
Evet. Meta, reklam gönderilerinin kendileri için hiçbir şey göndermez, ancak bunlardaki yorumlar feed üzerinde gelir.
Include Values ayarı neyi değiştirir?
Açıkken bir değişiklik changes içinde yeni değerleri taşır. Kapalıyken Meta yalnızca değişen alanların adlarını changed_fields içinde gönderir.
Bir Sayfanın hangi alanlara abone olduğunu nasıl görürüm?
Sayfanın token'ıyla GET /{page-id}/subscribed_apps isteği, Sayfanın yüklediği uygulamaları ve her biri için subscribed_fields değerlerini listeler.
easyCoexistence Sayfa profili değişikliklerini iletir mi?
Hayır. easyCoexistence'e bağlı Sayfalara yalnızca feed, messages ve mention alanlarına abone olunur; bu yüzden name, picture ve diğer profil alanları iletilmez.
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