Ir al contenido principal

Cómo agregar reseñas de Google a tu sitio web de Next.js

Muestra tus reseñas de Google en un sitio de Next.js o Vercel v0, desde un componente de servidor.

A
Escrito por Axel Lavergne

La mejor manera de mostrar tus reseñas de Google en un sitio de Next.js es utilizando una API de reseñas en un componente de servidor. Esto permite que Next.js las obtenga, como máximo, una vez por hora. Las reseñas vienen incrustadas en el HTML, lo que mantiene tu página rápida, facilita su lectura por motores de búsqueda y asegura que tu clave de API nunca llegue al navegador. Si tu sitio fue construido con Vercel v0, también funciona. Al final encontrarás el código y un mensaje que puedes dar a tu agente de codificación de IA. Antes de comenzar, ten en cuenta las cuatro opciones que afectan el funcionamiento.

TLDR

  • La mejor manera de mostrar reseñas de Google en un sitio de Next.js es obtenerlas de una API de reseñas en un componente de servidor, así las reseñas llegan en el HTML 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 de Next.js sin escribir código para obtenerlas.

  • 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 compilar, al cargar la página o en un iframe

Tienes tres opciones para mostrar las reseñas, cada una intercambia velocidad, frescura e indexación de formas distintas.

Opción

Cómo funciona

El compromiso

Al compilar

El servidor obtiene las reseñas y las inserta en el HTML.

Es la más rápida y eficiente. Las reseñas son tan recientes como tu última obtención, así que planifica bien las actualizaciones.

Asíncrono al cargar la página

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

Afecta cómo se indexa y se lee la página.

Iframe al cargar la página

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

Es una buena opción: siempre actualizado y muy rápido, porque el widget carga de forma estática.

Con Next.js, un componente de servidor te permite usar la primera opción sin necesidad de reconstrucciones. Esto se ejecuta en el servidor, por lo que las reseñas están en el HTML y la clave se mantiene fuera del navegador. La función revalidate hace que Next.js las actualice como máximo una vez por hora.

Un iframe sin construir. El widget de reseñas de Reviewflowz es un iframe que puedes personalizar a tu gusto. Siempre se mantiene actualizado y carga de forma estática, garantizando rapidez. Encuéntralo en Integraciones, en la pestaña Widgets.

De dónde vienen las reseñas: API de Places, API de Perfil de Negocio o una API de reseñas

La fuente que elijas determina cuántas reseñas puedes mostrar y cuánta configuración necesitas hacer antes de comenzar.

Fuente

Qué obtienes

Requisitos

API de Google Places

5 reseñas al azar. Pueden ser antiguas o negativas.

Una clave de API de Google Cloud.

API de Perfil de Negocio de Google

Todas las reseñas de tu perfil.

Primero debes obtener aprobación: solicitas acceso y Google revisa las peticiones en 14 días. Luego, debes usar OAuth para acceder como propietario o administrador del perfil.

API de reseñas de terceros

Todas tus reseñas, incluyendo las de otras plataformas.

Una clave de API. No necesitas acceso a Perfil de Negocio.

Cinco reseñas no son suficientes. Por lo tanto, es necesario acceder al Perfil de Negocio, solicitando la aprobación de Google o usando un servicio que se encargue de esto.

No necesitas acceso al Perfil de Negocio. La API de Reviewflowz obtiene tus reseñas de Google sin necesidad de acceder al Perfil de Negocio ni aprobación de Google, y cubre más de 200 plataformas con los mismos datos. Aquí está lo que devuelve para Google.

Qué reseñas mostrar

Mostrar todas las reseñas es lo más simple, pero rara vez es la mejor opción. Piensa en esto antes de implementar el código:

  • ¿Todas las reseñas o solo algunas específicas?

  • ¿Seleccionadas manualmente o de forma automática?

  • ¿Aplicar reglas: calificación mínima, texto requerido, lo más reciente primero?

  • ¿Filtrar por tema, ubicación, idioma o según lo que se ajuste a la página?

