Referência de mensagens de erro da API do Instagram

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.

Gostaria de saber o que significa uma mensagem de erro no feed do Instagram e como resolvê-la?

Neste guia, vamos explicar-lhe as mensagens de erro que o Instagram Feed pode apresentar e os passos para resolver cada uma delas. Basta ter o texto do erro no seu site ou no painel de controlo do WordPress. Para o encontrar rapidamente, prima Ctrl+F (Cmd+F num Mac) e procure uma parte da mensagem.

Antes de começar, certifique-se de que o Instagram Feed está instalado e ativado no seu site.

Eis os temas que iremos abordar.

O Instagram está em baixo?

Se o teu feed deixou de ser atualizado, verifica primeiro se a Meta está a comunicar algum problema na sua página de estado. Enquanto o Instagram estiver indisponível, o teu feed continuará a mostrar as publicações guardadas. Um aviso informa-te de que o feed está desatualizado.

Para saber mais sobre esse alerta, consulte o nosso guia sobre como receber alertas quando o seu feed do Instagram deixar de ser atualizado.

Se a página de estado não indicar qualquer problema, ou se o seu feed continuar sem atualizar após uma hora, procure a sua mensagem de erro abaixo. Se não estiver na lista, contacte o apoio ao cliente.

Por que razão as solicitações à API estão a sofrer atrasos?

Se o seu site efetuar várias solicitações de API incorretas num curto espaço de tempo, o Instagram pode bloquear temporariamente todas as solicitações provenientes do seu site. Para evitar isso, o Instagram Feed aguarda um certo tempo antes de efetuar outra solicitação de API após um erro.

O tempo de espera depende do erro.

  • 3 minutos após a maioria dos erros da API, incluindo os erros 1 e 2.
  • 5 minutos após o erro 24.
  • 15 minutos após o erro 18 e após um erro de limitação de taxa.
  • 60 minutos após o erro 368, que corresponde a um bloqueio temporário do Instagram.

Não é preciso ficar à espera. Guardar a página de definições do Feed do Instagram põe fim à espera após a maioria dos erros de API, tal como o botão «Limpar todos os caches » no separador «Feeds». O nosso guia de definições do Feed do Instagram indica onde se encontra esse botão.

Por que razão estou a ver mensagens de erro que já não se aplicam?

O Feed do Instagram regista erros da API para o ajudar a resolver problemas de ligação. Apenas alguns destes erros desaparecem por si próprios assim que o problema for resolvido.

Pode reiniciar o registo de erros através da opção «Reiniciar registo de erros», na separador «Avançado» da página de definições do feed do Instagram. Ao reiniciá-lo, os caches do seu feed também são limpos. Para conhecer os passos com capturas de ecrã, consulte a secção sobre como eliminar uma mensagem de erro antiga.

Uma fonte marcada como «Fonte inválida» permanece marcada após reiniciar o registo. Para a eliminar, volte a ligar a fonte.

Para conhecer os passos a seguir, consulte o nosso guia sobre como restabelecer uma fonte inválida do feed do Instagram.

Mensagens de erro do feed do Instagram

Cada título abaixo corresponde ao texto de uma mensagem de erro. Nos casos em que o texto do erro inclui um ID ou uma hashtag, este é apresentado aqui como XXXXXXXX.

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

O plugin apresenta isto como um aviso de administração intitulado «Ação necessária: Não foi possível guardar ou atualizar as fontes de feeds». Isto significa que o plugin não conseguiu atualizar as tabelas da sua base de dados.

Certifique-se de que o seu utilizador da base de dados possui permissões ALTER. O plugin também necessita das permissões SELECT, INSERT, UPDATE, DELETE, CREATE TABLE, DROP TABLE e INDEX.

Se necessário, contacte o seu fornecedor de alojamento. Assim que o problema estiver resolvido, desative e reative o plugin para concluir a atualização. O aviso também inclui um botão «Tentar criar as tabelas da base de dados novamente», que tenta criar as tabelas mais uma vez.

