Cet article est aussi disponible en :

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 termine ou interagit avec votre application. Vous pouvez vous connecter à une API personnalisée, à HubSpot ou à Salesforce — et pour chacune, vous pouvez définir précisément quels champs de données sont transmis.


Pour commencer


Rendez-vous dans Mon compte → Intégrations. Si aucune intégration n'a encore été configurée, vous verrez un écran d'accueil "Aucune intégration webhook pour le moment". Cliquez sur + Ajouter Nouvelle Intégration (disponible à la fois dans le coin supérieur droit et au centre de la page) pour ouvrir le sélecteur d'intégrations.


Sélection du type d'intégration


Une fenêtre modale intitulée "Sélectionner l'intégration Webhook" va apparaître. Vous pouvez filtrer par catégorie en utilisant le menu déroulant (par défaut sur Toutes). Les trois intégrations disponibles sont :


  • API personnalisée — pour tout point de terminaison REST que vous contrôlez
  • HubSpot — pour l'automatisation CRM & Marketing via HubSpot
  • Salesforce — pour le CRM Salesforce


Cliquez sur l'élément correspondant au 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 label de référence personnelle (par défaut "Intégration API personnalisée"). Vous pouvez le renommer en quelque chose de descriptif.
  • Point de terminaison API L'URL complète de votre récepteur webhook (par ex. https://api.example.com/webhook). Cela doit être un point de terminaison HTTPS.
  • 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 X-API-KEY

Jeton Bearer

Envoie la clé comme Authorization: Bearer <token>

Authentification de base

Envoie les identifiants username:password encodés en Base64

En-tête personnalisé

Vous permet de définir votre propre nom d'en-tête (par ex. X-Custom-Auth)


  • Lorsque En-tête personnalisé est sélectionné, un champ supplémentaire Nom de l'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 réussir à atteindre votre point de terminaison avec les identifiants fournis 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 App Privée HubSpot. HubSpot a supprimé les clés API classiques en 2022, alors vous devriez utiliser un jeton d'application privée généré depuis votre compte HubSpot sous Paramètres → Intégrations → Applications Privées.
  • Vérifier la connexion Teste le jeton avec 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 ex. yourcompany.my.salesforce.com).
  • Clé consommateur et Secret consommateur Ceux-ci sont obtenus d'une application connectée configurée dans Salesforce sous Configuration → Gestionnaire d'applications → Nouvelle application connectée. Drimify utilise le flux d'identification OAuth 2.0.
  • Nom du champ id externe Le nom API du champ utilisé pour faire correspondre (insérer ou mettre à jour) les enregistrements — typiquement 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 ex. Email).
  • Vérifier la connexion Teste la connexion OAuth Salesforce avant de sauvegarder.


⚠️ Champs obligatoires pour Salesforce


Salesforce impose des champs requis au niveau des objets. Si vous procédez à un upsert pour des Leads, Salesforce demande au minimum :


  • Nom de famille (lastName) — obligatoire pour la création de Lead


Si vous effectuez un upsert pour des Contacts, Salesforce exige :


  • Nom de famille (lastName) — obligatoire pour la création de Contact


L'Email n'est pas requis par défaut dans le schéma de Salesforce, mais il est presque toujours nécessaire comme ID externe pour correctement associer et dédupliquer les enregistrements lors de l'upsert. Sans un matching fiable de l'ID externe, Salesforce créera des enregistrements en double ou renverra une erreur.


Bonne pratique : Mappez toujours au minimum le Nom de famille et l'Email lors de la connexion à Salesforce. Omettre le nom entraînera le renvoi d'une erreur par le 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 mapping. Chaque ligne se compose de :


  • Champ Webhook (à gauche) — le nom de clé qui apparaîtra dans la charge utile sortante (vous le définissez, correspondant aux noms des champs attendus par votre intégration)
  • → Champ source (menu déroulant à droite) — le champ de données Drimify à mapper à celui-ci


Champs Source Drimify disponibles


Nom affiché

Clé de champ

Adresse postale

address

identifiant de l'application

appId

Référence de l'application

appReference

Code

code

Nom de la société

companyName

Pays de connexion

connectionCountry

Pays

country

Code du pays

countryCode

Case à cocher personnalisée

customCheckbox

Format personnalisé

customFormat

Champ de texte personnalisé

customText

Date

date

Date de naissance

dob

Date avec fuseau horaire

dateWithTimezone

Email

email

Prénom

firstName

Civilité

gender

ID

id

Idunic

idunic

adresse IP

ipAddress

Nom

lastName

Niveaux joués

levelsPlayed

Localisation

locale

Opt-in newsletter

optinNewsletter

Numéro de téléphone

phoneNumber

Joué

played

Code postal

cp

Profil

profil

uid du profil

profilUid

Référence du lot

prizeRef

Nom du gain

prizeTitle

identifiant unique du gain (uid)

prizeUid

Référence

referral

Score

score

Sélectionner une valeur

selectValue

Sélectionner la valeur 2

selectValue2

ID de session

sessionId

Temps passé

timeTaken

Ville

town

Date de mise à jour

updatedAt

Date de mise à jour horodatage

updatedAtTimeStamp

Nom d'utilisateur

username

Adresse du site internet

website


Vous pouvez ajouter autant de lignes que nécessaire. Pour supprimer un mapping, cliquez sur l'icône de poubelle à droite 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 commutateur à côté de chaque espace de travail pour contrôler quel espace peut utiliser cette intégration. Cliquez sur Tout sélectionner pour l'activer pour tous les espaces de travail en même temps.


Enregistrer et gérer les intégrations


Une fois tous les champs remplis, cliquez sur Enregistrer les modifications pour créer l'intégration. Elle apparaîtra ensuite 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 toute modification non enregistrée.

Mis à jour le : 10/03/2026

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !