Erro 100 da API do Instagram: parâmetro inválido e mídia não encontrada
O erro 100 da API do Instagram significa que um parâmetro da requisição era inválido, e o subcódigo indica o caso. O subcódigo 33 é o caso de mídia não encontrada: o ID do objeto não existe, não pode ser carregado com as permissões do token ou não aceita a chamada. Outros subcódigos cobrem tipos de mídia desconhecidos, tamanhos de carrossel, tags @, destinatários de DM e buscas de áudio.
A easyCoexistence devolve o erro da Meta para Claude, ChatGPT ou o seu próprio código quando uma chamada falha, com o status HTTP, o código de erro da Meta e a mensagem dela, para que o agente corrija o ID ou o valor e tente de novo.
Nome que a Meta dá ao código de erro 100 da Graph API na sua referência de erros da Marketing API.
Subcódigo abaixo de 100: o ID do objeto não existe, não pode ser carregado por falta de permissões ou não aceita a operação.
Subcódigo abaixo de 100 para um tipo de mídia que o Instagram não reconhece; o container precisa de um dos tipos esperados.
Subcódigo abaixo de 100 para mais de 20 tags @ em uma mesma mídia.
Subcódigo abaixo de 100 para um destinatário de DM sem usuário correspondente do Instagram; a Meta quer o ID com escopo do Instagram, não o ID do usuário.
O status HTTP que a Meta lista para cada linha do código 100 na sua tabela de erros do Instagram.
O que significa o erro 100 no Instagram?
Um parâmetro da requisição não pôde ser aceito. A referência da Marketing API da Meta chama o código 100 de Invalid parameter, a sua tabela de mensagens o chama de Bad Parameter Error, e as linhas do Instagram o associam a um error_subcode e a uma error_user_msg que o especificam, sob o status HTTP 400. O código sozinho abrange casos tão diferentes quanto um tipo de mídia inválido e um destinatário de DM errado, por isso leia error_subcode e error_user_msg antes de alterar qualquer coisa.
O que significa o subcódigo 33?
Que o ID da requisição não leva a lugar algum que este token possa acessar. A mensagem da Meta diz: Unsupported get request. Object with ID does not exist, cannot be loaded due to missing permissions, or does not support this operation. A correção é garantir que o ID exista e que o app tenha permissão para acessá-lo. Em um POST, as referências da Meta dão o subcódigo 33 como Unsupported post request.
O que faz um ID falhar com o subcódigo 33?
Verificações que vale fazer antes de tudo, cada uma ligada a uma parte da mensagem da Meta:
- O objeto existe: um post apagado ou um ID digitado errado não deixa nada para carregar.
- O token pertence à conta que é dona dele, já que uma permissão alcança apenas os dados da conta que a concedeu.
- O ID é do tipo certo: um ID de container de POST /<
IG_ID>/media não é o ID de mídia quemedia_publishretorna. - O nó aceita a chamada: um comentário encontrado por menções é lido pelo nó de comentário mencionado, a menos que o dono do comentário faça a requisição.
- O ID veio do mesmo login: IDs de mensagens de uma integração com Instagram Login têm formato diferente sob Unified Login.
Quais subcódigos de publicação acompanham o código 100?
Seis linhas da tabela de erros do Instagram da Meta, cada uma sobre um valor do container de mídia. As três linhas de marcação de produto só dizem respeito a configurações com product tagging, que a visão geral da Meta marca como não suportado no Instagram Login:
- 2207023: o tipo de mídia é desconhecido; os containers aceitam CAROUSEL, REELS ou STORIES como
media_type. - 2207028: o carrossel tem poucos ou muitos itens; a mensagem ainda diz de 2 a 10, enquanto o guia de publicação da Meta permite até 20.
- 2207040: mais de 20 tags @ na mídia; use menos.
- 2207035: posições de marcação de produto enviadas para um vídeo, que não aceita nenhuma.
- 2207036: posições de marcação de produto ausentes para uma foto, que precisa das coordenadas x e y.
- 2207037: uma marcação de produto que a Meta não conseguiu adicionar; marque apenas produtos da lista elegível da conta.
Quais subcódigos de mensagens acompanham o código 100?
Os códigos de erro comuns da Meta para mensagens listam estes com o código 100, cada um com a mudança que o corrige:
- 2534014: nenhum usuário do Instagram correspondente; envie para o ID com escopo do Instagram vindo do webhook, já que IDs de usuário do Instagram não são suportados.
- 2534015: dados de mensagem inválidos; o conteúdo não é permitido para aquele tipo de mensagem.
- 2534025: o comentário é inválido para uma resposta privada.
- 2534037: o app não é o dono da conversa, porque outro app, incluindo o Meta Business AI, tem a conversa.
- 2534029: a empresa está bloqueada para enviar mensagens pela API até que as violações de política sejam resolvidas.
Quais subcódigos de áudio acompanham o código 100?
Onze linhas pertencem a /ig_audio, a busca da Audio API, que roda em Facebook Login e Unified Login. A maioria se refere ao seu fluxo de anúncios para substituir música com direitos autorais em um Reel: user_id e ig_user_id enviados juntos (9050), um purpose ausente ou inválido para product=ADS (9052), um audio_replacement_mode ausente ou inválido (9056, 9057), um search_query ausente ou não permitido (9058, 9060), um ig_media_id ausente, que não é um Reel ou que não tem música com direitos autorais (9054, 9062, 9055), e problemas com partnership_ad_code (9063, 9064).
Em que a mídia não encontrada difere do erro 100?
A publicação reporta mídia ausente sob outros códigos. A tabela da Meta traz o código 24, subcódigo 2207006, quando a mídia não pode ser encontrada, possivelmente por falta de permissão ou token expirado, corrigido com um novo container; o código 24, subcódigo 2207008, quando um container não existe ou expirou, vale repetir uma ou duas vezes em 30 segundos a 2 minutos; e o código -2, subcódigo 2207020, quando a mídia expirou. O erro 100 com subcódigo 33 é o caso geral, um ID que o token não consegue alcançar.
Por que uma chamada funciona com um login e falha com outro?
Porque as três configurações diferem em host, token e recursos. As chamadas do Instagram Login vão para graph.instagram.com com um token de acesso de Instagram User e as permissões instagram_business_*, enquanto Facebook Login e Unified Login usam o seu próprio host da Graph API, tokens e as permissões instagram_*. A visão geral da Meta marca busca de hashtags, marcação de produtos e anúncios de parceria como não suportados no Instagram Login, e a Audio API roda apenas nas outras duas configurações. Sob Unified Login, /me não retorna a conta do Instagram, então as chamadas usam o ID de GET /me/assigned_instagram_accounts.
Como corrigir o erro 100?
Altere a requisição, guiado pelo subcódigo, já que reenviá-la sem mudanças obtém a mesma resposta. Para o subcódigo 33, leia o ID de volta com um GET usando o mesmo token e confirme que é o ID da mídia publicada, não um ID de container. Para os subcódigos de publicação, corrija o valor que a mensagem indica. Para mensagens, responda ao ID com escopo do Instagram vindo do webhook. Mantenha também o fbtrace_id no log, o identificador de suporte da Meta para a requisição.
Erros comuns
- Repetir o subcódigo 33 sem mudanças. O ID ou a sua permissão estão errados, e a Meta responde do mesmo jeito até que a requisição mude.
- Enviar uma DM para o ID de usuário do Instagram de uma pessoa. A mensagem usa o ID com escopo do Instagram vindo do webhook de mensagens, e a Meta responde um ID de usuário com o subcódigo 2534014.
- Usar o ID do container após publicar. Comentários, insights e leituras posteriores vão para o ID de mídia que media_publish retorna, não para o container.
list_social_accounts e list_social_posts fornecem os IDs de conta e de mídia que essas chamadas precisam. De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os primeiros 3 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
Vale repetir o erro 100 do Instagram?
Não sem mudanças. Ele diz respeito à própria requisição, a um ID, um valor ou um parâmetro, então a mesma requisição retorna o mesmo erro até que essa parte seja corrigida.
Por que o Instagram diz que um objeto não existe quando o post está publicado?
Verifique qual ID foi enviado e com qual token. O subcódigo 33 também cobre um objeto que o token não consegue carregar por falta de permissão, como uma mídia de outra conta.
O que significa o erro 100 com o subcódigo 2207023?
O media_type enviado não é um que o Instagram reconheça. Os containers aceitam CAROUSEL, REELS ou STORIES, ou nenhum media_type para uma imagem única; a Meta deixou de suportar VIDEO em 9 de novembro de 2023.
O erro 100 significa que a minha conta do Instagram está restrita?
Não. Uma conta restrita aparece como código 25, subcódigo 2207050; o erro 100 diz respeito a um valor da requisição.
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