ES
Guía de la Pages API

API de Páginas de Facebook: Page access tokens, permisos y una forma más sencilla de conectar Páginas

Page access tokens, tareas de Página, permisos pages_* y App Review en 2026, y cómo una app SaaS puede conectar las Páginas que gestionan sus usuarios.

Page access tokens 200 OK
GETgraph.facebook.com/me/accounts?fields=id,name,tasks,access_token
Northwind BakeryFacebookPágina · control total
access_token: {PAGE_ACCESS_TOKEN_1}
CREATE_CONTENTMODERATEMESSAGINGANALYZEADVERTISEMANAGE
Harbor YogaFacebookPágina · acceso parcial
access_token: {PAGE_ACCESS_TOKEN_2}
ANALYZEMESSAGING
Requiere pages_show_list Facebook Login for Business App Review para Páginas de clientes
TOKEN Un token por Página, admin y app
Respuesta corta

La API de Páginas de Facebook (Meta la llama Facebook Pages API) es un conjunto de endpoints de la Graph API para gestionar una Página de Facebook: publicar y leer publicaciones, moderar comentarios, leer estadísticas y gestionar las conversaciones de la Página. Cada llamada necesita un Page access token, obtenido de una persona que pueda realizar tareas en la Página. Para sus propias Páginas, gestionadas por personas con un rol en su app, no hace falta App Review; dar servicio a las Páginas de sus clientes requiere una app que haya superado el App Review.

Para un SaaS con muchos clientes existe un segundo modelo: los usuarios conectan sus cuentas de Facebook a través de Unipile y sus Páginas llegan con la conexión.

Con Unipile

Las Páginas de sus usuarios, sin ningún token de Página que gestionar

  1. Conectar. Su usuario vincula su cuenta de Facebook mediante Hosted Auth y sus Páginas llegan con ella. Sin app de Meta ni App Review.

  2. Listar las Páginas. Llame a GET /v2/{ACCOUNT_ID}/inboxes con su X-API-KEY: cada Página es un inbox PAGE_<page_id>_INBOX.

  3. Actuar como la Página. Responda con POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send, o publique como la Página con post_as.

Definición

¿Qué es la API de Páginas de Facebook?

Es la parte de la Graph API construida en torno al nodo Page: endpoints que leen y modifican una Página, sus publicaciones, comentarios y métricas. La mensajería funciona con la Messenger Platform y los anuncios con la Marketing API, con el mismo Page access token.

Pese a su nombre, la Graph API no es GraphQL. Es una API HTTP versionada en graph.facebook.com, organizada en nodos, edges y campos. Para una visión más amplia (Login, Messenger, versiones, rate limits), consulte cómo encajan las API de Facebook.

Facebook Lo que cubre la Pages API
Datos de la PáginaLeer y actualizar los datos y la configuración de la PáginaGET / POST /{page-id}pages_manage_metadata · MANAGE
PublicacionesPublicar, leer, editar y eliminar publicaciones como la PáginaPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENT
ComentariosLeer, responder y eliminar comentarios en las publicaciones de la Página (guía de la API de comentarios)GET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATE
EstadísticasMétricas de la Página y de las publicacionesGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZE
ConversacionesLa bandeja de entrada de la Página, a través de la Messenger PlatformGET /{page-id}/conversationspages_messaging · MESSAGING
WebhooksEventos en tiempo real del feed y la bandeja de entrada de la Página, una vez instalada su app en la Página mediante su edge subscribed_appsPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_list

Límites de uso de la Facebook Pages API

Las llamadas realizadas con un Page access token están sujetas a los límites Business Use Case de Meta, calculados por Página: 4.800 llamadas multiplicadas por el número de usuarios implicados en 24 horas, es decir, las personas que interactuaron con la Página en ese periodo. Cada respuesta incluye un encabezado X-Business-Use-Case-Usage con su consumo actual. Los límites de las demás API de Facebook están en nuestra guía de la API de Facebook.

Fuentes: de Meta, Pages API overview, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page conversations, subscribed_apps, límites de uso y la referencia de permisos. Última verificación: 17 de noviembre de 2026.

Access token

Cómo obtener un Page access token de Facebook

No existe una API key para la API de Páginas de Facebook. Un admin de la Página inicia sesión en su app de Meta con Facebook Login for Business, lo que le da un user access token. Después, GET /me/accounts devuelve todas las Páginas que gestiona, con sus tareas y un Page access token para cada una.

