Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Por qué una conexión con la API de Página de Facebook deja de funcionar y cómo mantenerla activa

Una conexión con Página de Facebook deja de funcionar cuando Meta deja de aceptar su token o de enviar sus eventos: el token provenía de un inicio de sesión de corta duración, la persona cambió su contraseña (error 190, subcódigo 460), perdió su rol en la Página (492) o eliminó la app en Integraciones comerciales (458), un permiso no se usó durante 90 días, la app quedó inactiva o Meta restringió la Página.

easyCoexistence toma el token de cada Página desde un inicio de sesión de larga duración, verifica la Página cada 6 horas y te envía un correo cuando Meta rechaza el token, y un solo inicio de sesión de Facebook trae la Página de vuelta como la misma conexión, con sus reglas de comentarios y automatizaciones.

Hours

Tiempo de vida de los tokens predeterminados de usuario y de Página de Meta; un token de Página obtenido a partir de un token de usuario de larga duración no tiene fecha de vencimiento.

90 days

Si durante este tiempo no hay inicios de sesión, llamadas a la API ni webhooks, Meta considera inactiva a una app e invalida todos sus tokens.

Exempt

Los permisos de Página como pages_manage_posts y read_insights no vencen con el período de acceso a datos de 90 días.

page_messaging_api

La restricción de Page Integrity que impide que una Página envíe mensajes a través de la API de Messenger Platform.

6 hours

Con qué frecuencia easyCoexistence verifica cada Página conectada con una llamada ligera a Graph, y envía un correo electrónico al titular si Meta rechaza el token.

¿Qué puede hacer que una conexión con Página deje de funcionar?

Hay causas en cuatro niveles: el inicio de sesión de la persona, los permisos y el estado de la app, la propia Página y la suscripción del webhook. Cada una se manifiesta de forma distinta, y la mayoría devuelve el error 190 con un subcódigo que indica la causa:

Short-lived sign-in190, subcode 463: the Page token expired with the user token it came from
Password change or logout190, subcode 460
Account checkpoint190, subcode 459 or 464: the person must log in at facebook.com
Role removed from the Page190, subcode 492
App removed in Business integrations190, subcode 458, and a call to the deauthorize callback
Permission unused for 90 daysCode 10, or one from 200 to 299, on the calls that need it
App inactive for 90 daysAll of the app's tokens invalidated
Page restricted368, or 10 with subcode 1893063 for messages
Webhooks failing for an hourThe app unsubscribed from the Page's events

¿Por qué un token de Página podría vencer en horas?

Porque se leyó desde /me/accounts con un token de usuario de corta duración, y entonces también es de corta duración. Los tokens predeterminados de usuario y de Página de Meta vencen en horas, alrededor de una o dos para un token de corta duración. Si se intercambia en el servidor con fb_exchange_token, el token de usuario dura unos 60 días, y un token de Página leído con él no tiene fecha de vencimiento. Meta no extiende un token que ya venció: el error dice Session has expired, con subcódigo 463, y la persona debe iniciar sesión de nuevo.

¿Qué ocurre después de un cambio de contraseña o de una verificación de seguridad?

Meta invalida los tokens de la persona. Un cierre de sesión o un cambio de contraseña devuelve el error 190 con subcódigo 460, The session is invalid because the user logged out, y Meta advierte que los eventos de seguridad pueden invalidar tokens antes de su vencimiento previsto. Los subcódigos 459 y 464 indican que la cuenta misma necesita atención: la persona debe iniciar sesión en facebook.com para corregir un problema y luego volver a iniciar sesión en la app. De lo contrario, la solución es un nuevo inicio de sesión, por esa persona o por otra con un rol en la Página.

¿Qué ocurre cuando la persona pierde su rol en la Página?

Su token de Página deja de funcionar con el error 190, subcódigo 492, que Meta describe como que el usuario asociado con el token de acceso a la Página ya no tiene un rol adecuado en ella. Los tokens se emiten por Página, persona y app, así que los tokens de otras personas con un rol siguen funcionando. La solución es volver a conectar la Página desde una cuenta que aún tenga control total o acceso a tareas, idealmente una que no vaya a dejar la empresa pronto.

¿Qué ocurre cuando alguien elimina la app en Integraciones comerciales?

Meta invalida los tokens de acceso de usuario que la app tenía para esa persona, y los tokens de Página leídos con ellos también dejan de funcionar, con el error 190, subcódigo 458: the user has not authorized the application. Las personas eliminan una app en la configuración de Facebook, en Integraciones comerciales, y Meta entonces llama al callback de desautorización de la app. Un token de usuario del sistema se finaliza de la misma forma desde Business Manager, en Configuración de empresa, Integraciones, Apps conectadas, y una app puede terminar su propio acceso con DELETE /{user-id}/permissions.

¿Vencen los permisos de Página después de 90 días?

Existen dos reglas distintas de 90 días, y solo una alcanza a los permisos de Página. El vencimiento del acceso a datos, que corta el acceso de una app 90 días después de la última actividad de la persona, no se aplica a pages_show_list, pages_manage_posts, pages_messaging, read_insights ni a los demás permisos de Página que Meta indica que no vencen. El vencimiento de permisos sí se aplica: un permiso que la app no ha usado durante 90 días puede vencer, incluso uno aprobado en App Review, y la persona debe concederlo de nuevo. Las llamadas que lo necesitan fallan con el código 10 o uno del rango 200 hasta que un nuevo inicio de sesión lo conceda.

¿Puede la app entera perder el acceso?

Sí, de tres formas documentadas, que Meta advierte con una notificación urgente en la bandeja de alertas del App Dashboard. Una app sin inicios de sesión, sin llamadas a la Graph API o a la Marketing API y sin notificaciones de webhook durante 90 días se considera inactiva, y Meta invalida todos sus tokens; restaurarla desde el App Dashboard la actualiza a la última versión, pero los tokens antiguos siguen inválidos y los permisos retirados por desuso deben pasar de nuevo por App Review. Hay que completar la Data Use Checkup anual, y incumplir las condiciones o políticas de Meta puede limitar el acceso a la API o revocar permisos.

¿Qué ocurre cuando Meta restringe la Página?

Las acciones restringidas fallan: error 368, temporarily blocked for policy violations, o para mensajes el código 10 con subcódigo 1893063. La Page Integrity API de Meta indica cuál: GET /{page-id}/page_status, con pages_manage_metadata, devuelve un estado de ok, warning, restricted o suspended, cada restricción activa, como page_publish, page_read_only, page_messaging o page_messaging_api, con su expiration_time, y acciones recomendadas como FILE_APPEAL. El campo de webhook business_integrity informa los cambios en el momento en que ocurren.

¿Por qué dejan de llegar eventos mientras las llamadas a la API siguen funcionando?

Porque los webhooks fallan según sus propias reglas. Después de una hora de entregas fallidas, Meta envía una alerta de Webhooks Disabled y desuscribe la app de la Página hasta que vuelva a suscribirse, y no envía nada en absoluto a una Página que haya desactivado la plataforma de App en su configuración de app. El token puede seguir siendo válido en ambos casos, así que después de una caída revisa GET /{page-id}/subscribed_apps y, cuando el endpoint vuelva a responder, haz un POST a él con el token de la Página.

¿Cómo detectas una conexión rota antes de que falle una publicación?

Verificando con una programación, ya que Meta no notifica a una app cuando un token deja de ser válido. Una llamada ligera como GET /{page-id}?fields=id,name con el token de Página falla igual que fallaría una publicación. debug_token, llamado con el ID y el secreto de la app como token de acceso, devuelve is_valid, expires_at y los scopes concedidos, además del código de error y el subcódigo de un token que ya no funciona; page_status informa las restricciones, y el callback de desautorización anuncia una app eliminada.

