Como criar uma chave de API do TripAdvisor

Como criar uma chave API do TripAdvisor na Terra, a plataforma para programadores da empresa, para que possa atualizar as avaliações com mais frequência e adicionar mais fontes.

Gostaria que as suas avaliações do TripAdvisor fossem atualizadas com mais frequência ou que fossem apresentadas mais fontes do TripAdvisor?

Neste guia, vamos mostrar-lhe quando é necessário ter uma chave API do TripAdvisor. Também vamos explicar como criar uma na Terra, a plataforma para programadores do TripAdvisor, e como adicioná-la ou removê-la no Reviews Feed. Se decidir utilizar a sua própria chave, basta ter uma conta na Terra, que é independente de qualquer conta do TripAdvisor que já tenha.

Requisitos: Os feeds do TripAdvisor exigem o nível de licença «Elite» do Feed de Avaliações.

Antes de começar, certifique-se de que a versão mais recente do Reviews Feed está instalada e ativada no seu site WordPress.

Precisa de uma chave API do TripAdvisor?

A chave API é opcional. Os seus feeds do TripAdvisor funcionam mesmo sem ela.

Sem uma chave, o Reviews Feed liga-se ao TripAdvisor por si. Nesse caso, as suas avaliações do TripAdvisor são atualizadas uma vez por semana. O seu site também pode ter até três fontes do TripAdvisor sem uma chave.

Ao adicionar a sua própria chave, ocorrem duas alterações:

  • Atualizações mais rápidas: as suas avaliações no TripAdvisor são atualizadas a cada 12 horas, em vez de uma vez por semana.
  • Mais fontes: pode adicionar mais de três fontes do TripAdvisor.

Quando tenta adicionar uma quarta fonte do TripAdvisor sem uma chave, o Reviews Feed apresenta a mensagem «Limite de fontes excedido. Introduza a chave API». Em seguida, é redirecionado para o passo em que pode adicionar uma chave.

A janela «Adicionar fontes» no Feed de Avaliações, no passo «Adicionar uma chave API para o TripAdvisor», com a mensagem «Limite de fontes excedido. Introduza a chave API.» destacada

Se a atualização semanal for adequada ao seu site e se apresentar três ou menos fontes do TripAdvisor, não precisa de nenhuma chave.

Adicionar uma fonte do TripAdvisor sem uma chave

Para começar, vamos ligar o TripAdvisor como uma nova fonte de avaliações sem uma chave API.

Quando adiciona uma fonte do TripAdvisor, o Reviews Feed pede primeiro uma chave API. Se não tiver uma, pode saltar este passo.

Na etapa «Adicionar uma chave API para o TripAdvisor», deixe o campo em branco. Em seguida, clique em «Ignorar».

O passo «Adicionar uma chave API para o TripAdvisor» da janela «Adicionar fontes», com o texto que indica que a chave é opcional destacado e uma seta a apontar para o botão «Ignorar»

Em seguida, cole o link para a página da empresa no TripAdvisor no campo «URL da página». Depois, clique em «Concluir».

A etapa «URL da página» da janela «Adicionar fontes», com um link para uma listagem do TripAdvisor colado no campo e uma seta a apontar para o botão «Concluir»

O Feed de comentários adiciona a fonte e exibe a mensagem «Fonte adicionada com sucesso».

O campo «URL da página» aceita três tipos de entrada:

  • A ligação para a página de um hotel, restaurante ou atração no TripAdvisor. Estas ligações contêm «-d» seguido de números.
  • O link para uma avaliação da empresa. O «Feeds de Avaliações» indica a empresa a que a avaliação pertence.
  • Apenas o ID numérico da localização. Trata-se do número que se segue a «-d» no link da página.

O Feed de comentários requer um link para uma única empresa. Quando colas um link para outro conteúdo, uma mensagem abaixo do campo indica para onde esse link aponta:

  • Visitas guiadas e experiências: estas ligações remetem para o Viator, que não está disponível através da API pública do TripAdvisor.
  • Perfis de membros: estas ligações remetem para um membro do TripAdvisor, e não para uma empresa.
  • Páginas de categorias: estes links conduzem a um destino ou a uma lista de locais, e não a uma única entrada.
