Introducción

En este documento se explica cómo llamar correctamente a la API de páginas para publicar en tu página.

Antes de empezar

Necesitarás lo siguiente:

  • Una página de Facebook, que puede ser una página sin publicar o una página publicada en la que puedas realizar la tarea CREATE_CONTENT.
  • Un identificador de acceso a la página para la página.
  • Los siguientes permisos:
    • pages_manage_metadata
    • pages_manage_posts
    • pages_manage_read_engagement
    • pages_show_list

Prácticas recomendadas

Al probar una llamada a la API, puedes incluir el parámetro access_token establecido en el identificador de acceso. Sin embargo, al realizar llamadas seguras desde la aplicación, debes usar la clase de identificador de acceso.

Paso 1. Obtener el identificador de la página

Para obtener una lista de los identificadores y los identificadores de acceso a la página de las páginas de Facebook en las que puedes realizar una tarea, envía una solicitud GET al extremo /user_id/accounts en la que user_id sea tu identificador de usuario.

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_id, por tus valores.
curl -i -X GET "https://graph.facebook.com/v21.0/user_id/accounts?access_token=user_access_token"

Si la operación se realiza correctamente, la aplicación recibe la siguiente respuesta JSON, que incluye una matriz de objetos. Cada objeto contiene información acerca de una página concreta e incluye, entre otros elementos, el nombre, el identificador, un identificador de acceso a la página de corta duración y las tareas que puedes realizar en la página:

{
  "data": [
    {
      "access_token": "page_access_token",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Name of this Page",
      "id": "page_id",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
...

Paso 2. Realizar una publicación

Para realizar una publicación, envía una solicitud POST al extremo /page_id/feed, donde page_id sea el identificador de la página en la que publicas, con el parámetro message establecido en el contenido del mensaje y el parámetro access_token establecido en el identificador de acceso a la página:

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_id, por tus valores.
curl -X POST "https://graph.facebook.com/v21.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

La publicación se realizará inmediatamente.

Si la operación se realiza correctamente, la aplicación recibe la siguiente respuesta JSON con el identificador de la publicación:

{
  "id": "page_post_id" 
}

Visita tu página de Facebook para ver la publicación.

Paso 3. Verificar la publicación

A fin de verificar si la publicación se ha realizado en la página, envía una solicitud GET al extremo /page_id/feed:

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_id, por tus valores.
      curl -i -X GET "https://graph.facebook.com/v21.0/page_id/feed?access_token=page_access_token"

Si la operación se realiza correctamente, la aplicación recibirá la siguiente respuesta JSON con una matriz de objetos. Cada objeto incluye el identificador de la publicación, el contenido del mensaje y la hora de creación de la publicación:

{
  "data": [
    {
      "created_time": "2020-03-25T17:33:34+0000",
      "message": "Hello World!",
      "id": "422575694827569_917077345377399"  
    },
...
  ]
}

Usar el explorador de la API Graph

La herramienta del explorador de la API Graph es una IU que permite experimentar con las API de Facebook sin añadir código a tu aplicación o sitio web. Puedes seleccionar permisos; obtener identificadores de acceso; probar los métodos GET, POST y DELETE, y obtener fragmentos de código de estas consultas para Android, iOS, JavaScript, PHP y cURL.

Ten en cuenta que necesitarás un identificador de la aplicación de Facebook para poder usar el explorador de la API Graph.

Paso 1. Obtener el identificador de la página

Selecciona los permisos pages_manage_metadata, pages_manage_posts, pages_manage_read_engagement y pages_show_list que aparecen en el menú desplegable de permisos, establece la solicitud GET en el extremo /me/accounts en el cuadro de consulta y haz clic en Enviar.

Haz clic en el identificador de tu página, que aparece justo debajo del nombre de la página, para moverlo al cuadro de consulta.

Paso 2. Publicar como una página

En el menú desplegable Usuario o página, selecciona el identificador de acceso de tu página. A continuación, define el método en POST con una solicitud al extremo /{page-id}/feed y establece los parámetroskey en message y value en el texto de la publicación. Haz clic en Enviar.

Cuando esta operación se lleva a cabo correctamente, el explorador de la API Graph muestra el identificador de la publicación de la página.

Visita nuestra página de Facebook para ver la publicación.

Paso 3. Verificar la publicación

Envía una solicitud GET al extremo /page-id/feed.

Cuando esta operación se lleva a cabo correctamente, el explorador de la API Graph muestra la hora de creación de la publicación de la página, el texto y el identificador.

Próximos pasos

Consulta la guía sobre cómo administrar una página de Facebook para obtener información sobre cómo recibir y actualizar la información de tu página de Facebook, como los detalles de la página, los identificadores de acceso, los usuarios bloqueados y las recomendaciones de usuario.

Obtén información sobre cómo publicar enlaces, fotos y vídeos en tu página.