Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Estado do contentor de media do Instagram: os códigos e o ciclo de vida

A API do Instagram publica através de contentores de media, e cada um reporta um status_code: IN_PROGRESS enquanto ainda está em processo de publicação, FINISHED quando está pronto, PUBLISHED depois de estar ao vivo, ERROR se não conseguiu concluir e EXPIRED se passaram 24 horas sem publicação. A Meta recomenda verificar uma vez por minuto, durante no máximo 5 minutos.

O easyCoexistence executa o ciclo do contentor dentro de publish_instagram_post: cria o contentor, aguarda que o Instagram conclua e publica, e enquanto um vídeo ainda está a ser processado conclui a publicação por si.

5

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

24 hours

Tempo que um contentor pode esperar por publicação antes de o estado passar a EXPIRED.

1 min

Intervalo sugerido pela Meta entre verificações de estado, durante no máximo 5 minutos.

400

Contentores que uma conta do Instagram pode criar em qualquer período de 24 horas.

2207027

Subcódigo de erro, dentro do código 9007, para publicar um contentor que ainda não está pronto.

O que é um contentor de media?

O objeto a partir do qual se publica uma publicação. POST /<IG_ID>/media cria um a partir de um URL de imagem ou vídeo; a Meta obtém e prepara o media, e POST /<IG_ID>/media_publish, com o ID do contentor como creation_id, transforma-o numa publicação. Um carrossel acrescenta um nível: um contentor por item e, depois, um contentor CAROUSEL que os lista como filhos.

O que significa cada código de estado?

GET /<IG_CONTAINER_ID>?fields=status_code devolve um de cinco valores, cada um com o seu próximo passo:

  • IN_PROGRESS: o contentor ainda está no processo de publicação; aguarde e volte a verificar.
  • FINISHED: o contentor e o seu media estão prontos; publique-o.
  • PUBLISHED: o media já está ao vivo; não há mais nada a publicar.
  • ERROR: o contentor não conseguiu concluir o processo de publicação; o campo status contém um subcódigo de erro com o motivo, e é preciso criar um novo contentor.
  • EXPIRED: não foi publicado dentro de 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 se deve verificar o estado?

Uma vez por minuto, durante no máximo 5 minutos, é a recomendação da Meta. A verificação importa sobretudo para vídeo, porque a Meta indica que os carregamentos de vídeo são assíncronos: receber um ID de contentor não garante que o carregamento correu bem, e só um status_code de FINISHED o confirma.

O que acontece se publicar cedo demais?

media_publish falha com o código 9007, subcódigo 2207027: o media não está pronto para publicação. Nada no pedido precisa de correção; verifique o estado e publique quando indicar FINISHED. O código 24 com subcódigo 2207008 é diferente: um contentor que não existe ou que expirou, e a Meta sugere repetir uma ou duas vezes entre 30 segundos e 2 minutos antes de criar um novo contentor.

Quanto tempo dura um contentor?

24 horas. Um contentor que não é publicado nesse prazo passa a EXPIRED e já não pode ser publicado, e o código -2 com subcódigo 2207020, o media expirou, também pede um novo contentor. Uma conta pode criar 400 contentores num período móvel de 24 horas, o que deixa margem para criar outro após uma falha.

O que mais reporta um contentor?

Dois campos a mais, e uma nota da publicação. status contém um subcódigo de erro sempre que status_code indica ERROR. copyright_check_status indica, num vídeo, se a verificação de direitos de autor da Meta foi executada e se encontrou correspondências. Após a publicação, media_publish pode devolver config_issue, CAPTION_NOT_ATTACHED ou USER_TAGGING_FAILURE, quando a publicação ficou online sem a legenda ou sem as marcações de utilizadores.

Erros comuns

  • Tratar um ID de contentor como um carregamento concluído. Os carregamentos de vídeo são assíncronos, e só um status_code de FINISHED confirma que o media está pronto.
  • Publicar enquanto o estado indica IN_PROGRESS. A chamada falha com o subcódigo 2207027 até indicar FINISHED.
  • Manter um contentor mais de um dia. Após 24 horas sem publicação passa a EXPIRED, e só um novo contentor pode ser publicado.
  • Ler apenas status_code numa falha. Quando indica ERROR, o campo status traz o subcódigo que identifica a causa.
Fazer isto com a EasyCoexistence

O Claude, o ChatGPT ou o seu próprio código recebem o ID do media publicado, ou um estado de processamento enquanto o easyCoexistence a conclui. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que adiciona números, com os primeiros 3 dias gratuitos.

Perguntas frequentes

O que significa IN_PROGRESS num contentor do Instagram?

A Meta ainda está a preparar o media. Aguarde e volte a verificar, pois publicar antes de o estado indicar FINISHED falha com o código 9007.

Quantos contentores de media pode criar uma conta do Instagram?

400 num período móvel de 24 horas, o que deixa margem para criar um contentor de novo após uma falha.

O que significa config_issue depois de publicar?

media_publish teve sucesso, mas a publicação ficou online sem a legenda, CAPTION_NOT_ATTACHED, ou sem as marcações de utilizadores, USER_TAGGING_FAILURE.

Porque é que o meu contentor ficou em ERROR?

Não conseguiu concluir o processo de publicação. O campo status contém um subcódigo de erro com o motivo; corrija essa causa e crie um novo contentor.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em