Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Errores de la API de Instagram: qué significan los códigos comunes

Los errores más comunes de la API de Instagram son: 190, para un token de acceso vencido o no válido; 4, 17 y 80002, para límites de tasa; 9004, para contenido multimedia que Meta no puede obtener; 9007, para un video que todavía se está procesando; 9, para el límite diario de publicación; y 10 con subcódigo 2534022, para un DM fuera de la ventana de mensajería. Cada uno llega como JSON con un código, a menudo un subcódigo que indica el caso exacto, y un mensaje.

easyCoexistence se encarga del lado de la conexión de estos errores: renueva el acceso a Instagram antes de que expire, revisa la cuenta cada 6 horas y te envía un correo cuando hay que volver a conectarla.

190

Código de la API Graph para un token de acceso vencido, revocado o no válido de otro modo.

80002

Código de error del límite de Business Use Case de Instagram.

2207042

Subcódigo, bajo el código 9, para una cuenta que alcanzó su límite diario de publicación en la API.

2207052

Subcódigo, bajo el código 9004, para contenido multimedia que Meta no pudo obtener de la URL indicada.

2534041

Subcódigo, bajo el código 200, cuando la cuenta desactivó el acceso a sus mensajes de Instagram.

¿Cómo se lee un error de la API de Instagram?

Cada error es un objeto JSON dentro de error. code es la categoría general, error_subcode indica el caso específico y suele ser el más útil de los dos, y message lo describe. Muchos errores también incluyen error_user_title y error_user_msg, texto dirigido a la persona, e is_transient. fbtrace_id identifica la petición ante el soporte de Meta y expira pronto, así que regístralo cuando ocurra el error.

¿Qué significan los errores de acceso y permisos?

Errores sobre quién puede hacer qué, con la solución para cada uno:

  • 190: el token de acceso venció, fue revocado o no es válido de otro modo; el subcódigo 463 indica vencido, 467 no válido y 460 un cambio de contraseña. Un token nuevo lo soluciona, lo que en el caso de una cuenta conectada significa volver a conectarla.
  • 10: permiso denegado. Un permiso nunca se concedió o se quitó después.
  • 200 a 299: falta un permiso específico, por ejemplo el 200 con subcódigo 2534041 cuando la cuenta desactivó el acceso a sus mensajes.
  • 25, subcódigo 2207050: la cuenta está restringida, inactiva o en verificación de seguridad; el titular debe iniciar sesión en la app de Instagram y completar lo que se le pide.

¿Qué significan los errores de límite de tasa?

Restricción de velocidad, y toda es temporal:

  • 4: demasiadas llamadas desde la app; espera y reintenta, o reduce el volumen de peticiones.
  • 17: demasiadas llamadas para el usuario; aplica la misma solución.
  • 80002: el límite de Business Use Case de Instagram, calculado por app y cuenta a partir de las impresiones de la cuenta: 4,800 llamadas por impresión en 24 horas.
  • 613, subcódigo 2534040: demasiadas llamadas de mensajería; pausa y vuelve a intentarlo más tarde.

¿Qué significan los errores de publicación relacionados con el contenido multimedia?

Errores sobre el archivo y el lugar donde está alojado; solo el de tiempo de espera vale la pena reintentarlo sin cambios:

  • 9004, subcódigo 2207052: Meta no pudo obtener el contenido multimedia desde la URL; asegúrate de que sea válida y pública.
  • -2, subcódigo 2207003: la descarga tardó demasiado; este sí vale la pena reintentarlo.
  • 36000, subcódigo 2207004: la imagen supera los 8 MB.
  • 36001, subcódigo 2207005: el formato de imagen no es compatible; usa JPEG.
  • 36003, subcódigo 2207009: la relación de aspecto está fuera del rango de 4:5 a 1.91:1.
  • 352, subcódigo 2207026: el formato de video no es compatible; usa MOV o MP4.

¿Qué significan los errores de publicación relacionados con el momento y los límites?

