Introducción
La Misión Webhook permite automatizar la atribución de puntos a un usuario en función de una acción específica realizada (ejemplo: compra en tienda, depósito de un artículo, etc.). La integración con un webhook asegura la transmisión de la información y la atribución de los puntos en tiempo real.
Configuración de la Misión
1. Ajustes básicos
Título de la Misión: Misión Webhook
Puntos a ganar: 30 puntos (modificable)
Descripción: Guía a los usuarios en la realización de la Misión
Número de validaciones posibles:
Por defecto: 1, 3, 5 o ilimitado
Opción personalizada disponible
2. Ajustes técnicos
Webhook y Envío de Datos
El webhook se basa en una llamada HTTP POST a la siguiente URL:
🔗 Enlace Webhook (a generar al crear la Misión):
https://app.loyoly.io/api/api/webhook/challenge-creators/
Headers requeridos
Loyoly-Challenge-Hash: 250954c32f708a03bceb7578e1ccb
(Identificador de seguridad para la autenticación)
Formato del Payload (cuerpo de la petición)
{ "challenge": 15458, "customer_id" : CUSTOMER_SHOPIFY_ID, "customer_email" : CUSTOMER_EMAIL, "points_value" : 10 }challenge: Identificador único de la Misión
customer_id: Identificador del cliente (recuperado vía Shopify u otra plataforma)
O
Customer_email: Email del cliente (recuperado vía Shopify u otra plataforma)
points_value: Valor de los puntos atribuidos (si el valor no se rellena, se atribuirán los puntos definidos para la Misión).
3. Gestión de las Respuestas
El servidor Webhook devuelve diferentes respuestas en función del éxito o el fracaso de la petición:
✅ 200 – Éxito
📌 Los puntos se atribuyen correctamente y se enviará el email "points_earned".
⚠️ Errores posibles (4XX)
400: Payload incorrecto (formato inválido)
401: Autenticación incorrecta (problema con el header)
429: Rate limiting (limitación a 2 peticiones por segundo)
4. Visualización y segmentación
Icono: Icono por defecto (posibilidad de personalización)
Explicación de la Misión: Zona para guiar a los usuarios sobre la validación de la Misión
Segmentación:
Abierto a todos
Posibilidad de aplicarla a una lista de usuarios o un nivel específico
5. Buenas prácticas
✅ Verifica que el ID cliente esté correctamente rellenado antes de enviar la petición
✅ Respeta el límite de 2 peticiones por segundo para evitar el bloqueo
✅ Utiliza el Loyoly-Challenge-Hash correcto para la autenticación
✅ Prueba la Misión antes de activarla para evitar cualquier error de atribución