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

Facebook etiketleme webhook'u: biri Sayfanızı etiketlediğinde

Facebook Sayfa webhook'larındaki mention alanı, biri bir gönderi ya da yorumda Sayfayı @etiketlediğinde uygulamayı bilgilendirir. Meta, alanı mention olan bir değişiklik gönderir; value içinde post_id, yorum için comment_id, message içindeki metin, eklenen bağlantılar ve medya, ayrıca item ve verb bulunabilir. Bu POST isteği X-Hub-Signature-256 ile imzalanır.

easyCoexistence, bağladığınız her Sayfayı feed ve messages'ın yanında mention alanına abone eder ve etiketleme olaylarını geldikleri anda, o Sayfaya özel bir sırla imzalanmış olarak HTTPS uç noktanıza iletir; hiçbir kopya tutulmaz; böylece yapay zekâ ajanınız her etiketlemeyi olduğu anda öğrenir.

mention

Yeni Sayfa etiketlemeleri için Sayfa webhook alanı; yorumlardaki ve gönderilerdeki etiketlemeler dahil.

pages_manage_metadata

Sayfa webhook'larının bir uygulamanın geri çağırma URL'sine ulaşabilmesi için, MODERATE yetkisine sahip bir Sayfa yöneticisinin vermesi gereken izin.

@ + name

Kişiler bir gönderide ya da yorumda Sayfayı şöyle etiketler: @ yazıp Sayfanın adını girer, ardından bunu seçerler.

36 hours

Meta'nın başarısız bir Sayfa bildirimini, giderek seyrekleşen aralıklarla, bırakmadan önce ne kadar süre yeniden denediği.

tagged_time

/{page-id}/tagged kenarının, Sayfanın etiketlendiği herkese açık her gönderiye eklediği alan.

Etiketleme webhook'unu ne tetikler?

Bir gönderi ya da yorumda Sayfanın etiketlenmesi. Facebook'ta etiketleme, @ yazıp Sayfanın adını yazarak ve önerilerden seçerek yapılır. Meta'nın referansı bu alanı Sayfanın yeni etiketlemeleri, yorumlardaki ve gönderilerdeki etiketlemeler dahil, olarak tanımlar. Facebook Yardım Merkezi, Sayfa ayarlarının kişilerin onu etiketlemesini engelleyebileceğini belirtir.

Bir etiketleme bildirimi nasıl görünür?

object değeri page olan, etiketlenen Sayfa için tek bir entry içeren bir POST: kimliği, bir zaman ve alanı mention olan bir changes dizisi. Meta'nın referansı value alanlarını listeler ama örnek vermez; bu yüzden gönderideki bir etiketleme aşağıdaki listeden şöyle kurgulanmıştır:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

Etiketleme olayının her alanı ne anlama gelir?

Bunlar Meta'nın referansındaki value alanlarıdır; bir bildirimin hangilerini taşıdığı gönderiye ya da yoruma bağlıdır:

  • post_id: Sayfayı etiketleyen gönderinin kimliği.
  • comment_id: etiketleme bir yorumdaysa yorumun kimliği; parent_id: üst öğesinin kimliği.
  • message: etiketlemeyi taşıyan metin.
  • link, photo, photos ve video: gönderinin ya da yorumun eklediği içeriklere bağlantılar.
  • item ve verb: nesnenin türü ve ona ne olduğu; feed alanının kullandığı listelerden.
  • created_time: gönderinin ya da yorumun oluşturulma zamanı.
  • from ve message_tags: yazar ve metinde etiketlenen profiller; ikisi de yalnızca Workplace olarak işaretlidir.
  • Ayrıca listelenenler: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id ve open_graph_story_id.

Etiketleme alanı hangi izni gerektirir?

pages_manage_metadata. Meta, Sayfa webhook'larının bir uygulamaya ulaşabilmesi için MODERATE yetkisine sahip bir Sayfa yöneticisinin bu izni vermesini şart koşar. Sayfa, POST /{page-id}/subscribed_apps ile, subscribed_fields içinde mention bulunarak abone edilir; bu işlem için CREATE_CONTENT, MANAGE ya da MODERATE görevine sahip birinden alınmış bir Sayfa token'ı kullanılır ve pages_manage_metadata ile pages_show_list izinleri gerekir. Uygulama da mention'a abone olur, çünkü yalnızca her iki düzeyde de abone olunan alanlar iletilir. Uygulamada rolü olmayan kişilerin yönettiği Sayfalar ise bu izinleri Advanced Access ile almalıdır.