Inspect a Page token with debug_token
curl -G "https://graph.facebook.com/v26.0/debug_token" \
  --data-urlencode "input_token=$PAGE_TOKEN" \
  --data-urlencode "access_token=$APP_ID|$APP_SECRET"

# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops working

¿Cómo reconectas una Página?

Con el mismo flujo que la conectó, ejecutado por alguien que aún tenga un rol en la Página, después de corregir la causa cuando la hay: una cuenta con checkpoint inicia sesión en facebook.com, una restricción se resuelve con su acción recomendada, y un endpoint que falla vuelve a responder 200. El nuevo inicio de sesión devuelve nuevas cadenas de token, así que reemplaza las almacenadas en lugar de conservar ambas:

1Fix the causeCheckpoint, restriction or endpoint first
2Sign in againFacebook Login for Business, code exchanged on the server
3Long-lived tokenfb_exchange_token, about 60 days
4New Page tokenRead /me/accounts and replace the stored one
5Subscribe againPOST /{page-id}/subscribed_apps if events had stopped

¿Qué hace easyCoexistence cuando se rompe una conexión con Página?

Vigila las roturas que puede ver y te avisa. Cada 6 horas verifica cada Página conectada con GET /{page-id}?fields=id,name, y cuando Meta rechaza el token con el error 190 o 102, en esa verificación o en cualquier llamada de herramienta, la Página se marca como Requiere reconexión, su titular recibe un único correo electrónico y una plataforma asociada recibe channel.disconnected. Otros rechazos, como un permiso faltante o un bloqueo por política, llegan en el resultado de la herramienta con el código y el mensaje de Meta.

Cuando alguien elimina la app en Integraciones comerciales, el callback de desautorización de Meta llega a easyCoexistence, que quita las Páginas que esa persona conectó, borra sus tokens y destinos de eventos, las excluye de la facturación y envía channel.removed. Volver a iniciar sesión desde el panel trae una Página de vuelta como la misma conexión, con sus reglas de comentarios y automatizaciones, suscrita de nuevo a feed, messages y mention. Tras el estado Requiere reconexión, el destino de eventos también se mantiene; después de una eliminación, set_social_webhook_destination lo vuelve a configurar con un nuevo secreto.

Errores comunes

  • Reintentar el error 190. Un token rechazado falla igual en cada llamada, y solo un nuevo inicio de sesión de alguien con un rol en la Página produce uno válido.
  • Reconectar para levantar una restricción. Un token nuevo deja el estado de la Página como estaba; lo que cambia es la acción recomendada en page_status, como una apelación.
  • Solicitar un permiso que el producto usa poco. Si no se usa durante 90 días puede vencer, y las llamadas que lo necesitan fallan; pídelo cuando salga la función.
  • Conservar el token antiguo tras reconectar. El nuevo inicio de sesión devuelve una cadena de token distinta, y un proceso que aún tenga la anterior seguirá fallando con 190.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, con descenso a medida que agregas conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Deja un token de Página de funcionar cuando vence el token de usuario de 60 días?

No, si se leyó desde /me/accounts con ese token de usuario de larga duración: un token de Página así no tiene fecha de vencimiento, aunque las causas de esta página aún pueden terminarlo.

¿Me avisará Meta cuando un token de Página deje de funcionar?

No en el caso de un token que se invalida: la siguiente llamada devuelve el error. Meta sí llama al callback de desautorización de la app cuando alguien la elimina, y advierte de riesgos para toda la app en la bandeja de alertas del App Dashboard.

¿Puede el token de otra persona mantener la Página conectada?

Sí. Los tokens de Página se emiten por Página, persona y app, así que un token de alguien más que aún tenga un rol en la Página sigue funcionando cuando termina el acceso de una persona.

¿Cuánto cuesta easyCoexistence para una Página de Facebook?

De US$ 9 a US$ 0.75 por conexión al mes, según cuántas conexiones tengas, contando cada Página como una y con los primeros 3 días gratis.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el