Campos de webhook de Página de Facebook: la lista completa
La referencia de webhooks de Página de Meta documenta 64 campos de suscripción: feed para publicaciones, comentarios y reacciones, mention para menciones de la Página, campos de Messenger como messages, message_echoes, messaging_postbacks y message_reads, y campos de perfil como name, picture, hours y website. Cada uno necesita pages_manage_metadata, y una app recibe un campo una vez que está suscrita tanto a nivel de app como por la Página mediante subscribed_apps.
easyCoexistence suscribe cada Página que conectas a feed, messages y mention y reenvía esos eventos a tu endpoint HTTPS en cuanto llegan, firmados con X-EC-Signature, mientras que las reglas de comentarios y las automatizaciones actúan sobre los comentarios nuevos y los mensajes.
Campos de suscripción documentados en la referencia de webhooks de Página de Meta, desde feed y mention hasta los campos de Messenger y de perfil.
Permiso que un administrador de la Página con privilegios MODERATE debe conceder antes de que los webhooks de Página lleguen a una app.
Un campo de Messenger aparte para los mensajes que envía la Página, disponible solo en conversaciones de Messenger.
Tarea de Página necesaria para suscribirse a leadgen, con leads_retrieval, ads_management, pages_read_engagement y pages_manage_metadata.
Solo los campos suscritos tanto a nivel de Página como de app producen webhooks.
¿Cómo se organizan los campos de webhook de Página?
Meta los documenta en una sola referencia para el objeto Página, y se agrupan en tres familias: actividad en la Página y alrededor de ella, conversaciones de Messenger y ediciones de los propios datos de la Página. Los cambios de feed, mention y perfil llegan en entry.changes, cada uno con su campo, o como changed_fields cuando la app desactivó Include Values; los eventos de Messenger llegan en entry.messaging, o en entry.standby para una app que no es dueña del hilo.
¿Qué campos informan de la actividad en la Página?
Doce campos cubren contenido y actividad, no conversaciones. Un comentario nuevo, por ejemplo, llega por feed como un cambio con item en comment y verb en add, junto con reacciones, compartidos y las publicaciones de la propia Página. Lo que entrega cada uno, según la referencia de Meta:
¿Qué campos transportan eventos de Messenger?
Messenger tiene la lista más larga, y la guía de webhooks de Messenger de Meta explica qué envía cada campo. Estos trece cubren las conversaciones de una Página; standby, que transporta mensajes a una app que no es dueña del hilo, está documentado en esa guía y no en la referencia de Página:
¿Qué otros campos de Messenger existen?
Diez más sirven a productos concretos, desde llamadas hasta comercio e informes de integridad:
send_cart: un mensaje que lleva información de carrito o pedido;message_context: detecciones que hacen los modelos de Meta sobre un mensaje, con un nombre de evento y una puntuación.- calls,
call_settings_updateycall_permission_reply: llamadas de voz de Messenger, cambios en la configuración de llamadas de la Página y la respuesta de una persona a una solicitud de permiso para llamar. messaging_customer_information: lo que una persona introdujo en una pantalla de información del cliente;messaging_in_thread_lead_form_submit: un formulario de cliente potencial enviado dentro de la conversación.message_template_status_update: cambió el estado de revisión de una plantilla de mensaje de utilidad.business_integrityymessaging_integrity: actualizaciones de integridad, con eventos de infracciones, restricciones y acciones enbusiness_integrity.
¿Qué campos informan de cambios en el perfil de la Página?
Veintinueve campos informan de ediciones de los datos propios de la Página, uno por dato, y cada uno llega como un cambio que lo nombra:
- Identidad: name, picture, category, que admite hasta tres categorías, y description, la Story Description.
- Datos de negocio:
company_overview, mission, founded, products,general_info,general_manager, members, awards y affiliation. - Contacto y lugar: email, phone, website, location, hours,
current_location, hometown, parking ypublic_transit. - Establecimiento:
price_range,payment_options, attire yculinary_team. - Personal: birthday,
personal_infoypersonal_interests.
¿Qué permiso necesita cada campo?
pages_manage_metadata para cualquiera de ellos, concedido por un administrador de la Página con privilegios MODERATE, y más para algunos. La Página se suscribe mediante subscribed_apps, y las guías de Meta fijan el token y los permisos por tipo de campo; para recibir eventos sobre personas fuera de los roles de la propia app, los permisos también necesitan Advanced Access:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
¿A qué campos se suscribe easyCoexistence?
A tres: feed, messages y mention. Cuando una Página se conecta, easyCoexistence envía POST /{page-id}/subscribed_apps con esos campos y el token de la Página, y luego reenvía cada entrada de esa Página al endpoint que configuras, firmada con X-EC-Signature. Las reglas de comentarios y las automatizaciones actúan sobre los comentarios nuevos de feed y sobre los mensajes, y las menciones se reenvían tal cual. No se suscribe ningún otro campo, así que los ecos, postbacks, recibos, traspasos, standby y los cambios de perfil no se reenvían.
Errores comunes
- Suscribir la Página a un campo que la app no ha suscrito. Meta entrega solo los campos suscritos tanto a nivel de Página como de app.
- Leer eventos de Messenger como cambios. Llegan en entry.messaging, con un objeto de mensaje por entrada, no en entry.changes.
- Esperar las respuestas propias de la Página en los mensajes. Los mensajes que envía la Página llegan por message_echoes, un campo aparte.
- Contar con feed para los me gusta de una Página grande. Meta envía notificaciones de me gusta solo para Páginas con menos de 10.000 me gusta.
De US$ 9 a US$ 0.75 por número conectado al mes, bajando a medida que añades números conectados, con los primeros 3 días gratis.
Preguntas frecuentes
¿El campo feed incluye los comentarios de los anuncios?
Sí. Meta no envía nada por las propias publicaciones de anuncios, pero los comentarios en ellas llegan por feed.
¿Qué cambia el ajuste Include Values?
Con él activado, un cambio trae los nuevos valores en changes. Con él desactivado, Meta envía solo los nombres de los campos modificados, en changed_fields.
¿Cómo veo a qué campos está suscrita una Página?
GET /{page-id}/subscribed_apps con el token de la Página enumera las apps instaladas por la Página y, para cada una, sus subscribed_fields.
¿easyCoexistence reenvía los cambios de perfil de la Página?
No. Las Páginas conectadas a easyCoexistence están suscritas solo a feed, messages y mention, así que name, picture y los demás campos de perfil no se reenvían.
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