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.
Valores que status_code pode assumir: IN_PROGRESS, FINISHED, PUBLISHED, ERROR e EXPIRED.
Tempo que um contentor pode esperar por publicação antes de o estado passar a EXPIRED.
Intervalo sugerido pela Meta entre verificações de estado, durante no máximo 5 minutos.
Contentores que uma conta do Instagram pode criar em qualquer período de 24 horas.
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.
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.
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