Facebook Sayfası feed webhook'u: yorum, gönderi ve tepki olayları
Facebook Sayfa webhook'larındaki feed alanı, bir Sayfanın feed'indeki neredeyse tüm değişiklikleri olduğu anda bildirir. Her değişiklik, gönderi, yorum veya tepki gibi bir item ile add, edit veya remove gibi bir verb'ü, ayrıca ilgili ID'leri, from alanındaki yazarı ve message alanındaki metni içerir. Meta bunu JSON olarak gönderir ve X-Hub-Signature-256 ile imzalar.
easyCoexistence, bağladığınız her Sayfayı feed alanına abone eder ve değişikliklerini geldikleri anda HTTPS uç noktanıza iletir; her biri o Sayfanın gizli anahtarıyla imzalanır.
Sayfa beğenileri için feed bildirimleri yalnızca bundan az beğenisi olan Sayfalar için gönderilir.
feed alanı reklam gönderilerinin kendisi için hiçbir şey göndermez, ama bunlardaki yorumları gönderir.
Sayfa webhook'larının bir uygulamaya ulaşabilmesi için, MODERATE yetkisine sahip bir Sayfa yöneticisinin vermesi gereken izin.
Meta çoğu güncellemeyi tek bir webhook teslimatında toplar, ancak toplamayı garanti etmez.
Meta, uygulamanın uç noktasına başarısız olan bir teslimatı giderek seyrekleşen aralıklarla ne kadar süreyle yeniden denediği.
Feed alanı neyi bildirir?
Meta'nın tanımına göre bir Sayfanın feed'indeki neredeyse tüm değişiklikler: gönderiler, yorumlar, tepkiler ve paylaşımlar gibi. Bir değişikliğin neler taşıdığı türüne bağlıdır. Meta, reklam gönderilerinin kendisi için hiçbir şey göndermez, ancak bunlara yapılan yorumlar gelir ve Sayfa beğenileri için bildirimler yalnızca Sayfanın 10,000'den az beğenisi olduğu sürece gönderilir.
item ve verb ne anlama gelir?
Her değişikliğin value kısmındaki iki alan ne olduğunu söyler:
- item: Meta'nın listesinden neyin değiştiği; listede post, status, photo, video, link, share, comment, reaction ve album bulunur.
- verb: ona ne olduğu: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute veya update.
- Yeni bir yorum, item comment ve verb add ile gelir; yorumdan DM'e kuralları da tam bunu arar.
- Bir tepki, item reaction ve onu adlandıran bir
reaction_typetaşır.
Bir feed değişikliği nasıl görünür?
JSON'u object değeri page olan bir POST isteğidir ve her Sayfa için bir entry içerir. Her entry; Sayfanın ID'sini, bir time değerini ve bir changes dizisini tutar. Bu, Meta'nın kendi örneğidir; bir kişinin Sayfaya gönderi yazmasıdır:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Bir değişiklik hangi alanları taşıyabilir?
Meta'nın referansı, bir feed değişikliğinin value alanındaki alanları listeler; bunlar değişikliğin türüne göre bulunur:
post_id,comment_idveparent_id: gönderi, yorum ve bunun ait olduğu öğe.- from: değişikliği yapanın ID'si ve adı.
- message: metin; ekli içerik için link, photo, photos veya video.
created_time, düzenlemeler için deedited_time.reaction_typetepkiler için,is_hiddenise bir gönderinin gizli olup olmadığı için.- post:
status_type,is_published,updated_timevepermalink_urlgibi ayrıntılar.
Bir Sayfa nasıl abone edilir?
Uygulama, Sayfanın token'ı ile POST /{page-id}/subscribed_apps isteğini subscribed_fields=feed ile gönderir. İstek; CREATE_CONTENT, MANAGE veya MODERATE görevini yapabilen biri tarafından, pages_manage_metadata ve pages_show_list izinleri verilmiş olarak yapılır. Meta bildirimleri yalnızca Sayfada uygulama kuruluyken ve Sayfanın ayarlarında uygulama platformunu kapatmamışken gönderir. easyCoexistence, bağlandığında her Sayfayı feed, messages ve mention alanlarına abone eder.
Feed olayları uç noktanıza nasıl ulaşır?
Meta, olayları easyCoexistence'ın uygulamasına teslim eder; uygulama X-Hub-Signature-256 değerini kontrol eder, Meta'ya hemen yanıt verir ve bağlı bir Sayfaya ait her entry'yi, o Sayfa için ayarladığınız HTTPS uç noktasına iletir. İletim, zaman damgası ile ham gövdenin, o Sayfanın gizli anahtarıyla oluşturulmuş HMAC-SHA256 değeri olan bir X-EC-Signature başlığı taşır. İletim yalnızca bir kez yapılır; hiçbir kopya tutulmaz ve yeniden deneme yapılmaz. Uç noktayı set_social_webhook_destination ile ya da Partner API'de PUT /channels/:id/webhook ile ayarlayın.
Hangi feed değişiklikleri yorum kurallarını ve otomasyonları başlatır?
Yalnızca yeni yorumlar: Sayfanın gönderilerinden birinde, item comment ve verb add olan bir değişiklik. Yorumdan DM'e kuralları, mesajını anahtar kelimeler açısından denetler ve Sayfanın kendi yaptığı yorumları atlar; otomasyonlar ise hiçbir kuralın yanıtlamadığı yorumları alır. Düzenlemeler, gizlemeler, tepkiler ve gönderiler, bir uç nokta ayarladıysanız doğrudan uç noktanıza gider.
Yaygın hatalar
- Her feed değişikliğini yeni yorum saymak. item ve verb alanlarını kontrol edin: tepkiler, düzenlemeler, gizlemeler ve kaldırmalar aynı alanda gelir.
- Sayfanın kendi yorumlarına yanıt vermek. Yanıtları da feed değişikliği olarak geri gelir; bu yüzden from.id değeri Sayfanın ID'si olanları atlayın.
- Teslimat başına tek değişiklik varsayımı. Meta bir teslimatta 1,000 güncellemeye kadar toplayabilir; bu yüzden her entry'de ve içindeki her değişiklikte döngü kurun.
- entry.time'ı değişikliğin gerçekleştiği an sanmak. Meta bunu bildirimin gönderildiği an olarak ayarlar; value içindeki created_time ise nesnenin oluşturulduğu andır.
Yorumdan DM'e kuralları ve otomasyonlar yeni yorumlar üzerinde çalışır. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Feed webhook'u yorumları içeriyor mu?
Evet. Yeni bir yorum, item comment ve verb add ile bir feed değişikliği olarak gelir; comment_id, post_id, from ve message taşır.
Sayfa beğenileri için webhook alır mıyım?
Yalnızca 10,000'den az beğenisi olan Sayfalar için, Meta'nın Sayfa webhook referansına göre.
Reklam gönderileri feed webhook'unda var mı?
Reklam gönderilerinin kendisi hayır, ancak bunlara yapılan yorumlar gönderilir.
Bir Sayfanın feed olaylarını almak için kendi Meta uygulamam gerekir mi?
Hayır. Meta olayları easyCoexistence'ın uygulamasına teslim eder; uygulama da her birini o Sayfa için ayarladığınız uç noktaya iletir.
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