Webhook-ul fluxului Paginii Facebook: evenimente pentru comentarii, postări și reacții
Câmpul feed al webhook-urilor Paginilor Facebook raportează aproape orice modificare a fluxului unei Pagini pe măsură ce se întâmplă. Fiecare modificare conține un item, cum ar fi postarea, comentariul sau reacția, și un verb, cum ar fi add, edit sau remove, plus ID-urile implicate, autorul în from și textul în message. Meta îl trimite ca JSON, semnat cu X-Hub-Signature-256.
easyCoexistence abonează fiecare Pagină pe care o conectați la câmpul feed și trimite modificările acesteia către endpoint-ul HTTPS al dumneavoastră pe măsură ce sosesc, semnate cu secretul acelei Pagini, în timp ce regulile comment-to-DM și automatizările acționează asupra comentariilor noi.
Notificările din feed pentru like-urile Paginii sunt trimise doar pentru Paginile cu mai puține like-uri decât acest prag.
Câmpul feed nu trimite nimic pentru postările de reclamă în sine, dar trimite comentariile de sub ele.
Permisiunea pe care trebuie să o acorde un administrator al Paginii cu privilegii MODERATE pentru ca webhook-urile Paginii să ajungă la o aplicație.
Majoritatea actualizărilor sunt grupate de Meta într-o singură livrare webhook, deși nu garantează gruparea.
Cât timp reîncearcă Meta o livrare eșuată către endpoint-ul aplicației, cu frecvență tot mai mică.
Ce raportează câmpul feed?
Aproape orice modificare a fluxului unei Pagini, în termenii Meta, cum ar fi postări, comentarii, reacții și distribuiri; ce conține o modificare depinde de tipul ei. Meta nu trimite nimic pentru postările de reclamă în sine, deși comentariile de sub ele ajung, și trimite notificări pentru like-urile Paginii doar cât timp Pagina are mai puțin de 10.000 de like-uri.
Ce înseamnă item și verb?
Două câmpuri din valoarea fiecărei modificări spun ce s-a întâmplat:
- item: ce s-a schimbat, din lista Meta, care include post, status, photo, video, link, share, comment, reaction și album.
- verb: ce s-a întâmplat cu el: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute sau update.
- Un comentariu nou sosește cu item comment și verb add, ceea ce caută regulile comment-to-DM.
- O reacție conține item reaction și un
reaction_typecare o denumește.
Cum arată o modificare din feed?
Un POST al cărui JSON are object setat la page și o intrare pentru fiecare Pagină, care conține ID-ul Paginii, o oră și un array de changes. Acesta este exemplul propriu al Meta, o persoană care postează pe Pagină:
{
"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>"
}
}
]
}
]
}Ce câmpuri poate conține o modificare?
Referința Meta enumeră aceste câmpuri printre cele ale valorii unei modificări din feed, prezente în funcție de tipul modificării:
post_id,comment_idșiparent_id: postarea, comentariul și elementul părinte al acestuia.- from: ID-ul și numele celui care a făcut modificarea.
- message: textul, cu link, photo, photos sau video pentru conținutul atașat.
created_time, șiedited_timepentru editări.reaction_typepentru reacții, șiis_hiddenpentru dacă o postare este ascunsă.- post: detalii precum
status_type,is_published,updated_timeșipermalink_url.
Cum se abonează o Pagină?
Aplicația trimite POST /{page-id}/subscribed_apps cu subscribed_fields=feed și token-ul Paginii, de la cineva care poate îndeplini sarcina CREATE_CONTENT, MANAGE sau MODERATE, cu pages_manage_metadata și pages_show_list acordate. Meta trimite notificări doar cât timp Pagina are aplicația instalată și nu a dezactivat platforma aplicațiilor în setările sale. easyCoexistence abonează fiecare Pagină la feed, messages și mention atunci când se conectează.
Cum ajung evenimentele din feed la endpoint-ul dumneavoastră?
Meta le livrează aplicației easyCoexistence, care verifică X-Hub-Signature-256, răspunde imediat Meta și trimite fiecare intrare pentru o Pagină conectată către endpoint-ul HTTPS setat de dumneavoastră pentru ea. Transmiterea conține un antet X-EC-Signature, un HMAC-SHA256 al timestamp-ului și al corpului brut, semnat cu secretul acelei Pagini, și pleacă o singură dată, fără copie păstrată și fără reîncercări. Setați endpoint-ul cu set_social_webhook_destination sau cu PUT /channels/:id/webhook din Partner API.
Ce modificări din feed pornesc regulile de comentarii și automatizările?
Doar comentariile noi: o modificare cu item comment și verb add pe una dintre postările Paginii. Regulile comment-to-DM verifică mesajul pentru cuvintele cheie și ocolesc comentariile făcute chiar de Pagină, iar automatizările preiau comentariile la care nu a răspuns nicio regulă. Editările, ascunderile, reacțiile și postările merg direct la endpoint-ul dumneavoastră, dacă ați setat unul.
Greșeli frecvente
- Tratarea oricărei modificări din feed ca un comentariu nou. Verificați item și verb: reacțiile, editările, ascunderile și eliminările sosesc pe același câmp.
- Răspunsul la propriile comentarii ale Paginii. Răspunsurile ei revin și ca modificări din feed, deci săriți peste cele al căror from.id este ID-ul Paginii.
- Presupunerea unei singure modificări pe livrare. Meta poate grupa până la 1.000 de actualizări, deci parcurgeți fiecare intrare și fiecare modificare din ea.
- Citirea lui entry.time ca momentul în care a avut loc modificarea. Meta îl setează la momentul în care a fost trimisă notificarea; created_time din valoare este momentul în care a fost creat obiectul.
De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu prima perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Webhook-ul de feed include comentariile?
Da. Un comentariu nou sosește ca modificare din feed cu item comment și verb add, care conține comment_id, post_id, from și message.
Primesc webhook-uri pentru like-urile Paginii?
Doar pentru Paginile cu mai puțin de 10.000 de like-uri, conform referinței Meta pentru webhook-urile Paginii.
Postările de reclamă sunt în webhook-ul de feed?
Nu postările de reclamă în sine, dar comentariile de sub ele sunt trimise.
Îmi trebuie propria aplicație Meta ca să primesc evenimentele din feed ale unei Pagini?
Nu. Meta le livrează aplicației easyCoexistence, care trimite fiecare eveniment către endpoint-ul setat de dumneavoastră pentru acea Pagină.
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