InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Facebook mention-webhook: wanneer iemand je pagina vermeldt

Het mention-veld van de webhooks van Facebook-pagina's stuurt een app een melding zodra iemand de pagina in een post of reactie vermeldt. Meta stuurt een change met field gelijk aan mention, waarvan de value de post_id kan bevatten, de comment_id bij een reactie, de tekst in message, bijgevoegde link en media, en item en verb, in een POST die is ondertekend met X-Hub-Signature-256.

easyCoexistence abonneert elke pagina die je verbindt op het mention-veld, naast feed en messages, en stuurt de vermeldingsevents door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met een geheim voor die pagina en zonder kopie te bewaren, zodat je agent van elke vermelding weet op het moment dat die gebeurt.

mention

Webhookveld van pagina's voor nieuwe vermeldingen van een pagina, inclusief vermeldingen in reacties en posts.

pages_manage_metadata

Recht dat een pagina-beheerder met MODERATE-rechten moet toekennen voordat pagina-webhooks de callback-URL van een app bereiken.

@ + name

Hoe mensen een pagina vermelden in een post of reactie: typ @ en de naam van de pagina en kies die.

36 hours

Hoe lang Meta een mislukte pagina-melding opnieuw probeert, met steeds minder frequentie, voordat die wordt weggegooid.

tagged_time

Veld dat de /{page-id}/tagged-edge toevoegt aan elke openbare post waarin de pagina is getagd.

Wat zet de mention-webhook in gang?

Iemand die de pagina vermeldt in een post of reactie. Op Facebook maak je een vermelding door @ te typen, de naam van de pagina te typen en die uit de suggesties te kiezen. Meta's referentie beschrijft het veld als nieuwe vermeldingen van een pagina, inclusief vermeldingen in reacties en posts. Het Helpcentrum van Facebook merkt op dat instellingen van een pagina kunnen voorkomen dat mensen haar vermelden.

Hoe ziet een vermeldingsmelding eruit?

Een POST met object gelijk aan page en één entry voor de vermelde pagina: haar ID, een time en een array changes waarvan het veld field mention is. Meta's referentie somt de velden van de value op maar geeft geen voorbeeld, dus deze vermelding in een post is gevormd op basis van die lijst:

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

Wat betekent elk veld van een vermelding?

Dit zijn de velden van de value in Meta's referentie; welke een melding meestuurt, hangt af van de post of reactie:

  • post_id: het ID van de post die de pagina vermeldde.
  • comment_id: het ID van de reactie, wanneer de vermelding in een reactie staat; parent_id: het ID van de bovenliggende reactie.
  • message: de tekst met de vermelding.
  • link, photo, photos en video: links naar wat de post of reactie heeft bijgevoegd.
  • item en verb: het soort object en wat ermee gebeurde, uit dezelfde lijsten die het feed-veld gebruikt.
  • created_time: wanneer de post of reactie is aangemaakt.
  • from en message_tags: de auteur en de profielen die in de tekst zijn getagd, beide gemarkeerd als Workplace only.
  • Ook vermeld: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id en open_graph_story_id.

Welk recht heeft het mention-veld nodig?

pages_manage_metadata, dat Meta vereist dat een pagina-beheerder met MODERATE-rechten toekent voordat pagina-webhooks een app bereiken. De pagina wordt geabonneerd via POST /{page-id}/subscribed_apps met mention onder subscribed_fields, met een pagina-token van iemand met de taak CREATE_CONTENT, MANAGE of MODERATE, met pages_manage_metadata en pages_show_list. De app abonneert zich ook op mention, want alleen velden die op beide niveaus zijn geabonneerd worden geleverd, en pagina's die worden beheerd door mensen zonder rol in de app hebben die rechten nodig in Advanced Access.

Hoe lees je de post of reactie die de pagina vermeldt?

Op ID, met het pagina-token, waar Meta dat toestaat. Een pagina-token leest posts die naar of door de pagina zijn geplaatst; publiek gedeelde posts van andere pagina's hebben pages_manage_posts en de feature Page Public Content Access nodig, op een token van een pagina-beheerder; en Meta koppelt het lezen van de eigen post van iemand aan het user_posts-recht van die persoon.

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>

Waar anders kan een pagina haar vermeldingen vinden?

Op de tagged-edge. GET /{page-id}/tagged somt de openbare posts op waarin de pagina is getagd, elk met een tagged_time, wat ook posts van vóór het instellen van de webhook dekt. Het vereist een pagina-token van iemand met de taak CREATE_CONTENT, MANAGE of MODERATE, met pages_read_user_content en pages_show_list, en Meta zegt dat de feature Page Public Content Access nodig kan zijn. Bij de post van een persoon geeft Meta from alleen terug aan de persoon die die schreef.

Hoe levert easyCoexistence vermeldingsevents af?

Het abonneert elke pagina op mention, naast feed en messages, zodra de pagina verbindt. De app controleert X-Hub-Signature-256 bij elke aflevering, antwoordt Meta meteen en POST elke entry voor de pagina, ongewijzigd, naar het HTTPS-endpoint dat je instelt met set_social_webhook_destination of PUT /channels/:id/webhook op de Partner API:

  • X-EC-Signature bevat t=<unix>,v1=<hex>: de HMAC-SHA256 van de tijdstempel, een punt en de ruwe body, ondertekend met het ondertekeningsgeheim van de pagina.
  • Het geheim begint met whsec_ en wordt één keer getoond; de URL opnieuw instellen geeft een nieuw geheim uit, en een null-URL stopt het doorsturen.
  • Elke entry gaat één keer uit, met een wachttijd van maximaal 8 seconden, naar een HTTPS-adres dat naar een publiek IP-adres verwijst, zonder redirects te volgen en zonder kopie te bewaren.
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>"
        }
      }
    ]
  }
}

Veelgemaakte fouten

  • entry.time lezen als het moment van de vermelding. Meta zet het op het moment dat de melding werd verstuurd; created_time in de value dateert de post of reactie.
  • Een mislukte opzoeking zien als een kapotte gebeurtenis. Meta waarschuwt dat sommige post_id- en comment_id-waarden in vermeldingsmeldingen niet kunnen worden opgevraagd, door gebrek aan recht of vanwege privacy, dus bewaar de berichttekst uit de gebeurtenis zelf.
  • De post ophalen voordat je het doorsturen beantwoordt. Doorgestuurde meldingen worden niet opnieuw geprobeerd, dus geef meteen een 2xx terug en zoek de post daarna op.
Dit doen met EasyCoexistence

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

Vertelt de mention-webhook wie de pagina heeft vermeld?

Niet voor een pagina: Meta's referentie markeert from als alleen Workplace. De post of reactie opzoeken op haar ID kan de auteur teruggeven, waar de rechten van Meta dat toestaan.

Kan ik vermeldingen krijgen van vóór de abonnering van de pagina?

Niet via de webhook, omdat Meta geen meldingsgeschiedenis bewaart om in te zoeken. De tagged-edge somt de openbare posts op waarin de pagina is getagd.

Hoe verschilt het mention-veld van feed?

feed meldt wijzigingen op de eigen feed van de pagina, zoals posts, reacties en emoji-reacties daarop; mention meldt dat de pagina in een post of reactie wordt vermeld. Elk veld wordt apart geabonneerd.

Doen de reactieregels van easyCoexistence iets met vermeldingen?

Nee. Regels en automatiseringen werken op reacties uit het feed-veld en op Messenger-berichten; wijzigingen van mention worden precies zo doorgestuurd naar je endpoint als Meta ze stuurde.

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