Status do container de mídia do Instagram: os códigos e o ciclo de vida
A API do Instagram publica por meio de containers de mídia, e cada um informa um status_code: IN_PROGRESS enquanto ainda está no processo de publicação, FINISHED quando está pronto, PUBLISHED depois que está no ar, ERROR se não concluiu e EXPIRED se passaram 24 horas sem publicação. A Meta recomenda checar uma vez por minuto, por no máximo 5 minutos.
O easyCoexistence executa o ciclo do container dentro de publish_instagram_post: cria o container, aguarda o Instagram concluir e publica; enquanto um vídeo ainda está sendo processado, ele conclui a publicação por conta própria.
Valores que status_code pode assumir: IN_PROGRESS, FINISHED, PUBLISHED, ERROR e EXPIRED.
Por quanto tempo um container pode aguardar sem ser publicado antes que seu status passe a EXPIRED.
Intervalo sugerido pela Meta entre as checagens de status, por no máximo 5 minutos.
Containers que uma conta do Instagram pode criar em qualquer janela de 24 horas.
Subcódigo de erro, dentro do código 9007, para publicar um container que ainda não está pronto.
O que é um container de mídia?
O objeto a partir do qual uma publicação é feita. POST /<IG_ID>/media cria um a partir de uma URL de imagem ou vídeo, a Meta busca e prepara a mídia, e POST /<IG_ID>/media_publish com o ID do container como creation_id o transforma em publicação. Um carrossel adiciona um nível: um container por item e, depois, um container CAROUSEL que os lista como filhos.
O que cada código de status significa?
GET /<IG_CONTAINER_ID>?fields=status_code retorna um de cinco valores, cada um com seu próprio próximo passo:
IN_PROGRESS: o container ainda está no processo de publicação; aguarde e consulte novamente.- FINISHED: o container e sua mídia estão prontos; publique-o.
- PUBLISHED: a mídia já está no ar; não há mais nada a publicar.
- ERROR: o container não concluiu o processo de publicação; o campo status traz um subcódigo de erro com o motivo, e é preciso um novo container.
- EXPIRED: não foi publicado em 24 horas; crie um novo.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}Com que frequência o status deve ser checado?
Uma vez por minuto, por no máximo 5 minutos, é a recomendação da Meta. A checagem importa mais para vídeos, pois a Meta observa que o upload de vídeo é assíncrono: receber um ID de container não garante que o upload funcionou, e um status_code FINISHED é o que confirma isso.
O que acontece se publicar cedo demais?
media_publish falha com o código 9007, subcódigo 2207027: a mídia não está pronta para publicação. Nada na requisição precisa de correção; verifique o status e publique quando ele indicar FINISHED. O código 24 com subcódigo 2207008 é outra situação, um container que não existe ou expirou, e a Meta sugere repetir uma ou duas vezes, entre 30 segundos e 2 minutos, antes de criar um novo container.
Por quanto tempo um container vale?
24 horas. Um container que não é publicado nesse prazo passa a EXPIRED e não pode mais ser publicado, e o código -2 com subcódigo 2207020, a mídia expirou, também pede um novo container. Uma conta pode criar 400 containers em qualquer janela de 24 horas, o que deixa espaço para criar outro após uma falha.
O que mais um container informa?
Mais dois campos, e uma observação da publicação. status traz um subcódigo de erro sempre que status_code indica ERROR. copyright_check_status informa, para um vídeo, se a verificação de direitos autorais da Meta foi executada e se encontrou correspondências. Depois da publicação, media_publish pode retornar config_issue, CAPTION_NOT_ATTACHED ou USER_TAGGING_FAILURE, quando a publicação foi ao ar sem a legenda ou sem as marcações de usuário.
Erros comuns
- Tratar o ID de um container como upload concluído. Uploads de vídeo são assíncronos, e somente um status_code FINISHED confirma que a mídia está pronta.
- Publicar enquanto o status indica IN_PROGRESS. A chamada falha com o subcódigo 2207027 até que o status indique FINISHED.
- Manter um container por mais de um dia. Após 24 horas sem publicação ele passa a EXPIRED, e só um novo container pode ser publicado.
- Ler apenas o status_code em uma falha. Quando indica ERROR, o campo status traz o subcódigo que identifica a causa.
Claude, ChatGPT ou seu próprio código recebem o ID da mídia publicada ou um status de processamento enquanto o easyCoexistence a conclui. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que significa IN_PROGRESS em um container do Instagram?
A Meta ainda está preparando a mídia. Aguarde e consulte novamente, pois publicar antes que o status indique FINISHED falha com o código 9007.
Quantos containers de mídia uma conta do Instagram pode criar?
400 em qualquer janela de 24 horas, o que deixa espaço para criar um container novamente após uma falha.
O que significa config_issue depois da publicação?
A media_publish foi bem-sucedida, mas a publicação foi ao ar sem a legenda, CAPTION_NOT_ATTACHED, ou sem as marcações de usuário, USER_TAGGING_FAILURE.
Por que meu container terminou em ERROR?
Ele não concluiu o processo de publicação. O campo status traz um subcódigo de erro com o motivo; corrija essa causa e crie um novo container.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em