Erro 100 da API do Instagram: parâmetro inválido e conteúdo não encontrado
O erro 100 da API do Instagram indica que um parâmetro do pedido é inválido, e o subcódigo identifica o caso. O subcódigo 33 corresponde ao caso de conteúdo não encontrado: o ID do objeto não existe, não pode ser carregado com as permissões do token ou não suporta a chamada. Outros subcódigos cobrem tipos de conteúdo desconhecidos, tamanhos de carrossel, marcações @, destinatários de mensagens privadas e pesquisas de áudio.
O easyCoexistence devolve o erro da Meta ao Claude, ao ChatGPT ou ao seu próprio código quando uma chamada falha, com o estado HTTP, o código de erro da Meta e a respetiva mensagem, para que o agente corrija o ID ou o valor e tente de novo.
Nome dado pela Meta ao código de erro 100 da Graph API, na sua referência de erros da Marketing API.
Subcódigo 33: o ID do objeto não existe, não pode ser carregado por falta de permissões ou não suporta a operação.
Subcódigo 2207023: o tipo de conteúdo não é reconhecido pelo Instagram; o contentor tem de ter um dos tipos esperados.
Subcódigo 2207040: mais de 20 marcações @ num mesmo conteúdo.
Subcódigo 2534014: destinatário de mensagem privada sem utilizador do Instagram correspondente; a Meta quer o ID com âmbito do Instagram, e não o ID de utilizador.
O estado HTTP que a Meta indica 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 do pedido não pôde ser aceite. A referência da Marketing API da Meta dá ao código 100 o nome Invalid parameter, a sua tabela de mensagens chama-lhe Bad Parameter Error, e as linhas do Instagram associam-no a um error_subcode e a uma mensagem para o utilizador que o restringem, com o estado HTTP 400. O código, por si só, abrange casos tão diferentes como um tipo de conteúdo errado e um destinatário de mensagem incorreto, por isso leia error_subcode e error_user_msg antes de alterar seja o que for.
O que significa o subcódigo 33?
Que o ID no pedido não leva a lado nenhum que este token possa alcançar. 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 consiste em garantir que o ID existe e que a aplicação tem permissão para lhe aceder. Num POST, as referências da Meta dão ao subcódigo 33 a designação Unsupported post request.
O que faz um ID falhar com o subcódigo 33?
Verificações a fazer antes de tudo o resto, cada uma ligada a uma parte da mensagem da Meta:
- O objeto existe: uma publicação eliminada ou um ID mal escrito não deixa nada para carregar.
- O token pertence à conta proprietária, pois uma permissão só alcança os dados da conta que a concedeu.
- O ID é do tipo certo: um ID de contentor de POST /<
IG_ID>/media não é o ID do conteúdo quemedia_publishdevolve. - O nó suporta a chamada: um comentário encontrado através de menções é lido pelo nó do comentário mencionado, a menos que o dono do comentário faça o pedido.
- O ID veio do mesmo login: os IDs de mensagens de uma integração com Instagram Login têm um formato diferente sob o Unified Login.
Que 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 contentor do conteúdo. As três linhas de marcação de produtos só dizem respeito a configurações com marcação de produtos, que a visão geral da Meta indica como não suportada no Instagram Login:
- 2207023: o tipo de conteúdo é desconhecido; os contentores aceitam CAROUSEL, REELS ou STORIES como
media_type. - 2207028: o carrossel tem poucos ou demasiados itens; a mensagem ainda diz 2 a 10, enquanto o guia de publicação da Meta permite até 20.
- 2207040: mais de 20 marcações @ no conteúdo; 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 em falta para uma fotografia, 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.
Que subcódigos de mensagens acompanham o código 100?
Os códigos de erro comuns de mensagens da Meta listam estes com o código 100, cada um com a alteração que o corrige:
- 2534014: nenhum utilizador do Instagram correspondente; envie para o ID com âmbito do Instagram do webhook, já que os IDs de utilizador do Instagram não são suportados.
- 2534015: dados de mensagem inválidos; o conteúdo não é permitido para esse tipo de mensagem.
- 2534025: o comentário é inválido para uma resposta privada.
- 2534037: a aplicação não é a dona da conversa, porque outra aplicação, incluindo a Meta Business AI, detém a conversa.
- 2534029: a empresa está bloqueada para enviar mensagens através da API até que as violações de política sejam resolvidas.
Que subcódigos de áudio acompanham o código 100?
Onze linhas pertencem a /ig_audio, a pesquisa da Audio API, que funciona com o Facebook Login e o Unified Login. A maioria diz respeito ao fluxo de anúncios que substitui música protegida por direitos de autor num Reel: user_id e ig_user_id enviados em conjunto (9050), um purpose em falta ou inválido para product=ADS (9052), um audio_replacement_mode em falta ou inválido (9056, 9057), um search_query em falta ou não permitido (9058, 9060), um ig_media_id em falta, que não é um Reel ou que não está livre de música protegida (9054, 9062, 9055), e problemas com partnership_ad_code (9063, 9064).
Em que é que o conteúdo não encontrado difere do erro 100?
A publicação reporta conteúdo em falta através de outros códigos. A tabela da Meta dá o código 24, subcódigo 2207006, quando o conteúdo não pode ser encontrado, possivelmente por falta de permissão ou token expirado, corrigido com um novo contentor; o código 24, subcódigo 2207008, quando um contentor não existe ou expirou, vale a pena repetir uma ou duas vezes entre 30 segundos e 2 minutos; e o código -2, subcódigo 2207020, quando o conteúdo expirou. O erro 100 com subcódigo 33 é o caso geral, um ID que o token não consegue alcançar.
Porque é que uma chamada funciona com um login e falha com outro?
Porque as três configurações diferem em domínio, token e funcionalidades. As chamadas com Instagram Login vão para graph.instagram.com com um token de acesso de utilizador do Instagram e as permissões instagram_business_*, enquanto o Facebook Login e o Unified Login usam o seu próprio domínio da Graph API, os seus tokens e as permissões instagram_*. A visão geral da Meta marca a pesquisa de hashtags, a marcação de produtos e os anúncios de parceria como não suportados no Instagram Login, e a Audio API só funciona nas outras duas configurações. Com o Unified Login, /me não devolve a conta do Instagram, por isso as chamadas usam o ID de GET /me/assigned_instagram_accounts.
Como se corrige o erro 100?
Altere o pedido, orientado pelo subcódigo, porque reenviá-lo sem alterações obtém a mesma resposta. Para o subcódigo 33, volte a ler o ID com um GET usando o mesmo token e confirme que é o ID do conteúdo publicado, e não um ID de contentor. Para os subcódigos de publicação, corrija o valor que a mensagem indica. Para mensagens, responda ao ID com âmbito do Instagram do webhook. Guarde também o fbtrace_id no registo, o identificador de suporte da Meta para o pedido.
Erros comuns
- Repetir o subcódigo 33 sem alterações. O ID ou a sua permissão estão errados, e a Meta responde sempre da mesma forma até que o pedido mude.
- Enviar uma mensagem privada para o ID de utilizador do Instagram de uma pessoa. As mensagens usam o ID com âmbito do Instagram do webhook de mensagens, e a Meta responde a um ID de utilizador com o subcódigo 2534014.
- Usar o ID do contentor depois de publicar. Comentários, estatísticas e leituras posteriores fazem-se com o ID do conteúdo que media_publish devolve, e não com o ID do contentor.
list_social_accounts e list_social_posts fornecem as contas e os IDs de conteúdo de que estas chamadas precisam. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que adiciona números, com os primeiros 3 dias grátis.
Perguntas frequentes
Vale a pena repetir o pedido com o erro 100 da API do Instagram?
Não sem alterações. Diz respeito ao próprio pedido, a um ID, a um valor ou a um parâmetro, por isso o mesmo pedido devolve o mesmo erro até que essa parte seja corrigida.
Porque é que o Instagram diz que um objeto não existe quando a publicação está online?
Verifique qual o ID enviado e com que token. O subcódigo 33 também abrange um objeto que o token não consegue carregar por falta de permissão, como conteúdo 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 contentores aceitam CAROUSEL, REELS ou STORIES, ou nenhum media_type para uma imagem única; a Meta deixou de suportar VIDEO a 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 no pedido.
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