Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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.

64

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.

pages_manage_metadata

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.

message_echoes

Un campo de Messenger aparte para los mensajes que envía la Página, disponible solo en conversaciones de Messenger.

ADVERTISE

Tarea de Página necesaria para suscribirse a leadgen, con leads_retrieval, ads_management, pages_read_engagement y pages_manage_metadata.

Both levels

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:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

¿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:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

¿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_update y call_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_integrity y messaging_integrity: actualizaciones de integridad, con eventos de infracciones, restricciones y acciones en business_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 y public_transit.
  • Establecimiento: price_range, payment_options, attire y culinary_team.
  • Personal: birthday, personal_info y personal_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:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

¿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.
Hacerlo con EasyCoexistence

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