1

Crear una app de Meta

En Meta for Developers, con el caso de uso "Manage everything on your Page".

App ID + App Secret
2

Añadir Facebook Login for Business

Solicite pages_show_list y lo que necesiten sus funciones.

Diálogo de login
3

Obtener un user access token

De corta duración; cámbielo en el servidor (fb_exchange_token) por uno de larga duración.

{USER_ACCESS_TOKEN}
4

Llamar a /me/accounts

Cada Página devuelve su ID, sus tareas y su token.

GET /me/accounts

Meta: "los Page access tokens son únicos para cada combinación de Página, admin y app". Diez Páginas de clientes son diez tokens que almacenar y vigilar.

La llamada de intercambio y la solicitud /me/accounts están listas para copiar en la pestaña "Meta token exchange" del bloque de código más abajo. Los tokens de usuario, de app y de system user se tratan en nuestra guía del token de acceso de la API de Facebook.

Obtener un Page access token en el Graph API Explorer

Para probar con una Página que usted gestiona, sin escribir código:

  • Elija su app en el menú de apps del Graph API Explorer y añada pages_show_list junto con los permisos que quiera probar.
  • Abra el menú "User or Page", elija su Página y genere el token: el Explorer le pide que conceda los permisos.
  • Copie el token que aparece en la parte superior de la herramienta. Es de corta duración: cámbielo como en el paso 3 por un token de Página que no caduca.

¿Cuánto dura un Page access token de Facebook?

Depende del user token del que parta. Un token de Página obtenido con un user token de corta duración dura aproximadamente una hora. Cambie primero el user token por uno de larga duración, vuelva a llamar a /me/accounts y, según Meta, el token de Página que obtenga no tiene fecha de caducidad, aunque puede seguir siendo invalidado.

Facebook Duración de los tokens, según Meta
User token de corta duraciónEntre una y dos horas aproximadamente
User token de larga duraciónUnos 60 días
Token de Página obtenido con un user token de corta duración"Válido durante 1 hora"
Token de Página obtenido con un user token de larga duración"No tiene fecha de caducidad", pero puede ser invalidado

Fuentes: de Meta, Access Tokens, Long-Lived Access Tokens y Get a Page Access Token; pasos del Graph API Explorer según su guía. Meta añade: "No dependa de que estas duraciones se mantengan". Última verificación: 17 de noviembre de 2026.

¿Puede un Page access token de Facebook no caducar nunca?

Sí. Un Page access token de larga duración, obtenido llamando a /me/accounts con un user token de larga duración, no tiene fecha de caducidad. En palabras de Meta, los Page access tokens de larga duración "solo caducan o se invalidan en determinadas condiciones". Es el token de Página "permanente" al que se refieren la mayoría de las guías. Sin embargo, no es eterno: los casos siguientes lo siguen invalidando, así que almacénelo, vigile los errores y prevea un flujo de reconexión. Para las Páginas propiedad de su propia empresa, un system user token es la otra opción.

Qué invalida un token de Página en producción

  • El admin pierde su rol en la Página. Meta solo emite tokens de Página a personas con un rol en la Página; obtenga un nuevo token de otro admin.
  • El admin cierra sesión en su app, cambia su contraseña o elimina su app. Debe volver a iniciar sesión.
  • Su app pierde un permiso. El acceso se corta entonces para todos los clientes a la vez.

Meta notifica estos casos con el error 190. Sus subcódigos y cómo comprobar un token con debug_token se detallan en nuestra guía del token de acceso de la API de Facebook; para un token de Página, la solución es siempre la misma: pedir al admin que vuelva a conectarse.

Permisos

Tareas y permisos de Página: quién puede hacer qué

Una llamada solo funciona si la persona detrás del token puede realizar la tarea correspondiente en la Página y si su app tiene el permiso correspondiente, con Advanced Access para las personas ajenas a su app.

Las 8 tareas de Página

Las tareas son lo que una persona puede hacer en una Página. /me/accounts las enumera por Página; un admin puede realizarlas todas.

Facebook Tareas de Página
ADVERTISECrear anuncios y publicaciones de Página no publicadas
ANALYZEVer las estadísticas de la Página y qué admin publicó una publicación o un comentario
CREATE_CONTENTPublicar contenido como la Página
MANAGEAsignar y gestionar tareas de Página; también necesaria para actualizar los datos y la configuración de la Página
MANAGE_LEADSVer y gestionar leads
MESSAGINGEnviar mensajes como la Página
MODERATEResponder y eliminar comentarios en las publicaciones de la Página
VIEW_MONETIZATION_INSIGHTSVer las estadísticas de monetización

Los permisos pages_* que solicitará

Los permisos son lo que su app puede hacer. Una app de Meta creada con el caso de uso "Manage everything on your Page" empieza con pages_show_list, business_management y public_profile. Añada solo lo que use cada función: cada permiso se revisa por separado.

Facebook Permisos pages_*
pages_show_listListar las Páginas que gestiona una persona: el selector de Páginas tras el login
pages_read_engagementLeer el contenido, los metadatos, los seguidores y las estadísticas de la Página
pages_manage_postsCrear, editar y eliminar publicaciones de la Página
pages_manage_engagementCrear, editar y eliminar comentarios publicados en la Página
pages_read_user_contentLeer las publicaciones y los comentarios de los visitantes en la Página y eliminar sus comentarios
read_insightsLeer las estadísticas de la Página, junto con pages_read_engagement
pages_messagingGestionar y acceder a las conversaciones de la Página en Messenger
pages_manage_metadataSuscribirse a los webhooks de la Página y actualizar su configuración

Leer Páginas que usted no gestiona es otro caso: requiere la función Page Public Content Access, que Meta limita a analizar o mostrar publicaciones e interacciones de Páginas, con su propio App Review y su propia Business Verification.

Fuentes: de Meta, Pages API overview (tareas), Manage a Page (MANAGE para la configuración), Page Insights, la referencia de permisos (descripciones resumidas) y Page Public Content Access. Última verificación: 17 de noviembre de 2026.

App Review

App Review: por qué funciona en su Página pero no en las de sus clientes

Su app empieza con Standard Access y Meta indica que "los permisos con Standard Access solo pueden solicitarse a usuarios que tengan un rol en la app solicitante". Su prototipo funciona en su Página y falla cuando un cliente inicia sesión. Para dar servicio a sus Páginas hace falta Advanced Access, concedido permiso por permiso mediante el App Review.

1Standard Access

Solo su equipo

Solo las personas con un rol en la app pueden conceder permisos.

2Revisión

App Review

Una solicitud por permiso y una empresa verificada.

3Advanced Access

En producción para clientes

Cualquier admin de Página puede conceder los permisos aprobados.

Lo que tiene que gestionar un SaaS multicliente

Una vez en producción, cada Página de cliente es una pequeña integración propia: un login de admin, un token almacenado, las tareas de ese admin, un control de estado y un flujo de reconexión. Nada en la API de Páginas de Facebook los supervisa por usted entre tenants. La guía de envío de Meta exige:

  • Una grabación de pantalla por permiso, que muestre al usuario concediéndolo y la función que lo usa: "No se aprobará ningún permiso o función solicitado sin grabación de pantalla".
  • Una descripción por permiso, lo más concreta posible.
  • Acceso para los revisores: una app pública o instrucciones para llegar a la función.
  • Solo los permisos que su app necesita.

Meta también exige la Business Verification: "La Business Verification es obligatoria para obtener Advanced Access".

Fuentes: de Meta, niveles de acceso, guía de envío al App Review y Pages API overview ("Todos los permisos y funciones relacionados con Páginas requieren aprobación mediante el proceso de App Review"). Última verificación: 17 de noviembre de 2026.

Mensajería

Mensajería de Páginas de Facebook: donde la Pages API cede el paso a Messenger

Las conversaciones de la Página no forman parte de la Pages API. Funcionan con la Messenger Platform, con el mismo Page access token, el permiso pages_messaging y la tarea MESSAGING.

Las personas se identifican con un ID con ámbito de Página (PSID), escriben primero y la Página puede responder durante las 24 horas siguientes a su último mensaje. Cómo una app SaaS lee y responde esas conversaciones se explica en nuestra página API de Facebook Messenger. Para las conversaciones de un perfil personal, consulte la API de Facebook Messenger para cuentas personales; para lo que factura Meta, consulte los precios de la API de Facebook Messenger.

Con Unipile

Otro modelo: conectar las Páginas que gestionan sus usuarios

Con Unipile, su usuario conecta su cuenta de Facebook una sola vez, mediante Hosted Auth. Las Páginas que administra se activan por defecto en el mismo account_id. Sin app de Meta, sin App Review y sin token de Página por su parte.

