Referência de mensagens de erro da API do X (anteriormente Twitter)

Uma tabela de referência com as mensagens de erro da API do X (Twitter), o que cada uma significa e como resolvê-las, começando pelas falhas de autenticação.

Está a ver uma mensagem de erro no lugar do seu feed do Twitter?

Neste guia, vamos explicar o que significa cada mensagem do plugin e como resolver o problema. Basta ter acesso ao painel de controlo do WordPress.

Antes de começar, certifique-se de que a versão mais recente do «Custom Twitter Feeds» está instalada e ativada no seu site WordPress.

Onde aparecem as mensagens de erro

Quando o seu feed não consegue apresentar tweets, o plugin exibe uma mensagem no local onde o feed normalmente aparece. Se estiver a iniciar sessão no WordPress como administrador, verá uma caixa com o erro e o que deve fazer a seguir.

Uma caixa numa página com o título «Esta mensagem só é visível para administradores», com a mensagem «Não foram encontrados tweets para as fontes de feed selecionadas»

Os visitantes não vêem essa caixa. No lugar do feed, vêem a mensagem «O feed do Twitter não está disponível neste momento.»

O plugin também mantém uma lista com data das mensagens recentes nas «Informações do Sistema», na secção «ERROS».

Mensagens de erro

As mensagens estão listadas por ordem alfabética. Encontre a que está na sua página. Depois, siga as instruções da última coluna.

MensagemO que isso significaO que fazer
Erro [número]: [detalhes].A API do Smash Balloon respondeu com um erro que não apresenta qualquer mensagem.Na versão paga, teste a sua ligação. Se a mensagem persistir, contacte a nossa equipa de apoio técnico, indicando o texto completo da mensagem.
Erro na solicitação HTTP – [código]: [detalhes]O seu servidor não recebeu uma resposta da API do Smash Balloon. Os detalhes indicam o motivo.Na versão paga, teste a sua ligação. Em seguida, verifique os requisitos do servidor.
Parece que não foram encontrados tweets que correspondam às tuas definições de moderação do feed.Os filtros do teu feed não apresentam nenhum tweet.Edita os filtros do teu feed para que caibam mais tweets, ou espera por novos tweets que correspondam a esses filtros.
Parece que ultrapassou o seu limite diário de atualizações do feed para este site a partir de [data].O seu site já esgotou as atualizações do feed para hoje, pelo que os novos tweets terão de aguardar até que o limite seja reiniciado. O limite é de 12 no nível de licença básica, 18 no nível de licença «plus» e 24 no nível de licença «elite».Não é necessário fazer nada. O limite é reiniciado automaticamente no prazo de 24 horas. A versão gratuita é atualizada uma vez por semana, pelo que o seu limite é reiniciado na semana seguinte.
Não foi encontrado nenhum feed com o ID [número].O ID do feed no seu shortcode não corresponde a nenhum feed do seu site. Todos os que acedem à página vêem esta mensagem.Aceda à página «Todos os feeds» no plugin e copie o código curto do feed que pretende.
Não foram encontrados tweets para as fontes de feed que selecionou.O plugin não tem tweets para apresentar neste feed. A fonte pode não ter tweets, os filtros do feed podem estar a ocultá-los, ou um feed de hashtag ou de pesquisa pode ter atingido o seu limite de sete dias.Verifique as fontes e os filtros no seu feed e, em seguida, limpe a cache do feed.
Pode haver um problema com as suas credenciais para utilizar a API do Smash no TwitterA API do Smash Balloon não aceitou as credenciais do seu site.Reative a sua chave de licença. Na versão gratuita, atualize a chave do seu site.
Demasiados pedidosA versão gratuita apresenta esta mensagem quando a API recebe demasiados pedidos num curto espaço de tempo.Aguarde a próxima atualização do seu feed. Se a mensagem persistir, contacte a nossa equipa de apoio.
O feed do Twitter não está disponível neste momento.É isto que os visitantes vêem no lugar do feed quando ocorre um erro.Abra a página enquanto estiver a iniciar sessão no WordPress como administrador para ver a mensagem completa.
Não foi possível concluir a atualização dos seus feeds. Parece que a sua chave de licença não está autorizada neste site para efetuar pedidos à API do TwitterA API do Smash Balloon não aceitou a sua chave de licença para este site. Na versão gratuita, a mensagem indica a chave do seu site.Reative a sua chave de licença. Na versão gratuita, atualize a chave do seu site.
O seu site não consegue estabelecer ligação ao smashballoon.com e iniciar a atualização dos feeds.O seu site não tem uma ligação ativa ao Smash Balloon.Reative a sua chave de licença. Na versão gratuita, atualize a chave do seu site.

Reativar a sua chave de licença

Várias mensagens pedem-lhe para desativar e, em seguida, reativar a sua chave de licença. A sua chave permanece guardada enquanto faz isso, pelo que não precisa de a introduzir novamente.

Para começar, aceda a Twitter Feed » Definições no painel de controlo do WordPress. Em seguida, no separador «Geral», clique em «Desativar» na secção «Chave de licença».

O item de menu «Definições do feed do Twitter» no painel de controlo do WordPress e o botão «Desativar» na secção «Chave de licença» do separador «Geral»