Erro 400 da API: A sua conta está associada a uma conta do Facebook e a funcionalidade de atividades futuras fora do Facebook da sua conta do Facebook está, neste momento, desativada.

Este erro deve-se a uma configuração do Facebook, e não ao plugin. Se a configuração «Atividade futura fora do Facebook» estiver desativada, a API do Instagram e do Facebook não permite que utilize os nossos plugins do Instagram ou do Facebook para apresentar um feed. Trata-se de uma limitação da própria API, e o plugin não consegue contorná-la.

Para ligar a fonte e apresentar o feed, é necessário iniciar sessão com uma conta do Facebook ou com uma conta do Instagram associada a uma conta do Facebook, na qual esta configuração esteja ativada.

Para conhecer os passos a seguir, consulte a secção «A sua atividade fora das tecnologias Meta está atualmente desativada», abaixo.

Pode encontrar informações detalhadas sobre a atividade fora do Facebook na página de ajuda do Facebook.

A sua atividade fora das tecnologias Meta está, neste momento, desativada

Este erro surge normalmente quando ligas a tua conta do Instagram através do nosso plugin. Está relacionado com uma configuração chamada «atividade fora do Facebook».

A ligação ao Instagram depende das APIs do Instagram e do Facebook e, se esta configuração estiver desativada, o seu feed não poderá ser apresentado. Trata-se de uma limitação da própria API, que não podemos alterar.

Para ativar esta configuração, siga estes passos.

  1. Visite as Definições do Facebook.
  2. Procure a secção "Atividade fora do Facebook".
  3. Clique em «Gerir atividades futuras».
  4. Clique em «Atividade futura da Connect».
  5. Clique em «Confirmar».
O ecrã «Gerir atividades futuras» nas definições do Facebook, com a opção «Ligar atividades futuras» selecionada

Assim que a função estiver ativada, volte a ligar a sua fonte.

Para conhecer os passos a seguir, consulte o nosso guia sobre como restabelecer uma fonte inválida do feed do Instagram.

Erro: Não foram encontradas mensagens.

O feed do Instagram apresenta esta mensagem quando não tem publicações para mostrar. As causas mais comuns encontram-se abaixo.

  • Feed do utilizador. A conta não tem publicações no Instagram.com.
  • Feed recente desta hashtag. Não foram publicadas quaisquer publicações com esta hashtag nas últimas 24 horas.
  • Problema com o seu token de acesso. Para saber como resolver, consulte o erro de API 190.
  • Filtragem excessiva. Os filtros do teu feed, como os filtros de palavras ou as publicações ocultas, removem todas as publicações. Para os ajustar, consulta o nosso guia sobre como filtrar as publicações no teu feed.

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

O plugin apresenta a mensagem «Erro: Conta privada do Instagram» quando o token de acesso de uma conta privada tem menos de 10 dias de validade. O Instagram exige que as contas privadas sejam reautenticadas a cada 60 dias.

Para resolver este problema, torna a tua conta pública no Instagram ou lembra-te de voltar a ligar a conta uma vez a cada 60 dias.

Para conhecer os passos a seguir, consulte o nosso guia sobre como restabelecer uma fonte inválida do feed do Instagram.

Erro: Não é possível recuperar publicações para esta hashtag: A hashtag «XXXXXXXX» solicitada pelo utilizador não pode ser visualizada devido à falta de permissões, é inválida ou não existe.

Ainda não foram publicadas quaisquer publicações públicas com esta hashtag. Assim que for publicada uma publicação com esta hashtag, este erro será resolvido.

Após este erro, o plugin aguarda 5 minutos antes de tentar novamente.

Para saber mais sobre os feeds de hashtags, consulte o nosso guia sobre como apresentar um feed de hashtags do Instagram.

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

Certifique-se de que o seu plugin está atualizado no Painel de Controlo do WordPress » Plugins » Plugins instalados.

Também terá de voltar a ligar a sua fonte. Para obter instruções sobre como o fazer, consulte o nosso guia de reconexão.

Erro 100 da API: Pedido GET não suportado.

