Información general

La API de páginas es un conjunto de extremos de la API Graph de Facebook que las aplicaciones pueden utilizar para crear y administrar la configuración y el contenido de una página.

Componentes

Identificadores de acceso

La autenticación de la API se gestiona mediante identificadores de acceso. La mayoría de los extremos requieren identificadores de acceso a la página, que son exclusivos para cada página, usuario de la aplicación y aplicación, y tienen un periodo de caducidad. Para obtener un identificador de un usuario de la aplicación, este debe ser el propietario de la página o debe poder realizar una tarea en esta.

Para poder obtener identificadores de acceso de los usuarios de la aplicación, implementa el inicio de sesión con Facebook.

API Graph

Si no tienes experiencia con la API Graph, lee nuestra documentación sobre la API Graph antes de continuar para 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 la aplicación y permitir a la aplicación pedir permisos a los usuarios para acceder 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 preferida de los proveedores de tecnología y los desarrolladores de aplicaciones empresariales que necesitan acceder a los activos de sus clientes empresariales.

Funciones

Algunos extremos requieren una función que se debe aprobar mediante el proceso de revisión de la aplicación para que la aplicación los pueda usar cuando se active. Las funciones te permiten acceder a datos de páginas públicos sin el permiso ni la capacidad de realizar una tarea en la página. Consulta la referencia de cada extremo para determinar la función de página que necesita.

Menciones

Las @menciones permiten a tu página responder de forma pública a un usuario concreto, que ha publicado en tu página o comentado en una publicación de la página, en un comentario o 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 par usuario-página. Los extremos de la API de páginas y la plataforma de Messenger dependen de los PSID, de modo que puedes utilizar un PSID para identificar las interacciones de un usuario con una página, así como las conversaciones de Messenger públicas del usuario con la página.

Permisos

La mayoría de los extremos requieren uno o varios permisos, que los usuarios deben conceder a la aplicación. Por lo general, esto se puede llevar a cabo mediante el inicio de sesión con Facebook, pero también en Business Manager si una empresa ha reclamado la aplicación.

Todos los permisos requieren una revisión de la aplicación para que un usuario pueda concederlos a la aplicación después de que se active. En el caso de las aplicaciones empresariales, que no tienen modos de aplicación, los permisos deben aprobarse para el acceso avanzado a fin de que el usuario pueda concederlos a la aplicación sin un rol en esta ni en una empresa que la haya reclamado.

Búsqueda de páginas

Busca información sobre las páginas de Facebook, incluidos nombres y ubicaciones, y busca páginas para @mencionar, ubicaciones de páginas, y etiqueta a una página para mostrar contenido de marca.

Límites de frecuencia

Todas las solicitudes al extremo de páginas están sujetas a limitación de frecuencia. Para ver el consumo de llamadas actual de la aplicación, ve al panel de aplicaciones.

Tareas

Las tareas permiten a los usuarios realizar acciones específicas en una página. Cuando un usuario utiliza una aplicación para interactuar con una página, en función de la acción que intente, primero comprobaremos si el usuario se ha aprobado para una tarea que permita ese tipo de acción.

Puedes aprobar usuarios individuales para las tareas siguientes:

Si se concede a un usuario acceso de administrador a una página en la interfaz de usuario, podrá realizar todas las tareas en dicha página.

Plataforma de Messenger

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

Webhooks de Meta para páginas

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

Revisión de la aplicación

Todos los permisos y funciones relacionados con las páginas se deben aprobar mediante el proceso de revisión de la aplicación para que la aplicación los pueda usar cuando se active.

Las aplicaciones en el modo de desarrollo pueden solicitar cualquier permiso de cualquier usuario de la aplicación que tenga un rol en la aplicación.

Funcionamiento

A continuación se incluye un flujo típico para acceder a la API de páginas:

1. Obtener un identificador de acceso de usuario del usuario de la aplicación mediante el inicio de sesión con Facebook.
2. Consultar el extremo /me/accounts para obtener el identificador y el identificador de acceso a la página de la página a la que el usuario de la aplicación permite acceder a la aplicación.
3. Capturar el identificador de página devuelto y el identificador de acceso a la página.
4. Usar estos identificadores para consultar el nodo de la página.

En algunos casos, el usuario de la aplicación puede conceder a la aplicación acceso a más de una página. En ese caso, debes capturar cada identificador de la página y su identificador de acceso correspondiente y proporcionar una forma de que el usuario de la aplicación se dirija a cada una de estas páginas.

Siguientes pasos

Sigue nuestra guía de introducción para aprender a realizar una publicación de la página con la API de páginas.

Más información