Su app Sincronizado
Una conexión
FacebookAnna LeeBandeja personal
FacebookNorthwind BakeryBandeja de Página
FacebookHarbor YogaBandeja de Página
Northwind Bakery 2Harbor YogaPersonal
Leo Martin¿Abre la tienda el domingo?Página
Sara KimFoto de un pedido de tartaPágina
Omar HaddadUsted: listo a mediodíaPágina
Estado de conexión
Bandeja personalConectada
Northwind BakeryConectada
Harbor YogaRequiere atención

Un problema en una Página no afecta a la bandeja personal ni a las demás Páginas.

GET api.unipile.com/v2/{ACCOUNT_ID}/inboxes 200 OK
Una Página conectada puede
  • Leer los mensajes de la Página, que aparece como una bandeja PAGE_<page_id>_INBOX
  • Responder en las conversaciones de la Página
  • Publicar como la Página, con el parámetro post_as (API de publicaciones de Facebook)
  • Leer las publicaciones de la Página
No puede
  • Iniciar una conversación nueva: la persona escribe primero
  • Eliminar sus mensajes (501 api/not_implemented)
  • Publicar Stories
  • Usar los Grupos de Facebook

Cada Página informa de su propio estado en metadata.products_connection_status (clave page_<page_id>). La misma conexión incluye los mensajes personales del admin y la misma API cubre LinkedIn, WhatsApp, Instagram, Telegram, email y calendarios.

La misma tarea en código

Listar las Páginas y después responder a una conversación de Página. La pestaña "Meta Graph API" usa un token de Página, la pestaña "Meta token exchange" muestra cómo obtener un token de Página que no caduca y la pestaña "Unipile" usa la cuenta conectada.

# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}",
    "name": "Northwind Bakery",
    "tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
    "access_token": "{PAGE_ACCESS_TOKEN}"
} ] }

# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"

# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }

# 2. Call /me/accounts with the long lived user token:
#    the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
#    with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. List the chats of one Page inbox
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Yes, we open at 9am on Sunday." }'
200 OK · un Page access token por Página, admin y app
200 OK · expires_in se expresa en segundos: unos 60 días para el user token
200 OK · un account_id para la bandeja personal y todas las Páginas

Llamadas de Meta verificadas con Long-Lived Access Tokens el 17 de noviembre de 2026. La activación, los ID de bandeja y post_as se detallan en la documentación de Facebook Pages.

Cumplimiento

Cada usuario conecta su propia cuenta

Unipile es una empresa independiente, no una app oficial de Meta ni un Meta Partner. Se conecta en nombre de cada usuario autenticado, y cada usuario sigue sujeto a las condiciones de Meta. Úsela para las conversaciones con clientes en las Páginas que gestionan sus usuarios.

Decisión

Pages API o cuenta conectada: ¿cuál encaja con su producto?

La Pages API de Meta encaja con un equipo que gestiona sus propias Páginas o necesita estadísticas y anuncios. Una cuenta conectada encaja con un SaaS cuyos usuarios aportan sus propias Páginas.

PreguntaPages API de MetaCuenta conectada Unipile
Quién conecta la PáginaUn admin de la Página, mediante Facebook Login for Business en su app de MetaSu usuario, mediante Hosted Auth
App de Meta y App ReviewObligatorios, además de Advanced Access y Business VerificationInnecesarios por su parte
Tokens que gestionarUn token de Página por Página, admin y appNinguno: un account_id y su API key
Mensajes de la PáginaMessenger Platform, pages_messaging, ventana de 24 horasLeer y responder; una Página no puede iniciar una conversación
Publicar como la Páginapages_manage_postspost_as en el endpoint de publicaciones
Cuenta personal del adminNo disponible para mensajeríaMisma conexión: chats personales, publicaciones y perfil
Estado por PáginaUsted comprueba cada tokenpage_<page_id> en products_connection_status
Quién conecta la Página
Pages API de MetaUn admin de la Página, mediante Facebook Login for Business en su app de Meta
UnipileSu usuario, mediante Hosted Auth
App de Meta y App Review
Pages API de MetaObligatorios, además de Advanced Access y Business Verification
UnipileInnecesarios por su parte
Tokens que gestionar
Pages API de MetaUn token de Página por Página, admin y app
UnipileNinguno: un account_id y su API key
Mensajes de la Página
Pages API de MetaMessenger Platform, pages_messaging, ventana de 24 horas
UnipileLeer y responder; una Página no puede iniciar una conversación
Publicar como la Página
Pages API de Metapages_manage_posts
Unipilepost_as en el endpoint de publicaciones
Cuenta personal del admin
Pages API de MetaNo disponible para mensajería
UnipileMisma conexión: chats personales, publicaciones y perfil
Estado por Página
Pages API de MetaUsted comprueba cada token
Unipilepage_<page_id> en products_connection_status