A mensagem completa diz: «Erro de API 100: Pedido GET não suportado. O objeto com o ID «XXXXXXXX» 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 da fonte não corresponder à fonte autenticada para o token de acesso. Uma alteração nas definições do Instagram ou do Facebook pode causar esta situação, como, por exemplo, as alterações abaixo indicadas.

  • Alterar os utilizadores administradores da página do Facebook associada.
  • Alterar a palavra-passe da conta do Instagram ou do Facebook.
  • Alterar as tuas definições de privacidade no Instagram ou no Facebook.
  • Alterar as definições relacionadas com as permissões das aplicações do Instagram ou do Facebook.

Para resolver este problema, volte a ligar a fonte seguindo o nosso guia de reconexão.

Nota: Se a mensagem de erro continuar a ser apresentada após restabelecer a ligação, limpe o registo de erros, que pode conter erros que já não se aplicam. A definição «Repor registo de erros», no separador «Avançado» da página «Definições do Feed do Instagram», permite fazer isso, tal como mostra o nosso guia sobre como eliminar uma mensagem de erro antiga.

Erro de API 190: Erro na validação do token de acesso.

Tem um problema com o seu token de acesso. Isto pode dever-se a uma alteração da palavra-passe na conta associada ou a outras alterações de segurança. A remoção da nossa aplicação das «Integrações Empresariais» da conta também pode causar este problema. Também é possível que tenha copiado o seu token de acesso incorretamente ao associar uma conta manualmente.

Quando o plugin consegue identificar a causa, apresenta uma destas mensagens.

  • Erro: A aplicação Smash Balloon já não está autorizada para esta conta do Instagram. O feed não será atualizado.
  • Erro: A palavra-passe da conta foi alterada, o que invalidou o token de acesso guardado. O feed não será atualizado.
  • Erro: O token de acesso guardado expirou. O feed não será atualizado.
  • Erro: O token de acesso guardado já não é válido. O feed não será atualizado.
  • Erro: O Instagram aplicou uma verificação de segurança a esta conta. O titular da conta tem de iniciar sessão no Instagram para a desbloquear.
  • Erro: Esta conta do Instagram não está confirmada. O titular da conta tem de a confirmar junto do Instagram.

No que diz respeito às mensagens relativas ao controlo de segurança e às contas não confirmadas, o titular da conta tem de concluir o passo no Instagram antes de o feed poder ser atualizado.

Para resolver os outros erros, volte a ligar a fonte. Na secção «Gerir fontes » da página «Definições do feed do Instagram», uma fonte com este erro apresenta a mensagem «Fonte inválida » e um link «Voltar a ligar ». O nosso guia sobre como voltar a ligar uma fonte inválida explica cada passo.

Se o erro persistir, elimine a fonte e adicione-a novamente. O ícone do caixote do lixo ao lado da fonte, na secção «Gerir Fontes», elimina-a assim que confirmar na janela que se abre. Os feeds que utilizam essa fonte deixam de receber novas publicações até que a adicione novamente.

Em seguida, adicione novamente a fonte através do botão «Adicionar fonte», apresentado na nossa referência às definições do Feed do Instagram. Para estabelecer a ligação utilizando um token de acesso, utilize a opção «Adicionar conta manualmente» na página de ligação e siga o nosso guia sobre como criar um token de acesso e um ID de utilizador para ligar manualmente uma conta do Instagram.

Para saber quanto tempo dura uma ligação e quais as fontes que se atualizam automaticamente, consulte «Quanto tempo dura uma ligação no Instagram e como é que se atualiza».

Erro: Esta conta já não tem acesso à página associada.

O plugin apresenta esta mensagem para cerca de 190 erros, em vez das mensagens acima. Isto acontece quando a conta associada perdeu a sua função de administrador, editor ou moderador na página do Facebook associada. Também acontece quando essa página passa a exigir a autenticação de dois fatores e a conta ainda não a ativou.

A reconexão não resolve nenhum dos dois problemas. Para resolver a situação, restaure a função da página ou ative a autenticação de dois fatores. Em seguida, tente novamente aceder ao feed.

