Erros da API do Instagram: o que significam os códigos comuns
Os erros mais comuns da API do Instagram são 190 para um token expirado ou inválido, 4, 17 e 80002 para limites de taxa, 9004 para mídia que a Meta não consegue buscar, 9007 para um vídeo ainda em processamento, 9 para o limite diário de publicação, e 10 com subcódigo 2534022 para uma DM fora da janela de mensagens. Cada erro chega em JSON com um code, muitas vezes com um subcódigo que identifica o caso exato, e uma message.
A easyCoexistence cuida do lado da conexão desses erros: renova o acesso ao Instagram antes que expire, verifica a conta a cada 6 horas e envia um e-mail quando ela precisa ser reconectada.
Código da Graph API para um token de acesso que expirou, foi revogado ou é inválido de outra forma.
Código de erro para o limite de taxa Business Use Case do Instagram.
Subcódigo, sob o código 9, para uma conta que atingiu seu limite diário de publicação via API.
Subcódigo, sob o código 9004, para mídia que a Meta não conseguiu buscar na URL informada.
Subcódigo, sob o código 200, quando a conta desativou o acesso às suas mensagens do Instagram.
Como ler um erro da API do Instagram?
Todo erro é um objeto JSON dentro de error. code é a categoria geral, error_subcode identifica o caso específico e costuma ser o mais útil dos dois, e message o descreve. Muitos erros também trazem error_user_title e error_user_msg, textos destinados à pessoa, e is_transient. O fbtrace_id identifica a requisição para o suporte da Meta e expira logo, então registre-o no momento do erro.
O que significam os erros de acesso e permissão?
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 de outra forma; o subcódigo 463 significa expirado, 467 inválido e 460 uma senha alterada. Um novo token resolve, o que, para uma conta conectada, significa reconectar.
- 10: permissão negada. Uma permissão nunca foi concedida ou foi removida depois.
- 200 a 299: falta uma permissão específica, por exemplo 200 com subcódigo 2534041 quando a conta desativou o acesso às suas mensagens.
- 25, subcódigo 2207050: a conta está restrita, inativa ou em checkpoint; o titular precisa entrar no app do Instagram e concluir o que for pedido.
O que significam os erros de limite de taxa?
Limitação de requisições, e todos são temporários:
- 4: chamadas demais do app; espere e repita, ou reduza o volume de requisições.
- 17: chamadas demais para o usuário; vale a mesma solução.
- 80002: limite Business Use Case do Instagram, calculado por app e conta a partir das impressões da conta: 4,800 chamadas por impressão em 24 horas.
- 613, subcódigo 2534040: chamadas de mensagens demais; pause e repita mais tarde.
O que significam os erros de publicação relacionados à mídia?
Erros sobre o arquivo e onde ele está hospedado; só o timeout vale repetir do jeito que está:
- 9004, subcódigo 2207052: a Meta não conseguiu buscar a mídia na URL; confirme que ela é válida e pública.
- -2, subcódigo 2207003: o download demorou demais; este vale repetir.
- 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 da faixa 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 a tempo e limites?
Erros sobre quando e quanto, a maioria resolvida esperando ou começando de novo:
- 9007, subcódigo 2207027: a mídia ainda não está pronta; espere até o
status_codedo container aparecer como FINISHED. - 24, subcódigo 2207008: o container não existe ou expirou; repita uma ou duas vezes entre 30 segundos e 2 minutos e, depois, crie um novo.
- -2, subcódigo 2207020: a mídia expirou; crie um novo container.
- 9, subcódigo 2207042: a conta atingiu seu limite diário de publicação; tente 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 tags de @, e a referência dela lista 30 hashtags, embora o Instagram permita 5 por post.
- 4, subcódigo 2207051: o Instagram restringiu a ação por suspeita de spam.
O que significam os erros de mensagens?
Erros de DMs e respostas privadas:
- 10, subcódigo 2534022: a mensagem foi enviada fora da janela permitida; espere a pessoa escrever de novo.
- 100, subcódigo 2534014: nenhum usuário do Instagram corresponde; use o ID com escopo do Instagram vindo do webhook, não um ID de usuário do Instagram.
- 100, subcódigo 2534025: o comentário não aceita resposta privada.
- 100, subcódigo 2534037: outro app, inclusive a Business AI da própria Meta, controla a conversa.
- 551, subcódigo 1545041: a pessoa não está disponível no momento.
O que significam os erros de insights?
As requisições de insights falham de três formas documentadas:
- 10, quando não há visualizações suficientes para a mídia exibir insights: uma métrica de Stories abaixo de 5.
- Uma métrica aposentada, como impressions desde 21 de abril de 2025, retorna erro; peça views no lugar.
- Um erro desconhecido quando uma das várias métricas solicitadas não suporta o detalhamento pedido.
Quais erros valem a pena repetir?
Apenas os temporários: códigos 1 e 2, os erros de servidor do Instagram 2207001 e 2207032, o timeout de download 2207003, o 2207008 de curta duração e os limites de taxa depois que a espera termina. Todos os demais devolvem a mesma resposta até que algo mude, seja o arquivo, a URL, uma permissão, o estado da conta ou a janela da pessoa, e repetir esses só gasta o limite de taxa.
Erros comuns
- Repetir um erro de formato ou tamanho. 2207004, 2207005, 2207009 e 2207026 falham da mesma forma até que a mídia mude.
- Tratar 9007 como falha. O vídeo ainda está em processamento; publique quando o container aparecer como FINISHED.
- Ler só o código. Códigos como 10 e 100 cobrem muitos casos, e o subcódigo é o que identifica este.
- Deixar o fbtrace_id fora dos logs. O suporte da Meta o pede, e ele expira logo após o erro.
Claude, ChatGPT ou seu próprio código então chamam a API oficial da Meta com um token sempre atualizado. De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros 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 o erro 190 no Instagram?
O token de acesso expirou, foi revogado ou é inválido de outra forma, por exemplo depois de uma troca de senha. Um novo token resolve, e, para uma conta conectada, isso significa reconectar.
Por que a publicação falha com 9004?
A Meta não conseguiu buscar a mídia na URL informada, subcódigo 2207052. Confira se o link é válido e público, sem login na frente, no momento em que a publicação acontece.
O que é o erro 9007?
O vídeo no container ainda está em processamento, subcódigo 2207027. Verifique o status_code do container e publique quando ele aparecer como FINISHED.
O que é o fbtrace_id em um erro da API do Instagram?
Um identificador da requisição que falhou, que o suporte da Meta pede quando você relata um problema. Ele expira logo após o erro, então registre-o no log na hora.
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