Metrics data affected for April 1-4, 2026

From April 1 to April 4, 2026, some metrics may be inaccurate due to a temporary reporting issue. The issue has been resolved, but data for this period may not fully reflect actual performance.

La API de páginas de Facebook permite a las apps administrar páginas de Facebook y acceder a las características relacionadas con los permisos necesarios. Esta API admite varias tareas de administración de páginas, como la publicación de contenido, la lectura de estadísticas, la moderación de comentarios y la recepción de actualizaciones en tiempo real.

Componentes clave:

Tokens de acceso: tokens autenticados con los permisos necesarios
Puntos de conexión: para realizar operaciones (publicar, obtener, actualizar, eliminar)
Webhooks: para recibir actualizaciones en tiempo real

Autenticación y tokens de acceso

Para interactuar con la API de páginas, se necesita un token de acceso a la página. Este token se obtiene a través de la autenticación de usuario y otorga permisos para realizar acciones de API como la página.

Generación de un token de acceso a la página

La app solicita los permisos necesarios al usuario.
El usuario autoriza la app.
La app intercambia el código de autorización para obtener un token de acceso de usuario.
La app utiliza el token para solicitar un token de acceso a la página.

Permisos y funciones

Los diferentes puntos de conexión requieren diferentes permisos:

pages_show_list: mostrar páginas administradas por un usuario
pages_read_engagement: leer contenido publicado en la página
pages_manage_posts: publicar y programar contenido
pages_manage_engagement: moderar comentarios, eliminar publicaciones
pages_read_user_content: leer contenido generado por usuarios en la página
pages_manage_metadata: administrar la configuración de la página
pages_manage_ads: crear y administrar anuncios para la página
pages_manage_cta: ver y actualizar los botones de llamada a la acción
pages_messaging: administrar y enviar mensajes en nombre de la página
business_management: administrar activos comerciales relacionados con la página

Puntos de conexión de la API

Información de la página

Recuperar información básica sobre una página.

Solicitud:

GET /<PAGE_ID>?fields=id,name,about,fan_count

Permisos:pages_show_list, pages_read_engagement

Publicación de contenido

Crea nuevas publicaciones en una página.

Solicitud:

POST /{page-id}/feed

Parámetros:

message
link
picture
published

Permisos:pages_manage_posts

  
POST /{page-id}/feed
Body:
{
message: "Hello from the Pages API!"
}

Administración de comentarios

Lee, crea y modera los comentarios en las publicaciones de la página.

Leer comentarios:

GET /{object-id}/comments

Publicar un comentario:

POST /{object-id}/comments

Eliminar un comentario:

DELETE /<COMMENT_ID>

Permisos:pages_manage_engagement

Estadísticas

Obtén estadísticas y métricas de una página.

Solicitud:

GET /{page-id}/insights?metric=page_impressions,page_fans

Permisos:pages_read_engagement

Menciones

Recupera publicaciones o comentarios donde se menciona la página.

Solicitud:

GET /{page-id}/tagged

Permisos:pages_read_user_content

Configuración de página

Actualiza o recupera la configuración de la página, como la foto de portada, la descripción o las preferencias de mensajes.

Obtener configuración:

GET /{page-id}?fields=cover,about,description

Actualizar configuración:

POST /{page-id}/settings

Permisos:pages_manage_metadata

Webhooks

Los webhooks proporcionan actualizaciones en tiempo real de cambios o eventos en la página, como nuevos comentarios, me gusta o mensajes.

Configuración

Configura una URL de devolución de llamadas en el panel de desarrolladores.
Suscríbete a los campos deseados (p. ej., feed, mentions, messages).
Tu servicio recibirá notificaciones HTTP POST sobre los eventos relevantes.

Revisión y publicación de apps

Si tu app necesita más permisos (la mayoría de las funciones de administración de páginas), se requiere la revisión de la app de Facebook.

Pasos de revisión

Solicita los permisos necesarios en el panel de desarrolladores.
Proporciona casos de uso detallados y videos de captura de video.
Envíalo para la revisión y responde a los comentarios.

Ejemplo de solicitudes

Publicación de un mensaje

Obtener estadísticas de publicaciones

Moderación de comentarios

Eliminar un comentario:

Administración de errores

Usa códigos de error y mensajes de Facebook para identificar problemas.
Errores comunes: token inválido, permisos faltantes y limitación de frecuencia.
Referencia: https://developers.facebook.com/docs/graph-api/using-graph-api/error-handling/

Prácticas recomendadas

Usa los permisos mínimos necesarios.
Almacena las respuestas en caché siempre que sea posible.
Maneja la búsqueda para conjuntos de resultados grandes.
Respeta la privacidad de los usuarios y las políticas de Facebook.

Referencias

API de páginas de Facebook

La API de páginas de Facebook de Meta permite que las apps accedan y actualicen la configuración y el contenido de una página de Facebook, creen y obtengan publicaciones, reciban comentarios sobre el contenido de la página, obtengan estadísticas de la página, actualicen las acciones que los usuarios pueden realizar en la página y mucho más.

Este documento contiene las guías que te proporcionarán más información sobre la API de páginas de Facebook y cómo implementarla.

Contenido de la documentación

Te recomendamos leer cada guía en el orden que se describe en este documento:

Información general: aprende sobre la API de páginas y su funcionamiento.
Crear una app: crea una app de Meta con el caso de uso de API de páginas.
Primeros pasos: tutorial introductorio que muestra cómo hacer una publicación en tu página de Facebook.
Gestionar una página: consigue una lista de tus páginas con tareas que puedes realizar en cada uno de los tokens de acceso de páginas y actualiza la configuración de estas.
Publicaciones y comentarios: crear, publicar, actualizar y eliminar publicaciones y comentarios de páginas.
Estadísticas de páginas: obtén estadísticas de tus publicaciones de páginas.
Búsqueda de páginas: busca páginas.
Pestañas de páginas: obtén una lista de pestañas para tu página.
Webhooks de Meta: haz que lleguen notificaciones en tiempo real a tu servidor sobre eventos que tengan lugar en tu página.
Cambios futuros: recibe notificaciones sobre cambios venideros que Meta implementará en tu página.
Códigos de error: mira códigos de error y sus descripciones para hallar errores que puedas encontrar al implementar la API de páginas.
Registro de cambios: visualiza el registro de cambios de la API de páginas.