Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Webhook de mention Facebook : quand quelqu'un mentionne votre Page

Le champ mention des webhooks de Page de Facebook avertit une application lorsqu'un utilisateur @mentionne la Page dans un post ou un commentaire. Meta envoie un change dont field vaut mention, et dont value peut contenir post_id, comment_id pour un commentaire, le texte de message, les liens et médias joints, ainsi que item et verb, dans un POST signé avec X-Hub-Signature-256.

easyCoexistence abonne chaque Page que vous connectez au champ mention, aux côtés de feed et messages, et transfère ses événements de mention vers votre endpoint HTTPS dès leur arrivée, signés avec un secret propre à cette Page et sans conserver de copie, afin que votre agent connaisse chaque mention au moment où elle se produit.

mention

Champ de webhook de Page pour les nouvelles mentions d'une Page, y compris les mentions dans les commentaires et les posts.

pages_manage_metadata

Permission qu'un administrateur de Page disposant des privilèges MODERATE doit accorder avant que les webhooks de Page n'atteignent l'URL de rappel d'une application.

@ + name

Comment les utilisateurs mentionnent une Page dans un post ou un commentaire : ils tapent @ suivi du nom de la Page, puis la sélectionnent.

36 hours

Durée pendant laquelle Meta réessaie une notification de Page échouée, à fréquence décroissante, avant de l'abandonner.

tagged_time

Champ que l'edge /{page-id}/tagged ajoute à chaque post public dans lequel la Page a été taguée.

Qu'est-ce qui déclenche le webhook de mention ?

Une personne qui mentionne la Page dans un post ou un commentaire. Sur Facebook, une mention se fait en tapant @ suivi du nom de la Page, puis en la choisissant dans les suggestions. La référence de Meta décrit le champ comme les nouvelles mentions d'une Page, y compris celles dans les commentaires et les posts. Le Centre d'aide de Facebook indique que les paramètres d'une Page peuvent empêcher les personnes de la mentionner.

À quoi ressemble une notification de mention ?

Un POST dont object vaut page, avec une entrée pour la Page mentionnée : son ID, une heure et un tableau changes dont field vaut mention. La référence de Meta liste les champs de value mais ne donne aucun exemple ; cet exemple de mention dans un post est donc construit à partir de cette liste :

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

Que signifie chaque champ d'une mention ?

Ce sont les champs de value dans la référence de Meta ; ceux qu'une notification contient dépendent du post ou du commentaire :

  • post_id : l'ID du post qui a mentionné la Page.
  • comment_id : l'ID du commentaire, lorsque la mention se trouve dans un commentaire ; parent_id : l'ID de son parent.
  • message : le texte qui porte la mention.
  • link, photo, photos et video : les liens vers ce que le post ou le commentaire a joint.
  • item et verb : le type d'objet et ce qui lui est arrivé, selon les mêmes listes que celles utilisées par le champ feed.
  • created_time : le moment où le post ou le commentaire a été créé.
  • from et message_tags : l'auteur et les profils identifiés dans le texte, tous deux marqués Workplace uniquement.
  • Également listés : action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id et open_graph_story_id.

Quelle permission le champ mention exige-t-il ?

pages_manage_metadata, que Meta impose à un administrateur de Page disposant des privilèges MODERATE d'accorder avant que les webhooks de Page n'atteignent une application. La Page s'abonne via POST /{page-id}/subscribed_apps avec mention parmi ses subscribed_fields, à l'aide d'un token de Page émis par une personne disposant de la tâche CREATE_CONTENT, MANAGE ou MODERATE, avec pages_manage_metadata et pages_show_list. L'application s'abonne aussi à mention, car seuls les champs souscrits aux deux niveaux sont livrés, et les Pages gérées par des personnes sans rôle sur l'application ont besoin de ces permissions en Advanced Access.

Comment lire le post ou le commentaire qui mentionne la Page ?

Par son ID, avec le token de la Page, lorsque Meta l'autorise. Un token de Page lit les posts publiés sur la Page ou par elle ; les posts partagés publiquement par d'autres Pages nécessitent pages_manage_posts et la fonctionnalité Page Public Content Access, avec un token d'administrateur de Page ; et Meta rattache la lecture du post d'une personne à sa propre permission user_posts.

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>

Où d'autre une Page peut-elle retrouver ses mentions ?

Sur l'edge tagged. GET /{page-id}/tagged liste les posts publics dans lesquels la Page a été taguée, chacun avec un tagged_time, ce qui couvre aussi les posts antérieurs à la mise en place du webhook. Il exige un token de Page émis par une personne disposant de la tâche CREATE_CONTENT, MANAGE ou MODERATE, avec pages_read_user_content et pages_show_list, et Meta indique que la fonctionnalité Page Public Content Access peut être requise. Pour un post de personne, Meta ne renvoie from qu'à la personne qui l'a écrit.

Comment easyCoexistence transmet-il les événements de mention ?

Il abonne chaque Page à mention, aux côtés de feed et messages, lorsque la Page se connecte. Son application vérifie X-Hub-Signature-256 sur chaque livraison, répond immédiatement à Meta et POSTe chaque entrée de la Page, sans modification, vers l'endpoint HTTPS que vous définissez avec set_social_webhook_destination ou PUT /channels/:id/webhook sur la Partner API :

  • X-EC-Signature contient t=<unix>,v1=<hex> : le HMAC-SHA256 de l'horodatage, d'un point et du corps brut, avec pour clé le secret de signature de la Page.
  • Le secret commence par whsec_ et n'est affiché qu'une fois ; définir de nouveau l'URL en émet un nouveau, et une URL nulle arrête le transfert.
  • Chaque entrée part une seule fois, avec un délai d'attente de 8 secondes, vers une adresse HTTPS qui résout une IP publique, sans suivre de redirection ni conserver de copie.
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>"
        }
      }
    ]
  }
}

Erreurs courantes

  • Lire entry.time comme le moment de la mention. Meta le fixe à l'envoi de la notification ; created_time dans value date le post ou le commentaire.
  • Traiter une recherche qui échoue comme un événement défectueux. Meta prévient que certaines valeurs post_id et comment_id des notifications de mention ne peuvent pas être interrogées, faute de permission ou pour des raisons de confidentialité ; conservez donc le texte du message issu de l'événement lui-même.
  • Récupérer le post avant de répondre au transfert. Les transferts ne sont pas réessayés ; renvoyez donc un 2xx immédiatement et recherchez le post ensuite.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Le webhook de mention indique-t-il qui a mentionné la Page ?

Pas pour une Page : la référence de Meta marque from comme Workplace uniquement. Rechercher le post ou le commentaire par son ID peut renvoyer son auteur, lorsque les permissions de Meta le permettent.

Puis-je recevoir des mentions antérieures à l'abonnement de la Page ?

Pas via le webhook, car Meta ne conserve aucun historique de notifications à interroger. L'edge tagged liste les posts publics dans lesquels la Page a été taguée.

En quoi le champ mention diffère-t-il de feed ?

feed signale les changements sur le fil propre de la Page, comme les posts, commentaires et réactions qui s'y trouvent ; mention signale que la Page est @mentionnée dans un post ou un commentaire. Chaque champ s'abonne séparément.

Les règles de commentaires d'easyCoexistence agissent-elles sur les mentions ?

Non. Les règles et automatisations agissent sur les commentaires du champ feed et sur les messages Messenger ; les changements mention sont transférés à votre endpoint tels que Meta les a envoyés.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le