Documentos    Instagram    Resolução de problemas

Referência de mensagens de erro da API do Instagram

Última atualização por Michael Bodin-Lenoir11 de setembro de 2026

Uma tabela de referência com as mensagens de erro da API do Instagram, o que cada uma significa e como resolvê-las. Aborda também os atrasos nas solicitações e o registo de erros.

Se receber uma mensagem de erro ao tentar apresentar as suas mensagens, pode utilizar a tabela abaixo para diagnosticar o problema e encontrar a solução adequada.

Porque é que os pedidos de API estão a ser atrasados?

Se o seu sítio Web tentar fazer vários pedidos de API incorrectos num curto período de tempo, o Instagram bloqueará temporariamente todos os pedidos do seu sítio Web. Para evitar isto, o plug-in define um atraso de 5 minutos até que seja efectuado outro pedido de API. Pode guardar as suas definições em Instagram Feed > Definições > Feeds para tentar imediatamente outro pedido de API.

Estou a ver mensagens de erro que já não se aplicam. Porquê?

O plug-in registará os erros da API para ajudar a resolver problemas de ligação. Apenas alguns destes erros serão eliminados por si próprios quando o problema for resolvido. Se pretender repor estas mensagens de erro, aceda a Feed do Instagram > Definições > Avançadas e clique no botão Repor ao lado de Repor registo de erros. Também pode guardar as suas definições em Feed do Instagram > Definições > Feeds para limpar os erros relacionados com hashtags.

Erro na base de dados: Permissões ALTER insuficientes para o utilizador da base de dados.

Certifique-se de que o utilizador da base de dados tem permissões ALTER. Contacte o seu fornecedor de alojamento, se necessário. Uma vez resolvido o problema, desactive e volte a ativar o plug-in para concluir a atualização.

Erro 400 da API: A sua conta está ligada à conta do Facebook e a atividade futura da sua conta do Facebook está atualmente desactivada.

Devido à forma como a API do Instagram/Facebook funciona, se a definição de atividade futura fora do Facebook estiver desactivada, não é possível utilizar as nossas aplicações do Instagram ou do Facebook para apresentar o feed. Para ligar a fonte e apresentar o feed, terá de se ligar utilizando uma conta do Facebook ou uma conta do Instagram com a sua conta do Facebook ligada que tenha esta opção activada. Atualmente, não há forma de contornar esta situação, uma vez que se trata de uma limitação direta da API, que não podemos afetar. Pode encontrar informações detalhadas sobre a atividade fora do Facebook aqui: https://www.facebook.com/help/1224342157705160

Erro: Não foram encontradas mensagens:

  • Feed do utilizador: A conta não tem publicações feitas no Instagram.com
  • Feed de hashtag recente: Não foram efectuadas mensagens para esta hashtag nas últimas 24 horas
  • Está a utilizar muitas publicações IGTV no seu feed - Ver abaixo
  • Problema com o seu Token de Acesso - Ver Erro 400 da API: O access_token fornecido é inválido
  • Demasiada filtragem com includewords, excludewords, whitelist ou bloqueio de fotografias - Ver esta FAQ

A sua conta tem muitas publicações IGTV

O Instagram ainda não suporta publicações IGTV na sua API. No entanto, essas postagens ainda são contadas na solicitação da API, mesmo que não sejam retornadas. Isso pode fazer com que o plug-in pense que não há postagens disponíveis se todas as postagens recentes forem postagens IGTV.

Solução:
Para resolver este problema, vá ao separador "Personalizar" na página de definições do "Feed do Instagram" e encontre a definição "Tamanho do pedido de API" e aumente-a para 25 ou mais, dependendo da frequência com que utiliza as publicações IGTV.

A sua conta é privada: O token de acesso irá expirar.

Isto deve-se ao facto de a conta estar definida como "privada" no Instagram. As contas privadas têm de ser reconectadas manualmente a cada 60 dias para recuperar novas publicações.

Solução:
Torne a sua conta "pública" ou lembre-se de a voltar a ligar uma vez a cada 60 dias.

