EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

5

Valores que status_code pode assumir: IN_PROGRESS, FINISHED, PUBLISHED, ERROR e EXPIRED.

24 hours

Por quanto tempo um container pode aguardar sem ser publicado antes que seu status passe a EXPIRED.

1 min

Intervalo sugerido pela Meta entre as checagens de status, por no máximo 5 minutos.

400

Containers que uma conta do Instagram pode criar em qualquer janela de 24 horas.

2207027

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.
Checking a container's status
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.
Fazendo isso com o EasyCoexistence

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