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.
Código da Graph API para um token de acesso que expirou, foi revogado ou é inválido por outro motivo.
Código de erro para o limite do Business Use Case do Instagram.
Subcódigo, sob o código 9, para uma conta que atingiu o seu limite diário de publicações pela API.
Subcódigo, sob o código 9004, para multimédia que a Meta não conseguiu obter do URL indicado.
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_codedo 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.
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