Introduction

La mission Webhook permet d'automatiser l'attribution de points à un utilisateur en fonction d'une action spécifique réalisée (exemple : achat en boutique, dépôt d'un article, etc.). L'intégration avec un webhook assure la transmission des informations et l'attribution des points en temps réel.

Configuration de la mission

1. Paramètres de base

Titre de la mission : Mission Webhook
Points à gagner : 30 points (modifiable)
Description : Guide les utilisateurs dans la réalisation de la mission
Nombre de validations possibles :
- Par défaut : 1, 3, 5 ou illimité
- Option personnalisée disponible

2. Paramètres techniques

Webhook et Envoi des Données

Le webhook repose sur un appel HTTP POST à l’URL suivante :

🔗 Lien Webhook (à générer lors de la création de la mission) :
https://app.loyoly.io/api/api/webhook/challenge-creators/

Headers requis

Loyoly-Challenge-Hash : 250954c32f708a03bceb7578e1ccb
(Identifiant de sécurité pour l’authentification)

Format du Payload (corps de la requête)

{ "challenge": 13555, "customer_id": "CUSTOMER_PRESTASHOP_ID", "points_value": 10 }

challenge : Identifiant unique de la mission
customer_id : Identifiant du client (récupéré via Shopify ou autre plateforme)
points_value : Valeur des points attribués (si la valeur n'est pas remplie, les points définis pour la mission seront attribués).

3. Gestion des Réponses

Le serveur Webhook retourne différentes réponses en fonction du succès ou de l’échec de la requête :

✅ 200 – Succès
📌 Les points sont attribués avec succès et l'email "points_earned" sera envoyé.

⚠️ Erreurs possibles (4XX)

400 : Payload incorrect (format invalide)
401 : Authentification incorrecte (problème avec le header)
429 : Rate limiting (limitation à 2 requêtes par seconde)

4. Affichage et ciblage

Icône : Icône par défaut (possibilité de personnalisation)
Explication de la mission : Zone pour guider les utilisateurs sur la validation de la mission
Ciblage :
- Ouvert à tous
- Possibilité d’appliquer à une liste d’utilisateurs ou un palier spécifique

5. Bonnes pratiques

✅ Vérifiez que l’ID client est bien renseigné avant d’envoyer la requête
✅ Respectez la limite de 2 requêtes par seconde pour éviter le blocage
✅ Utilisez le bon Loyoly-Challenge-Hash pour l’authentification
✅ Testez la mission avant son activation pour éviter toute erreur d’attribution