Ir al contenido principal

Cómo agregar reseñas de Google a tu sitio web Astro

Incorpora reseñas de Google en tu Astro site al construirlo, usando un código y un agente de codificación AI.

A
Escrito por Axel Lavergne

La mejor manera de mostrar reseñas de Google en un sitio Astro es traerlas desde una API al momento de construir el sitio y luego actualizarlo según un horario establecido. De esta forma, las reseñas llegan a tu HTML estático y la página se mantiene rápida, los motores de búsqueda pueden leerlas, y tu clave API no se expone al navegador. Al final encontrarás el código junto con indicaciones para tu agente de codificación AI. Antes de pegarlo hay cuatro decisiones que debes tomar para asegurar el mejor resultado, así que elígelo cuidadosamente.

TLDR

  • La mejor manera de mostrar reseñas de Google en un sitio Astro es obtenerlas de una API de reseñas al construir el sitio, así las reseñas quedan en tu HTML estático y tu clave API nunca llega al navegador.

  • La API de Reviewflowz obtiene tus reseñas de Google sin acceso a Google Business Profile y sin la aprobación de Google, y la misma API devuelve reseñas de más de 200 plataformas con los mismos campos.

  • Un widget de reseñas de Reviewflowz es un único iframe que personalizas a tu gusto, así que muestras reseñas de Google siempre actualizadas en un sitio Astro sin tener que reconstruirlo.

  • Las etiquetas de Reviewflowz permiten que cada página de tu sitio pida solo las reseñas que le corresponden, tanto si etiquetas las reseñas a mano como si dejas que la IA las etiquete.

Cuándo obtener las reseñas: al construir, al cargar la página o en un iframe

Existen tres momentos en los que puedes añadir reseñas a una página, cada uno con diferentes ventajas en velocidad, actualización e indexación.

Opción

Cómo funciona

La compensación

Al construir

Astro recupera reseñas al construir el sitio y las incorpora al HTML.

Es la manera más rápida y efectiva. Las reseñas se actualizan con cada construcción, así que si no lanzas cambios con frecuencia, considera reconstruir diaria o semanalmente usando un cron.

Async al cargar la página

Un script carga las reseñas después de que la página se abre.

Esto afecta la indexación y cómo se lee la página.

Iframe al cargar la página

La página inserta un widget de reseñas en un iframe.

Un buen balance: siempre se mantienen actualizadas y son extremadamente rápidas al cargar de manera estática.

Con Astro, el momento de construir es la mejor opción. El código en el frontmatter de un componente se ejecuta al construir el sitio, haciendo que las reseñas se integren en HTML puro cuando alguien abre la página, y la clave permanece en tu máquina o servidor de construcción.

El iframe, sin necesidad de construir: El widget de reseñas de Reviewflowz es un iframe que puedes personalizar a tu gusto. Lo mantenemos actualizado y cargamos de manera estática para un rendimiento óptimo. Encuéntralo en Integraciones, en la pestaña Widgets.

De dónde vienen las reseñas: Places API, Business Profile API o una API de terceros

Tu elección de fuente determina cuántas reseñas puedes mostrar y cuánto esfuerzo necesitas para configurarlo y empezar a ver reseñas.

Fuente

Lo que obtienes

Lo que requiere

Google Places API

5 reseñas al azar. Podrían ser antiguas o negativas.

Una clave API de Google Cloud.

Google Business Profile API

Todas las reseñas de tu propio perfil.

Primero se requiere aprobación: solicitas acceso y puedes obtenerlo en 14 días. Luego OAuth, con acceso de propietario o administrador al perfil.

API de reseñas de terceros

Todas tus reseñas, y también de otras plataformas.

Una clave API. No necesitas acceso a Business Profile.

Cinco reseñas no son suficientes. Necesitas acceso a Business Profile con la aprobación de Google, o un servicio que gestione esto por ti.

Sin necesidad de acceso a Business Profile: La API de Reviewflowz obtiene tus reseñas de Google sin acceso a Business Profile y sin aprobación de Google, además, cubre más de 200 plataformas. Aquí puedes ver lo que retorna para Google.

Qué reseñas mostrar

Mostrar cada reseña es la opción más sencilla, pero no siempre la mejor. Decide esto antes de comenzar a codificar:

  • ¿Todas las reseñas o sólo algunas?

  • ¿Elegidas manualmente o automáticamente?

  • ¿Con reglas: calificación mínima, texto requerido, las más recientes primero?

  • ¿Filtradas por tema, ubicación, idioma u otros criterios?

