Para integrar avaliações do Google em um site Next.js, o ideal é utilizar uma API de avaliações em um componente de servidor, garantindo que o Next.js as atualize no máximo uma vez por hora. As avaliações são inseridas diretamente no HTML, tornando o carregamento rápido, visível para mecanismos de busca e protegendo sua chave de API de ficar exposta no navegador. Se o seu site foi criado com a Vercel, ele é baseado no Next.js, e este método será ideal para você. O código está disponível no final, junto a um prompt que pode ser compartilhado com seu agente de codificação de IA. Antes de utilizá-lo, tome quatro decisões importantes que influenciarão o funcionamento eficaz dessa ferramenta.
TLDR
A melhor forma de mostrar avaliações do Google em um site Next.js é buscá-las em uma API de avaliações dentro de um componente de servidor, assim as avaliações chegam no HTML e a sua chave de API nunca chega ao navegador.
A API do Reviewflowz busca suas avaliações do Google sem acesso ao Google Business Profile e sem aprovação do Google, e a mesma API retorna avaliações de mais de 200 plataformas nos mesmos campos.
Um widget de avaliações do Reviewflowz é um único iframe que você personaliza livremente, assim você mostra avaliações do Google sempre atualizadas em um site Next.js sem escrever código de busca.
As tags do Reviewflowz permitem que cada página do seu site peça apenas as avaliações que combinam com ela, quer você marque as avaliações à mão, quer deixe a IA marcar.
Quando obter as avaliações: na build, ao carregar a página, ou em um iframe
Existem três momentos para adicionar as avaliações em sua página, e cada um oferece um equilíbrio diferente entre velocidade, atualização e indexação.
Opção | Como funciona | A troca |
Na build | O servidor carrega as avaliações diretamente no HTML. | O método mais eficiente e rápido. As avaliações são atualizadas conforme o último carregamento, então planeje como e quando elas serão atualizadas. |
Assíncrono ao carregar a página | Um script carrega as avaliações após a página ser aberta. | Pode dificultar a indexação e leitura da página. |
Iframe ao carregar a página | A página incorpora um widget de avaliação em um iframe. | Uma boa opção: sempre atualizado e muito rápido, pois o widget é carregado estaticamente. |
No Next.js, um componente de servidor permite a primeira opção sem necessidade de reconstruir o site. Ele roda no servidor, as avaliações são incorporadas no HTML e a chave de API permanece segura, enquanto a instrução revalidate instrui o Next.js a buscar as avaliações novamente no máximo uma vez por hora.
Utilizando um iframe sem a necessidade de código próprio. O widget de avaliação da Reviewflowz pode ser personalizado como quiser. Nós o mantemos atualizado e carregado de forma rápida e estática. Encontre-o na seção Integrações, na aba Widgets.
De onde vêm as avaliações: API de Lugares, API de Perfil de Negócios ou uma API de avaliações
Escolher a fonte das avaliações influencia a quantidade que você pode mostrar e a configuração necessária para integrá-las.
Fonte | O que você recebe | O que é necessário |
Google Places API | Até 5 avaliações, uma amostragem aleatória. Podem ser antigas ou negativas. | Chave de API do Google Cloud. |
Google Business Profile API | Todas as avaliações do seu perfil de negócios. | Aprovação prévia: solicite acesso, e o Google responderá em até 14 dias. OAuth é necessário, além de acesso de proprietário ou gerente ao perfil. |
API de avaliações de terceiros | Todas as suas avaliações, mais avaliações de outras plataformas. | Chave de API. Sem necessidade de acesso ao Perfil de Negócios. |
Cinco avaliações são pouco. Então, praticamente, você precisa de acesso ao Perfil de Negócios via aprovação do Google, ou um serviço que forneça isso para você.
Sem acesso ao Perfil de Negócios. A API da Reviewflowz obtém suas avaliações do Google sem exigir acesso ao Perfil de Negócios nem aprovação do Google, e cobre mais de 200 plataformas com os mesmos campos. Veja o que retorna para o Google.
Quais avaliações mostrar
Exibir todas as avaliações parece mais prático, mas raramente é a melhor escolha. Defina seu critério antes de escrever qualquer código:
Exibir todas as avaliações ou apenas uma seleção?
Seleção manual ou automática?
Com regras: classificação mínima, texto obrigatório, mais recentes primeiro?
Filtragem por tópico, localização, idioma, ou conforme a necessidade da página?
O código abaixo oferece uma seleção automática com regras: 6 avaliações, 5 estrelas, com texto, ainda no Google, mais novas primeiro. Cada regra é comentada, facilitando a edição para suas preferências. Três filtros extras permitem ajustes: language=en para idioma de preferência, location=<id> para uma de suas localizações, e tag=<id> para avaliações selecionadas manualmente ou por IA por tags.
Personalize as avaliações por página com tags. No Reviewflowz, marque avaliações manualmente ou permita que a IA faça isso, e cada página solicita a API por sua própria tag. A Lugg implementou sua página de avaliações assim: visitantes escolhem um caso de uso e cidade e veem avaliações específicas, com 6 a 9% dos novos usuários da Lugg aterrissando em uma página de avaliações antes de tudo. O guia de feed de depoimentos contém todos os detalhes para a configuração.
Avaliações do Tripadvisor, Trustpilot e outras plataformas
Se busca além do Google, precisará de uma API de avaliações de terceiros. Algumas plataformas, como o Tripadvisor, proíbem o uso de suas avaliações em sites próprios. É aconselhável sempre linkar de volta à avaliação original, evitando problemas com essas plataformas.
O código abaixo faz isso para o Google: cada avaliação traz uma url que abre no Google, apresentada como um link "Ler no Google", permitindo que os visitantes confirmem a autenticidade da avaliação.
Outras plataformas, mesma API. Com Reviewflowz, avaliações de Tripadvisor, Trustpilot e outras chegam por meio do mesmo pedido: altere platform, e as avaliações são retornadas nos mesmos campos, cada qual com sua própria url para referência. Consulte o guia de feed de depoimentos para listar todos os filtros.
Adicionar avaliações do Google ao seu site Next.js, passo a passo
Passo 1. Acesse o Reviewflowz, vá até Fontes de Avaliação e clique em Nova fonte de avaliação. Escolha Google Maps, procure pelo seu negócio e selecione-o.
Passo 2. Acesse Configurações → Webhooks & API e clique em Criar uma chave de API. Dê um nome, escolha Apenas leitura e crie a chave. A API faz parte do plano Premium.
Passo 3. Coloque a chave no arquivo .env.local como REVIEWFLOWZ_KEY, e adicione a mesma variável aos ambientes do seu host (na Vercel, nas configurações do projeto). Passo 4. Crie app/components/GoogleReviews.tsx e insira o seguinte código:
// app/components/GoogleReviews.tsx
// Componente de servidor: roda no servidor, mantendo a chave fora do navegador.
// Defina REVIEWFLOWZ_KEY=rfz_live_... em .env.local (e nas variáveis
// de ambiente do seu host, tipo as da Vercel).
type Review = {
id: string;
rating: number;
text: string | null;
reviewer: { name: string | null };
url: string | null;
};
export default async function GoogleReviews() {
const params = new URLSearchParams({
platform: "google_maps", // Somente avaliações do Google
rating_min: "5", // 5 estrelas
has_text: "true", // com texto
removed: "false", // ainda no Google
sort: "date", // mais recentes primeiro
limit: "6", // quantas mostrar
});
const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${process.env.REVIEWFLOWZ_KEY}` },
next: { revalidate: 3600 }, // Buscar novamente no máximo uma vez por hora
});
if (!res.ok) throw new Error(`Reviewflowz API ${res.status}: ${await res.text()}`);
const { data: reviews }: { data: Review[] } = await res.json();
return (
<section className="google-reviews">
{reviews.map((review) => (
<figure key={review.id}>
<p aria-label={`${review.rating} out of 5 stars`}>{"★".repeat(Math.round(review.rating))}</p>
<blockquote>{review.text}</blockquote>
<figcaption>
{review.reviewer.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Ler no Google</a>}
</figcaption>
</figure>
))}
</section>
);
}
Passo 5. Importe o componente em qualquer página e adicione <GoogleReviews /> onde as avaliações devem aparecer. Passo 6. Mantenha a atualização: revalidate: 3600 faz com que a API busque as avaliações novamente no máximo uma vez por hora. Um ETag é enviado pela API, e uma resposta 304 ainda conta como um pedido, dentro do limite de 300 chamadas por minuto por conta.
Prompt para seu agente de codificação de IA: Adicione uma seção de avaliações do Google para esse site Next.js. Crie app/components/GoogleReviews.tsx como um componente de servidor que faz uma requisição GET para a API de Reviews com o cabeçalho "Authorization: Bearer" mais a variável de ambiente REVIEWFLOWZ_KEY, e next: { revalidate: 3600 }. Mantenha como componente de servidor, assegurando que a chave nunca chegue ao navegador. Exiba a classificação de cada avaliação, o texto, o nome do avaliador e um link "Ler no Google" para sua url. Verifique o checklist em guia de feed de depoimentos.
Deseja todas as opções, filtros e webhooks em um local? Leia Crie um feed de depoimentos para cada página. Usando WordPress? Incorpore um widget de avaliação no WordPress.