Errores sobre cuándo y cuánto, la mayoría se resuelve esperando o empezando de nuevo:

  • 9007, subcódigo 2207027: el contenido multimedia no está listo; espera hasta que status_code del contenedor diga FINISHED.
  • 24, subcódigo 2207008: el contenedor no existe o expiró; reintenta una o dos veces entre 30 segundos y 2 minutos, y luego crea uno nuevo.
  • -2, subcódigo 2207020: el contenido multimedia expiró; crea un contenedor nuevo.
  • 9, subcódigo 2207042: la cuenta alcanzó su límite diario de publicación; vuelve a intentarlo al día siguiente.
  • 100, subcódigo 2207028: un carrusel necesita de 2 a 10 elementos.
  • 36004, subcódigo 2207010: la descripción es demasiado larga; los límites de Meta son 2,200 caracteres y 20 etiquetas @, y su referencia enumera 30 hashtags, aunque Instagram permite 5 en una publicación.
  • 4, subcódigo 2207051: Instagram restringió la acción por sospecha de spam.

¿Qué significan los errores de mensajería?

Errores de los DM y de las respuestas privadas:

  • 10, subcódigo 2534022: el mensaje se envió fuera de la ventana permitida; espera a que la persona vuelva a escribir.
  • 100, subcódigo 2534014: no existe un usuario de Instagram coincidente; usa el ID con alcance de Instagram del webhook, no un ID de usuario de Instagram.
  • 100, subcódigo 2534025: el comentario no admite una respuesta privada.
  • 100, subcódigo 2534037: otra app, incluida Business AI de Meta, controla la conversación.
  • 551, subcódigo 1545041: la persona no está disponible en este momento.

¿Qué significan los errores de estadísticas?

Las peticiones de estadísticas fallan de tres formas documentadas:

  • 10, cuando no hay suficientes espectadores para que el contenido muestre estadísticas: una métrica de historia por debajo de 5.
  • Una métrica retirada, como las impresiones desde el 21 de abril de 2025, devuelve un error; pide vistas en su lugar.
  • Un error desconocido cuando una de varias métricas solicitadas no admite el desglose pedido.

¿Qué errores vale la pena reintentar?

Solo los temporales: los códigos 1 y 2, los errores del servidor de Instagram 2207001 y 2207032, el tiempo de espera de descarga 2207003, el 2207008 transitorio, y los límites de tasa una vez cumplida la espera. Los demás devuelven la misma respuesta hasta que algo cambie, ya sea el archivo, la URL, un permiso, el estado de la cuenta o la ventana de la persona, y reintentarlos solo gasta el límite de tasa.

Errores comunes

  • Reintentar un error de formato o tamaño. 2207004, 2207005, 2207009 y 2207026 fallan igual hasta que cambie el contenido multimedia.
  • Tratar el 9007 como un fallo. El video todavía se está procesando; publica cuando el contenedor diga FINISHED.
  • Leer solo el código. Códigos como 10 y 100 cubren muchos casos, y el subcódigo es lo que identifica este.
  • Quitar fbtrace_id de los registros. El soporte de Meta lo pide, y expira poco después del error.
Hacerlo con EasyCoexistence

Claude, ChatGPT o tu propio código luego llaman a la API oficial de Meta con un token que se mantiene actualizado. De US$ 9 a US$ 0.75 por conexión al mes, con una baja a medida que agregas conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Qué significa el error 190 en Instagram?

El token de acceso venció, fue revocado o no es válido de otro modo, por ejemplo tras un cambio de contraseña. Un token nuevo lo soluciona, y en el caso de una cuenta conectada eso significa volver a conectarla.

¿Por qué falla la publicación con el 9004?

Meta no pudo obtener el contenido multimedia desde la URL indicada, subcódigo 2207052. Comprueba que el enlace sea válido y público, sin inicio de sesión delante, en el momento en que se publica.

¿Qué es el error 9007?

El video del contenedor todavía se está procesando, subcódigo 2207027. Revisa el status_code del contenedor y publica cuando diga FINISHED.

¿Qué es fbtrace_id en un error de la API de Instagram?

Un identificador de la petición fallida, que el soporte de Meta pide al reportar un problema. Expira poco después del error, así que escríbelo en tus registros en ese momento.

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