Configurer les intégrations Webhook sur Drimify
Configuration des Intégrations Webhook dans Drimify
Les intégrations webhook de Drimify vous permettent de transmettre automatiquement les données des participants à des services externes dès qu'un utilisateur interagit avec votre application. Vous pouvez vous connecter à une API Personnalisée, HubSpot ou Salesforce — et pour chacun d'eux, vous pouvez spécifier exactement quels champs de données sont transmis.
Premiers Pas
Accédez à Mon Compte → Intégrations. Si aucune intégration n'a encore été configurée, vous verrez l'écran de placeholder "Aucune intégration webhook encore". Cliquez sur + Ajouter Nouvelle Intégration (disponible à la fois en haut à droite et au centre de la page) pour ouvrir le sélecteur d'intégrations.
Sélection d'un Type d'Intégration
Une fenêtre modale s'affichera avec le titre "Sélectionner Intégration Webhook". Vous pouvez filtrer par catégorie en utilisant le menu déroulant (par défaut sur Tous). Les trois intégrations disponibles sont :
- API Personnalisée — pour tout point de terminaison REST pour l'API que vous contrôlez
- HubSpot — pour l'automatisation CRM & 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 Intégration s'ouvre avec les champs suivants :
- Nom de l'Intégration Une étiquette pour votre propre référence (par défaut "Intégration API Personnalisée"). Vous pouvez le renommer pour quelque chose de descriptif.
- Point de Terminaison API L'URL complète de votre récepteur webhook (par exemple :
https://api.example.com/webhook). Cela doit être un point de terminaison HTTPS. - **Méthode HTTP : **
Sélectionnez la méthode HTTP utilisée pour envoyer la demande webhook à votre point de terminaison.
Les options sont :
- POST — Recommandé pour la plupart des cas d'utilisation (crée une nouvelle ressource ou envoie des données)
- PUT — Remplace entièrement une ressource existante
- PATCH — Met à jour partiellement une ressource existante
Choisissez la méthode qui correspond à la manière dont votre API attend de recevoir les données.
- Type de Clé API Choisissez la méthode d'authentification utilisée par votre point de terminaison. Les options sont :
Option | Description |
|---|---|
Aucune | Aucun en-tête d'authentification n'est envoyé |
Clé API (X-API-KEY) | Envoie la clé dans un en-tête |
Jeton Bearer | Envoie la clé comme |
Authentification Basique | Envoie les identifiants |
En-Tête Personnalisé | Vous permet de définir le nom de votre propre en-tête (par exemple : |
- Lorsque En-Tête Personnalisé est sélectionné, un champ Nom de l'En-Tête Personnalisé supplémentaire 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 Connexion Cliquez sur ce bouton pour tester si Drimify peut atteindre avec succès votre point de terminaison avec les identifiants fournis avant de sauvegarder.
Intégration HubSpot
Après avoir sélectionné HubSpot, le panneau montre :
- 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'Appli Privée HubSpot. HubSpot a remplacé les clés API héritées en 2022, vous devez donc utiliser un jeton d'application privée généré depuis votre compte HubSpot sous Paramètres → Intégrations → Applications Privées.
- Vérifier 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 : "Salesforce Integration".
- Domaine Salesforce L'URL de votre instance Salesforce (par exemple,
yourcompany.my.salesforce.com). - Consumer Key et Consumer Secret Obtenus depuis une Application Connectée configurée dans Salesforce sous Configuration → Gestionnaire D'applications → Nouvelle Application Connectée. Drimify utilise le flux de crédentiels client OAuth 2.0.
- Nom du champ External id Le nom API du champ utilisé pour faire correspondre (upsert) les enregistrements — typiquement
Email_External_Id__cou un identifiant 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 de l'objet. Si vous effectuer un upsert de Leads, Salesforce exige au minimum :
- Nom de famille (
lastName) — obligatoire pour la création de Lead
Si vous effectuer un upsert de Contacts, Salesforce exige :
- Nom de famille (
lastName) — obligatoire pour la création de Contact
Email n'est pas requis par le schéma de Salesforce par défaut, mais est presque toujours nécessaire comme ID Externe pour faire correspondre et dédupliquer correctement les enregistrements lors de l'upsert. Sans une correspondance d'ID externe fiable, Salesforce créera des enregistrements dupliqués ou renverra une erreur.
Bonne pratique : Mappez toujours au minimum Nom de famille et Email lors de la connexion à Salesforce. Omettre le Nom entraînera une erreur du webhook et l'enregistrement ne sera pas créé ni mis à jour.
Associer Les Champs
Disponible sur les trois types d'intégration, 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 Champ pour ajouter une ligne de mappage. Chaque ligne se compose de :
- Champ webhook (gauche) — le nom de la clé qui apparaîtra dans la charge utile sortante (vous définissez cela, correspondant aux 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 d'affichage | 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 | |
Levels Joué | |
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 à droite de la ligne.
Disponible dans les Espaces de Travail
En bas du formulaire d'intégration, une section Disponible dans les Espaces de Travail vous permet d'utiliser le commutateur à côté de chaque espace de travail pour contrôler quel espace peut utiliser cette intégration. Cliquez sur Sélectionner Tout pour l'activer pour tous les espaces de travail d'un coup.## Économisez et Gérer les Intégrations
Une fois que tous les champs sont remplis, cliquez sur Save Changes 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 de cette liste à tout moment. Cliquez sur Cancel pour annuler les modifications non enregistrées.
Mis à jour le : 22/04/2026
Merci !