Conectando Plataformas de Revisión Externas

Integración de Plataforma de Revisión Externa

Conecta tu plataforma de revisión de terceros existente a LoyaltyTree para sincronizar reseñas y otorgar semillas a los clientes automáticamente.

Descripción General

Si ya utilizas una plataforma de revisión como Judge.me, Loox o Yotpo, puedes integrarla con LoyaltyTree en lugar de cambiar a nuestro sistema de revisión nativo. Esto te permite:

• Mantener tus reseñas existentes: No es necesario migrar o empezar de nuevo
• Otorgar semillas por reseñas: Los clientes ganan recompensas de lealtad cuando dejan reseñas
• Experiencia unificada para el cliente: Las reseñas contribuyen a su viaje de lealtad en general
• Sincronización automática: Las reseñas fluyen hacia LoyaltyTree a través de webhooks

Paso 1: Acceder a la Configuración de Reseñas

1. Navega a Tiendas en tu administración de LoyaltyTree
2. Encuentra la tarjeta de tu tienda y haz clic en el botón Configuración de Reseñas 
3. Ve a la pestaña Configuración

Paso 2: Seleccionar Modo de Plataforma Externa

En la Configuración del Sistema de Reseñas:

1. Encuentra el menú desplegable Sistema de Reseñas
2. Cámbialo de "LoyaltyTree Nativo" a Plataforma Externa
3. Asegúrate de que Habilitar Sistema de Reseñas esté marcado

Paso 3: Elegir Tu Plataforma de Reseñas

Selecciona tu proveedor de reseñas del menú desplegable Plataforma de Reseñas:

Paso 4: Habilitar el Procesamiento de Webhooks

Marca la opción Habilitar Procesamiento de Webhooks. Esto permite que LoyaltyTree reciba y procese datos de reseñas de tu plataforma externa.

Paso 5: Configurar la URL del Webhook

Una vez que selecciones una plataforma, LoyaltyTree genera una URL de Webhook única para tu tienda.

Copia tu URL de Webhook:

1. Encuentra el campo URL de Webhook en el panel de integración
2. Haz clic en el botón Copiar para copiar la URL completa
3. Mantén esta URL segura - es única para tu tienda

Agrega el Webhook a Tu Plataforma de Reseñas:

Los pasos exactos varían según la plataforma, pero generalmente:

1. Ve a la configuración de administración de tu plataforma de reseñas
2. Encuentra la sección Webhooks o Integraciones
3. Agrega un nuevo webhook con la URL que copiaste
4. Selecciona el evento Reseña Creada o Nueva Reseña
5. Guarda la configuración de tu webhook

Paso 6: Secreto del Webhook (Opcional)

Para mayor seguridad, puedes configurar un Secreto de Webhook para verificar que los webhooks entrantes sean auténticos.

Cómo funciona:

1. Ingresa una clave secreta en el campo Secreto de Webhook
2. Configura tu plataforma de reseñas para firmar las solicitudes con este secreto
3. LoyaltyTree verificará la firma utilizando el encabezado x-webhook-signature o x-signature

Nota: No todas las plataformas soportan firmas de webhook. Si la tuya no lo hace, puedes dejar este campo vacío.

Paso 7: Opción Genérica/Personalizada - Formato JSON Esperado

Cuando tu plataforma de reseñas envía un webhook, LoyaltyTree espera el siguiente formato de datos:

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "¡Gran producto!",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "Nombre del Producto"
}

Campos Requeridos:

Soporte para Formato Anidado:

LoyaltyTree también soporta formatos de datos anidados comúnmente utilizados por plataformas de reseñas:

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "¡Gran producto!"
  }
}

Recompensas de Semillas por Reseñas Externas

Nota: Las asignaciones de semillas para reseñas se gestionan a nivel de Grupo de Lealtad. Ve a Configuraciones de Lealtad → Configuración de Semillas de tu tienda para configurar cuántas semillas ganan los clientes por reseñas, bonificaciones por fotos y bonificaciones por primera reseña.

Cuando se recibe un webhook de reseña:

1. LoyaltyTree empareja el customer_email con un cliente existente
2. Si se encuentra, se otorgan semillas según tu configuración de Configuración de Semillas
3. Las reseñas con fotos pueden ganar semillas adicionales si están configuradas
4. Los revisores primerizos pueden ganar semillas adicionales

Resolución de Problemas

¿Las reseñas no se sincronizan?

• Verifica la URL del webhook: Asegúrate de haber copiado la URL completa incluyendo todos los parámetros de consulta
• Verifica que el webhook esté habilitado: Confirma que "Habilitar Procesamiento de Webhooks" esté marcado en LoyaltyTree
• Verifica tu plataforma de reseñas: Asegúrate de que el webhook esté activo y apunte a la URL correcta
• Prueba con una nueva reseña: Envía una reseña de prueba para activar el webhook

¿El cliente no recibe semillas?

• El correo electrónico debe coincidir: El customer_email en el webhook debe coincidir con un cliente en tu base de datos de LoyaltyTree
• Verifica la Configuración de Semillas: Asegúrate de que las recompensas por reseñas estén configuradas en tu Grupo de Lealtad
• El cliente debe estar registrado: Los clientes anónimos o invitados pueden no recibir premios de semillas

¿Errores de firma de webhook?

• El secreto debe coincidir: El secreto en LoyaltyTree debe coincidir exactamente con el configurado en tu plataforma de reseñas
• Formato de encabezado: LoyaltyTree busca encabezados x-webhook-signature o x-signature

¿Necesitas Ayuda?

Contacta a nuestro equipo de soporte en support@loyaltytree.eco para obtener asistencia con la integración de la plataforma de revisión externa.