Configurer les intégrations Webhook sur Drimify
Configuration des intégrations Webhook dans Drimify
Les intégrations webhook de Drimify vous permettent d'envoyer automatiquement les données des participants vers des services externes chaque fois qu'un utilisateur complète ou interagit avec votre application. Vous pouvez vous connecter à une API personnalisée, à HubSpot ou à Salesforce — et pour chacun, vous pouvez définir précisément quels champs de données sont transmis.
Premiers Pas
Dirigez-vous vers Paramètres → Intégrations. Si aucune intégration n'a encore été configurée, vous verrez l'écran d'attente "Pas encore d'intégrations webhook". Cliquez sur + Ajouter une nouvelle intégration (disponible en haut à droite et au centre de la page) pour ouvrir le sélecteur d'intégration.
Sélection d'un Type d'Intégration
Une fenêtre modale apparaîtra avec pour titre "Sélectionner l'intégration Webhook". Vous pouvez filtrer par catégorie à l'aide du menu déroulant (par défaut sur Toutes). Les trois intégrations disponibles sont :
- API personnalisée — pour tout point de terminaison REST de l'API que vous contrôlez
- HubSpot — pour l'automatisation CRM et Marketing via HubSpot
- Salesforce — pour le CRM Salesforce
Cliquez sur la vignette du type d'intégration que vous souhaitez configurer.
Intégration API Personnalisée
Authentification
Après avoir sélectionné API personnalisée, le panneau Ajouter une intégration s'ouvre avec les champs suivants :
Nom de l'intégration Un libellé pour votre propre référence (par défaut "Intégration API Personnalisée"). Vous pouvez le renommer pour qu'il soit plus descriptif.
Point de terminaison API L'URL complète de votre destinataire webhook (par exemple https://api.example.com/webhook). Cela doit être un point de terminaison HTTPS.
Type de clé API Choisissez la méthode d'authentification que votre point de terminaison utilise. Les options sont :
Option | Description |
|---|---|
Aucun | Aucun en-tête d'authentification n'est envoyé |
Clé API (X-API-KEY) | Envoie la clé dans un en-tête |
Token Bearer | Envoie la clé en tant que |
Auth Basique | Envoie des identifiants |
En-tête personnalisé | Vous permet de définir votre propre nom d'en-tête (par exemple |
Lorsque En-tête personnalisé est sélectionné, un champ supplémentaire Nom d'en-tête personnalisé apparaît où vous entrez le nom de la clé d'en-tête.
Clé API La valeur secrète envoyée avec la méthode d'authentification choisie.
Vérifier la connexion Cliquez sur ce bouton pour tester si Drimify peut atteindre votre point de terminaison avec les informations d'identification fournies avant de sauvegarder.
Intégration HubSpot
Après avoir sélectionné HubSpot, le panneau affiche :
Nom de l'intégration Par défaut "Intégration HubSpot".
Clé API / Jeton d'accès Collez ici votre Jeton d’accès d'application privée HubSpot. HubSpot a déprécié les clés API classiques en 2022, vous devriez donc utiliser un Jeton d'application privée généré depuis votre compte HubSpot dans Paramètres → Intégrations → Applications Privées.
Vérifier la connexion Teste le jeton contre l'API HubSpot avant de sauvegarder.
Intégration Salesforce
Après avoir sélectionné Salesforce, le panneau affiche :
Nom de l'intégration Par défaut "Intégration Salesforce".
Domaine Salesforce L'URL de votre instance Salesforce (par exemple votreentreprise.my.salesforce.com).
Clé consommateur et Secret consommateur Ceux-ci sont obtenus à partir d'une Application Connectée configurée dans Salesforce sous Configuration → Gestionnaire d’Applications → Nouvelle Application Connectée. Drimify utilise le flux d'informations d'identification du client OAuth 2.0.
Nom du champ id externe Le nom API du champ utilisé pour associer (upsert) des enregistrements — généralement Email_External_Id__c ou un champ id externe personnalisé sur l'objet Contact ou Lead. Ce champ doit être marqué comme ID Externe dans Salesforce.
Source de l'ID Externe Un menu déroulant pour sélectionner quel champ de données Drimify utiliser comme clé de correspondance (par exemple, Email).
Vérifier la connexion Teste la connexion OAuth de Salesforce avant de sauvegarder.### ⚠️ Champs Obligatoires pour Salesforce
Salesforce impose des champs obligatoires au niveau des objets. Si vous faites un upsert de Leads, Salesforce exige au minimum :
- Nom de Famille (
lastName) — requis pour la création de Leads.
Si vous faites un upsert de Contacts, Salesforce exige :
- Nom de Famille (
lastName) — requis pour la création de Contacts.
Le champ Email n'est pas requis par défaut selon le schéma de Salesforce, mais il est presque toujours nécessaire en tant qu'ID Externe pour correctement associer et dédupliquer les enregistrements lors d'un upsert. Sans correspondance fiable de l'ID externe, Salesforce créera des enregistrements en double ou renverra une erreur.
Conseil pratique : Mappez toujours au minimum le Nom de Famille et l'Email lors de la connexion à Salesforce. Ne pas inclure le Nom provoquera une erreur retour du webhook et l'enregistrement ne sera pas créé ou mis à jour.
Associer les Champs
Disponible sur les trois types d'intégration, l'outil Associer les Champs vous permet de spécifier exactement quels champs de données Drimify sont envoyés à votre intégration et sous quels noms de clés.
Cliquez sur + Ajouter Field pour ajouter une ligne de mappage. Chaque ligne comprend :
- Champ du Webhook (à gauche) — le nom de la clé qui apparaîtra dans le payload sortant (vous définissez cela, en fonction des noms de champs attendus par votre intégration)
- → Champ source (menu déroulant à droite) — le champ de données Drimify à mapper
Champs Source Drimify Disponibles
Nom Affiché | Clé du Champ |
|---|---|
Adresse Postale | |
app id | |
Référence de l’app | |
Code | |
Nom de Société | |
Pays de Connexion | |
Pays | |
Code du Pays | |
Case à Cocher Personnalisée | |
Format Personnalisé | |
Champ de Texte Personnalisé | |
Date | |
Date de Naissance | |
Date avec Fuseau Horaire | |
| |
Prénom | |
Civilité | |
ID | |
Idunic | |
Adresse IP | |
Nom | |
Niveaux Joués | |
Localisation | |
Opt-In Newsletter | |
Numéro de Téléphone | |
Joué | |
Code Postal | |
Profil | |
UID du Profil | |
Réf. du Lot | |
Nom du Gain | |
Identifiant Unique du Gain (UID) | |
Référence | |
Score | |
Sélectionner une Valeur | |
Sélectionner la Valeur 2 | |
ID de Session | |
Temps Passé | |
Ville | |
Date de Mise à Jour | |
Date de Mise à Jour Timestamp | |
Nom d'Utilisateur | |
Adresse Site Internet | |
Vous pouvez ajouter autant de lignes que nécessaire. Pour supprimer un mappage, cliquez sur l'icône de corbeille sur le côté droit de la ligne.
Disponible dans les Espaces de Travail
En bas de chaque formulaire d'intégration se trouve une section Disponible dans les Espaces de Travail. Utilisez le toggle à côté de chaque espace de travail pour contrôler quel espace de travail peut utiliser cette intégration. Cliquez sur Sélectionner Tout pour l'activer pour tous les espaces de travail d'un coup.
Enregistrer et Gérer les Intégrations
Une fois que tous les champs sont renseignés, cliquez sur Enregistrer les Modifications pour créer l'intégration. Elle apparaîtra alors dans la liste principale des Intégrations. Vous pouvez modifier ou supprimer les intégrations existantes depuis cette liste à tout moment.
Cliquez sur Annuler pour annuler toutes les modifications non enregistrées.
Mis à jour le : 06/03/2026
Merci !