
Guías de integración
Guía de la API de LinkedIn
Guía de la API de email
Guía de la API de WhatsApp
Contactar con ventas
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.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Un token por Página, admin y app
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.
Las Páginas de sus usuarios, sin ningún token de Página que gestionar
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.
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.
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.
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.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listLas 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.
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.
En Meta for Developers, con el caso de uso "Manage everything on your Page".
App ID + App SecretSolicite pages_show_list y lo que necesiten sus funciones.
De corta duración; cámbielo en el servidor (fb_exchange_token) por uno de larga duración.
Cada Página devuelve su ID, sus tareas y su token.
GET /me/accountsMeta: "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.
Para probar con una Página que usted gestiona, sin escribir código:
pages_show_list junto con los permisos que quiera probar.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.
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.
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.
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.
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 tareas son lo que una persona puede hacer en una Página. /me/accounts las enumera por Página; un admin puede realizarlas todas.
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.
pages_read_engagementLeer 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.
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.
Solo las personas con un rol en la app pueden conceder permisos.
Una solicitud por permiso y una empresa verificada.
Cualquier admin de Página puede conceder los permisos aprobados.
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:
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.
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, 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.
Un problema en una Página no afecta a la bandeja personal ni a las demás Páginas.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOXpost_as (API de publicaciones de Facebook)501 api/not_implemented)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.
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." }'
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.
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.
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.
| Pregunta | Pages API de Meta | Cuenta conectada Unipile |
|---|---|---|
| Quién conecta la Página | Un admin de la Página, mediante Facebook Login for Business en su app de Meta | Su usuario, mediante Hosted Auth |
| App de Meta y App Review | Obligatorios, además de Advanced Access y Business Verification | Innecesarios por su parte |
| Tokens que gestionar | Un token de Página por Página, admin y app | Ninguno: un account_id y su API key |
| Mensajes de la Página | Messenger Platform, pages_messaging, ventana de 24 horas | Leer y responder; una Página no puede iniciar una conversación |
| Publicar como la Página | pages_manage_posts | post_as en el endpoint de publicaciones |
| Cuenta personal del admin | No disponible para mensajería | Misma conexión: chats personales, publicaciones y perfil |
| Estado por Página | Usted comprueba cada token | page_<page_id> en products_connection_status |
account_id y su API keypages_messaging, ventana de 24 horaspages_manage_postspost_as en el endpoint de publicacionespage_<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.
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.
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