Vai al contenuto principale

Come integrare le recensioni di Google sul tuo sito Lovable

Esponi le recensioni Google su Lovable usando un'edge function di Supabase che protegge la tua chiave API.

A
Scritto da Axel Lavergne

Un sito Lovable è un'app React che funziona nel browser, quindi non devi inserire la chiave API delle recensioni nel suo codice: chiunque potrebbe leggerla. La soluzione è un'edge function di Supabase. Questa tiene al sicuro la chiave, acquisisce le recensioni di Google da un'API di recensioni, le conserva per un'ora e fornisce alla pagina solo le informazioni necessarie. Trovi il codice per entrambe le parti a fine articolo, incluso un suggerimento da dare a Lovable. Prima di copiarlo, però, è importante fare delle scelte consapevoli per garantire un buon funzionamento.

TLDR

  • Un sito Lovable funziona nel browser, quindi la tua chiave API delle recensioni va in una Supabase Edge Function che recupera le recensioni, mai nel codice del sito.

  • L'API di Reviewflowz recupera le tue recensioni Google senza accesso a Google Business Profile e senza l'approvazione di Google, e la stessa API restituisce recensioni da oltre 200 piattaforme negli stessi campi.

  • Un widget di recensioni di Reviewflowz è un unico iframe che personalizzi liberamente, così mostri recensioni Google sempre aggiornate su un sito Lovable senza mantenere alcuna funzione.

  • I tag di Reviewflowz permettono a ogni pagina del tuo sito di chiedere solo le recensioni adatte, che tu le tagghi a mano o lasci farlo all'IA.

Quando recuperare le recensioni: al build, al caricamento della pagina o in un iframe

Hai tre momenti per aggiungere le recensioni a una pagina, e ciascuno comporta un diverso bilanciamento tra velocità, freschezza e indicizzazione.

Opzione

Come funziona

Il compromesso

Al build

Le recensioni vengono recuperate durante la costruzione del sito e sono integrate nell'HTML.

È il metodo più veloce, efficiente ed efficace per framework che precompilano le pagine.

Async al caricamento della pagina

Le recensioni vengono caricate una volta aperta la pagina.

Influenza l'indicizzazione e la lettura della pagina.

Iframe al caricamento della pagina

La pagina incorpora un widget di recensioni in un iframe.

Un'ottima soluzione: sempre aggiornata e ultra veloce, dato che il widget si carica staticamente.

I siti Lovable caricano le loro pagine nel browser, quindi le recensioni si caricano come il resto della pagina: al caricamento, tramite la tua funzione edge. Se stai cercando l'opzione veloce e sempre aggiornata senza ulteriore manutenzione, scegli l'iframe.

L'iframe, senza creare nulla. Il widget delle recensioni di Reviewflowz è un iframe che puoi personalizzare quanto vuoi. Lo manteniamo sempre aggiornato e lo carichiamo staticamente, perciò resta velocissimo. Puoi trovarlo in Integrazioni nella scheda Widgets.

Da dove provengono le recensioni: Places API, Business Profile API o un'API di recensioni

La scelta della fonte determina quante recensioni puoi mostrare e quanto tempo è necessario per ottenere la prima.

Fonte

Cosa ottieni

Cosa richiede

Google Places API

5 recensioni campionate casualmente, non sempre recenti.

Una chiave API di Google Cloud.

Google Business Profile API

Tutte le recensioni del tuo profilo.

Approvazione preventiva: richiedi accesso e Google verifica la tua richiesta entro 14 giorni. Poi OAuth, con accesso da proprietario o manager al profilo.

Un'API di recensioni di terze parti

Tutte le recensioni, e anche recensioni da altre piattaforme.

Una chiave API. Nessun accesso al profilo business necessario.

Cinque recensioni non bastano. Perciò, generalmente, avrai bisogno dell'accesso al Business Profile tramite l'approvazione di Google, oppure di un servizio che lo gestisca per te.

Nessun accesso al Business Profile necessario. L'API di Reviewflowz raccoglie le recensioni di Google senza accesso al Business Profile e senza l'approvazione di Google. Questa API supporta oltre 200 piattaforme con le stesse funzionalità. Scopri cosa offre per Google.

Quali recensioni mostrare

Mostrare tutte le recensioni è l'opzione più semplice, ma spesso non la migliore. Decidi i seguenti aspetti prima di scrivere il codice:

  • Mostrare tutte le recensioni o solo una selezione?

  • La selezione sarà manuale o automatica?

  • Con regole: punteggio minimo, testo richiesto, le più recenti prioritizzate?

  • Filtrate per argomento, località, lingua o altro per adattarsi alla pagina?

La funzione seguente seleziona automaticamente, con regole: 6 recensioni da 5 stelle, con testo, ancora su Google, le più recenti vengono mostrate per prime. Ogni regola è una riga commentata, quindi puoi modificarle facilmente. Altri tre filtri più generali: language=en per recensioni in una determinata lingua, location=<id> per una delle tue sedi, tag=<id> per recensioni selezionate manualmente o tramite tag di AI.

