Um site Lovable é um aplicativo React que roda no navegador. Por isso, não dá para guardar a chave da API de avaliações no código, já que qualquer pessoa poderia acessá-la. A solução é usar uma Função Edge do Supabase. Ela guarda a chave, busca suas avaliações do Google via API, armazena a resposta por uma hora e exibe apenas o necessário. O código para ambas as partes está no final, junto com um prompt que você pode usar na Lovable. Antes de colar, tome cuidado com quatro escolhas que influenciam no funcionamento.
TLDR
Um site Lovable roda no navegador, então a chave da API de avaliações deve ficar em uma Supabase Edge Function que busca as avaliações, nunca no código do site.
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 Lovable sem manter nenhuma função.
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 buscar as avaliações: durante a compilação, ao carregar a página ou via iframe
Você tem três opções para buscar avaliações numa página, e cada uma afeta a velocidade, a atualidade e a indexação de modos diferentes.
Opção | Como funciona | A troca |
Na compilação | As avaliações são buscadas e incorporadas ao HTML quando o site é compilado. | É rápida, eficiente e funciona bem em frameworks que fazem renderização antecipada. |
Assíncrono ao carregar a página | A página busca as avaliações assim que é aberta. | Pode impactar na indexação e leitura da página. |
Iframe ao carregar a página | A página inclui um widget de avaliação em um iframe. | É uma troca equilibrada: sempre atualizado e muito rápido, com carregamento estático do widget. |
Os sites Lovable renderizam suas páginas no navegador, então as avaliações são carregadas com o resto da página, via Função Edge. Se preferir uma opção rápida e sempre atualizada, sem necessidade de manutenção, escolha usar iframe.
Iframe sem complicação. O widget ReviewFlowz é um iframe que você pode personalizar. Nós cuidamos de mantê-lo atualizado e estático, garantindo velocidade. Encontre-o em Integrações, na aba Widgets.
De onde vêm as avaliações: Places API, Business Profile API ou API de avaliação
A escolha da fonte de avaliações define quantas você pode mostrar e a facilidade de configuração inicial.
Fonte | O que você obtém | O que é necessário |
Google Places API | Cinco avaliações aleatórias. Podem ser antigas e negativas. | Uma chave de API do Google Cloud. |
Google Business Profile API | Todas as avaliações do seu perfil. | Requer aprovação: solicite acesso e o Google revisa em até 14 dias. Depois, OAuth, com acesso de proprietário ou gerente ao perfil. |
API de avaliação de terceiros | Todas as suas avaliações, inclusive de outras plataformas. | Uma chave de API. Não requer acesso ao Business Profile. |
Cinco avaliações não são suficientes. Na prática, você precisará de acesso ao Business Profile, por meio da aprovação do Google, ou usar um serviço que gerencie isso para você.
Sem acesso ao Business Profile? Sem problemas. A API Reviewflowz busca suas avaliações do Google sem acesso ao Business Profile e sem a necessidade da aprovação do Google. Além disso, cobre mais de 200 plataformas nos mesmos campos. Confira o que ela retorna para o Google.
Quais avaliações mostrar
Exibir todas as avaliações pode ser mais simples, mas nem sempre é a melhor escolha. Decida isso antes de escrever qualquer código:
Todas as avaliações ou uma seleção?
Escolha manual ou automática?
Com regras: classificação mínima, texto necessário, mais recentes primeiro?
Filtradas por tema, local, idioma, ou pelo que melhor combina com a página?
A função abaixo seleciona automaticamente, com regras: 6 avaliações, 5 estrelas, com texto, ainda válidas no Google, mais recentes primeiro. Cada regra é uma linha comentada, que pode ser modificada conforme necessário. Três filtros adicionais vão além: language=en para um idioma específico, location=<id> para um local seu, e tag=<id> para avaliações marcadas manualmente ou por tag de IA.
Escolha avaliações por página usando tags. No Reviewflowz, você pode marcar avaliações manualmente ou deixar a IA fazer isso, e cada página solicita à API sua própria tag. A Lugg construiu sua página de avaliações desse jeito: os visitantes escolhem um caso de uso e uma cidade, e leem as avaliações sobre isso. Entre 6 e 9% dos novos usuários da Lugg acessam primeiro uma página de avaliações. O guia de feed de depoimentos explica o processo.
Avaliações do Tripadvisor, Trustpilot e outras plataformas
Se quiser mais do que o Google, você precisará de uma API externa aqui também. Algumas plataformas, como o Tripadvisor, não permitem o uso de suas próprias avaliações em seu site. Isso geralmente não é um problema, mas é sempre boa prática fazer um link para a avaliação original, para que não haja reclamações.
O código abaixo faz isso para o Google: cada avaliação fornece uma url que a abre no Google, e o componente a exibe como um link "Leia no Google", permitindo que visitantes verifiquem a autenticidade da avaliação.
Outras plataformas, mesma lógica. Com o Reviewflowz, plataformas como Tripadvisor e Trustpilot são acessíveis com a mesma chamada: altere platform, e as avaliações retornam nos mesmos campos, cada uma com sua própria url para link de volta. O guia de feed de depoimentos lista todos os filtros.
Adicione avaliações do Google ao seu site Lovable, passo a passo
Passo 1. No Reviewflowz, vá a Fontes de Avaliação e clique em Nova fonte de avaliação. Escolha Google Maps, depois busque seu negócio e selecione.
Passo 2. Vá em Configurações → Webhooks & API e clique em Criar uma chave de API. Nomeie-a, marque Apenas leitura e crie-a. A API está disponível no plano Premium.
Passo 3. Guarde a chave como um segredo do Supabase chamado REVIEWFLOWZ_KEY: na Lovable, vá para Supabase → Funções Edge → Segredos, ou use supabase secrets set REVIEWFLOWZ_KEY=... em um terminal. Passo 4. Crie a Função Edge supabase/functions/google-reviews/index.ts com este código. Ela mantém a chave segura, armazena a resposta por uma hora, evitando custos por chamada, e envia ao navegador apenas as informações exibidas na página:
// supabase/functions/google-reviews/index.ts
// Uma Função Edge do Supabase: ela guarda sua chave Reviewflowz, então a chave nunca
// chega ao navegador. Defina a chave uma vez com:
// supabase secrets set REVIEWFLOWZ_KEY=rfz_live_...
// (ou na Lovable: Supabase → Funções Edge → Segredos).
const cors = {
"Access-Control-Allow-Origin": "*",
"Access-Control-Allow-Headers": "authorization, x-client-info, apikey, content-type",
};
const params = new URLSearchParams({
platform: "google_maps", // Apenas avaliações do Google
rating_min: "5", // 5 estrelas
has_text: "true", // com texto escrito
removed: "false", // ainda presente no Google
sort: "date", // mais recente primeiro
limit: "6", // quantas mostrar
});
// Mantenha a resposta por uma hora enquanto esta função permanece aquecida, então cada
// visitante não custa uma chamada à API.
let cached: { at: number; body: string } | null = null;
const ONE_HOUR = 60 * 60 * 1000;
Deno.serve(async (req) => {
if (req.method === "OPTIONS") return new Response("ok", { headers: cors });
if (!cached || Date.now() - cached.at > ONE_HOUR) {
const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${Deno.env.get("REVIEWFLOWZ_KEY")}` },
});
if (!res.ok) {
console.error(`API Reviewflowz ${res.status}: ${await res.text()}`);
return new Response(JSON.stringify({ reviews: [] }), {
status: 502, headers: { ...cors, "Content-Type": "application/json" },
});
}
const { data } = await res.json();
// Envie ao navegador apenas o que a página mostra.
const reviews = data.map((r: any) => ({
id: r.id, rating: r.rating, text: r.text, name: r.reviewer.name, url: r.url,
}));
cached = { at: Date.now(), body: JSON.stringify({ reviews }) };
}
return new Response(cached.body, { headers: { ...cors, "Content-Type": "application/json" } });
});
Passo 5. Crie src/components/GoogleReviews.tsx. Ele busca as avaliações na função via cliente Supabase que a Lovable já configurou:
// src/components/GoogleReviews.tsx
// O aplicativo React da Lovable solicita à sua Função Edge as avaliações; a função
// guarda a chave. `supabase` é o cliente que a Lovable já criou para você.
import { useEffect, useState } from "react";
import { supabase } from "@/integrations/supabase/client";
type Review = { id: string; rating: number; text: string | null; name: string | null; url: string | null };
export default function GoogleReviews() {
const [reviews, setReviews] = useState<Review[]>([]);
useEffect(() => {
supabase.functions.invoke("google-reviews").then(({ data, error }) => {
if (error) console.error(error);
else setReviews(data.reviews);
});
}, []);
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.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Leia no Google</a>}
</figcaption>
</figure>
))}
</section>
);
}
Passo 6. Insira <GoogleReviews /> onde as avaliações devem aparecer. Quando a função estiver ativa no seu projeto Supabase, as avaliações estarão visíveis. O limite é de 300 chamadas de API por minuto, por conta.
Prompt para a Lovable: Adicione uma seção de avaliações do Google a este site. Crie uma Supabase Edge Function chamada google-reviews que leia o segredo REVIEWFLOWZ_KEY e faça uma requisição GET em https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 com o cabeçalho "Authorization: Bearer" e a chave. Cache a resposta por uma hora e retorne apenas id, classificação, texto, nome do revisor e URL. Em seguida, crie src/components/GoogleReviews.tsx que chama a função com supabase.functions.invoke("google-reviews") e exibe a classificação, texto, nome e um link "Leia no Google" para a URL de cada avaliação. Nunca exponha a chave no código React. Confira o guia em https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.
Quer todas as opções, filtros e webhooks em um só lugar? Leia Construa um feed de depoimentos para cada página. Usando WordPress em vez disso? Incorpore um widget de avaliações no WordPress.


