AccediInizia la prova gratuita
easyCoexistence API ufficiali

Webhook delle menzioni su Facebook: quando qualcuno menziona la tua Pagina

Il campo mention dei webhook delle Pagine di Facebook avvisa un'app quando qualcuno menziona la Pagina in un post o in un commento. Meta invia un elemento changes con field impostato su mention, il cui value può contenere post_id, comment_id per un commento, il testo in message, link e media allegati, item e verb, in una POST firmata con X-Hub-Signature-256.

easyCoexistence iscrive ogni Pagina che colleghi al campo mention, accanto a feed e messages, e inoltra i suoi eventi di menzione al tuo endpoint HTTPS man mano che arrivano, firmati con un segreto per quella Pagina e senza conservare alcuna copia, così il tuo agente viene a sapere di ogni menzione nel momento in cui avviene.

mention

Campo del webhook di Pagina per le nuove menzioni di una Pagina, incluse quelle nei commenti e nei post.

pages_manage_metadata

Permesso che un amministratore della Pagina con privilegi MODERATE deve concedere prima che i webhook di Pagina raggiungano l'URL di callback di un'app.

@ + name

Come le persone menzionano una Pagina in un post o in un commento: digitano @ e il nome della Pagina, poi la selezionano.

36 hours

Per quanto tempo Meta riprova una notifica di Pagina non riuscita, con frequenza decrescente, prima di scartarla.

tagged_time

Campo che l'edge /{page-id}/tagged aggiunge a ogni post pubblico in cui la Pagina è stata taggata.

Cosa attiva il webhook delle menzioni?

Qualcuno che menziona la Pagina in un post o in un commento. Su Facebook una menzione si fa digitando @ e il nome della Pagina e selezionandola dai suggerimenti, e il riferimento di Meta descrive il campo come nuove menzioni di una Pagina, incluse quelle nei commenti e nei post. Il Centro assistenza di Facebook segnala che le impostazioni di una Pagina possono impedire alle persone di menzionarla.

Come appare una notifica di menzione?

Una POST con object impostato su page e una voce per la Pagina menzionata: il suo ID, un time e un array changes il cui field è mention. Il riferimento di Meta elenca i campi del value ma non fornisce un esempio, quindi questa menzione in un post è costruita a partire da quell'elenco:

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

Cosa significa ogni campo di una menzione?

Sono i campi del value nel riferimento di Meta; quali ne contenga una notifica dipende dal post o dal commento:

  • post_id: l'ID del post che ha menzionato la Pagina.
  • comment_id: l'ID del commento, quando la menzione è in un commento; parent_id: l'ID del suo genitore.
  • message: il testo che contiene la menzione.
  • link, photo, photos e video: link a ciò che il post o il commento ha allegato.
  • item e verb: il tipo di oggetto e cosa gli è successo, dalle stesse liste usate dal campo feed.
  • created_time: quando il post o il commento è stato creato.
  • from e message_tags: l'autore e i profili taggati nel testo, entrambi marcati come Workplace only.
  • Elencati anche: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id e open_graph_story_id.

Quale permesso serve al campo mention?

pages_manage_metadata, che Meta richiede che un amministratore della Pagina con privilegi MODERATE conceda prima che i webhook di Pagina raggiungano un'app. La Pagina si iscrive tramite POST /{page-id}/subscribed_apps con mention tra i subscribed_fields, usando un token di Pagina di qualcuno con il task CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata e pages_show_list. L'app si iscrive anche a mention, perché vengono consegnati solo i campi iscritti a entrambi i livelli, e le Pagine gestite da persone senza un ruolo sull'app richiedono quei permessi in Advanced Access.

Come si legge il post o il commento che menziona la Pagina?

Tramite il suo ID, con il token della Pagina, dove Meta lo consente. Un token di Pagina legge i post pubblicati sulla o dalla Pagina; i post condivisi pubblicamente da altre Pagine richiedono pages_manage_posts e la funzionalità Page Public Content Access, con un token di un amministratore della Pagina; e Meta lega la lettura del post di una persona al permesso user_posts di quella persona.

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>

Dove altro una Pagina può trovare le sue menzioni?

Nell'edge tagged. GET /{page-id}/tagged elenca i post pubblici in cui la Pagina è stata taggata, ciascuno con un tagged_time, che copre anche i post precedenti all'attivazione del webhook. Richiede un token di Pagina di qualcuno con il task CREATE_CONTENT, MANAGE o MODERATE, con pages_read_user_content e pages_show_list, e Meta dice che può essere richiesta la funzionalità Page Public Content Access. Su un post di una persona, Meta restituisce from solo a chi lo ha scritto.

Come easyCoexistence consegna gli eventi di menzione?

Iscrive ogni Pagina a mention, accanto a feed e messages, quando la Pagina si connette. La sua app verifica X-Hub-Signature-256 su ogni consegna, risponde subito a Meta e invia con POST ogni voce della Pagina, invariata, all'endpoint HTTPS che imposti con set_social_webhook_destination o PUT /channels/:id/webhook nella Partner API:

  • X-EC-Signature contiene t=<unix>,v1=<hex>: l'HMAC-SHA256 del timestamp, un punto e il corpo grezzo, con chiave il segreto di firma della Pagina.
  • Il segreto inizia con whsec_ e viene mostrato una sola volta; reimpostare l'URL ne emette uno nuovo, e un URL null interrompe l'inoltro.
  • Ogni voce parte una sola volta, con attesa fino a 8 secondi, verso un indirizzo HTTPS che risolve in un IP pubblico, senza seguire reindirizzamenti e senza conservare alcuna copia.
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>"
        }
      }
    ]
  }
}

Errori comuni

  • Leggere entry.time come il momento della menzione. Meta lo imposta al momento in cui la notifica è stata inviata; created_time nel value data il post o il commento.
  • Trattare come evento rotto una ricerca che fallisce. Meta avvisa che alcuni valori di post_id e comment_id nelle notifiche di menzione non possono essere interrogati, per mancanza di permesso o per privacy, quindi conserva il testo del messaggio dall'evento stesso.
  • Recuperare il post prima di rispondere all'inoltro. Gli inoltri non vengono ritentati, quindi restituisci subito un 2xx e cerca il post dopo.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0.75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

Il webhook di menzione dice chi ha menzionato la Pagina?

No, per una Pagina: il riferimento di Meta marca from solo come Workplace only. Cercare il post o il commento tramite il suo ID può restituire il suo autore, dove i permessi di Meta lo consentono.

Posso ottenere menzioni precedenti all'iscrizione della Pagina?

Non dal webhook, perché Meta non conserva una cronologia delle notifiche da interrogare. L'edge tagged elenca i post pubblici in cui la Pagina è stata taggata.

In cosa il campo mention è diverso da feed?

feed segnala modifiche sul feed della Pagina stessa, come post, commenti e reazioni lì; mention segnala che la Pagina viene menzionata in un post o in un commento. Ogni campo si iscrive separatamente.

Le regole sui commenti di easyCoexistence agiscono sulle menzioni?

No. Regole e automazioni agiscono sui commenti dal campo feed e sui messaggi di Messenger; le modifiche di mention vengono inoltrate al tuo endpoint esattamente come le ha inviate Meta.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il