A etapa «URL da página» da janela «Adicionar fontes», com um link para um passeio do TripAdvisor no campo e a mensagem a explicar que os passeios e as experiências não estão disponíveis, em destaque

Se vir uma destas mensagens, ou uma a indicar que o Reviews Feed não conseguiu encontrar um ID de localização do TripAdvisor, abra a página da própria empresa no TripAdvisor. Em seguida, copie o link e cole-o no campo. O nosso guia sobre como adicionar uma fonte do TripAdvisor indica os links que o Reviews Feed aceita e o significado de cada mensagem.

Criar a sua chave API da Terra

Se pretender atualizações mais rápidas ou mais fontes, vai precisar da sua própria chave. O TripAdvisor emite chaves API através da Terra, a sua plataforma para programadores.

A Terra utiliza a sua própria conta, distinta de qualquer conta do TripAdvisor que tenha para a sua empresa. As chaves e as contas da API de Conteúdo mais antiga do TripAdvisor não são transferidas para a Terra. Vai precisar de uma nova chave da Terra, mesmo que já tenha utilizado uma chave da API do TripAdvisor anteriormente.

Primeiro, aceda à página de programadores do TripAdvisor e inscreva-se no Terra Discover, o pacote que substituiu a API de Conteúdo. As perguntas frequentes do Terra explicam o processo de inscrição.

O Discover funciona com um modelo de pagamento conforme a utilização. Inclui um nível gratuito. A utilização que exceda esse nível é faturada. A página de preços baseados na utilização da Terra apresenta os preços atuais.

Depois de se registar, gere a sua chave API a partir do Painel de Controlo do Terra. Em seguida, abra o separador «Visão Geral» para encontrar a sua chave no cartão «A minha chave API». Como vai precisar dela no seu site WordPress daqui a pouco, copie-a.

Nota: Trate a sua chave API como uma palavra-passe e não a partilhe publicamente. Se alguma vez for divulgada, gere-a novamente a partir do cartão «A minha chave API». Em seguida, adicione a nova chave ao Feed de Avaliações. O guia de segurança da Terra explica que a regeneração revoga imediatamente a chave antiga.

É tudo o que precisas do Terra. A seguir, volta ao teu site do WordPress.

Adicionar a chave ao feed de comentários

Depois de copiar a sua chave Terra, já está pronto para a guardar no Reviews Feed.

No painel de controlo do WordPress, aceda a Feed de comentários » Definições.

O menu de administração do WordPress com a opção «Feed de comentários» e, em seguida, «Definições» selecionadas

No separador «Geral», desça até à secção «Gerir chaves API». Em seguida, clique no ícone do lápis no cartão do TripAdvisor.

A secção «Gerir chaves API» das definições do Feed de Avaliações, com uma seta a apontar para o ícone do lápis no cartão do TripAdvisor

Na janela que se abre, cole a sua chave no campo. Em seguida, clique em «Atualizar» para a guardar.

A janela «Adicionar chave API para o TripAdvisor», com uma chave colada no campo e uma seta a apontar para o botão «Atualizar»

O botão nesta janela exibe a mensagem «Adicionar» até introduzir uma chave. Assim que o fizer, a mensagem muda para «Atualizar».

O Reviews Feed verifica a chave à medida que a guarda. Se a chave não funcionar, o Reviews Feed não a guarda e pede-lhe para verificar os dados que introduziu.

Nesse caso, copie novamente a chave do Terra Dashboard. Em seguida, cole-a no campo.

Assim que a chave for guardada, as suas avaliações do TripAdvisor são atualizadas a cada 12 horas. Também pode adicionar mais de três fontes do TripAdvisor.

A mesma chave aplica-se a todas as fontes do TripAdvisor no plugin. Não será necessário introduzi-la novamente para cada fonte que adicionar.

As suas chaves do Google e do Yelp devem ser introduzidas no mesmo local, tal como indicado na secção «Gerir chaves API» da nossa referência de definições.

Eliminar uma chave API

Se já não quiser utilizar a sua própria chave, pode removê-la a qualquer momento. O Reviews Feed volta então a utilizar a ligação integrada no plugin.

