InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Facebook-pagina feed-webhook: gebeurtenissen voor opmerkingen, posts en reacties

Het feed-veld van de webhooks van Facebook-pagina's meldt bijna alle wijzigingen in de feed van een Pagina zodra ze zich voordoen. Elke wijziging bevat een item, zoals post, opmerking of reactie, en een verb, zoals add, edit of remove, plus de betrokken ID's, de auteur in from en de tekst in message. Meta verstuurt dit als JSON, ondertekend met X-Hub-Signature-256.

easyCoexistence abonneert elke Pagina die je verbindt op het feed-veld en stuurt de wijzigingen door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met het geheim van die Pagina.

10K likes

Feedmeldingen voor likes van Pagina's worden alleen verstuurd voor Pagina's met minder likes dan dit aantal.

Ad posts

Het feed-veld stuurt niets voor advertentieposts zelf, maar wel voor de opmerkingen erop.

pages_manage_metadata

Een Pagina-beheerder met MODERATE-rechten moet toestemming geven, zodat Pagina-webhooks een app bereiken.

1,000

De meeste updates bundelt Meta in één webhook-levering, al garandeert het dat niet.

36 hours

Hoe lang Meta mislukte levering aan het endpoint van de app opnieuw probeert, met afnemende frequentie.

Wat rapporteert het feed-veld?

Bijna alle wijzigingen in de feed van een Pagina, in de woorden van Meta, zoals posts, opmerkingen, reacties en shares. Wat een wijziging bevat hangt af van het soort. Meta verstuurt niets voor advertentieposts zelf, al komen opmerkingen erop wel binnen, en stuurt meldingen voor Pagina-likes alleen zolang een Pagina minder dan 10.000 likes heeft.

Wat betekenen item en verb?

Twee velden in de waarde van elke wijziging geven aan wat er gebeurde:

  • item: wat er veranderde, uit de lijst van Meta, met onder meer post, status, photo, video, link, share, comment, reaction en album.
  • verb: wat er met het item gebeurde: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute of update.
  • Een nieuwe opmerking komt binnen met item comment en verb add, waar comment-naar-DM-regels op zoeken.
  • Een reactie heeft item reaction en een reaction_type die deze benoemt.

Hoe ziet een feed-wijziging eruit?

Een POST waarvan de JSON object op page zet, met per Pagina een entry met het ID van de Pagina, een tijd en een array van changes. Dit is het eigen voorbeeld van Meta, een persoon die op de Pagina post:

A feed change, as Meta sends it
{
  "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>"
          }
        }
      ]
    }
  ]
}

Welke velden kan een wijziging bevatten?

Meta's referentie noemt deze velden van de value van een feed-wijziging, aanwezig afhankelijk van het soort wijziging:

  • post_id, comment_id en parent_id: de post, de opmerking en waar die bij hoort.
  • from: het ID en de naam van degene die de wijziging maakte.
  • message: de tekst, met link, photo, photos of video voor bijgevoegde content.
  • created_time, en edited_time voor bewerkingen.
  • reaction_type voor reacties, en is_hidden voor of een post verborgen is.
  • post: details zoals status_type, is_published, updated_time en permalink_url.

Hoe abonneert een Pagina zich?

De app stuurt POST /{page-id}/subscribed_apps met subscribed_fields=feed en het token van de Pagina, van iemand die de taak CREATE_CONTENT, MANAGE of MODERATE kan uitvoeren, met pages_manage_metadata en pages_show_list toegekend. Meta stuurt alleen meldingen zolang de Pagina de app geïnstalleerd heeft en het app-platform in de instellingen niet heeft uitgeschakeld. easyCoexistence abonneert elke Pagina bij het verbinden op feed, messages en mention.

Hoe komen feed-gebeurtenissen bij je endpoint?

Meta levert ze aan de app van easyCoexistence, die X-Hub-Signature-256 controleert, Meta direct antwoordt en elke entry voor een verbonden Pagina doorstuurt naar het HTTPS-endpoint dat je ervoor instelde. De doorsturing bevat een X-EC-Signature-header, een HMAC-SHA256 van een tijdstempel en de ruwe body, ondertekend met het geheim van die Pagina. Ze gaat één keer uit, zonder kopie en zonder nieuwe pogingen. Stel het endpoint in met set_social_webhook_destination of met PUT /channels/:id/webhook op de Partner API.

Welke feed-wijzigingen starten reactieregels en automatiseringen?

Alleen nieuwe opmerkingen: een wijziging met item comment en verb add op een van de posts van de Pagina. Comment-naar-DM-regels controleren de message op hun trefwoorden en slaan opmerkingen over die de Pagina zelf maakte. Automatiseringen nemen de opmerkingen waar geen regel op antwoordde. Bewerkingen, verbergingen, reacties en posts gaan rechtstreeks naar je endpoint, als je er een hebt ingesteld.

Veelgemaakte fouten

  • Elke feed-wijziging als een nieuwe opmerking behandelen. Controleer item en verb: reacties, bewerkingen, verbergingen en verwijderingen komen op hetzelfde veld binnen.
  • Reageren op de eigen opmerkingen van de Pagina. Haar antwoorden komen ook als feed-wijzigingen binnen, dus sla over waarvan from.id het ID van de Pagina is.
  • Ervan uitgaan dat er één wijziging per levering is. Meta kan tot 1.000 updates bundelen, dus loop over elke entry en elke wijziging erin.
  • entry.time lezen als het moment van de wijziging. Meta zet die op het moment dat de melding werd verstuurd. created_time in de value is het moment waarop het object is aangemaakt.
Dit doen met EasyCoexistence

Regels voor comment-naar-DM en automatiseringen reageren op nieuwe opmerkingen. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Bevat de feed-webhook opmerkingen?

Ja. Een nieuwe opmerking komt binnen als feed-wijziging met item comment en verb add, met comment_id, post_id, from en message.

Krijg ik webhooks voor likes van Pagina's?

Alleen voor Pagina's met minder dan 10.000 likes, volgens de Pagina-webhookreferentie van Meta.

Zitten advertentieposts in de feed-webhook?

Niet de advertentieposts zelf, wel de opmerkingen erop.

Heb ik een eigen Meta-app nodig om feed-gebeurtenissen van een Pagina te krijgen?

Nee. Meta levert ze aan de app van easyCoexistence, die elke gebeurtenis doorstuurt naar het endpoint dat je voor die Pagina instelde.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op