
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
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.
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationSu appis_validtrueexpires_aten 60 díastoken de usuario de larga duracióndata_access_expires_aten 90 díasse renueva si el usuario está activoscopesSin refresh token: verificar y volver a iniciar sesión
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.
Ningún token de Meta que obtener, extender ni depurar
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.
Llamar con su clave de API
Envíe X-API-KEY con el account_id del usuario: GET /v2/{ACCOUNT_ID}/chats.
Vigilar un solo estado
Compruebe products_connection_status; si hace falta, el usuario se vuelve a conectar mediante Hosted Auth.
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.
| Token | Actúa en nombre de | Cómo se obtiene | Duración y uso |
|---|---|---|---|
| Usuario | Una persona con sesión iniciada | Facebook Login o Graph API Explorer | 1 a 2 horas, o unos 60 días |
| Página | Una Página de Facebook | /me/accounts con el token de usuario de un admin | Sigue a su token de usuario |
| App | Su app de Meta | Llamada client_credentials, o {APP_ID}|{APP_SECRET} | Solo llamadas de servidor a servidor |
| System user | Su empresa | Configuración del negocio | Sin caducidad, o 60 días |
| Cliente | Su app, en código cliente | Panel de apps | No es secreto |
/me/accounts con el token de usuario de un adminclient_credentials, o {APP_ID}|{APP_SECRET}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.
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.
developers.facebook.com/tools/explorer/dialog/oauth con client_id, redirect_uri, statecode/oauth/access_token con el code y el App SecretLa 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.
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".
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}"
Solicitudes tomadas de las guías Long-Lived Access Tokens y Access Tokens de Meta. Unipile: documentación de Facebook Pages.
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.
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.
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.
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).
Sin renovación, para los casos en que la filtración de un token es un riesgo aceptable.
Defina set_token_expires_in_60_days=true y renuévelo con fb_exchange_token antes del día 60.
Fuentes: de Meta, Install apps and generate tokens y Access Tokens. Última verificación: 17 de noviembre de 2026.
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).
0 significa sin fecha de caducidad.granular_scopes añade los IDs de destino.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.
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.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
Leer error_subcode, guardar fbtrace_id para el soporte de Meta
| Subcódigo | Significado | Qué hacer |
|---|---|---|
| 458 | App no instalada | Volver a iniciar la sesión del usuario |
| 459 | Usuario en checkpoint | El usuario inicia sesión en facebook.com |
| 460 | Contraseña cambiada | Volver a iniciar la sesión del usuario |
| 463 | Token caducado | Iniciar sesión y volver a canjear |
| 464 | Usuario no confirmado | El usuario inicia sesión en facebook.com |
| 467 | Token no válido | Volver a conectar al usuario |
| 492 | Sin rol adecuado en la Página | Nuevo 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.
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.
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.expires_at.Fuentes: guías Access Tokens y Securing Requests de Meta. Última verificación: 17 de noviembre de 2026.
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.
| Pregunta | Access tokens de Meta | Cuenta conectada con Unipile |
|---|---|---|
| Qué guarda | Un token por usuario, más uno por Página, admin y app | Un account_id por usuario y una API key |
| Qué vigila | expires_at y data_access_expires_at de cada token | Un estado por Página en metadata.products_connection_status |
| Qué renueva | Canje de larga duración o inicio de sesión antes del día 60 | Ningún token de Meta que canjear |
| Ante el error 190 | Analizar el subcódigo y pedir al usuario que vuelva a iniciar sesión | El usuario se vuelve a conectar mediante Hosted Auth si hace falta |
account_id por usuario y una API keyexpires_at y data_access_expires_at de cada tokenmetadata.products_connection_statusUna 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.
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.
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.
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