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, 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.

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.
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.

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.

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.

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).