Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Erros da API do Instagram: o que significam os códigos comuns

Os erros mais comuns da API do Instagram são o 190 para um token expirado ou inválido, 4, 17 e 80002 para limites de pedidos, 9004 para multimédia que a Meta não consegue obter, 9007 para um vídeo ainda em processamento, 9 para o limite diário de publicações e 10 com o subcódigo 2534022 para uma DM fora da janela de mensagens. Cada erro chega em JSON com um código, muitas vezes um subcódigo que indica o caso exato, e uma mensagem.

A easyCoexistence trata da parte da ligação destes erros: renova o acesso ao Instagram antes de expirar, verifica a conta de 6 em 6 horas e envia-lhe um email quando é preciso voltar a ligá-la.

190

Código da Graph API para um token de acesso que expirou, foi revogado ou é inválido por outro motivo.

80002

Código de erro para o limite do Business Use Case do Instagram.

2207042

Subcódigo, sob o código 9, para uma conta que atingiu o seu limite diário de publicações pela API.

2207052

Subcódigo, sob o código 9004, para multimédia que a Meta não conseguiu obter do URL indicado.

2534041

Subcódigo, sob o código 200, quando a conta desativou o acesso às suas mensagens do Instagram.

Como se lê um erro da API do Instagram?

Cada erro é um objeto JSON dentro de error. code é a categoria geral, error_subcode indica o caso específico e costuma ser o mais útil dos dois, e message descreve-o. Muitos erros trazem também error_user_title e error_user_msg, texto destinado à pessoa, e is_transient. O fbtrace_id identifica o pedido para o apoio da Meta e expira em pouco tempo, pelo que deve ser registado no momento em que o erro ocorre.

O que significam os erros de acesso e permissões?

Erros sobre quem pode fazer o quê, com a correção para cada um:

  • 190: o token de acesso expirou, foi revogado ou é inválido por outro motivo; o subcódigo 463 significa expirado, 467 inválido e 460 uma palavra-passe alterada. Um novo token resolve, o que, numa conta ligada, significa voltar a ligar a conta.
  • 10: permissão negada. Uma permissão nunca foi concedida ou foi entretanto removida.
  • 200 a 299: falta uma permissão específica, por exemplo 200 com o subcódigo 2534041 quando a conta desativou o acesso às suas mensagens.
  • 25, subcódigo 2207050: a conta está restringida, inativa ou sujeita a verificação de segurança; o titular tem de iniciar sessão na aplicação do Instagram e concluir o que esta pedir.

O que significam os erros de limite de pedidos?

Limitação de pedidos, toda ela temporária:

  • 4: demasiadas chamadas da aplicação; aguarde e tente novamente, ou reduza o volume de pedidos.
  • 17: demasiadas chamadas para o utilizador; aplica-se a mesma solução.
  • 80002: limite do Business Use Case do Instagram, calculado por aplicação e conta a partir das impressões da conta: 4 800 chamadas por impressão em 24 horas.
  • 613, subcódigo 2534040: demasiadas chamadas de mensagens; faça uma pausa e tente mais tarde.

O que significam os erros de publicação relacionados com o conteúdo?

Erros sobre o ficheiro e onde está alojado; só o tempo limite vale a pena repetir tal como está:

  • 9004, subcódigo 2207052: a Meta não conseguiu obter o conteúdo multimédia a partir do URL; confirme que é válido e público.
  • -2, subcódigo 2207003: a transferência demorou demasiado; este caso vale a pena tentar novamente.
  • 36000, subcódigo 2207004: a imagem tem mais de 8 MB.
  • 36001, subcódigo 2207005: o formato da imagem não é suportado; use JPEG.
  • 36003, subcódigo 2207009: a proporção está fora do intervalo de 4:5 a 1.91:1.
  • 352, subcódigo 2207026: o formato do vídeo não é suportado; use MOV ou MP4.

O que significam os erros de publicação relacionados com o momento e os limites?