Erro 18 da API: Foi atingido o limite de 30 pesquisas de hashtags únicas por semana.

O Instagram tem um limite de 30 pesquisas de hashtags únicas por semana, calculado de forma contínua. O plugin apresenta a seguinte mensagem : «Erro: foi atingido o limite de 30 hashtags únicas por semana». Após este erro, o plugin aguarda 15 minutos antes de tentar novamente.

Se o seu site precisar de mais de 30 feeds de hashtags, ligue uma conta empresarial adicional do Instagram, associada a uma identidade separada no Instagram e a uma página do Facebook. Ligar uma conta empresarial adicional do Instagram associada à mesma página do Facebook não aumenta o limite.

Pode ligá-lo através do botão «Adicionar fonte» na secção «Gerir fontes » da página de definições do Feed do Instagram. O nosso guia de definições do Feed do Instagram indica onde se encontra.

Erro 1 da API: Ocorreu um erro desconhecido.

Primeiro, atualiza o Instagram Feed para a versão mais recente. Após este erro, o plugin aguarda 3 minutos antes de tentar novamente.

Se este erro continuar a aparecer, poderá tratar-se de um problema com a API do Instagram ou do Facebook. Para confirmar, consulte a página de estado e, se o erro persistir, contacte o apoio ao cliente.

Erro 2 da API: Ocorreu um erro inesperado. Por favor, volte a tentar mais tarde.

Pode haver um problema temporário com a API do Instagram ou do Facebook. Após este erro, o plugin aguarda 3 minutos antes de tentar novamente.

Limpar a cache põe fim ao período de espera de 3 minutos, pelo que o plugin pode tentar novamente de imediato. O botão «Limpar todas as caches» encontra-se no separador «Feeds» da página de definições do Feed do Instagram, tal como mostra o nosso guia de definições do Feed do Instagram.

Se o feed continuar sem ser atualizado após algumas horas, contacte o apoio ao cliente.

O Instagram está a limitar temporariamente os pedidos provenientes deste site.

O Feed do Instagram mostra isto quando o Instagram informa que o seu site atingiu um limite de frequência. Não há nenhum problema. Não é necessário voltar a ligar a sua fonte.

O teu feed continua a mostrar as publicações guardadas. O plugin volta a tentar automaticamente ao fim de 15 minutos.

A parte da mensagem que só os administradores do WordPress conseguem ver acrescenta que os limites de taxa ocorrem com menos frequência quando se aumenta o tempo de armazenamento em cache. Essa configuração encontra-se na secção «Caching» do separador «Feeds», na página «Definições do Feed do Instagram». O nosso guia sobre as definições do Feed do Instagram explica cada opção.

O plugin trata estes códigos de erro da API como limites de taxa.

  • Erro 4 da API
  • Erro 9 da API
  • Erro 17 da API
  • Erro 32 da API
  • Erro 341 da API
  • Erro 613 da API
  • Erro da API 130429

Erro 368 da API: O Instagram bloqueou temporariamente os pedidos relativos a esta conta.

O plugin apresenta esta mensagem quando ocorre o erro 368 da API. Esta mensagem desaparece por si só, não sendo necessário restabelecer a ligação. O plugin aguarda 60 minutos antes de tentar novamente.

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 com as chaves de segurança do WordPress do seu site. Se migrar a sua base de dados a partir de um site que utilize chaves diferentes, como um site de teste, o plugin não conseguirá desencriptar os tokens de acesso. Poderá ser necessário voltar a ligar as suas contas para que os feeds sejam atualizados.

A fonte pode apresentar a mensagem «Fonte inválida » ou «Erro de encriptação » na secção «Gerir fontes » da página de definições do feed do Instagram, acompanhada de um link «Reconectar ». Para resolver este problema, volte a ligar a fonte, tal como indicado no nosso guia sobre como voltar a ligar uma fonte inválida.

Se isso não funcionar, elimine a fonte e adicione-a novamente. O ícone do caixote do lixo ao lado da fonte, na secção «Gerir Fontes», elimina-a assim que confirmar na janela que se abre.