Etiketleyen gönderi ya da yorum nasıl okunur?

Kimliğiyle, Meta'nın izin verdiği yerlerde Sayfa token'ı ile. Sayfa token'ı, Sayfaya yayımlanan ya da Sayfanın yayımladığı gönderileri okur; başka Sayfaların herkese açık paylaştığı gönderiler için ise bir Sayfa yöneticisinden alınmış bir token üzerinde pages_manage_posts ve Page Public Content Access özelliği gerekir. Meta ayrıca bir kişinin kendi gönderisinin okunmasını o kişinin user_posts iznine bağlar.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

Sayfa etiketlemelerini başka nerede bulabilir?

tagged kenarında. GET /{page-id}/tagged, Sayfanın etiketlendiği herkese açık gönderileri listeler; her biri bir tagged_time ile gelir ve webhook kurulmadan önceki gönderileri de kapsar. Bu istek için CREATE_CONTENT, MANAGE ya da MODERATE görevine sahip birinden bir Sayfa token'ı ile pages_read_user_content ve pages_show_list gerekir; Meta, Page Public Content Access özelliğinin de gerekebileceğini söyler. Bir kişinin gönderisinde ise Meta, from alanını yalnızca gönderiyi yazan kişiye döndürür.

easyCoexistence etiketleme olaylarını nasıl iletir?

Sayfa bağlandığında her Sayfayı, feed ve messages'ın yanına, mention'a abone eder. Uygulaması her iletimde X-Hub-Signature-256 imzasını denetler, Meta'ya hemen yanıt verir ve Sayfaya ait her entry'yi, değiştirmeden, Partner API'deki set_social_webhook_destination ya da PUT /channels/:id/webhook ile belirlediğiniz HTTPS uç noktasına POST eder:

  • X-EC-Signature başlığı şunu taşır: t=<unix>,v1=<hex>; zaman damgasının, bir noktanın ve ham gövdenin HMAC-SHA256 değeridir ve Sayfanın imzalama sırrıyla anahtarlanır.
  • Sır whsec_ ile başlar ve yalnızca bir kez gösterilir; URL yeniden ayarlandığında yeni bir sır üretilir, URL null yapıldığında iletim durur.
  • Her entry en fazla 8 saniye beklenerek, herkese açık bir IP'ye çözülen bir HTTPS adresine tek sefer gönderilir; yönlendirmeler izlenmez ve hiçbir kopya tutulmaz.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

Yaygın hatalar

  • entry.time'ı etiketlemenin anı sanmak. Meta bunu bildirimin gönderildiği an olarak ayarlar; value içindeki created_time, gönderinin ya da yorumun tarihini verir.
  • Başarısız olan bir sorguyu bozuk bir olay saymak. Meta, bazı etiketleme bildirimlerindeki post_id ve comment_id değerlerinin izin eksikliği ya da gizlilik nedeniyle sorgulanamayacağını uyarır; bu yüzden mesaj metnini olayın kendisinden alın.
  • Iletimi yanıtlamadan önce gönderiyi getirmek. İletimler yeniden denenmez; bu yüzden hemen bir 2xx dönün ve gönderiyi sonradan sorgulayın.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Etiketleme webhook'u Sayfayı kimin etiketlediğini söyler mi?

Sayfa için söylemez: Meta'nın referansı from alanını yalnızca Workplace olarak işaretler. Gönderiyi ya da yorumu kimliğiyle sorgulamak, Meta'nın izinlerinin izin verdiği yerlerde yazarını döndürebilir.

Sayfa abone edilmeden önceki etiketlemeleri alabilir miyim?

Webhook'tan alamazsınız, çünkü Meta sorgulanabilir bir bildirim geçmişi tutmaz. tagged kenarı, Sayfanın etiketlendiği herkese açık gönderileri listeler.

mention alanı feed'den nasıl farklıdır?

feed, Sayfanın kendi akışındaki değişiklikleri bildirir; gönderiler, yorumlar ve tepkiler gibi. mention ise Sayfanın bir gönderide ya da yorumda @etiketlenmesini bildirir. Her alan kendi başına abone edilir.

easyCoexistence'ın yorum kuralları etiketlemelere uygulanır mı?

Hayır. Kurallar ve otomasyonlar, feed alanındaki yorumlara ve Messenger mesajlarına uygulanır; mention değişiklikleri ise Meta'nın gönderdiği haliyle uç noktanıza iletilir.

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