Erros sobre quando e quanto, a maioria resolvida por espera ou por recomeçar:

  • 9007, subcódigo 2207027: o conteúdo ainda não está pronto; aguarde até que o status_code do container indique FINISHED.
  • 24, subcódigo 2207008: o container não existe ou expirou; volte a tentar uma ou duas vezes, entre 30 segundos e 2 minutos, e depois crie um novo.
  • -2, subcódigo 2207020: o conteúdo expirou; crie um novo container.
  • 9, subcódigo 2207042: a conta atingiu o limite diário de publicações; tente novamente no dia seguinte.
  • 100, subcódigo 2207028: um carrossel precisa de 2 a 10 itens.
  • 36004, subcódigo 2207010: a legenda é longa demais; os limites da Meta são 2,200 caracteres e 20 etiquetas @, e a sua referência indica 30 hashtags, embora o Instagram permita 5 hashtags numa publicação.
  • 4, subcódigo 2207051: o Instagram restringiu a ação por suspeita de spam.

O que significam os erros de mensagens?

Erros das DMs e das respostas privadas:

  • 10, subcódigo 2534022: a mensagem foi enviada fora da janela permitida; aguarde que a pessoa volte a escrever.
  • 100, subcódigo 2534014: não existe um utilizador do Instagram correspondente; use o ID com âmbito Instagram do webhook, e não um ID de utilizador do Instagram.
  • 100, subcódigo 2534025: o comentário não aceita uma resposta privada.
  • 100, subcódigo 2534037: outra aplicação, incluindo a Business AI da própria Meta, controla a conversa.
  • 551, subcódigo 1545041: a pessoa não está disponível de momento.

O que significam os erros de insights?

Os pedidos de Insights falham de três formas documentadas:

  • 10, quando não há visualizações suficientes para o conteúdo mostrar insights: uma métrica de Stories abaixo de 5.
  • Uma métrica retirada, como as impressões desde 21 de abril de 2025, devolve um erro; peça, em vez disso, as visualizações.
  • Um erro desconhecido quando uma de várias métricas pedidas não suporta a desagregação solicitada.

Que erros vale a pena repetir?

Apenas os temporários: os códigos 1 e 2, os erros de servidor do Instagram 2207001 e 2207032, o tempo limite de transferência 2207003, o 2207008, de curta duração, e os limites de pedidos depois de terminada a espera. Todos os outros devolvem sempre a mesma resposta até que algo mude, seja o ficheiro, o URL, uma permissão, o estado da conta ou a janela da pessoa, e repeti-los só gasta o limite de pedidos.

Erros comuns

  • Repetir um erro de formato ou de tamanho. Os 2207004, 2207005, 2207009 e 2207026 falham da mesma forma até que o conteúdo mude.
  • Tratar o 9007 como falha. O vídeo ainda está a ser processado; publique quando o container indicar FINISHED.
  • Ler apenas o código. Códigos como 10 e 100 abrangem muitos casos, e é o subcódigo que indica qual deles.
  • Deixar o fbtrace_id fora dos registos. O apoio da Meta pede-o, e expira pouco depois do erro.
Fazer isto com a EasyCoexistence

O Claude, o ChatGPT ou o seu próprio código chamam depois a API oficial da Meta com um token sempre atualizado. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O que significa o erro 190 no Instagram?

O token de acesso expirou, foi revogado ou é inválido por outro motivo, por exemplo depois de uma alteração de palavra-passe. Um novo token resolve o problema e, numa conta ligada, isso significa voltar a ligar a conta.

Porque é que a publicação falha com o 9004?

A Meta não conseguiu obter o conteúdo multimédia do URL indicado, subcódigo 2207052. Verifique se o link é válido e público, sem qualquer início de sessão pelo meio, no momento em que a publicação é feita.

O que é o erro 9007?

O vídeo do container ainda está a ser processado, subcódigo 2207027. Verifique o status_code do container e publique quando indicar FINISHED.

O que é o fbtrace_id num erro da API do Instagram?

É um identificador do pedido que falhou, e o apoio da Meta pede-o quando se reporta um problema. Expira pouco depois do erro, por isso registe-o nos registos da sua aplicação no momento.

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