La meilleure façon de montrer tes avis Google sur un site Astro est de les récupérer via une API d'avis lors de la construction du site, puis de le reconstruire régulièrement. Les avis s'intègrent au HTML statique, gardant la page rapide, lisible par les moteurs de recherche, et ta clé API reste sécurisée. Le code se trouve à la fin, avec une invite que ton agent IA peut traiter pour toi. Avant de l'insérer, prends quatre décisions importantes pour maximiser son efficacité.
TLDR
Le meilleur moyen d'afficher des avis Google sur un site Astro est de les récupérer via une API d'avis lors de la construction du site, ainsi les avis arrivent dans ton HTML statique et ta clé d'API n'atteint jamais le navigateur.
L'API de Reviewflowz récupère tes avis Google sans accès à Google Business Profile et sans validation de Google, et la même API renvoie les avis de plus de 200 plateformes avec les mêmes champs.
Un widget d'avis Reviewflowz est un seul iframe que tu personnalises librement, donc tu affiches des avis Google toujours à jour sur un site Astro sans le reconstruire.
Les tags de Reviewflowz permettent à chaque page de ton site de demander uniquement les avis qui lui correspondent, que tu taggues les avis à la main ou que tu laisses l'IA le faire.
Quand récupérer les avis : durant la construction, au chargement de la page ou dans une iframe
Tu as trois options pour intégrer des avis sur une page, chacune offrant un équilibre entre rapidité, fraîcheur et indexation.
Option | Comment ça fonctionne | Le compromis |
À la construction | Astro récupère les avis pendant la construction du site et les intègre dans le HTML. | C'est la méthode la plus rapide et efficace. Les avis sont à jour à la dernière construction. Si tu ne déploies pas souvent, reconstruis quotidiennement ou hebdomadairement avec un cron. |
Asynchrone au chargement de la page | Un script charge les avis après l'ouverture de la page. | Cela affecte l'indexation et la lecture de la page. |
Iframe au chargement de la page | La page inclut un widget d'avis dans une iframe. | C'est une bonne alternative : toujours frais et rapide, car le widget se charge de façon statique. |
Sur Astro, la construction reste la meilleure approche. Le code dans le frontmatter d'un composant s'exécute lors de la construction du site, donc les avis apparaissent en HTML brut dès l'ouverture de la page, et ta clé reste protégée sur ta machine ou ton serveur de construction.
L'iframe, sans construction. Le widget d'avis Reviewflowz est une iframe que tu personnalises comme tu le souhaites. Nous le maintenons à jour et il se charge statiquement, donc il reste extrêmement rapide. Tu le trouveras dans Intégrations, sous l'onglet Widgets.
D'où viennent les avis : API Places, API Business Profile ou une API d'avis
Le choix de la source détermine combien d'avis tu peux afficher et combien de configuration est nécessaire.
Source | Ce que tu obtiens | Ce qu'il faut |
Google Places API | 5 avis, un échantillon aléatoire. Ils peuvent être anciens ou peu flatteurs. | Une clé API Google Cloud. |
Google Business Profile API | Tous les avis de ton propre profil. | Approbation nécessaire : demande d'accès à Google, réponse sous 14 jours. Puis OAuth, avec un accès propriétaire ou gestionnaire au profil. |
Une API d'avis tierce | Tous tes avis, et ceux d'autres plateformes. | Une clé API. Pas besoin d'accès Business Profile. |
Cinq avis ne suffisent pas. En pratique, il te faut un accès Business Profile, avec l'approbation de Google, ou un service qui gère ça pour toi.
Aucun accès Business Profile requis. L'API Reviewflowz récupère tes avis Google sans accès Business Profile ni approbation de Google, et couvre plus de 200 plateformes au sein des mêmes champs. Voici ce qu'elle retourne pour Google.
Quels avis montrer
Afficher tous les avis est simple, mais rarement la meilleure option. Prends les décisions avant d'écrire du code :
Tous les avis, ou seulement quelques-uns ?
Sélection manuelle ou automatique ?
Avec des règles : note minimale, texte obligatoire, par date ?
Filtré par sujet, lieu, langue, ou autre ?
Le code ci-dessous sélectionne automatiquement avec des règles : 6 avis, 5 étoiles, texte obligatoire, tous sur Google, plus récent en premier. Chaque règle est commentée, modifie-les à volonté. Trois filtres vont plus loin : language=en pour une langue, location=<id> pour les lieux, et tag=<id> pour des avis manuellement ou IA-tagged.
Sélectionner les avis par page avec des balises. Dans Reviewflowz, tague les avis manuellement, ou laisse l'IA le faire, et chaque page demande l'API pour sa balise. Lugg utilise cette méthode pour sa page d'avis : les visiteurs choisissent un cas d'utilisation et une ville et lisent les avis associés, et environ 6 à 9% des nouveaux utilisateurs Lugg passent d'abord par cette page. Le guide des flux de témoignage montre comment faire.
Avis de Tripadvisor, Trustpilot et autres plateformes
Si tu veux afficher plus que Google, il te faut une API tierce pour les avis. Certaines plateformes, comme Tripadvisor, interdisent d'afficher leurs avis sur ton site. Beaucoup s'en fichent. Retourne au moins vers l'avis original, ainsi les plateformes restent contente.
Le code ci-dessous le fait pour Google : chaque avis a une url qui l'ouvre sur Google, et le composant l'affiche en lien "Lire sur Google" pour que le visiteur puisse vérifier l'avis.
D'autres plateformes, même appel. Avec Reviewflowz, Tripadvisor, Trustpilot et autres arrivent par la même requête : change platform, et les avis reviennent organisés, chacun avec son url pour un lien de retour. Le guide des flux de témoignage liste chaque filtre.
Ajouter des avis Google à ton site Astro, étape par étape
Étape 1. Dans Reviewflowz, va sur Sources d'avis et clique sur Nouvelle source d'avis. Sélectionne Google Maps, recherche ton entreprise et sélectionne-la.
Étape 2. Accède à Paramètres → Webhooks & API et clique sur Créer une clé API. Donne-lui un nom, choisis Lecture seule, et crée-la. L'API est incluse dans le plan Premium.
Étape 3. Ajoute la clé dans ton fichier .env à la racine de ton projet, en tant que REVIEWFLOWZ_KEY. Ajoute aussi cette variable sur ton serveur de construction pour qu'il puisse la lire. Étape 4. Crée src/components/GoogleReviews.astro et colle ceci :
---
// src/components/GoogleReviews.astro
// S'exécute lorsque le site se construit : la clé reste sur votre machine ou votre serveur de construction,
// jamais dans la page. Mettez REVIEWFLOWZ_KEY=rfz_live_... dans votre fichier .env.
const params = new URLSearchParams({
platform: "google_maps", // Avis Google uniquement
rating_min: "5", // 5 étoiles
has_text: "true", // avec texte écrit
removed: "false", // toujours sur Google
sort: "date", // plus récent en premier
limit: "6", // combien afficher
});
const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${import.meta.env.REVIEWFLOWZ_KEY}` },
});
if (!res.ok) throw new Error(`Reviewflowz API ${res.status}: ${await res.text()}`);
const { data: reviews } = await res.json();
---
<section class="google-reviews">
{reviews.map((review) => (
<figure>
<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">Lire sur Google</a>}
</figcaption>
</figure>
))}
</section>
Étape 5. Importe le composant sur n'importe quelle page et place <GoogleReviews /> là où tu veux que les avis apparaissent. Étape 6. Assure-toi de le mettre à jour régulièrement : reconstruis le site tous les jours ou toutes les semaines, ou quand un webhook informe ton serveur qu'il y a un nouvel avis.
Invite pour ton agent de codage IA : Ajoute une section des avis Google à ce site Astro. Crée src/components/GoogleReviews.astro qui récupère GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 avec l'en-tête "Authorization: Bearer" plus la variable d'environnement REVIEWFLOWZ_KEY. Récupère-la dans le frontmatter du composant, afin qu'elle s'exécute au moment de la construction et que la clé ne parvienne jamais au navigateur. Montre la note, le texte, le nom du critique et un lien "Lire sur Google" vers son url pour chaque avis. Suis la liste de contrôle dans https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.
Tu veux explorer toutes les options, filtres et webhooks à un seul endroit ? Consulte Construire un flux de témoignage pour chaque page. Tu utilises WordPress à la place ? Intégrez un widget d'avis sur WordPress.