A remoção de uma chave é também a solução para as chaves da antiga API de Conteúdo do TripAdvisor. O TripAdvisor retirou essa API de serviço a 31 de agosto de 2026. Essas chaves já não funcionam.

Se uma dessas chaves ainda estiver guardada e você exibir fontes do TripAdvisor, o Reviews Feed apresenta um aviso na página «Definições». Para aceder às suas chaves a partir daí, clique em «Gerir chaves API » no aviso.

A mensagem «A sua chave API do TripAdvisor deixou de funcionar» na página «Definições do Feed de Avaliações», com uma seta a apontar para o botão «Gerir chaves API»

É possível distinguir os dois tipos de chaves pela sua forma. As chaves da API de conteúdo têm 32 caracteres e não contêm hífens. As chaves Terra são mais longas e contêm hífens.

Em seguida, abra a janela da chave do TripAdvisor na secção «Gerir chaves API», tal como fez quando adicionou a chave. Nessa janela, clique em «Remover».

A janela «Adicionar chave API para o TripAdvisor», com uma chave guardada e uma seta a apontar para o botão «Remover»

O Feed de Avaliações remove a chave. O aviso já não é apresentado. As suas avaliações no TripAdvisor são agora atualizadas uma vez por semana.

Se pretender continuar a utilizar a sua própria chave, adicione uma chave Terra em vez da antiga. Os passos são os mesmos descritos em «Adicionar a chave ao feed de avaliações».

E pronto! Agora já sabes quando precisas de uma chave API do TripAdvisor, como criar uma no Terra e como adicioná-la ou removê-la. A seguir, consulta o nosso guia sobre como apresentar o teu feed de comentários para tirares o máximo partido dos comentários no teu site.

Perguntas mais frequentes

A seguir, respondemos a algumas das perguntas mais frequentes sobre as chaves API do TripAdvisor no Feed de Avaliações.

Preciso de uma chave API do TripAdvisor para apresentar as avaliações do TripAdvisor?

Não. Os teus feeds do TripAdvisor funcionam sem uma chave.

Consulte a secção «Precisa de uma chave API do TripAdvisor?» acima para saber o que essa chave altera.

Porque é que não consigo adicionar outra fonte do TripAdvisor?

A mensagem «Limite de fontes excedido. Introduza a chave API.» significa que o seu site já tem três fontes do TripAdvisor sem uma chave. Para adicionar mais, crie uma chave API do Terra. Em seguida, adicione-a ao Feed de Avaliações.

Por que é que o «Feeds de Avaliações» indica que a minha chave API do TripAdvisor deixou de funcionar?

A sua chave guardada provém da antiga API de Conteúdo do TripAdvisor, que o TripAdvisor deixou de utilizar a 31 de agosto de 2026. Essas chaves não são transferidas para o Terra. Pode remover a chave para utilizar a ligação integrada no plugin. Também pode substituí-la por uma chave do Terra.

Como posso saber se a minha chave é uma chave da API de Conteúdo ou uma chave Terra?

Dá para perceber pela forma. As chaves da API de conteúdo têm 32 caracteres e não contêm hífens. As chaves Terra são mais longas e contêm hífens.

Que links do TripAdvisor posso utilizar como fonte?

No campo «URL da página», utilize o link para a página de um hotel, restaurante ou atração que contenha «-d» seguido de números. Também pode introduzir apenas esse número. Se o seu link apontar para um passeio, um perfil de membro ou uma página de categoria, abra a página do TripAdvisor da própria empresa e copie esse link.

Tenho de pagar por uma chave API do Terra?

O Terra Discover funciona num modelo de pagamento conforme a utilização, com um nível gratuito. A utilização que exceda esse nível é faturada. Pode consultar os preços atuais na página de preços baseados na utilização do Terra.

Porque é que o Reviews Feed não guardou a minha chave?

O Reviews Feed verifica a chave quando a guardas e não guarda uma chave que não funcione. Se a chave não tiver sido guardada, copia-a novamente a partir do Terra Dashboard. Se tiveres regenerado a tua chave no Terra, a antiga já não funciona. Nesse caso, cola a nova.

apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto