EntrarComeçar teste grátis
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 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.

190

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

80002

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

2207042

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

2207052

Subcódigo, sob o código 9004, para mídia que a Meta não conseguiu buscar na URL informada.

2534041

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_code do 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.
Fazendo isso com o EasyCoexistence

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