Em seguida, adicione novamente a fonte através do botão «Adicionar fonte», apresentado na nossa referência às definições do Feed do Instagram. Para estabelecer a ligação utilizando um token de acesso, utilize a opção «Adicionar conta manualmente» na página de ligação e siga o nosso guia sobre como criar um token de acesso e um ID de utilizador para ligar manualmente uma conta do Instagram.

Se voltar a ligar a sua conta, mas esta continuar a desligar-se e o erro 999 voltar a aparecer, siga os passos indicados no nosso guia sobre como resolver o erro 999.

Erro de ligação: http_request_failed – erro 7 do cURL: Não foi possível estabelecer ligação com api.instagram.com na porta 443: Ligação recusada

Alguns fornecedores de alojamento têm restrições ou configurações de segurança que impedem pedidos remotos a outros sites. Normalmente, o seu fornecedor de alojamento pode resolver este problema ou abrir uma exceção para o seu site. Para obter ajuda, tente contactar o seu fornecedor de alojamento com uma mensagem como esta.

«Parece que o nosso plugin do Instagram está a encontrar um erro ao tentar ligar-se à API do Instagram. Os programadores pediram-nos para entrar em contacto consigo e informar que estamos a observar o erro http_request_failed – erro cURL 7: Falha ao ligar-se à porta 443 do api.instagram.com: Ligação recusada ao tentar estabelecer ligações remotas ao api.instagram.com.»

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

É possível que o seu servidor não esteja ligado à Internet ou que o seu fornecedor de alojamento esteja a bloquear a ligação. Se estiver a utilizar um ambiente de desenvolvimento local, o seu computador tem de estar ligado à Internet.

Num site alojado, contacte o seu fornecedor de alojamento e informe-o de que está a receber este erro ao ligar-se ao graph.facebook.com.

Erro de ligação: http_request_failed – erro cURL 28: A resolução atingiu o tempo limite após 10 000 milissegundos

O seu servidor pode ter restrições quanto à ligação à API do Instagram. Se isto acontecer quando ligar uma fonte, tente voltar a ligar-se após cerca de 10 minutos. Se isso não resolver o problema, ou se o problema ocorrer de forma intermitente, contacte o seu fornecedor de alojamento relativamente a este erro ao ligar-se à API do Instagram.

Erro 200 da API: É necessária a permissão «instagram_basic» para gerir o objeto; a aplicação pode ter essa 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 associado ao plugin é removida. Para ligar a sua fonte como perfil empresarial do Instagram, é necessário que exista uma ligação a uma página do Facebook. Para verificar se a sua conta está configurada corretamente, consulte o nosso guia sobre perfis empresariais do Instagram.

Em seguida, volte a ligar a sua fonte no plugin.

  1. Primeiro, elimine a fonte. Na secção «Gerir fontes » da página de definições do feed do Instagram, o ícone do caixote do lixo ao lado da fonte elimina-a assim que confirmar na janela pop-up que se abre.
  2. Em seguida, adicione novamente a fonte através do botão «Adicionar fonte», apresentado na nossa referência às definições do Feed do Instagram. Na página de ligação, escolha o tipo de conta. Quando o Facebook apresentar as suas definições de ligação, abra «Editar definições» e certifique-se de que todas as páginas, perfis e autorizações estão selecionados.
  3. Assim que a sua fonte tiver sido adicionada novamente, abra o seu feed no personalizador e aceda a Definições » Fontes. A conta que voltou a ligar deve estar selecionada para o feed.

Se continuar a ter dificuldades em visualizar as suas publicações depois de ter experimentado as soluções acima, contacte o apoio ao cliente para obter ajuda.

E pronto! Agora já sabes como identificar uma mensagem de erro do feed do Instagram e como resolvê-la. Para receberes um alerta quando o teu feed deixar de ser atualizado, consulta o nosso guia sobre como receber alertas quando o feed do Instagram deixa de ser atualizado.

apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto