Por qué una conexión con la API de Instagram deja de funcionar y cómo mantenerla activa
Una conexión con la API de Instagram deja de funcionar cuando Meta ya no acepta su token o la cuenta deja de cumplir los requisitos: un token de larga duración sin renovar durante 60 días, un cambio de contraseña, un permiso o la app completa eliminados por el propietario, un cambio a cuenta personal o una restricción en la cuenta. Cada caso devuelve su propio error, y la mayoría se resuelve con el propietario iniciando sesión de nuevo.
easyCoexistence vigila cada conexión de Instagram las 24 horas: renueva el token mucho antes de que se cumplan los 60 días, revisa la cuenta cada 6 horas, le envía un correo una sola vez cuando Meta rechaza el acceso y notifica a las plataformas con channel.disconnected, de modo que una conexión caída vuelve con un solo inicio de sesión.
Los tokens de Instagram no renovados en 60 días vencen y ya no pueden renovarse.
Subcódigo de la Graph API, bajo el código 190, para una sesión terminada por un cambio de contraseña; la persona vuelve a iniciar sesión.
De las entregas fallidas de webhooks de mensajería, antes de que Meta las desactive y desvincule la app de la cuenta.
Meta puede retirar el acceso de una app a permisos o funciones que no haya usado en un período de 28 días.
Cada cuánto revisa easyCoexistence cada cuenta de Instagram conectada, renovando su token bien antes de que se agoten los 60 días.
¿Por qué deja de funcionar una conexión con la API de Instagram?
Porque Meta deja de aceptar el token, o la cuenta deja de cumplir los requisitos para la API. La documentación de Meta enumera las causas, cada una con lo que devuelve la API y el paso que restablece el acceso. La mayoría aparece primero como una llamada fallida, por eso los controles más abajo las buscan de forma programada:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A new sign-in, if the owner wants it back |
| Switched to a personal account | (#10) Access is denied because the instagram account type is not business or creator. | Back to Business or Creator, then a new sign-in |
| Allow access to messages off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A working endpoint, then a new subscription |
¿Cuándo vence un token y cuándo aún puede renovarse?
Con Instagram Login, un token de larga duración dura 60 días desde su última renovación. Una renovación con grant_type=ig_refresh_token le da otros 60 días, siempre que tenga al menos 24 horas, no haya vencido y el propietario haya concedido instagram_business_basic. Pasados los 60 días, las llamadas fallan con el código 190 y solo ayuda un nuevo inicio de sesión. Con Unified Login, la configuración define si el token vence.
¿Qué hacen un cambio de contraseña y un permiso retirado?
Un cambio de contraseña puede terminar la sesión a la que pertenece el token: la guía de errores de la Graph API de Meta lo informa como código 190 con subcódigo 460 e indica que la persona debe iniciar sesión de nuevo en la app. Un permiso que nunca se concedió o que ha sido retirado devuelve el código 10, o un código del 200 al 299; en los DM, el código 200 con subcódigo 2534041 significa que el propietario desactivó el acceso a los mensajes. Las Condiciones de la Plataforma de Meta también le permiten retirar el acceso de una app a un permiso o función no usado durante 28 días.
¿Qué ocurre cuando el propietario elimina la app?
Su acceso a datos no públicos termina. El propietario elimina la app en Instagram en Website permissions, Apps and websites, Active, y Meta llama a la URL de callback de desautorización guardada en la configuración de inicio de sesión comercial de la app. El Centro de ayuda de Instagram indica que, a partir de ahí, una app eliminada solo puede acceder a la información pública de la cuenta, de modo que la conexión termina hasta que el propietario vuelva a iniciar sesión.
¿Qué ocurre cuando la cuenta cambia de tipo o recibe una restricción?
Cualquiera de los dos la saca de lo que atiende la API. La API de Meta funciona solo con cuentas profesionales, y la tabla de solución de problemas de Unified Login da el mensaje (#10) Access is denied because the instagram account type is not business or creator para una cuenta cambiada a personal; el propietario vuelve a cambiarla y luego la conecta de nuevo. Una cuenta restringida, inactiva o con checkpoint devuelve el código 25 con subcódigo 2207050, que el propietario resuelve en la app de Instagram.
¿Cómo dejan de llegar los webhooks?
A través de un endpoint que falla. Meta reintenta una notificación de Instagram durante hasta 36 horas, pero las entregas de mensajería son más estrictas: tras 15 minutos de fallos se envía una alerta a la cuenta de desarrollador, y tras una hora Meta envía una alerta de Webhooks Disabled y desvincula la app de la cuenta. Cuando el endpoint vuelve a funcionar, POST /<IG_ID>/subscribed_apps con los mismos campos reactiva las notificaciones.
¿Cómo se detecta una caída antes que los usuarios?
Revisando la conexión de forma programada en lugar de esperar a que falle una publicación:
- Guarde
expires_inde cada intercambio y renovación de token, y renueve mucho antes del día 60, una vez que el token tenga un día. - Haga una llamada autenticada barata de forma programada, como GET /me?fields=
user_id,username, y trate el código 190 o 102 como una necesidad de reconexión. - Implemente la URL de callback de desautorización, para que una eliminación desde la configuración de Instagram le llegue de inmediato.
- Lea las Developer Alerts y el correo comercial de la app, donde Meta envía avisos de webhooks y revisiones.
- Registre el código, el subcódigo y el
fbtrace_idde cada error por cuenta, para distinguir una restricción de una petición incorrecta.
¿Cómo se reconecta cada caso?
La mayoría de las causas terminan en el mismo paso, un nuevo inicio de sesión por parte del propietario de la cuenta, que emite un código y un token nuevos. Las excepciones son ajustes que el propietario cambia en la app de Instagram:
- Token vencido, cambio de contraseña, app o permiso eliminados: envíe al propietario otra vez por el inicio de sesión y que apruebe los permisos.
- Cuenta personal: cámbiela a Business o Creator en la app de Instagram y luego inicie sesión de nuevo.
- Mensajes desactivados: active Allow access to messages en Herramientas conectadas; no hace falta un nuevo inicio de sesión.
- Cuenta restringida: complete lo que pide la app de Instagram; un nuevo inicio de sesión no cambia nada.
- Webhooks desactivados: corrija el endpoint y luego vuelva a suscribir la cuenta.
¿Qué hace easyCoexistence para mantener viva una conexión?
Vigila cada cuenta de Instagram conectada las 24 horas. Renueva el token cuando quedan menos de 20 de sus 60 días, revisa la cuenta cada 6 horas con GET /me y marca la conexión para reconectar en cuanto Meta rechaza el token, ya sea en esa comprobación o en una llamada de herramienta. Responde de inmediato a las entregas de webhooks de Meta y las reenvía después, y cuando el propietario elimina la app en la configuración de Instagram, el callback de desautorización de Meta termina la conexión y la quita de la facturación.
¿Cómo le avisa easyCoexistence y cómo se reconecta?
Una sola vez, por correo, indicando la cuenta, con un botón a la página del canal; las plataformas reciben además un evento firmado channel.disconnected. Mientras el propietario no actúe, list_social_accounts muestra el estado y el último error de Meta, y las herramientas responden que la cuenta necesita reconectarse. Reconectar es un solo inicio de sesión con la misma cuenta de Instagram, que reactiva la misma conexión con sus ajustes.
Errores comunes
- Renovar un token solo después de que falle una llamada. Una vez vencido, Meta rechaza la renovación, así que programe las renovaciones mientras siga siendo válido.
- Enviar una cuenta restringida de vuelta por el inicio de sesión. El código 25 con subcódigo 2207050 describe el estado de la cuenta, que el propietario corrige en la app de Instagram.
- Dejar sin configurar la URL de callback de desautorización. Una eliminación desde la configuración de Instagram entonces solo aparece cuando falla la siguiente llamada.
- Corregir un endpoint fallido y esperar. Tras una alerta de Webhooks Disabled, las notificaciones siguen desactivadas hasta que la cuenta vuelva a suscribirse con POST /<IG_ID>/subscribed_apps.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añade conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Usar un token de Instagram evita que venza?
No. Solo una renovación extiende un token de larga duración, y uno que pasa 60 días sin renovarse vence aunque se haya usado con frecuencia.
¿Instagram elimina una app comercial tras 90 días sin uso?
No. El Centro de ayuda de Instagram indica que las apps con permisos para gestionar cuentas comerciales y de creadores no vencen tras 90 días de inactividad.
¿Una cuenta desconectada sigue contando en la factura de easyCoexistence?
Sí, hasta que la reconecte o la elimine. Una cuenta cuyo propietario eliminó la app desde la configuración de Instagram sale del recuento en cuanto Meta informa la eliminación.
¿Cuánto cuesta a easyCoexistence monitorizar una cuenta de Instagram?
La monitorización viene con cada conexión: de US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añade conexiones, 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