Webhook pentru mențiunea Paginii Facebook: când cineva menționează pagina dumneavoastră
Câmpul mention al webhook-urilor Paginii Facebook notifică o aplicație când cineva menționează pagina într-o postare sau un comentariu. Meta trimite o modificare cu field setat la mention, a cărei valoare poate include post_id, comment_id pentru un comentariu, textul din message, linkurile și media atașate, precum și item și verb, într-un POST semnat cu X-Hub-Signature-256.
easyCoexistence abonează fiecare Pagină pe care o conectați la câmpul mention, alături de feed și messages, și trimite evenimentele sale de mențiune către endpoint-ul dumneavoastră HTTPS pe măsură ce sosesc, semnate cu un secret pentru fiecare Pagină și fără a păstra vreo copie, astfel încât agentul dumneavoastră să afle despre fiecare mențiune în momentul în care are loc.
Câmp webhook de Pagină pentru mențiuni noi ale unei Pagini, inclusiv mențiunile din comentarii și postări.
Permisiune pe care un administrator al Paginii cu privilegii MODERATE trebuie să o acorde înainte ca webhook-urile Paginii să ajungă la URL-ul de callback al unei aplicații.
Cum menționează oamenii o Pagină într-o postare sau un comentariu: tastați @ și numele Paginii, apoi o alegeți.
Cât timp reîncearcă Meta o notificare eșuată a Paginii, cu frecvență descrescătoare, înainte de a o abandona.
Câmpul pe care îl adaugă edge-ul /{page-id}/tagged la fiecare postare publică în care Pagina a fost etichetată.
Ce declanșează webhook-ul de mențiune?
O persoană care menționează Pagina într-o postare sau un comentariu. Pe Facebook, o mențiune se face tastând @ și numele Paginii și alegându-l din sugestii, iar referința Meta descrie câmpul ca mențiuni noi ale unei Pagini, inclusiv cele din comentarii și postări. Centrul de ajutor Facebook arată că setările unei Pagini pot împiedica oamenii să o menționeze.
Cum arată o notificare de mențiune?
Un POST cu object setat la page și o singură intrare pentru Pagina menționată: ID-ul său, un timp și un array changes al cărui field este mention. Referința Meta enumeră câmpurile valorii, dar nu oferă niciun exemplu, așa că această mențiune dintr-o postare este construită după lista respectivă:
{
"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>"
}
}
]
}
]
}Ce înseamnă fiecare câmp al unei mențiuni?
Acestea sunt câmpurile valorii din referința Meta; pe care le conține o notificare depinde de postare sau comentariu:
post_id: ID-ul postării care a menționat Pagina.comment_id: ID-ul comentariului, atunci când mențiunea este într-un comentariu;parent_id: ID-ul comentariului părinte.- message: textul care conține mențiunea.
- link, photo, photos și video: linkuri către ce atașează postarea sau comentariul.
- item și verb: tipul obiectului și ce s-a întâmplat cu el, din aceleași liste folosite de câmpul feed.
created_time: momentul în care a fost creată postarea sau comentariul.- from și
message_tags: autorul și profilurile etichetate în text, ambele marcate doar Workplace. - Enumerate de asemenea: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_idșiopen_graph_story_id.
Ce permisiune necesită câmpul mention?
pages_manage_metadata, pe care Meta cere ca un administrator al Paginii cu privilegii MODERATE să o acorde înainte ca webhook-urile Paginii să ajungă la o aplicație. Pagina se abonează prin POST /{page-id}/subscribed_apps cu mention printre subscribed_fields, folosind un token de Pagină de la cineva cu sarcina CREATE_CONTENT, MANAGE sau MODERATE, cu pages_manage_metadata și pages_show_list. Aplicația se abonează și ea la mention, deoarece sunt livrate doar câmpurile abonate la ambele niveluri, iar Paginile administrate de persoane fără un rol în aplicație au nevoie de aceste permisiuni în Advanced Access.
Cum citiți postarea sau comentariul care menționează Pagina?
După ID, cu token-ul Paginii, acolo unde Meta o permite. Un token de Pagină citește postările publicate pe Pagină sau de Pagină; postările partajate public de alte Pagini necesită pages_manage_posts și funcția Page Public Content Access, pe un token de la un administrator al Paginii. Iar Meta leagă citirea postării unei persoane de permisiunea user_posts a acelei persoane.
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>Unde mai poate o Pagină să își găsească mențiunile?
Pe edge-ul tagged. GET /{page-id}/tagged listează postările publice în care Pagina a fost etichetată, fiecare cu un tagged_time, care acoperă și postările de dinaintea configurării webhook-ului. Are nevoie de un token de Pagină de la cineva cu sarcina CREATE_CONTENT, MANAGE sau MODERATE, cu pages_read_user_content și pages_show_list, iar Meta spune că poate fi necesară funcția Page Public Content Access. La o postare a unei persoane, Meta returnează câmpul from doar persoanei care a scris-o.
Cum livrează easyCoexistence evenimentele de mențiune?
Abonează fiecare Pagină la mention, alături de feed și messages, atunci când Pagina se conectează. Aplicația sa verifică X-Hub-Signature-256 la fiecare livrare, răspunde imediat Meta și trimite fiecare intrare pentru Pagină, nemodificată, la endpoint-ul HTTPS pe care îl setați cu set_social_webhook_destination sau PUT /channels/:id/webhook din Partner API:
- X-EC-Signature conține t=<unix>,v1=<hex>: HMAC-SHA256 al marcajului de timp, al unui punct și al corpului brut, cu cheia fiind secretul de semnare al Paginii.
- Secretul începe cu whsec_ și se afișează o singură dată; setarea din nou a URL-ului emite unul nou, iar un URL null oprește redirecționarea.
- Fiecare intrare pleacă o singură dată, cu așteptare de până la 8 secunde, către o adresă HTTPS care se rezolvă la un IP public, fără a urma redirecționări și fără a păstra vreo copie.
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>"
}
}
]
}
}Greșeli frecvente
- Citirea entry.time ca momentul mențiunii. Meta îl setează la momentul în care a fost trimisă notificarea; created_time din valoare datează postarea sau comentariul.
- Tratarea unei căutări eșuate ca pe un eveniment defect. Meta avertizează că unele valori post_id și comment_id din notificările de mențiune nu pot fi interogate, din lipsă de permisiune sau din motive de confidențialitate, așa că păstrați textul mesajului din chiar evenimentul respectiv.
- Preluarea postării înainte de a răspunde la redirecționare. Redirecționările nu se reîncearcă, așa că returnați imediat un 2xx și căutați postarea după aceea.
US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, iar primele 3 zile sunt gratuite.
Întrebări frecvente
Webhook-ul de mențiune spune cine a menționat Pagina?
Nu pentru o Pagină: referința Meta marchează from doar ca Workplace. Căutarea postării sau comentariului după ID poate returna autorul acestuia, acolo unde permisiunile Meta o permit.
Pot primi mențiuni de dinaintea abonării Paginii?
Nu prin webhook, deoarece Meta nu păstrează un istoric al notificărilor de interogat. Edge-ul tagged listează postările publice în care Pagina a fost etichetată.
Cum diferă câmpul mention de feed?
feed raportează modificările de pe propriul feed al Paginii, cum ar fi postările, comentariile și reacțiile de acolo; mention raportează menționarea Paginii într-o postare sau un comentariu. Fiecare câmp se abonează separat.
Regulile de comentarii ale easyCoexistence acționează asupra mențiunilor?
Nu. Regulile și automatizările acționează asupra comentariilor din câmpul feed și asupra mesajelor din Messenger; modificările de tip mention sunt trimise la endpoint-ul dumneavoastră exact cum le-a trimis Meta.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la