> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.drimify.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 :

1. Un **Webhook** pour s'assurer que votre équipe marketing reçoit les coordonnées du lead dans votre CRM.
2. 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**.