# Reseñas Verificadas WooCommerce — Documentación > DataFirefly Reviews (dfreviews) convierte el sistema de reseñas nativo de WooCommerce en una máquina de prueba social: solicitudes de reseñas automáticas tras la compra, insignia Compra verificada, fotos de clientes,… - Página: - Idioma: es - Actualizado el: 2026-07-16 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfreviews/index.md), [en](https://www.datafirefly.com/en/documentation/dfreviews/index.md), [de](https://www.datafirefly.com/de/documentation/dfreviews/index.md), [it](https://www.datafirefly.com/it/documentation/dfreviews/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfreviews/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviews/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviews/index.md) - Índice: DataFirefly Reviews (dfreviews) convierte el sistema de reseñas nativo de WooCommerce en una máquina de prueba social: solicitudes de reseñas automáticas tras la compra, insignia Compra verificada, fotos de clientes, votos útiles, resumen IA en la ficha de producto, respuesta automática a las reseñas por IA, cupón de recompensa y rich snippets Schema.org. Esta documentación cubre la instalación, la configuración completa y la resolución de problemas. ## Instalación 1. En su administración de WordPress, abra **Plugins → Añadir nuevo → Subir plugin**. 2. Seleccione `dfreviews-1.0.0.zip`, haga clic en **Instalar ahora** y luego en **Activar**. 3. Aparece un nuevo submenú **WooCommerce → DF Reviews**: es el centro de control del plugin. El plugin se apoya en las reseñas nativas de WooCommerce: sus reseñas existentes se conservan y son utilizables de inmediato. No se requiere ninguna migración. Requisitos: WooCommerce 8 o 9, WordPress 6.0+, PHP de 8.0 a 8.3. El plugin es compatible con HPOS (High-Performance Order Storage) y funciona sin jQuery ni Composer. ## Configuración de la clave OpenAI El resumen IA y la respuesta automática utilizan su propia clave API de OpenAI: 1. Cree una clave en [platform.openai.com](https://platform.openai.com/api-keys). 2. Péguela en **WooCommerce → DF Reviews → Settings**, sección **OpenAI**. 3. El modelo por defecto es `gpt-4o-mini` — el más económico, recomendado. Un resumen o una respuesta cuesta normalmente mucho menos de un céntimo. Sin clave OpenAI, todas las demás funciones (solicitudes, fotos, votos, cupones, rich snippets) siguen plenamente operativas. La pestaña **AI tools** muestra el estado de la configuración de IA. ## Solicitudes de reseñas automáticas Sección **Review requests** de los ajustes: - **Estado desencadenante**: la solicitud se pone en cola cuando un pedido alcanza este estado (por defecto _Completado_). - **Plazo de envío**: días de espera tras el estado desencadenante (por defecto: 3 días). - **Recordatorio**: se envía un único email de recordatorio si no se ha publicado ninguna reseña (por defecto: 5 días después del primer email). Cada email contiene un enlace de reseña personal con token: la reseña publicada a través de él recibe automáticamente la insignia **Compra verificada**. Los envíos se realizan en lotes de 50 en cada pasada del cron. La pestaña **Request queue** lista las últimas 100 solicitudes con su estado (pending, sent, reminded, completed, failed, unsubscribed) y permite lanzar un procesamiento manual. Cada email incluye un enlace de baja. Las direcciones dadas de baja se almacenan como hashes SHA-256 y no vuelven a recibir solicitudes. ## Resumen IA de las reseñas En cuanto un producto alcanza el número mínimo de reseñas publicadas (por defecto: 3), el cron genera un bloque mostrado al inicio de la pestaña de reseñas: **puntos fuertes**, **puntos a tener en cuenta** y **síntesis**. - El resumen se almacena en caché por producto **y por idioma**: con Polylang o WPML, cada versión lingüística muestra un resumen en su idioma. - Se regenera automáticamente al publicarse nuevas reseñas (invalidación por huella de las reseñas analizadas). - El ajuste **Max reviews analyzed** limita cuántas reseñas se envían al modelo. La pestaña **AI tools** lista los resúmenes generados con idioma y fecha. ## Respuesta automática a las reseñas por IA Cada reseña publicada puede recibir una respuesta del comerciante generada por IA, redactada **en el idioma de la reseña**. Ajustes clave: - **Modo de publicación**: _Borrador_ (recomendado al principio — cada respuesta espera su aprobación en la pantalla Comentarios) o _Publicación inmediata_. - **Tono**: cálido, profesional o conciso. - **Nombre de firma**: mostrado como autor de la respuesta (vacío = nombre del sitio). - **Responder a valoraciones desde**: 1 para responder a todas las reseñas — recomendado, ya que las reseñas negativas son las que más se benefician de una respuesta. Salvaguardas integradas: para notas de 3/5 o menos, la respuesta pide disculpas y deriva al soporte, sin prometer nunca un reembolso. Las respuestas se limitan a unas 70 palabras, se muestran con la insignia **Respuesta oficial** y quedan excluidas de las medias y de los rich snippets. Para reseñas existentes o importadas: acción **Generate AI reply** en la lista de comentarios de WordPress, o el procesamiento de recuperación por lotes del cron. ## Fotos, votos y cupón de recompensa - **Fotos de clientes**: los clientes adjuntan hasta 3 fotos (configurable, máx. 10) a su reseña — jpg, png, webp, gif, 5 MB máx., mostradas con lightbox. - **Votos útiles**: botones «¿Le ha resultado útil esta reseña?» con protección antiduplicados por cuenta y por IP hasheada. Nunca se muestran en las respuestas del comerciante. - **Cupón de recompensa**: al publicarse su reseña, el cliente recibe un cupón porcentual (por defecto: 10 %, 30 días), único, de un solo uso, restringido a su email. Anti-farming: una sola recompensa por email y por producto. ## Formulario y visualización - **Campo de título** de la reseña, opcional u obligatorio. - **Longitud mínima** de la reseña en caracteres (por defecto: 10). - **Bloque de distribución de valoraciones** (barras de 5★ a 1★) sobre la lista de reseñas. - **Color de las estrellas** personalizable (hexadecimal, por defecto #e7a11a). ## Rich snippets Schema.org El plugin conserva el marcado AggregateRating y Review nativo de WooCommerce saneándolo: las respuestas del comerciante quedan excluidas del marcado y de las medias, manteniendo exactas sus estrellas en Google. La opción puede desactivarse en los ajustes, lo que elimina entonces todo el marcado de reseñas. ## Cron: fiabilizar los envíos El procesamiento (solicitudes, recordatorios, resúmenes IA, respuestas de recuperación) se ejecuta cada hora vía WP-Cron. Como WP-Cron solo se activa con las visitas al sitio, configure un cron de servidor real para un envío fiable: 1. Copie la **URL de cron con token** mostrada en **Settings → Cron**. 2. Añádala al cron de su alojamiento (o crontab), cada 15 a 60 minutos, por ejemplo con `curl -s "URL" > /dev/null`. Un bloqueo anticoncurrencia impide dos ejecuciones simultáneas. El botón **Run processing now** de la pestaña Request queue lanza un procesamiento manual en cualquier momento. ## Importación y exportación CSV Pestaña **Import / Export**: - **Exportación**: todas las reseñas de productos con nota, título, indicador verificado y fechas. - **Importación**: CSV con fila de cabecera y columnas `product_id` o `sku`, `author`, `email`, `rating`, `title`, `content`, `date` (Y-m-d H:i:s, opcional), `verified` (1/0, opcional). Las estadísticas de valoraciones se recalculan automáticamente tras la importación. ## Cuenta del cliente Se añade una pestaña **Mis reseñas** a la cuenta del cliente (Mi cuenta): cada cliente encuentra allí sus reseñas con estado de moderación, estrellas e insignia de verificado. Si la pestaña devuelve un 404 tras la activación, vuelva a guardar los enlaces permanentes en **Ajustes → Enlaces permanentes → Guardar**. ## RGPD y datos - Enlace de baja en cada email de solicitud; direcciones dadas de baja almacenadas como hashes SHA-256, nunca en claro. - Direcciones IP de los votantes hasheadas con el salt de WordPress. - Única llamada saliente: la API de OpenAI que usted controla, y solo si hay una clave configurada. - La desinstalación elimina las tablas y ajustes del plugin pero **conserva todas las reseñas** (reseñas WooCommerce nativas). ## Resolución de problemas - **Las solicitudes no salen**: compruebe que la función está activada, que los pedidos alcanzan el estado desencadenante y que el cron funciona (última pasada mostrada en AI tools). Configure la URL de cron de servidor. - **Sin resumen IA**: ¿clave OpenAI configurada? ¿Número mínimo de reseñas publicadas alcanzado? El resumen se genera en la pasada del cron, no al instante. - **Sin respuesta IA**: compruebe el modo (en borrador, la respuesta espera en Comentarios → Pendiente), la valoración mínima configurada y la clave API. - **Emails no recibidos**: el plugin envía a través del mailer de WooCommerce — pruebe su configuración de email global (se recomienda un plugin SMTP).