Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Facebook webhook za označavanje: kada neko označi vašu stranicu

Polje mention u Facebook webhookovima stranice obaveštava aplikaciju kada neko @označi stranicu u objavi ili komentaru. Meta šalje objekat change sa field postavljenim na mention, čija vrednost može sadržati post_id, comment_id za komentar, tekst u message, priložene linkove i medije, kao i item i verb, u POST zahtevu potpisanom sa X-Hub-Signature-256.

easyCoexistence pretplaćuje svaku stranicu koju povežete na polje mention, pored feed i messages, i prosleđuje njegove događaje označavanja vašem HTTPS endpointu čim stignu, potpisane tajnom za tu stranicu i bez čuvanja kopije, pa vaš agent saznaje za svako označavanje čim se dogodi.

mention

Polje webhook stranice za nova označavanja stranice, uključujući označavanja u komentarima i objavama.

pages_manage_metadata

Dozvola koju administrator stranice sa MODERATE privilegijama mora odobriti pre nego što webhook stranice stigne do callback URL-a aplikacije.

@ + name

Kako ljudi označavaju stranicu u objavi ili komentaru: otkucaju @ i ime stranice, pa je izaberu.

36 hours

Koliko dugo Meta ponavlja neuspelo obaveštenje o stranici, sve ređe, pre nego što ga odbaci.

tagged_time

Polje koje /{page-id}/tagged dodaje svakoj javnoj objavi u kojoj je stranica označena.

Šta pokreće webhook za označavanje?

Neko označava stranicu u objavi ili komentaru. Na Facebook-u se označavanje pravi tako što se otkuca @ i ime stranice, pa se izabere iz predloga, a Metina referenca opisuje polje kao nova označavanja stranice, uključujući označavanja u komentarima i objavama. Centar za pomoć Facebook-a navodi da podešavanja stranice mogu sprečiti ljude da je označe.

Kako izgleda obaveštenje o označavanju?

POST sa object postavljenim na page i jednim entry za označenu stranicu: njen ID, vreme i niz changes čije je polje mention. Metina referenca navodi polja vrednosti, ali ne daje primer, pa je ovo označavanje u objavi oblikovano prema toj listi:

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>"
          }
        }
      ]
    }
  ]
}

Šta znači svako polje označavanja?

Ovo su polja vrednosti u Metinoj referenci; koja će obaveštenje sadržati zavisi od objave ili komentara:

  • post_id: ID objave koja je označila stranicu.
  • comment_id: ID komentara, kada je označavanje u komentaru; parent_id: ID njegovog roditelja.
  • message: tekst koji nosi označavanje.
  • link, photo, photos i video: linkovi na ono što je objava ili komentar priložio.
  • item i verb: vrsta objekta i šta mu se dogodilo, iz istih lista koje koristi polje feed.
  • created_time: kada je objava ili komentar napravljen.
  • from i message_tags: autor i profili označeni u tekstu, oba samo za Workplace.
  • Takođe navedeno: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id i open_graph_story_id.

Koja dozvola je potrebna polju mention?

pages_manage_metadata, koju administrator stranice sa MODERATE privilegijama mora odobriti pre nego što webhook stranice stigne do aplikacije. Stranica se pretplaćuje preko POST /{page-id}/subscribed_apps sa mention među subscribed_fields, koristeći token stranice nekog sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE, uz pages_manage_metadata i pages_show_list. Aplikacija se takođe pretplaćuje na mention, jer se polja isporučuju samo ako su pretplaćena na oba nivoa, a stranicama kojima upravljaju ljudi bez uloge u aplikaciji potrebne su te dozvole u Advanced Access.

Kako pročitati objavu ili komentar koji označava stranicu?

Po ID-u, tokenom stranice, gde Meta to dozvoljava. Token stranice čita objave objavljene na stranicu ili od strane stranice; javno podeljene objave drugih stranica zahtevaju pages_manage_posts i funkciju Page Public Content Access, na tokenu administratora stranice; a Meta vezuje čitanje tuđe objave za dozvolu user_posts te osobe.

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>

Gde još stranica može naći svoja označavanja?

Na edge-u tagged. GET /{page-id}/tagged navodi javne objave u kojima je stranica označena, svaka sa tagged_time, što obuhvata i objave napravljene pre nego što je webhook podešen. Zahteva token stranice nekog sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE, uz pages_read_user_content i pages_show_list, a Meta navodi da je možda potrebna funkcija Page Public Content Access. Kod objave osobe, Meta vraća polje from samo osobi koja ju je napisala.

Kako easyCoexistence isporučuje događaje označavanja?

Pretplaćuje svaku stranicu na mention, pored feed i messages, kada se stranica poveže. Njegova aplikacija proverava X-Hub-Signature-256 na svakoj isporuci, odmah odgovara Meti i POST-uje svaki entry za stranicu, nepromenjen, na HTTPS endpoint koji postavite pomoću set_social_webhook_destination ili PUT /channels/:id/webhook u Partner API-ju:

  • X-EC-Signature nosi t=<unix>,v1=<hex>: HMAC-SHA256 vremenske oznake, tačke i sirovog tela, sa ključem tajne za potpisivanje stranice.
  • Tajna počinje sa whsec_ i prikazuje se jednom; ponovno postavljanje URL-a izdaje novu, a null URL zaustavlja prosleđivanje.
  • Svaki entry se šalje jednom, čekajući do 8 sekundi, na HTTPS adresu koja se razrešava na javnu IP adresu, bez praćenja preusmeravanja i bez čuvanja kopije.
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>"
        }
      }
    ]
  }
}

Česte greške

  • Čitanje entry.time kao trenutka označavanja. Meta ga postavlja na trenutak slanja obaveštenja; created_time u vrednosti datira objavu ili komentar.
  • Tretiranje neuspešnog pretraživanja kao pokvarenog događaja. Meta upozorava da se neke vrednosti post_id i comment_id u obaveštenjima o označavanju ne mogu proveriti, zbog nedostatka dozvole ili privatnosti, pa tekst message držite iz samog događaja.
  • Preuzimanje objave pre odgovora na prosleđivanje. Prosleđivanja se ne ponavljaju, pa odmah vratite 2xx, a objavu tražite posle.
Ovo radite uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze; prvih 3 dana besplatno.

Često postavljana pitanja

Da li webhook za označavanje kaže ko je označio stranicu?

Ne za stranicu: Metina referenca označava from samo za Workplace. Pretraga objave ili komentara po ID-u može vratiti njegovog autora gde to Metine dozvole dozvoljavaju.

Mogu li dobiti označavanja iz vremena pre pretplate stranice?

Ne preko webhooka, jer Meta ne čuva istoriju obaveštenja za upit. Edge tagged navodi javne objave u kojima je stranica označena.

Po čemu se polje mention razlikuje od feed?

feed prijavljuje promene na sopstvenom feed-u stranice, kao što su objave, komentari i reakcije tamo; mention prijavljuje da je stranica @označena u objavi ili komentaru. Svako polje se pretplaćuje posebno.

Da li pravila i automatizacije easyCoexistence deluju na označavanja?

Ne. Pravila i automatizacije deluju na komentare iz polja feed i na Messenger poruke; promene mention se prosleđuju vašem endpointu tačno onako kako ih je Meta poslala.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na