Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Webhook za spominjanje na Facebooku: kada netko spomene vašu stranicu

Polje mention u webhookovima Facebook stranica obavještava aplikaciju kada netko u objavi ili komentaru označi stranicu s @. Meta šalje promjenu u kojoj je polje postavljeno na mention, a vrijednost može sadržavati post_id, comment_id za komentar, tekst u message, priložene poveznice i medije te item i verb. Zahtjev je POST potpisan zaglavljem X-Hub-Signature-256.

easyCoexistence pretplaćuje svaku stranicu koju povežete na polje mention, uz feed i messages, i prosljeđuje njene događaje spominjanja na vaš HTTPS endpoint čim stignu, potpisane tajnom za tu stranicu i bez zadržavanja kopije, pa vaš agent za svako spominjanje zna čim se dogodi.

mention

Polje webhooka stranice za nova spominjanja, uključujući spominjanja u komentarima i objavama.

pages_manage_metadata

Dopuštenje koje administrator stranice s ovlastima MODERATE mora odobriti prije nego što webhookovi stranice dođu do povratnog URL-a aplikacije.

@ + name

Kako ljudi spominju stranicu u objavi ili komentaru: upišu @ i naziv stranice, zatim je odaberu.

36 hours

Koliko dugo Meta ponavlja neuspjelu obavijest o stranici, sve rjeđe, prije nego je odbaci.

tagged_time

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

Što pokreće webhook za spominjanje?

Netko spominje stranicu u objavi ili komentaru. Na Facebooku se spominjanje radi tako da upišete @ i naziv stranice te je odaberete iz prijedloga. Metina referenca opisuje polje kao nova spominjanja stranice, uključujući spominjanja u komentarima i objavama. Facebookov centar za pomoć navodi da postavke stranice mogu ljudima onemogućiti spominjanje.

Kako izgleda obavijest o spominjanju?

POST zahtjev u kojem je object postavljen na page, s jednim unosom za spomenutu stranicu: njezin ID, vrijeme i niz changes čije je polje mention. Metina referenca navodi polja vrijednosti, ali ne daje primjer, pa je ovo spominjanje u objavi oblikovano prema tom popisu:

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

Što znači svako polje spominjanja?

To su polja vrijednosti iz Metine reference. Koja će se pojaviti u obavijesti ovisi o objavi ili komentaru:

  • post_id: ID objave koja je spomenula stranicu.
  • comment_id: ID komentara, kada je spominjanje u komentaru; parent_id: ID njegova roditelja.
  • message: tekst koji nosi spominjanje.
  • link, photo, photos i video: poveznice na ono što je objava ili komentar priložio.
  • item i verb: vrsta objekta i što se dogodilo s njim, iz istih popisa koje koristi polje feed.
  • created_time: kada su objava ili komentar stvoreni.
  • from i message_tags: autor i profili označeni u tekstu; oba su označena kao samo za Workplace.
  • Također navedeno: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id i open_graph_story_id.

Koje dopuštenje treba polje mention?

pages_manage_metadata, koje Meta zahtijeva da administrator stranice s ovlastima MODERATE odobri prije nego što webhookovi stranice dođu do aplikacije. Stranica se pretplaćuje putem POST /{page-id}/subscribed_apps s mention među subscribed_fields, koristeći token stranice od nekoga sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE, uz pages_manage_metadata i pages_show_list. Aplikacija se također pretplaćuje na mention, jer se isporučuju samo polja pretplaćena na obje razine, a stranice kojima upravljaju ljudi bez uloge u aplikaciji trebaju te dozvole u Advanced Accessu.

Kako pročitati objavu ili komentar koji spominje stranicu?

Prema ID-u, s tokenom stranice, gdje to Meta dopušta. Token stranice čita objave objavljene na stranici ili od nje. Javno podijeljene objave drugih stranica trebaju pages_manage_posts i značajku Page Public Content Access, s tokenom administratora stranice; a Meta čitanje osobne objave osobe veže uz njezino dopuštenje user_posts.

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>

Gdje još stranica može pronaći svoja spominjanja?

Na tagged edgeu. GET /{page-id}/tagged navodi javne objave u kojima je stranica označena, svaku s tagged_time, što obuhvaća i objave nastale prije postavljanja webhooka. Traži token stranice od nekoga sa zadatkom CREATE_CONTENT, MANAGE ili MODERATE, uz pages_read_user_content i pages_show_list, a Meta kaže da može biti potrebna značajka Page Public Content Access. Na osobnoj objavi Meta vraća from samo osobi koja ju je napisala.

Kako easyCoexistence isporučuje događaje spominjanja?

Pretplaćuje svaku stranicu na mention, uz feed i messages, pri povezivanju stranice. Njegova aplikacija provjerava X-Hub-Signature-256 na svakoj isporuci, odmah odgovara Meti i šalje svaki unos za stranicu, nepromijenjen, na HTTPS endpoint koji postavite pomoću set_social_webhook_destination ili PUT /channels/:id/webhook na Partner API-ju:

  • X-EC-Signature nosi t=<unix>,v1=<hex>: HMAC-SHA256 vremenske oznake, točke i sirovog tijela zahtjeva, uz ključ za potpisivanje stranice.
  • Tajna vrijednost počinje s whsec_ i prikazuje se jednom; ponovnim postavljanjem URL-a izdaje se nova, a null URL zaustavlja prosljeđivanje.
  • Svaki unos šalje se jednom, uz čekanje do 8 sekundi, na HTTPS adresu koja se razrješava u javnu IP adresu, bez praćenja preusmjeravanja i bez zadržavanja 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>"
        }
      }
    ]
  }
}

Uobičajene pogreške

  • Čitanje entry.time kao trenutka spominjanja. Meta ga postavlja na trenutak slanja obavijesti; created_time u vrijednosti datira objavu ili komentar.
  • Shvaćanje neuspjelog upita kao neispravnog događaja. Meta upozorava da se neke vrijednosti post_id i comment_id u obavijestima o spominjanju ne mogu upitati, zbog nedostatka dopuštenja ili privatnosti, pa tekst iz polja message zadržite iz samog događaja.
  • Dohvaćanje objave prije odgovora na prosljeđivanje. Prosljeđivanja se ne ponavljaju, pa odmah vratite 2xx, a objavu potražite poslije.
Radite ovo uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Govori li webhook za spominjanje tko je spomenuo stranicu?

Ne za stranicu: Metina referenca označava from samo za Workplace. Pretraživanje objave ili komentara po ID-u može vratiti njezina autora tamo gdje Metina dopuštenja to dopuštaju.

Mogu li dobiti spominjanja iz vremena prije pretplate stranice?

Ne putem webhooka, jer Meta ne čuva povijest obavijesti za upit. Tagged edge navodi javne objave u kojima je stranica označena.

Po čemu se polje mention razlikuje od feeda?

feed prijavljuje promjene na vlastitom feedu stranice, poput objava, komentara i reakcija na njemu; mention prijavljuje da je stranica spomenuta s @ u objavi ili komentaru. Svako se polje pretplaćuje zasebno.

Djeluju li pravila za komentare easyCoexistence na spominjanja?

Ne. Pravila i automatizacije djeluju na komentare iz polja feed i na Messenger poruke; promjene spominjanja prosljeđuju se na vaš endpoint točno onako kako ih je Meta poslala.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na