Webhook del feed de la Página de Facebook: eventos de comentarios, publicaciones y reacciones
El campo feed de los webhooks de Página de Facebook informa casi todos los cambios en el feed de una Página en cuanto ocurren. Cada cambio trae un item, como post, comment o reaction, y un verb, como add, edit o remove, además de los IDs implicados, el autor en from y el texto en message. Meta lo envía como JSON, firmado con X-Hub-Signature-256.
easyCoexistence suscribe cada Página que conectes al campo feed y reenvía sus cambios a tu endpoint HTTPS en cuanto llegan, firmados con el secreto de esa Página, mientras las reglas de comentario a DM y las automatizaciones actúan sobre los comentarios nuevos.
Las notificaciones del feed por me gusta de Página solo se envían para Páginas con menos me gusta que este.
El campo feed no envía nada por los posts de anuncios en sí, pero sí envía los comentarios que reciben.
Permiso que un administrador de la Página con privilegios MODERATE debe conceder para que los webhooks de Página lleguen a una app.
Meta agrupa la mayoría de las actualizaciones en una sola entrega del webhook, aunque no garantiza el agrupamiento.
Durante cuánto tiempo Meta reintenta una entrega fallida al endpoint de la app, con frecuencia decreciente.
¿Qué informa el campo feed?
Casi todos los cambios en el feed de una Página, en palabras de Meta, como publicaciones, comentarios, reacciones y compartidos; lo que trae cada cambio depende de su tipo. Meta no envía nada por los posts de anuncios en sí, aunque sí llegan los comentarios en ellos, y envía notificaciones de me gusta de Página solo mientras una Página tenga menos de 10,000 me gusta.
¿Qué significan item y verb?
Dos campos del valor de cada cambio indican qué ocurrió:
- item: qué cambió, según la lista de Meta, que incluye post, status, photo, video, link, share, comment, reaction y album.
- verb: qué le pasó: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute o update.
- Un comentario nuevo llega con item comment y verb add, que es lo que buscan las reglas de comentario a DM.
- Una reacción trae item reaction y un
reaction_typeque la identifica.
¿Cómo es un cambio del feed?
Un POST cuyo JSON tiene object con el valor page y una entrada por Página, con el ID de la Página, una hora y un array de changes. Este es el ejemplo propio de Meta: una persona publicando en la Página:
{
"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>"
}
}
]
}
]
}¿Qué campos puede traer un cambio?
La referencia de Meta enumera estos campos del valor de un cambio del feed, presentes según el tipo de cambio:
post_id,comment_idyparent_id: la publicación, el comentario y aquello al que pertenece.- from: el ID y el nombre de quien hizo el cambio.
- message: el texto, con link, photo, photos o video para el contenido adjunto.
created_time, yedited_timepara las ediciones.reaction_typepara las reacciones, eis_hiddenpara indicar si una publicación está oculta.- post: detalles como
status_type,is_published,updated_timeypermalink_url.
¿Cómo se suscribe una Página?
La app envía POST /{page-id}/subscribed_apps con subscribed_fields=feed y el token de la Página, desde alguien que puede realizar la tarea CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata y pages_show_list concedidos. Meta envía notificaciones solo mientras la Página tenga la app instalada y no haya desactivado la plataforma de apps en su configuración. easyCoexistence suscribe cada Página a feed, messages y mention al conectarse.
¿Cómo llegan los eventos del feed a tu endpoint?
Meta los entrega a la app de easyCoexistence, que comprueba X-Hub-Signature-256, responde a Meta de inmediato y reenvía cada entrada de una Página conectada al endpoint HTTPS que configuraste para ella. El reenvío lleva un encabezado X-EC-Signature, un HMAC-SHA256 de una marca de tiempo y del cuerpo sin procesar, firmado con el secreto de esa Página, y sale una sola vez, sin copia guardada y sin reintentos. Configura el endpoint con set_social_webhook_destination o con PUT /channels/:id/webhook en la Partner API.
¿Qué cambios del feed activan reglas de comentarios y automatizaciones?
Solo los comentarios nuevos: un cambio con item comment y verb add en una de las publicaciones de la Página. Las reglas de comentario a DM revisan su message en busca de sus palabras clave y omiten los comentarios que la propia Página hizo, y las automatizaciones toman los comentarios a los que ninguna regla respondió. Las ediciones, ocultaciones, reacciones y publicaciones van directo a tu endpoint, si configuraste uno.
Errores comunes
- Tratar cualquier cambio del feed como un comentario nuevo. Revisa item y verb: reacciones, ediciones, ocultaciones y eliminaciones llegan por el mismo campo.
- Responder a los comentarios de la propia Página. Sus respuestas también llegan como cambios del feed, así que omite los que tengan from.id igual al ID de la Página.
- Suponer un cambio por entrega. Meta puede agrupar hasta 1,000 actualizaciones, así que recorre cada entry y cada change dentro de ella.
- Leer entry.time como el momento del cambio. Meta lo fija al momento en que se envió la notificación; created_time en el valor es cuando se creó el objeto.
De US$ 9 a US$ 0.75 por conexión al mes, bajando al sumar conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿El webhook del feed incluye comentarios?
Sí. Un comentario nuevo llega como cambio del feed con item comment y verb add, con comment_id, post_id, from y message.
¿Recibo webhooks de me gusta de Página?
Solo para Páginas con menos de 10,000 me gusta, según la referencia de webhooks de Página de Meta.
¿Los posts de anuncios están en el webhook del feed?
No los posts de anuncios en sí, pero sí se envían los comentarios en ellos.
¿Necesito mi propia app de Meta para recibir los eventos del feed de una Página?
No. Meta los entrega a la app de easyCoexistence, que reenvía cada uno al endpoint que configuraste para esa Página.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el