Scegli le recensioni per pagina con i tag. In Reviewflowz puoi taggare le recensioni manualmente o lasciare che l'AI lo faccia, e ogni pagina richiede all'API il proprio tag. Lugg ha realizzato la sua pagina delle recensioni in questo modo: i visitatori selezionano un contesto d'uso e una città, e leggono recensioni su quello specifico servizio. Circa il 6-9% dei nuovi utenti di Lugg visita prima una pagina delle recensioni. La guida al flusso delle testimonianze spiega come configurarlo.

Recensioni da Tripadvisor, Trustpilot e altre piattaforme

Se desideri più recensioni oltre a quelle di Google, avrai bisogno di un'API di recensioni di terze parti. Alcune piattaforme, come Tripadvisor, vietano l'uso delle loro recensioni sul tuo sito web. Generalmente, non è un problema per la maggior parte delle persone. È comunque una buona pratica collegare la recensione originale, così queste piattaforme non si lamentano.

Il codice qui sotto è per Google: ogni recensione ha un url che la collega su Google, e il componente lo mostra come un link "Leggi su Google", affinché i visitatori possano verificarne l'autenticità.

Altre piattaforme, stesso metodo. Con Reviewflowz, le recensioni da Tripadvisor, Trustpilot e altro arrivano con la stessa richiesta: cambi il platform e ricevi le recensioni negli stessi formati, ognuna con il proprio url per il collegamento. La guida al flusso delle testimonianze elenca tutti i filtri disponibili.

Aggiungi le recensioni di Google al tuo sito Lovable, passo dopo passo

Passo 1. In Reviewflowz, vai su Fonti delle recensioni e seleziona Nuova fonte di recensioni. Scegli Google Maps, quindi cerca e seleziona la tua attività.

La pagina Nuova fonte di recensioni con Google Maps selezionato e un'attività trovata per nome

Passo 2. Vai su Impostazioni → Webhooks & API e clicca Crea una chiave API. Dai un nome, seleziona Sola lettura e crea. L'API è disponibile nel piano Premium.

La finestra Crea una chiave API con il permesso Sola lettura selezionato

Passo 3. Memorizza la chiave come segreto di Supabase chiamato REVIEWFLOWZ_KEY: in Lovable, vai su Supabase → Edge Functions → Secreti, oppure lancia supabase secrets set REVIEWFLOWZ_KEY=... dal terminale. Passo 4. Crea la funzione edge supabase/functions/google-reviews/index.ts con il codice fornito. Mantiene la chiave, conserva la risposta per un'ora evitando di generare una chiamata API ad ogni visitatore, e invia al browser solo ciò che la pagina mostra:

// supabase/functions/google-reviews/index.ts
// Una funzione edge di Supabase: custodisce la tua chiave Reviewflowz, così che
// non arrivi mai al browser. Imposta la chiave una volta con:
// supabase secrets set REVIEWFLOWZ_KEY=rfz_live_...
// (o in Lovable: Supabase → Edge Functions → Secreti).

const cors = {
"Access-Control-Allow-Origin": "*",
"Access-Control-Allow-Headers": "authorization, x-client-info, apikey, content-type",
};

const params = new URLSearchParams({
platform: "google_maps", // Solo recensioni di Google
rating_min: "5", // 5 stelle
has_text: "true", // con testo scritto
removed: "false", // ancora su Google
sort: "date", // le più recenti per prime
limit: "6", // quante mostrarne
});

// Mantieni la risposta per un'ora finché questa funzione resta attiva, così ogni
// visitatore non provoca una chiamata 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();
// Invia al browser solo ciò che la pagina 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. Crea src/components/GoogleReviews.tsx. Questo componente a React interroga la funzione per ottenere le recensioni, utilizzando il client Supabase che Lovable ha già configurato:

// src/components/GoogleReviews.tsx
// L'app React di Lovable richiama la tua funzione edge per ottenere le recensioni; la funzione
// custodisce la chiave. `supabase` è il client Lovable già pronto.
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([]); useEffect(() => { supabase.functions.invoke("google-reviews").then(({ data, error }) => { if (error) console.error(error); else setReviews(data.reviews); }); }, []); return ( {reviews.map((review) => ( {"★".repeat(Math.round(review.rating))} {review.text} {review.name} {review.url && Leggi su Google} ))} );}

Passo 6. Posiziona <GoogleReviews /> dove desideri che appaiano le recensioni. Una volta che la funzione è attiva nel tuo progetto Supabase, le recensioni verranno visualizzate. Il limite è di 300 chiamate API al minuto per account.

Suggerimento per Lovable: Aggiungi una sezione di recensioni di Google al sito. Crea una funzione edge di Supabase chiamata google-reviews che legga il segreto REVIEWFLOWZ_KEY e richiami GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 con l'intestazione "Authorization: Bearer" più la chiave. Memorizza la risposta per un'ora e restituisci solo id, valutazione, testo, nome recensore e url. Poi crea src/components/GoogleReviews.tsx che invochi la funzione con supabase.functions.invoke("google-reviews") mostrando valutazione, testo, nome e un link "Leggi su Google" per ogni recensione. Non inserire mai la chiave nel codice React. Segui la checklist su https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Vuoi tutte le opzioni, i filtri e i webhook in un solo posto? Leggi Costruisci un flusso di testimonianze per ogni pagina. Hai un sito WordPress? Incorpora un widget di recensioni su WordPress.

Hai ricevuto la risposta alla tua domanda?