Comprendre les Webhooks, les API et les Callbacks JavaScript
Intégration de Drimify : Guide des APIs, Webhooks et Callbacks JavaScript
Lorsque vous construisez des expériences interactives avec Drimify, il est essentiel que les données puissent s'intégrer à votre infrastructure technologique existante, par exemple, en ajoutant un nouveau lead automatiquement à votre CRM ou en déclenchant un événement personnalisé sur votre site dès qu'un utilisateur termine un jeu. Pour cela, Drimify propose trois méthodes d'intégration : APIs, Webhooks et Callbacks JavaScript. Voici comment choisir celle qui correspond le mieux aux besoins de votre entreprise.
1. API : La Récupération de Données "à la Demande"
Une API (Interface de Programmation d'Applications) permet à votre système de demander des informations spécifiques à Drimify quand vous le souhaitez.
- Fonctionnement : Votre serveur envoie une requête à Drimify pour obtenir des données précises (par exemple : "Donnez-moi toutes les entrées des dernières 24 heures"). Drimify vous renvoie ensuite ces données.
- Idéal pour : Générer des rapports, synchroniser en masse des données avec votre tableau de bord ou vérifier les chiffres de participation à la fin d'une campagne.
- À retenir : Votre système initie la conversation.
2. Webhook : La Notification "en Temps Réel"
Un Webhook est une notification envoyée automatiquement de Drimify à votre serveur dès qu'un événement spécifique se produit.
- Fonctionnement : Vous définissez un "déclencheur" (par exemple, lorsqu'un utilisateur termine un formulaire d'inscription ou une expérience). Dès que cet événement a lieu, Drimify pousse les coordonnées ou les données de l'utilisateur directement dans votre CRM ou à l'URL de votre base de données.
- Idéal pour : Automatiser en temps réel, comme envoyer immédiatement un email de "Bienvenue" ou mettre à jour le profil d'un lead dans votre CRM.
- À retenir : Drimify initie la conversation automatiquement selon un événement prédéfini.
3. Callback JavaScript : La Réaction "dans le Navigateur"
Un Callback JavaScript gère la communication entre le widget Drimify et le site ou l'application où il est intégré. Contrairement aux APIs ou Webhooks, cela se passe localement dans le navigateur de l'utilisateur.
- Fonctionnement : Votre site "écoute" les actions se déroulant dans l'iframe Drimify. Quand un utilisateur atteint un certain jalon, le jeu envoie un signal à votre page parente (ex. :
onComplete). - Idéal pour : Déclencher des changements visuels immédiats sur votre site, comme masquer le jeu pour révéler un lien de téléchargement caché ou rediriger l'utilisateur vers une page de destination spécifique.
- À retenir : Cela connecte l'expérience au front-end de votre site en temps réel.
Comparaison & Cas d'Utilisation
Fonctionnalité | API | Webhook | Callback JavaScript |
Direction | Votre Système → Drimify | Drimify → Votre Système | Drimify → Votre Site/Appli |
Environnement | Serveur-à-Serveur | Serveur-à-Serveur | Navigateur/Côté Client |
Utilisation Courante | Synchronisation de données en masse | Automatisation CRM & Email | Changements Dynamiques de l'UI |
Exemple | Extraire un rapport hebdomadaire | Envoyer un nouveau lead à HubSpot | Afficher un bouton "Récupérer votre Prix" |
Comprendre le "Backend" vs. "Frontend"
Pour choisir la bonne méthode, demandez-vous : "Où les données doivent-elles aller ?"
- Vers votre Base de Données ou CRM (Backend) : Utilisez les Webhooks. C'est ce qui vous permet d'envoyer de manière sécurisée l'adresse email ou les détails de contact d'un lead de Drimify à vos systèmes internes (comme HubSpot, Salesforce ou une base de données personnalisée). Cela fonctionne parfaitement que votre campagne soit sur un site ou dans une appli.
- Vers l'Écran de l'Utilisateur (Frontend) : Utilisez les Callbacks JavaScript. C'est idéal pour faire réagir immédiatement le site à l'action d'un joueur—for example, afficher un bouton "Obtenez votre Remise" sur votre page web dès qu'ils terminent le jeu.### Comparaison d'Intégration
Fonctionnalité | Webhooks (Recommandé pour les Données) | Callbacks JavaScript (Idéal pour l'UX) |
Connexion | Serveur-à-Serveur | Navigateur-à-Navigateur |
Objectif Principal | Transférer de manière sécurisée les données de lead et informations de contact. | Créer une expérience utilisateur fluide et interactive sur votre site. |
Exemple Concret | Ajouter automatiquement un participant à votre liste de diffusion. | Masquer le jeu et révéler un code promo sur votre page. |
Sécurité | Élevée (se produit en coulisses). | Directe (se produit sur l'appareil de l'utilisateur). |
Résumé des Cas d'Utilisation
Que vous intégriez Drimify sur un site internet ou dans une application mobile, vous utiliserez souvent une combinaison des deux :
- Un Webhook pour s'assurer que votre équipe marketing reçoit les coordonnées du lead dans votre CRM.
- Un Callback JavaScript pour garantir que l'utilisateur voit un message de "Merci" ou un lien de récompense immédiat sans rafraîchir la page.
Remarque sur les Callbacks : Étant donné que les Callbacks JavaScript s'exécutent dans le navigateur de l'utilisateur, ils sont excellents pour l'expérience utilisateur (UX) mais ne doivent pas être utilisés pour la validation de données à haute sécurité. Pour des transferts de données sécurisés côté serveur (comme des informations de lead sensibles), priorisez toujours les Webhooks.
Mis à jour le : 20/03/2026
Merci !