Passer au contenu principal

Comment fonctionnent les webhooks LearnyBox ?

Recevez des notifications en temps réel sur les événements de votre plateforme et automatisez vos intégrations techniques.

Écrit par Véronique
Mis à jour cette semaine

Les webhooks vous permettent de connecter LearnyBox à n'importe quel outil ou système externe (CRM, outil d'automatisation, application métier…). À chaque événement clé sur votre plateforme (vente, inscription, nouveau contact) LearnyBox envoie automatiquement les données correspondantes vers l'URL de votre choix.

Cet article s'adresse aux utilisateurs ayant des notions techniques ou travaillant avec un développeur. Il détaille le fonctionnement, la configuration et les bonnes pratiques des webhooks LearnyBox.

Qu'est-ce qu'un webhook ?

Un webhook est un mécanisme qui permet à LearnyBox d'envoyer automatiquement des informations vers une URL que vous définissez, à chaque fois qu'un événement se produit sur votre plateforme. Contrairement à une API classique où vous devez interroger le serveur, ici c'est LearnyBox qui vous notifie en temps réel.

Le principe est simple :

  1. Vous configurez une URL de réception (appelée "endpoint") sur votre serveur ou outil tiers.

  2. Vous sélectionnez les événements que vous souhaitez écouter.

  3. Lorsqu'un événement se produit, LearnyBox envoie une requête HTTP POST contenant les données associées à cet événement.

Contraintes techniques

Voici les spécifications à respecter pour que vos webhooks fonctionnent correctement :

  • Méthode HTTP : POST

  • Format des données : application/json

  • Réponse attendue : votre serveur doit répondre avec un code HTTP 200

⚠️ Toute réponse différente de 200 sera considérée comme un échec. LearnyBox renverra automatiquement la notification selon le calendrier de tentatives ci-dessous.

Politique de nouvelles tentatives en cas d'échec

Si votre serveur ne répond pas correctement, LearnyBox effectue jusqu'à 5 tentatives avec des délais croissants :

  • Tentative 1 échouée → nouvelle tentative après 60 secondes

  • Tentative 2 échouée → nouvelle tentative après 5 minutes

  • Tentative 3 échouée → nouvelle tentative après 10 minutes

  • Tentative 4 échouée → nouvelle tentative après 1 heure

  • Tentative 5 échouée → la notification est définitivement marquée comme échouée

Assurez-vous que votre serveur répond rapidement avec un code HTTP 200 pour éviter les tentatives multiples et la désactivation de vos notifications.

Sécurité des données

Les données envoyées par les webhooks LearnyBox sont chiffrées pour garantir leur confidentialité.

  • Algorithme de chiffrement : AES-256-CBC

  • Clé de déchiffrement : votre clé secrète (disponible dans les paramètres de votre compte LearnyBox)

⚠️ Ne partagez jamais votre clé secrète. Elle est indispensable pour déchiffrer les données reçues et garantir que les requêtes proviennent bien de LearnyBox.

Bonnes pratiques

Pour garantir la fiabilité de vos intégrations webhook, voici les recommandations essentielles :

  • Ne jamais exposer votre clé secrète : ne la stockez pas en clair dans votre code source public.

  • Implémenter des logs : enregistrez les requêtes reçues pour faciliter le débogage en cas de problème.

  • Gérer les erreurs : prévoyez un traitement des cas d'erreur pour éviter les interruptions de service.

  • Répondre rapidement en HTTP 200 : traitez la donnée de manière asynchrone si nécessaire, mais renvoyez immédiatement le code 200 pour confirmer la bonne réception.

Comment tester un webhook ?

Avant de déployer en production, vous pouvez tester vos webhooks avec ces outils :

  • webhook.site : génère une URL temporaire qui affiche les requêtes reçues en temps réel. Idéal pour vérifier que LearnyBox envoie bien les données.

  • ngrok : crée un tunnel sécurisé vers votre machine locale, ce qui vous permet de tester votre code de réception en conditions réelles.

  • Postman : permet de simuler et d'inspecter les requêtes HTTP pour valider le déchiffrement et le traitement des données.

Commencez par utiliser webhook.site pour valider que les événements se déclenchent correctement, puis passez à ngrok pour tester votre code de traitement.

FAQ

Les webhooks sont-ils disponibles sur tous les abonnements LearnyBox ?

Consultez les détails de votre abonnement ou contactez le support pour vérifier l'accès à cette fonctionnalité.

Que se passe-t-il si mon serveur est temporairement indisponible ?

LearnyBox effectue jusqu'à 5 tentatives avec des délais croissants (de 60 secondes à 1 heure). Si toutes les tentatives échouent, la notification est définitivement marquée comme échouée.

Puis-je recevoir plusieurs événements sur la même URL ?

Oui, vous pouvez configurer une seule URL de réception pour écouter plusieurs événements. Votre serveur devra alors distinguer les événements reçus dans le payload.

Comment retrouver ma clé secrète pour déchiffrer les données ?

Votre clé secrète est disponible dans les paramètres de votre espace LearnyBox, dans la section dédiée aux webhooks.

Où trouver la liste complète des événements ?

Consultez notre article dédié : Quels sont les événements disponibles pour les webhooks LearnyBox ?

Avez-vous trouvé la réponse à votre question ?