Erro: Não é possível recuperar mensagens para este hashtag: O Hashtag "XXXXXXXX" solicitado pelo utilizador não pode ser visto devido à falta de permissões, é inválido ou não existe.

  • Não foram efectuadas publicações públicas com este hashtag. Assim que for efectuada uma publicação com este hashtag, este erro será resolvido

Erro 100 da API: tentou aceder a um campo inexistente (media_product_type) no tipo de nó (Media)

Certifique-se de que o seu plug-in está atualizado no seu Painel de controlo do WordPress > Plug-ins > Plug-ins instalados.

Terá também de voltar a ligar a sua fonte. Para obter instruções sobre como o fazer, consulte esta documentação de reconexão.

Erro 100 da API: pedido de obtenção não suportado.

Erro 100 da API: Pedido de obtenção não suportado. O objeto com o ID 'xxxxxxxxxxxxxxx' não existe, não pode ser carregado devido à falta de permissões ou não suporta esta operação.

Isto também pode dever-se ao facto de o ID de origem não corresponder à origem autenticada do Token de acesso. Uma causa potencial seria a alteração das definições no Instagram/Facebook. Causas potenciais:

  • Alterar os utilizadores administradores da página do Facebook relacionada
  • Alterar a palavra-passe da conta do Instagram ou do Facebook
  • Alterar as suas definições de privacidade no Instagram ou no Facebook
  • Alterar as definições relacionadas com as permissões da aplicação para o Instagram ou o Facebook

Solução:
Pode voltar a ligar a Fonte seguindo esta FAQ.

Nota: Se a mensagem de erro continuar a ser apresentada depois de fazeres isto, tenta limpar o registo de erros na seguinte localização: Feed do Instagram > Definições > Avançadas > botão "Repor registo de erros".

Erro 190 da API: Erro ao validar o token de acesso.

Tem um problema com o seu Token de acesso. Isto pode dever-se à alteração da palavra-passe na conta ligada ou a outras alterações de segurança, ou ao facto de a nossa aplicação ter sido removida das integrações empresariais da conta. Também pode ter copiado incorretamente o seu token de acesso ao tentar ligar uma conta.

Solução:

Remova a fonte do plug-in navegando para Instagram Feed > Configurações > remova a(s) fonte(s) conectada(s) clicando no ícone vermelho da lixeira e, em seguida, clique no botão Salvar alterações. Depois disso, tente obter um novo token de acesso e conectar-se manualmente. Para garantir a criação de um token de acesso válido, você pode seguir nosso guia aqui.

Erro 18 da API: O limite de 30 pesquisas de hashtag únicas por semana foi atingido.

O Instagram tem um limite de 30 pesquisas de hashtag únicas numa base semanal contínua. Se o seu site necessitar de mais de 30 feeds de hashtag, terá de criar uma segunda conta empresarial do Facebook/Instagram e ligá-la, acedendo a Feed do Instagram > Definições e clicando em Adicionar fonte na secção Gerir fontes.

Erro 1 da API: ocorreu um erro desconhecido.

Certifique-se de que está atualizado com a versão mais recente do plug-in. Se este erro continuar a aparecer, pode haver um problema com a API do Facebook/Instagram. Contactar o suporte.

Erro 2 da API: ocorreu um erro inesperado. Por favor, tente novamente o seu pedido mais tarde.

Pode haver um problema temporário com a API do Instagram/Facebook. Tenta limpar a tua cache, acedendo a Feed do Instagram > Definições > Feeds e clicando em Limpar todas as caches. Se o feed continuar a não ser atualizado após algumas horas, contacta o suporte.

Erro 999: O token de acesso não pôde ser desencriptado.

Todos os dados do Instagram, incluindo os tokens de acesso, são encriptados na sua base de dados. Se migrar a sua base de dados de outro site, como um site de desenvolvimento ou de preparação, poderá ter de voltar a ligar a sua conta ou contas para que os feeds sejam actualizados, seguindo estes passos:

Remova a fonte do plug-in navegando para Instagram Feed > Configurações > remova a(s) fonte(s) conectada(s) clicando no ícone vermelho da lixeira e, em seguida, clique no botão Salvar alterações. Depois disso, clique em Adicionar fonte e recrie a conexão. Você também pode tentar recuperar um token de acesso e criar manualmente uma conexão com o nosso guia aqui.

Se voltar a ligar a sua conta, mas esta voltar a ser desligada continuamente com a apresentação do erro 999, siga os passos deste guia para corrigir o problema.

Erro de ligação: http_request_failed - erro 7 do cURL: Falha na ligação a api.instagram.com porta 443: Ligação recusada

Alguns anfitriões têm restrições ou definições de segurança para impedir pedidos remotos a outros sítios Web.

Solução:
Normalmente, eles podem resolver o problema ou abrir uma exceção para o seu sítio. Tente contactar o seu anfitrião com uma mensagem como esta:

Parece que o nosso plug-in do Instagram está a encontrar um erro ao tentar ligar-se à API do Instagram. Os programadores pediram-nos para vos contactar e mencionar que estamos a ver o erro http_request_failed - cURL error 7: Failed to connect to api.instagram.com port 443: Connection timed out when trying to make remote connections to api.instagram.com/.

Erro de ligação: http_request_failed - erro 6 do cURL: Não foi possível resolver o anfitrião: graph.facebook.com

O seu servidor pode não estar ligado à Internet ou o seu anfitrião pode estar a bloquear a ligação. Se estiver a utilizar um ambiente de desenvolvimento local, certifique-se de que está ligado à Internet.

Erro de ligação: http_request_failed - erro cURL 28: A resolução expirou após 10000 milissegundos

O seu servidor pode ter restrições na ligação à API do Instagram.

Solução:
Se isso ocorrer ao tentar conectar uma fonte, tente reconectar após 10 minutos ou mais. Se isto não resolver o problema ou se for intermitente, tente contactar o seu anfitrião e mencione que está a ver este erro ao tentar ligar-se à API do Instagram.

Uma solução alternativa é tentar ligar-se como um perfil "Business" seguindo estas instruções.

Erro 200 da API: requer permissão instagram_basic para gerir o objeto, a aplicação pode ter a permissão mas, para utilizar esta API, a aplicação tem de pertencer a uma empresa verificada.

Isto acontece quando a ligação entre uma página do Facebook e o perfil empresarial do Instagram ligado ao plug-in é removida.

Solução:

Para ligar a sua fonte como um perfil empresarial do Instagram, tem de existir uma ligação a uma página do Facebook. Certifica-te de que a tua conta está configurada corretamente seguindo este guia: Perfis comerciais do Instagram - Smash Balloon.

Volte a ligar a sua fonte no plugin. Para o fazer, siga os passos abaixo:

  • Aceda ao seu painel de controlo do WordPress > Feed do Instagram > Definições > remover a(s) fonte(s) conectada(s) clicando no ícone vermelho da lixeira (Ver captura de ecrã) e, em seguida, clique no botão Salvar configurações.
  • Quando enviado para o Facebook, terá de clicar no botão Editar definições para rever as suas definições de ligação e garantir que TODAS as páginas, perfis e permissões estão selecionados.
  • Quando a sua fonte tiver sido adicionada novamente, clique no botão Guardar alterações.
  • Navegue até às definições do seu feed > Fontes e certifique-se de que a conta que voltou a ligar ao plug-in está ligada ao feed que apresenta (Ver captura de ecrã).

Se continuar a ter problemas com a apresentação das suas mensagens depois de tentar resolver os problemas comuns acima referidos, contacte o serviço de apoio para obter assistência.

Já corrigiste o teu feed? Eis como evitar ter de o reconstruir sempre que ele avaria.

O Smash Balloon Instagram Feed Pro restabelece a ligação de fontes interrompidas com apenas alguns cliques, em vez de as eliminar e recriar do zero. Oferece uma garantia de reembolso de 14 dias.

Resolva isto de uma vez por todas
apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto

Categorias