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

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.

64

Meta'nın Sayfa webhook referansında belgelenen abonelik alanları; feed ve mention'dan Messenger ve profil alanlarına kadar.

pages_manage_metadata

Sayfa webhook'larının bir uygulamaya ulaşabilmesi için, MODERATE yetkisine sahip bir Sayfa yöneticisinin vermesi gereken izin.

message_echoes

Sayfanın gönderdiği mesajlar için ayrı bir Messenger alanı; yalnızca Messenger konuşmalarında kullanılabilir.

ADVERTISE

leadgen'e abone olmak için gereken Sayfa görevi; leads_retrieval, ads_management, pages_read_engagement ve pages_manage_metadata ile.

Both levels

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:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

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:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

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_update ve call_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_integrity ve messaging_integrity: bütünlük güncellemeleri; business_integrity iç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 ve public_transit.
  • Mekân: price_range, payment_options, attire ve culinary_team.
  • Kişisel: birthday, personal_info ve personal_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:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

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.
Bunu EasyCoexistence'la yapmak

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