El código a continuación selecciona automáticamente, aplicando reglas: 6 reseñas, 5 estrellas, con texto, aún visibles en Google, lo más reciente primero. Cada regla está comentada para que puedas ajustarla. También puedes aplicar tres filtros adicionales: language=en para seleccionar un idioma, location=<id> para una de tus ubicaciones, y tag=<id> para reseñas elegidas manualmente o clasificadas por etiqueta de IA.

Selecciona reseñas por página con etiquetas. En Reviewflowz, puedes etiquetar manualmente las reseñas o dejar que la IA lo haga. Cada página puede solicitar su propia etiqueta a la API. Lugg construyó su página de reseñas de esta manera: los visitantes eligen un caso de uso y una ciudad, y leen las reseñas pertinentes. Alrededor del 6 al 9% de los nuevos usuarios de Lugg empiezan explorando una página de reseñas. La guía de feed de testimonios muestra cómo configurarlo.

Reseñas de Tripadvisor, Trustpilot y otras plataformas

Si buscas más que solo Google, necesitarás una API de reseñas de terceros. Algunas plataformas, como Tripadvisor, prohíben mostrar sus reseñas en tu sitio web. Sin embargo, la mayoría de las personas no tienen problema con esto. En general, es buena práctica enlazar de vuelta a la reseña original para no tener inconvenientes con esas plataformas.

El código que verás a continuación hace esto para Google: cada reseña lleva una url que la abre en Google, y el componente muestra un enlace "Leer en Google", permitiendo a los visitantes verificar que la reseña es auténtica.

Otras plataformas, misma llamada. Con Reviewflowz, las reseñas de Tripadvisor, Trustpilot y otras se obtienen con la misma solicitud: solo cambia platform, y las reseñas aparecerán con los mismos campos, cada una con su url para enlazar nuevamente. La guía de feed de testimonios enumera todos los filtros disponibles.

Agregar reseñas de Google a tu sitio de Next.js, paso a paso

Paso 1. En Reviewflowz, abre Fuentes de Reseñas y haz clic en Nueva fuente de reseñas. Elige Google Maps, busca tu negocio y selecciónalo.

La página Nueva fuente de reseñas con Google Maps seleccionado y un negocio encontrado por nombre

Paso 2. Ve a Configuración → Webhooks y API y haz clic en Crear una clave de API. Asígnale un nombre, selecciona Solo lectura y créala. Este API está disponible como parte del plan Premium.

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

Paso 3. Guarda la clave en .env.local como REVIEWFLOWZ_KEY, y añade la misma variable a las variables de entorno de tu host (en Vercel, en la configuración del proyecto). Paso 4. Crea app/components/GoogleReviews.tsx y pega el siguiente código:

// app/components/GoogleReviews.tsx
// Un componente de servidor: se ejecuta en el servidor, para que la clave no llegue
// al navegador. Guarda REVIEWFLOWZ_KEY=rfz_live_... en .env.local (y en las variables
// de entorno de tu host, como las de 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", // Solo reseñas de Google
rating_min: "5", // 5 estrellas
has_text: "true", // con texto
removed: "false", // todavía en Google
sort: "date", // lo más reciente primero
limit: "6", // cuántas mostrar
});

const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${process.env.REVIEWFLOWZ_KEY}` },
next: { revalidate: 3600 }, // volver a obtener como máximo una 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">Leer en Google</a>}
</figcaption>
</figure>
))}
</section>
);
}

Paso 5. Integra el componente en cualquier página usando <GoogleReviews /> donde quieras mostrar las reseñas. Paso 6. Así es como se gestiona la actualización: revalidate: 3600 actualiza las reseñas como máximo una vez por hora. La API ofrece un ETag, y una respuesta 304 aún cuenta como una llamada, con un límite de 300 llamadas por minuto por cuenta.

Mensaje para tu agente de codificación de IA: Agrega una sección de reseñas de Google a este sitio de Next.js. Crea app/components/GoogleReviews.tsx como un componente de servidor que obtiene 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" más la variable de entorno REVIEWFLOWZ_KEY, y next: { revalidate: 3600 }. Mantenlo como un componente de servidor, para que la clave nunca llegue al navegador. Muestra la calificación, texto, nombre del revisor y un enlace "Leer en Google" a su url de cada reseña. Sigue la lista de verificación en https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

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

¿Ha quedado contestada tu pregunta?