¿Aún duda entre Login, Messenger, Marketing API y Pages? Nuestra tabla de decisión indica qué API de Facebook necesita para cada tipo de producto.

Conecte Páginas sin gestionar tokens

Deje que cada usuario vincule su cuenta de Facebook una sola vez y trabaje con las bandejas y publicaciones de sus Páginas a través de la misma API que sus cuentas de LinkedIn, WhatsApp y email. Prueba gratuita de 7 días, sin tarjeta de crédito.

Comisión Europea
Regulado por la UE Digital Markets Act (DMA)

Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Más información

Todos los endpoints de la API de Facebook en un solo lugar

Las Páginas son solo una parte. Consulte todos los endpoints de Facebook disponibles con Unipile (mensajes, publicaciones, comentarios, perfiles, webhooks) o lea la guía completa de la API de Facebook.

Preguntas frecuentes sobre la API de Páginas de Facebook

Respuestas rápidas sobre el Page access token de Facebook, su duración, el App Review y los permisos.

Haga que un admin de la Página inicie sesión en su app de Meta con Facebook Login for Business, solicitando pages_show_list. Cambie en su servidor el user token por uno de larga duración con grant_type=fb_exchange_token y llame a GET /me/accounts: cada Página se devuelve con su propio access_token y las tareas que el admin puede realizar.

Depende del user token del que procede. Según Meta, un token de Página obtenido con un user token de corta duración es válido durante 1 hora. Si lo obtiene a partir de un user token de larga duración (unos 60 días), el token de Página no tiene fecha de caducidad, aunque un cierre de sesión, un cambio de contraseña o la eliminación de la app lo siguen invalidando.

Sí. Llame a /me/accounts con un user token de larga duración y los tokens de Página devueltos no tienen fecha de caducidad. No son permanentes en todos los casos: si el admin pierde su rol en la Página, cambia su contraseña o elimina su app, el token deja de funcionar y el admin tiene que volver a conectarse.

Su app solo tiene Standard Access, así que únicamente las personas con un rol en la app pueden concederle permisos. Para dar servicio a las Páginas de clientes, cada permiso necesita Advanced Access, concedido mediante el App Review con una grabación de pantalla por permiso, y Meta exige además la Business Verification.

Casi todas las integraciones empiezan con pages_show_list. Después, añada solo lo que use: pages_read_engagement para leer contenido y metadatos, pages_manage_posts para publicar, pages_manage_engagement para los comentarios, pages_messaging para las conversaciones, pages_manage_metadata para los webhooks y la configuración, y read_insights para las métricas.

No. Unipile es una empresa independiente, no un Meta Partner, y Meta no la respalda, patrocina ni aprueba. Conectar Páginas a través de Unipile tampoco convierte su producto en una app de Meta. Facebook y Messenger son marcas comerciales de Meta Platforms, Inc.

No. En lugar de una app de Meta que recopila Page access tokens, sus usuarios conectan su cuenta de Facebook una sola vez mediante la autenticación alojada de Unipile, y las Páginas que administran llegan con esa conexión. No hay App Review, Advanced Access ni Business Verification que completar por su parte.

Está concebida en el espíritu de la Digital Markets Act (Ley de Mercados Digitales): cada admin de Página conecta su propia cuenta, Unipile actúa en su nombre para las Páginas que ya gestiona y no almacena perfiles de usuario. Los detalles están en nuestra página sobre la Digital Markets Act.

Sí. Una Página conectada a través de Unipile sigue sujeta a las Condiciones de servicio de Meta y a las políticas de Páginas. Limítese a usos legítimos como responder a los clientes en la bandeja de entrada de la Página, publicar el contenido propio de la Página o sincronizar las conversaciones con un CRM; el spam y la automatización no autorizada pueden provocar la restricción de la cuenta o de la Página.

¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.

Hable con un experto