Información general

La API de páginas es un conjunto de puntos de conexión de la API Graph de Facebook que las apps pueden usar para crear y administrar la configuración y el contenido de una página.

Componentes

Tokens de acceso

La autenticación de la API se realiza mediante tokens de acceso. La mayoría de los puntos de conexión requieren tokens de acceso a la página, que son únicos de cada página, usuario de la app y app, y no tienen fecha de vencimiento. Para obtener un token de usuario de la app, el usuario debe ser el dueño de la página o tener la posibilidad de realizar una tarea en ella.

Para obtener tokens de acceso de usuarios de la app, implementa el inicio de sesión con Facebook.

API Graph

Si no estás familiarizado con la API Graph, lee la documentación sobre la API Graph antes de continuar, a fin de obtener más información sobre la gráfica social de Meta.

Inicio de sesión con Facebook

El inicio de sesión con Facebook permite a los usuarios iniciar sesión en tu app y a tu app la posibilidad de solicitar a los usuarios permisos de acceso a los datos.

Inicio de sesión con Facebook para empresas

El inicio de sesión con Facebook para empresas es la solución de autenticación y autorización ideal para los proveedores de tecnología y los desarrolladores de apps de negocios que necesitan contar con acceso a los recursos de los clientes de negocios.

Funciones

Algunos puntos de conexión requieren una función que se debe aprobar mediante el proceso de revisión de apps. De esta manera, tu app podrá usarlos cuando se publica. Las funciones te permiten acceder a datos de páginas públicas sin permiso o realizar una tarea en ellas. Consulta la referencia de cada punto de conexión para determinar qué función de página requiere.

Menciones

Con las @menciones, tu página puede responder de manera pública a una persona específica, que hizo una publicación en tu página o comentó una publicación de la página, ya sea en un comentario o en una respuesta.

Identificadores de usuario específicos de la página

Los usuarios que interactúan con las páginas se identifican mediante identificadores de usuario específicos de la página (PSID). Los PSID son identificadores únicos de cada pareja de usuario y página. Los puntos de conexión de la API de páginas y la plataforma de Messenger dependen de los identificadores de usuario específicos de la página (PSID), así que puedes usar un PSID para identificar las interacciones de un usuario con una página, además de las conversaciones de Messenger públicas del usuario con la página.

Permisos

La mayoría de los puntos de conexión requieren uno o más permisos, que los usuarios de la app deben otorgar a tu app. Normalmente, esto se puede hacer mediante el inicio de sesión con Facebook, pero también se puede hacer a través del administrador comercial, si una empresa reclamó tu app.

Todos los permisos requieren una revisión de apps antes de que un usuario de la app pueda otorgarlos a su app después de su activación. En el caso de las apps comerciales, que no tienen modos de app, los permisos deben aprobarse para el acceso avanzado antes de que un usuario pueda otorgarlos a tu app sin un rol en esta en sí o un rol en una empresa que la haya reclamado.

Búsqueda en la página

Encuentra información sobre las páginas de Facebook, incluidos los nombres y ubicaciones; encuentra páginas para @mencionar y ubicaciones de páginas; y etiqueta una página para mostrar contenido de marca.

Límites de frecuencia

Todas las solicitudes de puntos de conexión de las páginas están sujetas a límites de frecuencia. Puedes ver el consumo actual de llamadas de tu app en el panel de apps.

Tareas

Permiten a los usuarios realizar acciones específicas en una página. Cuando un usuario usa una app para interactuar con una página, según el tipo de acción que intente realizar, primero comprobaremos que el usuario tenga aprobada una tarea que permita ese tipo de acción.

Puedes autorizar las siguientes tareas para usuarios individuales:

Si a una persona se le da acceso de administrador a una página en la UI, puede realizar todas las tareas en esa página.

Plataforma de Messenger

Mantén conversaciones de Messenger con tus clientes y con las personas interesadas en tu página.

Webhooks de Meta para páginas

Recibe notificaciones en tiempo real cuando un usuario realice un comentario en una publicación de la página o reaccione a una publicación.

Revisión de apps

Todos los permisos y funciones relacionados con la página requieren aprobación mediante el proceso de revisión de apps. Una vez aprobados, tu app puede usarlos cuando esté activa.

Las apps en modo de desarrollo pueden solicitar permisos de cualquier usuario que tenga un rol en la app.

Cómo funciona

Este es un proceso típico para acceder a la API de páginas:

1. Obtener un token de acceso de usuario de la app a través del inicio de sesión con Facebook.
2. Consultar el punto de conexión /me/accounts para obtener el identificador y el token de acceso a la página según el acceso permitido a la app por el usuario.
3. Capturar el identificador de página y el token de acceso a la página devueltos.
4. Usar el identificador y el token para consultar el nodo de la página.

Ten en cuenta que, en algunos casos, el usuario de la app puede concederle a esta acceso a más de una página. En ese caso, debes capturar cada identificador de la página y su token correspondiente, además de proporcionar una manera de que el usuario de la app pueda llegar a cada una de las páginas.

Próximos pasos

Consulta nuestra Guía de primeros pasos para obtener información sobre cómo hacer publicaciones en una página mediante la API de páginas.

Más información