El siguiente código selecciona automáticamente con reglas: 6 reseñas, 5 estrellas, con texto, aún disponibles en Google, las más recientes primero. Cada regla es una línea comentada, por lo que puedes modificarlas a tu necesidad. Tres filtros adicionales: language=en para un idioma específico, location=<id> para una ubicación, y tag=<id> para reseñas seleccionadas por etiquetas manuales o de etiquetas AI.

Elige reseñas por página con etiquetas: En Reviewflowz puedes etiquetar reseñas manualmente o dejar que AI lo haga, y cada página pide a la API su etiqueta específica. Lugg creó su página de reseñas así: los visitantes seleccionan un caso de uso y una ciudad para leer reseñas específicas, y aproximadamente el 6 al 9% de los nuevos usuarios de Lugg llegan primero a una página de reseñas. La guía del feed de testimonios muestra cómo configurarlo.

Reseñas de Tripadvisor, Trustpilot y otras plataformas

Para más allá de Google, necesitarás una API de terceros. Algunas plataformas, como Tripadvisor, no permiten usar tus reseñas en tu sitio web. Sin embargo, a la mayoría no le importa si enlazas a la reseña original. La práctica ideal es enlazar de regreso a la fuente original para mantener la transparencia.

El código siguiente hace eso para Google: cada reseña incluye una url que se abre en Google, y el componente la muestra como un enlace "Leer en Google", para que los visitantes puedan verificar la autenticidad de la reseña.

Otras plataformas, misma solicitud: Con Reviewflowz, puedes obtener reseñas de Tripadvisor, Trustpilot, etc., con la misma solicitud ajustando el platform. Las reseñas se devuelven en los mismos campos, cada una con su propia url para enlazarse de nuevo. La guía del feed de testimonios detalla cada filtro disponible.

Agrega reseñas de Google a tu sitio Astro, paso a paso

Paso 1. Entra a Reviewflowz, ve a Fuentes de Reseñas y haz clic en Nueva fuente de reseñas. Elige Google Maps, busca tu negocio y selecciona.

La página de Nueva fuente de reseñas con Google Maps seleccionado y una empresa encontrada por nombre

Paso 2. Ve a Configuraciones → Webhooks & API y haz clic en Crear una clave API. Asígnale un nombre, selecciona Solo lectura y créala. La API está disponible en el plan Premium.

La ventana Crear una clave API con el permiso de Solo lectura seleccionado

Paso 3. Coloca esa clave en el archivo .env en la raíz de tu proyecto, bajo REVIEWFLOWZ_KEY. Añade la misma variable a las variables de entorno de tu servidor de construcción, para que la construcción pueda leerla. Paso 4. Crea src/components/GoogleReviews.astro y pega el siguiente código:

---
// src/components/GoogleReviews.astro
// Se ejecuta durante la construcción: la clave permanece en tu máquina o servidor de construcción,
// nunca en la página. Pon REVIEWFLOWZ_KEY=rfz_live_... en tu archivo .env.
const params = new URLSearchParams({
platform: "google_maps", // Solo reseñas de Google
rating_min: "5", // 5 estrellas
has_text: "true", // con texto
removed: "false", // aún en Google
sort: "date", // las más recientes primero
limit: "6", // cantidad a mostrar
});

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">Leer en Google</a>}
</figcaption>
</figure>
))}
</section>

Paso 5. Importa el componente en cualquier página y coloca <GoogleReviews /> donde quieras que aparezcan las reseñas. Paso 6. Mantenlo actualizado: reconstruye el sitio diariamente, semanalmente o cuando un webhook le indique a tu servidor que llegó una nueva reseña.

Instrucciones para tu agente de codificación AI: Agrega una sección de reseñas de Google a este sitio Astro. Crea src/components/GoogleReviews.astro que obtenga los datos desde GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 con el encabezado "Authorization: Bearer" seguido de la variable de entorno REVIEWFLOWZ_KEY. Recibe la información en el frontmatter del componente para que se ejecute en el momento de construcción y la clave nunca se exponga al navegador. Muestra la evaluación de cada reseña, el texto, el nombre del revisor y un enlace "Leer en Google" a su URL. Sigue las instrucciones en https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

¿Quieres todas las opciones, filtros y webhooks en un solo lugar? Consulta Construir un feed de testimonios para cada página. ¿Usas WordPress? Incorpora un widget de reseñas en WordPress.

¿Ha quedado contestada tu pregunta?