Webhook du feed de Page Facebook : commentaires, publications et réactions
Le champ feed des webhooks de Page Facebook signale presque toutes les modifications du feed d'une Page, au moment où elles surviennent. Chaque modification contient un item, comme post, comment ou reaction, et un verb, comme add, edit ou remove, ainsi que les identifiants concernés, l'auteur dans from et le texte dans message. Meta l'envoie en JSON, signé avec X-Hub-Signature-256.
easyCoexistence abonne chaque Page que vous connectez au champ feed et transmet ses modifications à votre endpoint HTTPS dès leur arrivée, signées avec le secret de cette Page, tandis que les règles de commentaire vers DM et les automatisations agissent sur les nouveaux commentaires.
Les notifications du feed pour les likes d'une Page ne sont envoyées que pour les Pages ayant moins de likes que ce seuil.
Le champ feed n'envoie rien pour les publications sponsorisées elles-mêmes, mais transmet les commentaires qui leur sont adressés.
Permission qu'un administrateur de la Page disposant des droits MODERATE doit accorder pour que les webhooks de Page atteignent une application.
La plupart des mises à jour sont regroupées par Meta dans une seule livraison de webhook, sans que ce regroupement soit garanti.
Pendant combien de temps Meta retente une livraison échouée vers l'endpoint de l'application, à fréquence décroissante.
Que signale le champ feed ?
Presque toutes les modifications du feed d'une Page, selon les termes de Meta : publications, commentaires, réactions et partages. Ce qu'une modification contient dépend de son type. Meta n'envoie rien pour les publications sponsorisées elles-mêmes, mais transmet les commentaires qui s'y rapportent, et n'envoie des notifications pour les likes d'une Page que tant qu'elle compte moins de 10 000 likes.
Que signifient item et verb ?
Deux champs de la valeur de chaque modification indiquent ce qui s'est passé :
- item : ce qui a changé, selon la liste de Meta, qui comprend post, status, photo, video, link, share, comment, reaction et album.
- verb : ce qui est arrivé, parmi add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute ou update.
- Un nouveau commentaire arrive avec item comment et verb add, ce que recherchent les règles de commentaire vers DM.
- Une réaction comporte l'item reaction et un
reaction_typequi la désigne.
À quoi ressemble une modification du feed ?
Un POST dont le JSON a object défini sur page, avec une entrée par Page contenant l'ID de la Page, une heure et un tableau de changes. Voici l'exemple de Meta lui-même, une personne publiant sur la Page :
{
"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>"
}
}
]
}
]
}Quels champs une modification peut-elle porter ?
Le référentiel de Meta énumère ces champs parmi ceux de la valeur d'une modification du feed, présents selon le type de modification :
post_id,comment_idetparent_id: la publication, le commentaire et ce à quoi il se rattache.- from : l'ID et le nom de l'auteur de la modification.
- message : le texte, avec link, photo, photos ou video pour les contenus joints.
created_time, etedited_timepour les modifications.reaction_typepour les réactions, etis_hiddenpour indiquer si une publication est masquée.- post : des détails tels que
status_type,is_published,updated_timeetpermalink_url.
Comment une Page est-elle abonnée ?
L'application envoie POST /{page-id}/subscribed_apps avec subscribed_fields=feed et le token de la Page, depuis une personne pouvant exécuter la tâche CREATE_CONTENT, MANAGE ou MODERATE, avec les permissions pages_manage_metadata et pages_show_list accordées. Meta n'envoie des notifications que tant que l'application est installée sur la Page et que la plateforme d'applications n'a pas été désactivée dans ses paramètres. easyCoexistence abonne chaque Page à feed, messages et mention lors de sa connexion.
Comment les événements du feed atteignent-ils votre endpoint ?
Meta les livre à l'application d'easyCoexistence, qui vérifie X-Hub-Signature-256, répond immédiatement à Meta et transmet chaque entrée concernant une Page connectée à l'endpoint HTTPS que vous lui avez défini. La transmission porte un en-tête X-EC-Signature, un HMAC-SHA256 d'un horodatage et du corps brut, signé avec le secret propre à cette Page, et part une seule fois, sans copie conservée ni nouvelle tentative. Définissez l'endpoint avec set_social_webhook_destination ou avec PUT /channels/:id/webhook sur l'API Partner.
Quelles modifications du feed lancent les règles de commentaire et les automatisations ?
Seuls les nouveaux commentaires : une modification avec item comment et verb add sur une publication de la Page. Les règles de commentaire vers DM vérifient son message selon leurs mots-clés et ignorent les commentaires que la Page a rédigés elle-même, tandis que les automatisations reprennent les commentaires auxquels aucune règle n'a répondu. Les modifications, masquages, réactions et publications vont directement à votre endpoint, si vous en avez défini un.
Erreurs courantes
- Considérer toute modification du feed comme un nouveau commentaire. Vérifiez item et verb : les réactions, modifications, masquages et suppressions arrivent sur le même champ.
- Répondre aux commentaires de la Page elle-même. Ses réponses reviennent aussi comme modifications du feed ; ignorez celles dont from.id est l'ID de la Page.
- Supposer une seule modification par livraison. Meta peut regrouper jusqu'à 1 000 mises à jour ; parcourez donc chaque entrée et chaque modification qu'elle contient.
- Lire entry.time comme le moment de la modification. Meta y inscrit l'heure d'envoi de la notification ; created_time dans la valeur est la date de création de l'objet.
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 du feed inclut-il les commentaires ?
Oui. Un nouveau commentaire arrive comme modification du feed avec item comment et verb add, portant comment_id, post_id, from et message.
Reçoit-on des webhooks pour les likes d'une Page ?
Uniquement pour les Pages comptant moins de 10 000 likes, selon la référence des webhooks de Page de Meta.
Les publications sponsorisées sont-elles dans le webhook du feed ?
Pas les publications sponsorisées elles-mêmes, mais les commentaires qui s'y rapportent sont transmis.
Ai-je besoin de ma propre application Meta pour recevoir les événements du feed d'une Page ?
Non. Meta les livre à l'application d'easyCoexistence, qui transmet chacun à l'endpoint que vous avez défini pour cette Page.
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