Estado del contenedor de medios de Instagram: códigos y ciclo de vida
La API de Instagram publica a través de contenedores de medios, y cada uno informa un status_code: IN_PROGRESS mientras sigue en el proceso de publicación, FINISHED cuando está listo, PUBLISHED una vez en línea, ERROR si no logró completarse y EXPIRED si pasaron 24 horas sin publicarse. Meta recomienda consultarlo una vez por minuto, durante no más de 5 minutos.
easyCoexistence ejecuta el ciclo del contenedor dentro de publish_instagram_post: crea el contenedor, espera a que Instagram termine y publica; mientras un video sigue procesándose, termina de publicar por sí sola.
Valores que puede tomar status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR y EXPIRED.
Tiempo que un contenedor puede esperar sin publicarse antes de que su estado pase a EXPIRED.
Intervalo sugerido por Meta entre consultas de estado, por no más de 5 minutos.
Contenedores que una cuenta de Instagram puede crear en un periodo móvil de 24 horas.
Subcódigo de error, dentro del código 9007, por publicar un contenedor que aún no está listo.
¿Qué es un contenedor de medios?
El objeto desde el que se publica una publicación. POST /<IG_ID>/media crea uno a partir de la URL de una imagen o video; Meta descarga y prepara el medio, y POST /<IG_ID>/media_publish con el ID del contenedor como creation_id lo convierte en una publicación. Un carrusel añade un nivel: un contenedor por elemento y luego un contenedor CAROUSEL que los enumera como hijos.
¿Qué significa cada código de estado?
GET /<IG_CONTAINER_ID>?fields=status_code devuelve uno de cinco valores, cada uno con su propio siguiente paso:
IN_PROGRESS: el contenedor sigue en el proceso de publicación; espera y vuelve a consultar.- FINISHED: el contenedor y sus medios están listos; publícalo.
- PUBLISHED: el medio ya está en línea; no queda nada por publicar.
- ERROR: el contenedor no logró completar el proceso de publicación; el campo status contiene un subcódigo de error con el motivo, y hace falta un contenedor nuevo.
- EXPIRED: no se publicó en 24 horas; crea uno nuevo.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}¿Con qué frecuencia debe consultarse el estado?
Una vez por minuto, durante no más de 5 minutos, es la recomendación de Meta. Importa sobre todo en video, porque Meta señala que las subidas de video son asíncronas: recibir un ID de contenedor no garantiza que la subida funcionó, y un status_code FINISHED es lo que la confirma.
¿Qué ocurre si se publica demasiado pronto?
media_publish falla con el código 9007, subcódigo 2207027: el medio no está listo para publicarse. Nada de la petición necesita corregirse; consulta el estado y publica cuando diga FINISHED. El código 24 con subcódigo 2207008 es distinto: un contenedor que no existe o ha vencido, y Meta sugiere reintentar una o dos veces entre 30 segundos y 2 minutos antes de crear un contenedor nuevo.
¿Cuánto dura un contenedor?
24 horas. Un contenedor que no se publica en ese plazo pasa a EXPIRED y ya no puede publicarse, y el código -2 con subcódigo 2207020, el medio ha expirado, también pide un contenedor nuevo. Una cuenta puede crear 400 contenedores en un periodo móvil de 24 horas, lo que deja margen para crear uno de nuevo tras un fallo.
¿Qué más informa un contenedor?
Dos campos más, y una nota de la publicación. status contiene un subcódigo de error siempre que status_code diga ERROR. copyright_check_status indica, en un video, si la comprobación de derechos de autor de Meta se ejecutó y si encontró coincidencias. Tras publicar, media_publish puede devolver config_issue, CAPTION_NOT_ATTACHED o USER_TAGGING_FAILURE, cuando la publicación salió en línea sin su pie de foto o sin sus etiquetas de usuario.
Errores comunes
- Tratar un ID de contenedor como una subida terminada. Las subidas de video son asíncronas, y solo un status_code FINISHED confirma que el medio está listo.
- Publicar mientras el estado dice IN_PROGRESS. La llamada falla con el subcódigo 2207027 hasta que diga FINISHED.
- Mantener un contenedor más de un día. Tras 24 horas sin publicarse pasa a EXPIRED, y solo puede publicarse un contenedor nuevo.
- Leer solo status_code ante un fallo. Cuando dice ERROR, el campo status trae el subcódigo que indica la causa.
Claude, ChatGPT o tu propio código reciben el ID del medio publicado, o un estado de procesamiento mientras easyCoexistence lo completa. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Qué significa IN_PROGRESS en un contenedor de Instagram?
Meta todavía está preparando el medio. Espera y vuelve a consultar, ya que publicar antes de que el estado diga FINISHED falla con el código 9007.
¿Cuántos contenedores de medios puede crear una cuenta de Instagram?
400 en un periodo móvil de 24 horas, lo que deja margen para crear un contenedor de nuevo tras un fallo.
¿Qué significa config_issue tras publicar?
media_publish tuvo éxito, pero la publicación salió en línea sin su pie de foto, CAPTION_NOT_ATTACHED, o sin sus etiquetas de usuario, USER_TAGGING_FAILURE.
¿Por qué mi contenedor terminó en ERROR?
No logró completar el proceso de publicación. Su campo status contiene un subcódigo de error con el motivo; corrige esa causa y crea un contenedor nuevo.
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