O estado passa a ser «Inativo». Em seguida, clique em «Ativar».

A secção «Chave de Licença», que indica que a licença está inativa, com o botão «Ativar»

O estado volta a ser «Ativo».

Na versão gratuita, aceda a Feeds do Twitter » Definições e clique em «Atualizar» na linha «Chave do site». Se, em vez disso, essa linha apresentar a opção «Ligar», significa que o seu site ainda não está ligado. O nosso guia sobre como configurar a versão gratuita explica-lhe passo a passo como proceder.

Testar a sua ligação

A versão paga inclui um teste que verifica se o seu servidor consegue aceder ao smashballoon.com.

Para o ativar, aceda a Twitter Feed » Definições no painel de controlo do WordPress. Em seguida, clique em «Testar ligação » na secção «Chave de licença» do separador «Geral».

A secção «Chave de Licença» do separador «Geral», com uma seta no link «Testar ligação»

O resultado aparece no lugar do link. «Ligação bem-sucedida» significa que o seu servidor conseguiu aceder ao smashballoon.com. «Ligação falhada» significa que não conseguiu. O link «Ver erro», ao lado, indica o motivo.

Este teste verifica o smashballoon.com, e as suas atualizações de feeds são feitas através do ctf.smashballoon.com. Se o teste falhar ou se a mensagem persistir, verifique os requisitos do servidor abaixo.

Erros na sua própria aplicação

Se tiver ligado a sua própria aplicação através da funcionalidade «Ligar a sua própria aplicação» (V2), o plugin acede diretamente à API do X, em vez de à API do Smash Balloon. Os erros do X são guardados nas «Informações do sistema», na secção «ERROS».

Eis como interpretar o que encontrar lá:

  • «Não foi possível estabelecer ligação à API do Twitter. O seu alojamento pode estar a bloquear a ligação.» significa que o seu servidor não consegue aceder à API X. Para resolver este problema, verifique os requisitos do servidor abaixo.
  • Um erro relacionado com as suas chaves ou tokens significa que o X não os aceitou. Para resolver este problema, verifique se a Chave de Consumidor, o Segredo de Consumidor, o Token de Acesso e o Segredo do Token de Acesso no plugin correspondem aos da sua aplicação no X. O nosso guia sobre como criar a sua própria aplicação no X indica onde encontrar cada um deles.

Requisitos do servidor

Os feeds personalizados do Twitter requerem o PHP 7.4 ou superior. Na versão paga, a opção «Acesso de escrita ao MCP» requer o WordPress 6.9 ou superior.

A ligação predefinida atualiza os seus feeds através da API do Smash Balloon em ctf.smashballoon.com. Utiliza a API HTTP do WordPress. O seu servidor tem de permitir ligações HTTPS de saída para esse endereço. Se essas ligações estiverem bloqueadas, peça ao seu fornecedor de alojamento web para as autorizar.

O cURL e o allow_url_fopen só são relevantes se tiver ligado a sua própria aplicação e definido o Método de Pedido como cURL ou file_get_contents(). O plugin chama então a API X em api.twitter.com utilizando esse método. O seu servidor necessita da opção correspondente.

Para verificar ambas as opções, abra a «Informação do Sistema». Em seguida, procure as linhas «PHP allow_url_fopen» e «PHP cURL».

O texto «Informações do sistema», nas linhas relativas às opções «allow_url_fopen» e «cURL» do PHP, apresenta «Sim» em ambas

A opção «Método de pedido» encontra-se no separador «Avançado» das definições do plugin. Por predefinição, está definida como «Automático». Só é necessário alterá-la se utilizar a sua própria aplicação e não conseguir estabelecer ligação ao X.

A definição «Método de pedido» no separador «Avançado» das definições do plugin está definida como «Automático»

Se o seu servidor cumprir estes requisitos e continuar a receber uma mensagem de erro, a secção seguinte explica como obter ajuda.

Ainda não está a funcionar?

Se continuar a ver uma mensagem de erro, a nossa equipa pode analisar o caso mais detalhadamente. Contacte a nossa equipa de apoio e forneça os seguintes detalhes:

  • A mensagem de erro completa
  • O URL da página com o seu feed
  • O tipo e a fonte do seu feed
  • As soluções que já experimentaste
  • Informações do seu sistema

E pronto! Agora já sabes o que significa cada mensagem de erro e como resolvê-la. A seguir, consulta o nosso guia sobre as alterações à API X para saberes como funcionam as atualizações do feed.

Perguntas mais frequentes

A seguir, respondemos a algumas das perguntas mais frequentes sobre as mensagens de erro nos Feeds Personalizados do Twitter.

A desativação da minha chave de licença irá removê-la do meu site?

Não. A sua chave de licença permanece guardada no campo «Chave de licença». Consulte a secção «Reativar a sua chave de licença », acima, para conhecer os passos a seguir.

Preciso de alterar a configuração do método de pedido?

Apenas se utilizar a sua própria aplicação e não conseguir estabelecer ligação ao X. A ligação predefinida utiliza sempre a API HTTP do WordPress. Nessa ligação, pode deixar a configuração em «Automático».

apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto