ES
Guía de access tokens

Token de acceso de la API de Facebook: tokens de usuario, de Página, de app y de system user

Cómo obtener cada token, extenderlo a unos 60 días, verificarlo con debug_token y gestionar el error 190, y cómo una app SaaS puede prescindir de toda la gestión de tokens.

Verificación del token 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationSu app
is_validtrue
expires_aten 60 díastoken de usuario de larga duración
data_access_expires_aten 90 díasse renueva si el usuario está activo
scopespublic_profilepages_show_list
TOKEN Sin refresh token: verificar y volver a iniciar sesión
Respuesta corta

Un token de acceso de la API de Facebook es la cadena que necesita cada llamada a la Graph API. Obtiene un token de usuario con Facebook Login (o con el Graph API Explorer para pruebas), lo canjea en su servidor por un token de larga duración de unos 60 días y después llama a /me/accounts para obtener los tokens de Página. No hay API key ni refresh token: vigile los tokens con debug_token y gestione el error 190.

Para un SaaS con muchos clientes existe un segundo modelo: los usuarios conectan sus cuentas de Facebook a través de Unipile y su app nunca guarda un token de Meta.

Con Unipile

Ningún token de Meta que obtener, extender ni depurar

  1. 1

    Conectar la cuenta

    Su usuario vincula su cuenta o su Página de Facebook una sola vez mediante Hosted Auth. Sin app de Meta ni App Review.

  2. 2

    Llamar con su clave de API

    Envíe X-API-KEY con el account_id del usuario: GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Vigilar un solo estado

    Compruebe products_connection_status; si hace falta, el usuario se vuelve a conectar mediante Hosted Auth.

Definición

¿Qué es un token de acceso de la API de Facebook?

Meta define un access token como "una cadena opaca que identifica a un usuario, una app o una Página de Facebook". Cada solicitud a la Graph API lleva uno, y su tipo determina en nombre de quién actúa.

TokenActúa en nombre deCómo se obtieneDuración y uso
UsuarioUna persona con sesión iniciadaFacebook Login o Graph API Explorer1 a 2 horas, o unos 60 días
PáginaUna Página de Facebook/me/accounts con el token de usuario de un adminSigue a su token de usuario
AppSu app de MetaLlamada client_credentials, o {APP_ID}|{APP_SECRET}Solo llamadas de servidor a servidor
System userSu empresaConfiguración del negocioSin caducidad, o 60 días
ClienteSu app, en código clientePanel de appsNo es secreto
Token de usuario
Actúa en nombre deUna persona con sesión iniciada
Cómo se obtieneFacebook Login o Graph API Explorer
Duración y uso1 a 2 horas, o unos 60 días
Token de Página
Actúa en nombre deUna Página de Facebook
Cómo se obtiene/me/accounts con el token de usuario de un admin
Duración y usoSigue a su token de usuario
Token de app
Actúa en nombre deSu app de Meta
Cómo se obtieneLlamada client_credentials, o {APP_ID}|{APP_SECRET}
Duración y usoSolo llamadas de servidor a servidor
System user token
Actúa en nombre deSu empresa
Cómo se obtieneConfiguración del negocio
Duración y usoSin caducidad, o 60 días
Token de cliente
Actúa en nombre deSu app, en código cliente
Cómo se obtienePanel de apps
Duración y usoNo es secreto

Instagram tiene su propio flujo: consulte nuestra guía del token de la API de Instagram.

Fuente: guía Access Tokens de Meta. Última verificación: 17 de noviembre de 2026.

Obtener un token

Cómo obtener un token de acceso de la API de Facebook

No existe una API key de Facebook: cada llamada usa un access token. Para pruebas, genere uno para su propia cuenta en el Graph API Explorer. En producción, los usuarios inician sesión en su app de Meta con Facebook Login (for Business cuando necesita sus Páginas) y su servidor canjea el código devuelto por un token de acceso de usuario.

Pruebas, en 4 pasos

Graph API Explorer

  1. Abra developers.facebook.com/tools/explorer
  2. Elija su app de Meta y "User Token"
  3. Añada los permisos que necesita
  4. Haga clic en Generate Access Token y apruebe
Producción, en 4 pasos

Facebook Login en su app de Meta

  1. Cree una app de Meta (App ID, App Secret)
  2. Envíe a los usuarios a /dialog/oauth con client_id, redirect_uri, state
  3. Conceden los permisos; usted recibe un code
  4. Su servidor llama a /oauth/access_token con el code y el App Secret

La respuesta contiene access_token, token_type y expires_in. Otras personas solo pueden conceder permisos cuando el App Review otorga a su app el Advanced Access. El recorrido completo de acceso está en nuestra visión general de la API de Facebook, y su parte de Páginas en nuestra guía de la API de Páginas de Facebook.

Fuente: guía Manually Build a Login Flow de Meta (Graph API v27.0). Última verificación: 17 de noviembre de 2026.

Token de larga duración

Cómo obtener un access token de larga duración

Envíe el token de usuario de corta duración a GET /oauth/access_token con grant_type=fb_exchange_token, su App ID y su App Secret. La respuesta contiene un token de larga duración y su expires_in, unos 60 días. Meta es explícita: "Haga esta llamada desde su servidor, no desde un cliente".

  • Canjee antes de la caducidad. "No se puede usar un token caducado para solicitar un token de larga duración": cuando el token corto ha caducado, el usuario tiene que volver a iniciar sesión.
  • Guarde la caducidad como fecha junto al token.
  • ¿Solo pruebas? El Access Token Debugger tiene un botón Extend Access Token que hace lo mismo con un token propio.

El ciclo de vida del token en código

Las pestañas 1 a 3 usan la Graph API de Meta; la pestaña 4 es Unipile, sin token de Meta.

# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "grant_type=fb_exchange_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "fb_exchange_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "grant_type=client_credentials"

# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
  -d "input_token={LONG_LIVED_USER_TOKEN}" \
  -d "access_token={APP_ID}|{APP_SECRET}"

# Response (abridged)
{ "data": {
    "app_id": "{APP_ID}",
    "is_valid": true,
    "expires_at": 1800057600,
    "data_access_expires_at": 1802649600,
    "scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {API_KEY}"

# List the chats of the connected account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {API_KEY}"
200 OK · token de usuario de larga duración, unos 60 días
200 OK · nunca en código cliente ni en binarios
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · un account_id, ningún token que canjear

Solicitudes tomadas de las guías Long-Lived Access Tokens y Access Tokens de Meta. Unipile: documentación de Facebook Pages.

Tokens de Página, en resumen

Con el token de usuario de larga duración de un admin de la Página, GET /me/accounts devuelve cada Página con su propio token, que "no tiene fecha de caducidad y solo caduca o se invalida en determinadas condiciones". Más detalles en nuestra guía de la API de Páginas de Facebook; para publicar con uno, vea cómo publicar en una Página con su token.

Duración

¿Cuánto dura un token de acceso de Facebook?

Según Meta, un token de usuario de corta duración dura entre una y dos horas, y uno de larga duración unos 60 días. Los tokens de Página obtenidos a partir de un token de larga duración y algunos system user tokens no tienen fecha de caducidad. Por otro lado, su acceso a los datos de un usuario se detiene tras 90 días de inactividad.

Facebook Duración de los tokens, según Meta
Token de usuario de corta duración1 a 2 horas
Token de usuario de larga duraciónUnos 60 días
Token de Página, de un token de usuario de larga duraciónSin fecha de caducidad
System user tokenNunca, o 60 días
Acceso a los datos del usuario90 días tras la última actividad
La caducidad del token no es la del acceso a los datos

Meta indica que "el periodo de caducidad del acceso a los datos es de 90 días, según la última vez que el usuario estuvo activo". El usuario sigue con la sesión iniciada, pero su app no puede leer sus datos hasta que vuelva a autorizarla.

Ningún token es permanente: un token "que nunca caduca" deja de funcionar igualmente cuando el usuario elimina su app, cambia su contraseña o pierde su rol. Meta advierte: "No dependa de que estas duraciones se mantengan".

Fuentes: de Meta, Access Tokens, Long-Lived Access Tokens, Authorization vs. data access y system user tokens. Última verificación: 17 de noviembre de 2026.

System user

System user access tokens para procesos de servidor a servidor

Un system user access token pertenece a un usuario del sistema de su Business Manager, no a una persona. Según Meta, permite que "su app realice acciones programáticas y automatizadas sobre objetos de anuncios o Páginas". Se genera en la configuración del negocio (Business Settings).

Opción 1

Nunca caduca

Sin renovación, para los casos en que la filtración de un token es un riesgo aceptable.

Opción 2, recomendada

Caduca en 60 días

Defina set_token_expires_in_60_days=true y renuévelo con fb_exchange_token antes del día 60.

  • Solo la misma empresa. El usuario del sistema y la app pertenecen al mismo Business Manager, y "si el usuario no tiene acceso, la solicitud se rechaza".
  • Primero, acceso a la Marketing API: acceso estándar o superior.

Fuentes: de Meta, Install apps and generate tokens y Access Tokens. Última verificación: 17 de noviembre de 2026.

Depuración

Cómo verificar un token de acceso de Facebook con debug_token

Llame a GET /debug_token?input_token={TOKEN} con un token de acceso de app (o el token de usuario de un desarrollador de la app). Devuelve la validez, la caducidad, la caducidad del acceso a los datos y los permisos concedidos. Sin código, pegue el token en el Access Token Debugger (developers.facebook.com/tools/debug/accesstoken).

Facebook Lo que devuelve debug_token
is_validSi el token sigue funcionando.
expires_atCaducidad del token, como timestamp Unix; 0 significa sin fecha de caducidad.
data_access_expires_atCuándo termina el acceso a los datos, incluso con un token válido.
scopesPermisos concedidos; granular_scopes añade los IDs de destino.
app_id, user_idPara quién se emitió el token.
profile_idEl ID de la Página, para un token de Página.

Para comprobar si un token de acceso de Facebook es válido en producción, ejecute la solicitud de la pestaña 3 del bloque de código anterior en su servidor, de forma periódica, y guarde ambas fechas con cada token. Un permiso que falta en scopes explica la mayoría de los errores del tipo "a mí me funciona, a ellos no".

Fuente: referencia de debug_token de Meta (Graph API v27.0). Última verificación: 17 de noviembre de 2026.

Errores

Errores del token de acceso de Facebook: el código 190 y sus subcódigos

El error 190 significa que el token de acceso de Facebook ha caducado o no es válido. Llega como un OAuthException, y su error_subcode le indica qué pedir al usuario. Reintentar con el mismo token nunca lo soluciona.

Facebook Lo que devuelve la Graph API

{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }

190 Leer error_subcode, guardar fbtrace_id para el soporte de Meta
SubcódigoSignificadoQué hacer
458App no instaladaVolver a iniciar la sesión del usuario
459Usuario en checkpointEl usuario inicia sesión en facebook.com
460Contraseña cambiadaVolver a iniciar la sesión del usuario
463Token caducadoIniciar sesión y volver a canjear
464Usuario no confirmadoEl usuario inicia sesión en facebook.com
467Token no válidoVolver a conectar al usuario
492Sin rol adecuado en la PáginaNuevo token de un admin actual
Subcódigo 458
SignificadoApp no instalada
Qué hacerVolver a iniciar la sesión del usuario
Subcódigo 459
SignificadoUsuario en checkpoint
Qué hacerEl usuario inicia sesión en facebook.com
Subcódigo 460
SignificadoContraseña cambiada
Qué hacerVolver a iniciar la sesión del usuario
Subcódigo 463
SignificadoToken caducado
Qué hacerIniciar sesión y volver a canjear
Subcódigo 464
SignificadoUsuario no confirmado
Qué hacerEl usuario inicia sesión en facebook.com
Subcódigo 467
SignificadoToken no válido
Qué hacerVolver a conectar al usuario
Subcódigo 492
SignificadoSin rol adecuado en la Página
Qué hacerNuevo token de un admin actual

En un SaaS con muchos clientes, el 492 es el caso clásico: el admin que conectó una Página se marcha. Los demás códigos están en nuestra tabla de errores de la API de Facebook.

Fuente: guía Graph API error handling de Meta. Última verificación: 17 de noviembre de 2026.

Seguridad

Almacenar y proteger los tokens de acceso de Facebook

Trate cada token de acceso de Facebook como la contraseña de la cuenta que hay detrás: mantenga el App Secret y los tokens de app en su servidor, cifre en reposo los tokens de usuario y de Página, firme las llamadas de servidor con appsecret_proof y elimine los tokens en cuanto un cliente se desconecte.

  • Secretos solo en el servidor. Meta: "Nunca incluya tokens de acceso de app en el código del lado del cliente ni en los binarios de la app" y "Use los tokens de acceso de app solo en llamadas de servidor a servidor".
  • Los tokens de cliente son públicos. Meta señala que "no son secretos", así que nunca use uno para autorizar nada sensible.
  • Firme las llamadas con appsecret_proof. Meta lo define como "un hash sha256 de su access token, con su app secret como clave"; active Require App Secret en el panel de apps.
  • Cifrado en reposo, HTTPS en tránsito. Mantenga los tokens fuera de los logs y de las URLs.
  • Un registro por token. Guarde el usuario, la Página, la app y expires_at.
  • Purgue al desconectar. Elimine el token cuando un usuario se va.

Fuentes: guías Access Tokens y Securing Requests de Meta. Última verificación: 17 de noviembre de 2026.

Con Unipile

Olvídese de la gestión de tokens: conecte las cuentas de Facebook de sus usuarios

Con Unipile, cada usuario conecta su cuenta de Facebook una sola vez, mediante Hosted Auth. Las Páginas que gestiona llegan en el mismo account_id, y usted llama a la API con su propia clave (X-API-KEY). Sin token de Meta, sin app de Meta y sin App Review por su parte.

PreguntaAccess tokens de MetaCuenta conectada con Unipile
Qué guardaUn token por usuario, más uno por Página, admin y appUn account_id por usuario y una API key
Qué vigilaexpires_at y data_access_expires_at de cada tokenUn estado por Página en metadata.products_connection_status
Qué renuevaCanje de larga duración o inicio de sesión antes del día 60Ningún token de Meta que canjear
Ante el error 190Analizar el subcódigo y pedir al usuario que vuelva a iniciar sesiónEl usuario se vuelve a conectar mediante Hosted Auth si hace falta
Qué guarda
Tokens de MetaUn token por usuario, más uno por Página, admin y app
UnipileUn account_id por usuario y una API key
Qué vigila
Tokens de Metaexpires_at y data_access_expires_at de cada token
UnipileUn estado por Página en metadata.products_connection_status
Qué renueva
Tokens de MetaCanje de larga duración o inicio de sesión antes del día 60
UnipileNingún token de Meta que canjear
Ante el error 190
Tokens de MetaAnalizar el subcódigo y pedir al usuario que vuelva a iniciar sesión
UnipileEl usuario se vuelve a conectar mediante Hosted Auth si hace falta

Una cuenta conectada cubre mensajes, bandejas de las Páginas, publicaciones, comentarios y reacciones. Una Página puede responder a sus conversaciones y publicar, pero no puede iniciar una conversación. Vea la pestaña 4 más arriba y nuestra página de la API de Facebook Messenger.

Cumplimiento

Cada usuario conecta su propia cuenta

Unipile es una empresa independiente, no una app oficial de Meta ni un Meta Partner. Actúa en nombre de cada usuario autenticado, y cada usuario sigue sujeto a las condiciones de Meta.

Desarrolle sobre Facebook sin gestionar tokens

Cada usuario vincula su cuenta de Facebook una sola vez; usted usa una única API para Facebook, LinkedIn, WhatsApp y email. Prueba gratuita de 7 días.

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

Una vez conectada la cuenta, consulte todos los endpoints de Facebook disponibles con Unipile o lea la guía completa de la API de Facebook para los permisos, los límites y los errores.

Preguntas frecuentes sobre el token de acceso de la API de Facebook

Respuestas rápidas sobre la duración de los tokens, su renovación, la comprobación de validez, el almacenamiento y el error 190.

No realmente. Un token de usuario de larga duración dura unos 60 días. Los tokens de Página derivados de él y algunos system user tokens no tienen fecha de caducidad, pero dejan de funcionar igualmente cuando el usuario elimina su app, cambia su contraseña o pierde su rol. Prevea un flujo de reconexión.

No en el sentido de OAuth: Meta no documenta ningún grant refresh_token para Facebook Login. Usted canjea un token de corta duración válido con fb_exchange_token; cuando un token caduca, el usuario vuelve a iniciar sesión. En las apps móviles nativas, Meta renueva los tokens de larga duración una vez al día cuando la persona usa su app.

Porque 60 días es un máximo, no una promesa. Un token deja de funcionar antes cuando el usuario cambia su contraseña, elimina su app, se topa con un control de seguridad o pierde su rol en la Página, y Meta advierte de que las duraciones "pueden cambiar sin previo aviso o caducar antes". Lea el error_subcode del error 190 para saber en qué caso está.

Llame a GET /debug_token?input_token={TOKEN} con su token de acceso de app y lea is_valid, expires_at, data_access_expires_at y scopes. Para una comprobación puntual, pegue el token en el Access Token Debugger de Meta.

Sí, si los trata como contraseñas: cífrelos en reposo, manténgalos fuera de los logs y del código cliente, y use el App Secret y los tokens de app solo en llamadas de servidor a servidor. Firme las llamadas de servidor con appsecret_proof.

El error 190 con el subcódigo 492 indica una sesión no válida: el usuario detrás de un Page access token ya no tiene un rol adecuado en la Página. Obtenga un nuevo token de Página de un admin actual.

No. Unipile es una empresa independiente: no es Meta Partner ni una app oficial de Meta, y no está respaldada, patrocinada ni aprobada por Meta. Facebook es una marca de Meta Platforms, Inc.

No. Usted llama a Unipile con su API key y el account_id de cada usuario conectado. Los usuarios vinculan su cuenta de Facebook y las Páginas que gestionan mediante la autenticación alojada de Unipile: sin app de Meta, App Secret ni App Review por su parte.

Está diseñada de acuerdo con la Digital Markets Act: cada usuario conecta su propia cuenta, y Unipile actúa en su nombre sin almacenar perfiles de usuario. Más información en nuestra página sobre la Digital Markets Act.

Sí. Cada cuenta conectada sigue sujeta a las Condiciones del servicio de Meta. Use la API para casos legítimos como la atención al cliente, el CRM y las conversaciones directas; el spam y la automatización no autorizada pueden provocar la restricción de las cuentas.

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

Hable con un experto