Configurer les intégrations dans Drimify (webhooks et services de messagerie)

Les intégrations Drimify vous permettent d’envoyer automatiquement les données des participants à des services externes lorsqu’un utilisateur interagit avec votre application. Vous pouvez connecter une API personnalisée, HubSpot ou Salesforce et définir précisément les champs de données à transmettre pour chaque intégration.

Premiers pas

Si aucune intégration n’a encore été configurée, le message « Aucune intégration webhook pour le moment » ou « Aucune intégration de messagerie pour le moment » s’affiche.
Cliquez sur + Ajouter une nouvelle intégration (en haut à droite ou au centre de la page) pour ouvrir le sélecteur d’intégration.

Intégrations webhook

Sélectionner un type d’intégration

Une fenêtre intitulée « Sélectionner une intégration webhook » s’affiche.
Vous pouvez filtrer les intégrations par catégorie à l’aide du menu déroulant (réglé sur Toutes par défaut). Trois intégrations sont disponibles :

• API personnalisée — pour tout point de terminaison REST d’une API que vous gérez
• HubSpot — pour le CRM et l’automatisation marketing avec HubSpot
• Salesforce — pour le CRM Salesforce

Cliquez sur la vignette de l’intégration à configurer.

Intégration d’une 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 nom qui vous permet d’identifier votre intégration (par défaut : « Intégration API personnalisée »). Vous pouvez le remplacer par un nom plus explicite.
• Point de terminaison de l’API : l’URL complète du service qui recevra votre webhook (par exemple : https://api.example.com/webhook). Cette URL doit utiliser HTTPS.
• Méthode HTTP :

Sélectionnez la méthode HTTP à utiliser pour envoyer la requête webhook à votre point de terminaison.
Options disponibles :

• POST — recommandée dans la plupart des cas (création d’une ressource ou envoi de données)
• PUT — remplacement complet d’une ressource existante
• PATCH — mise à jour partielle d’une ressource existante

Choisissez la méthode attendue par votre API pour recevoir les données.

• Type d’authentification : choisissez la méthode d’authentification utilisée par votre point de terminaison.

• Lorsque vous sélectionnez Authentification Basic, deux champs s’affichent : Identifiant (nom d’utilisateur) et Mot de passe. Saisissez-les tels quels : Drimify génère automatiquement l’en-tête Authorization: Basic. Vous n’avez rien à encoder vous-même.
• Lorsque vous sélectionnez En-tête personnalisé, un champ supplémentaire Nom de l’en-tête personnalisé s’affiche pour vous permettre de saisir le nom de la clé d’en-tête.
• Clé API : la valeur secrète envoyée selon la méthode d’authentification sélectionnée.
• Vérifier la connexion : cliquez sur ce bouton pour vérifier que Drimify peut accéder à votre point de terminaison avec les identifiants fournis avant d’enregistrer l’intégration.

Récupérer le jeton auprès d’un point de terminaison d’authentification (appel préalable)

Certaines API nécessitent une authentification préalable : vous appelez un point de terminaison d’authentification avec vos identifiants, recevez un jeton, puis utilisez ce jeton lors de l’appel webhook. Drimify peut gérer automatiquement cette procédure.

Lorsque le type d’authentification est Clé API, Jeton Bearer ou En-tête personnalisé, une case « Récupérer ce jeton auprès d’un point de terminaison d’authentification » s’affiche. Si vous la cochez, le champ de saisie du jeton statique est remplacé par les paramètres d’appel préalable ci-dessous. Pour le type En-tête personnalisé, le champ du nom de l’en-tête reste visible : le jeton récupéré est envoyé dans cet en-tête.

Le jeton récupéré est inséré selon le type d’authentification choisi :

• Jeton Bearer → Authorization: Bearer <token>
• Clé API → X-API-KEY: <token>
• En-tête personnalisé → <your header name>: <token>

Choisir l’une des trois méthodes

OAuth2 (client_credentials) — pour les serveurs OAuth2 standard (par exemple : Keycloak).

• Champs : URL du jeton, ID client, Secret client, Portée (facultatif)
• Drimify envoie une requête OAuth2 standard de type client_credentials et récupère le jeton dans access_token. Sa durée de validité est déterminée par la valeur expires_in renvoyée par le serveur.

Authentification JSON — pour les points de terminaison de connexion qui acceptent un corps de requête JSON et renvoient un jeton.

• Champs : URL d’authentification, Corps de la requête (liste de paires clé/valeur), Chemin du jeton
• Drimify envoie une requête POST avec un corps JSON généré à partir des paires clé/valeur saisies. Par exemple, les lignes email = a@b.com et password = secret produisent {"email":"a@b.com","password":"secret"}.
• Le Chemin du jeton indique à Drimify où trouver le jeton dans la réponse JSON, à l’aide d’une notation par points. Par exemple : data.access_token, ou simplement token s’il se trouve à la racine de la réponse.

Personnalisée — pour les cas qui ne correspondent à aucune des deux méthodes ci-dessus.

• Champs : URL d’authentification, Méthode HTTP (POST ou GET), En-têtes (liste de paires clé/valeur), Corps de la requête (liste de paires clé/valeur), Encodage du corps de la requête (JSON ou form-urlencoded), Chemin du jeton
• Avec la méthode GET, la requête ne contient pas de corps : transmettez les paramètres dans les en-têtes ou dans l’URL d’authentification.
• Si vous ajoutez vous-même un en-tête Content-Type, il est prioritaire sur celui défini par l’encodage du corps de la requête.

Listes de paires clé/valeur (corps de la requête et en-têtes)

Chaque ligne comporte une clé, une valeur et une case « Donnée sensible » (cochée par défaut). Vous pouvez ajouter ou supprimer des lignes, mais pas les modifier directement : pour modifier une ligne, supprimez-la, puis ajoutez-la à nouveau. Le caractère sensible d’une valeur ne peut être défini qu’à l’ajout de la ligne. Les valeurs sensibles sont masquées après l’enregistrement et ne sont plus jamais affichées, ni dans le formulaire ni dans les journaux.

Mise en cache des jetons et nouvelles tentatives

• Les jetons OAuth2 sont mis en cache pour la durée indiquée par expires_in.
• Pour les méthodes Authentification JSON et Personnalisée, définissez la Durée de validité du jeton (minutes). Si vous laissez ce champ vide, la durée par défaut est de 60 minutes.
• Les jetons sont conservés en cache pendant 7 jours au maximum.
• Si votre point de terminaison renvoie une erreur 401 alors qu’un jeton en cache est utilisé, Drimify supprime ce jeton, s’authentifie à nouveau et effectue une nouvelle tentative d’appel.
• Si l’appel préalable échoue (erreur, délai d’attente dépassé ou aucun jeton trouvé au chemin indiqué), le webhook n’est pas envoyé sans authentification. L’échec d’envoi est consigné dans les journaux, puis la file d’attente des envois effectue de nouvelles tentatives selon le fonctionnement habituel.

Vérifier la connexion avec un appel préalable

Le bouton Vérifier la connexion prend entièrement en charge l’appel préalable : Drimify s’authentifie d’abord auprès de votre point de terminaison d’authentification, puis effectue l’appel de test avec le jeton récupéré.

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 le jeton d’accès de votre application privée HubSpot. Les anciennes clés API HubSpot sont obsolètes depuis 2022. Vous devez donc utiliser un jeton d’application privée généré dans votre compte HubSpot, sous : Paramètres → Intégrations → Applications privées
• Vérifier la connexion : teste le jeton auprès de l’API HubSpot avant l’enregistrement.

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 : yourcompany.my.salesforce.com).
• Clé consommateur et Secret consommateur : ces identifiants sont fournis par une application connectée configurée dans Salesforce, sous : Configuration → Gestionnaire d’applications → Nouvelle application connectée. Drimify utilise le flux OAuth 2.0 Client Credentials.
• Nom du champ d’ID externe : le nom d’API du champ utilisé pour identifier les enregistrements lors des opérations d’upsert (création ou mise à jour), généralement Email_External_Id__c ou un autre champ d’ID externe personnalisé de l’objet Contact. Ce champ doit être défini comme ID externe dans Salesforce. Drimify crée ou met à jour des Contacts. Les prospects ne sont pas encore pris en charge.
• Source de l’ID externe : un menu déroulant qui vous permet de sélectionner le champ de données Drimify à utiliser comme clé de correspondance (par exemple : Email).
• Vérifier la connexion : teste la connexion OAuth à Salesforce avant l’enregistrement.

⚠️ Champs Salesforce obligatoires

Salesforce impose des champs obligatoires pour l’objet Contact. Pour créer un Contact, vous devez renseigner au minimum :

• lastName

Même si l’adresse email n’est pas obligatoire dans le schéma par défaut de Salesforce, elle est presque toujours nécessaire comme ID externe pour identifier correctement les enregistrements et éviter les doublons lors des opérations d’upsert. Sans correspondance fiable sur l’ID externe, Salesforce risque de créer des doublons ou de renvoyer une erreur.

Bonne pratique

Associez toujours au minimum les champs suivants :

• Nom
• Email

lorsque vous connectez Salesforce. Si le champ Nom n’est pas associé, le webhook échouera et l’enregistrement ne sera ni créé ni mis à jour.

Associer les champs

Disponible pour les trois types d’intégration, la fonctionnalité Associer les champs vous permet de définir précisément les champs de données Drimify à envoyer à votre intégration, ainsi que les noms des clés à utiliser.
Cliquez sur + Ajouter un champ pour ajouter une ligne de correspondance.

Chaque ligne comprend :

• Champ du webhook (à gauche) — le nom de la clé qui figurera dans les données envoyées. Vous le définissez selon les exigences de votre intégration.
• → Champ source (menu déroulant à droite) — la source de la valeur de ce champ. Vous pouvez :
• • Sélectionner un champ de données Drimify (par exemple : Référence de l’app, Email, Score) pour envoyer une valeur dynamique recueillie auprès du participant.
  • Sélectionner Valeur statique pour envoyer une valeur fixe à chaque déclenchement du webhook. Un champ de texte supplémentaire s’affiche pour vous permettre de saisir cette valeur (par exemple : My_Value). Cette option est utile pour transmettre des constantes, comme un nom d’événement, un identifiant de source ou une étiquette d’environnement.

Champs sources Drimify disponibles

Vous pouvez ajouter autant de correspondances que nécessaire.
Pour supprimer une correspondance, cliquez sur l’icône de corbeille à droite de la ligne.## Indiquer dans votre CRM qu’un contact provient de Drimify

Drimify ne renseigne pas automatiquement la source des contacts, mais vous pouvez le faire en associant les champs dans Salesforce et HubSpot :

1. Dans votre CRM, créez un champ pour enregistrer la source. Dans Salesforce, il s’agit d’un champ de type texte sur l’objet Contact (par exemple Drimify_Source__c). Dans HubSpot, il s’agit d’une propriété de contact (par exemple drimify_source).
2. Dans votre intégration Drimify, ouvrez Associer les champs et ajoutez une ligne en renseignant le nom API de ce champ à gauche. Sélectionnez Valeur statique à droite et saisissez Drimify.
3. Pour savoir à quelle expérience le contact a participé, ajoutez une deuxième ligne associant un autre champ (par exemple Drimify_Game__c) à Référence de l’application.

Disponibilité dans les espaces de travail

En bas du formulaire d’intégration, la section Disponible dans les espaces de travail vous permet de choisir les espaces de travail qui peuvent utiliser l’intégration grâce à l’interrupteur situé à côté de chacun d’eux.
Cliquez sur Tout sélectionner pour activer l’intégration dans tous les espaces de travail en une seule fois.

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 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 abandonner les modifications non enregistrées.

Intégrations de messagerie

Les intégrations de messagerie vous permettent d’envoyer des e-mails transactionnels (confirmations, résultats ou messages de suivi, par exemple) directement depuis vos expériences Drimify, via le fournisseur de messagerie de votre choix.

Ajouter une intégration de messagerie

1. Accédez à Intégrations → Intégrations de messagerie
2. Cliquez sur Ajouter une intégration de messagerie
3. Sélectionnez votre fournisseur :

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• Tipimail
• SMTP personnalisé

Configurer votre intégration de messagerie

Paramètres généraux

Les paramètres généraux suivants sont communs à tous les fournisseurs :

• Nom de l’intégration – Nom utilisé en interne pour identifier votre intégration
• Nom de l’expéditeur – Nom affiché comme expéditeur de l’e-mail
• Adresse e-mail de l’expéditeur – Adresse e-mail utilisée pour envoyer les messages (ne s’applique pas à Drimify — voir ci-dessous)
• Adresse e-mail en Cci (facultatif) – Adresse e-mail à laquelle envoyer une copie cachée de tous les messages sortants

Authentification

Chaque fournisseur nécessite des identifiants spécifiques. Consultez les instructions de configuration propres à chaque fournisseur ci-dessous pour en savoir plus.

Tester la connexion

Après avoir saisi vos identifiants, cliquez sur Envoyer un e-mail de test pour vérifier le bon fonctionnement de votre intégration. Le message de confirmation « E-mail de test envoyé avec succès » s’affichera si la connexion fonctionne.

Champs des paramètres du modèle

Associez les champs de données Drimify aux variables des modèles de votre fournisseur de messagerie. Cette section est disponible pour les fournisseurs qui prennent en charge les modèles d’e-mails dynamiques : Brevo, Mailgun, Mailjet, Mandrill, SendGrid et Tipimail.

• Nom du paramètre – Nom de la variable attendue dans votre modèle d’e-mail
• Champ – Donnée Drimify correspondante (par exemple : Prénom, E-mail, Score, etc.)

Cliquez sur Ajouter un champ pour créer des associations supplémentaires.

Disponibilité dans les espaces de travail

Sélectionnez les espaces de travail qui peuvent utiliser cette intégration de messagerie.

Configuration par fournisseur

Amazon SES

Éléments nécessaires :

• Un utilisateur AWS IAM disposant des autorisations ses:SendEmail
• Une clé d’accès API et une clé privée API (disponibles dans AWS IAM)
• Votre région AWS (par exemple eu-west-1, us-east-1)
• Un jeton de session (uniquement si vous utilisez des identifiants temporaires ou STS)
• Une adresse e-mail d’expédition ou un domaine vérifié dans Amazon SES

Étapes :

1. Dans AWS IAM, créez un utilisateur disposant des autorisations d’envoi SES et générez une paire de clés d’accès
2. Dans Drimify, renseignez votre Clé d’accès API, votre Clé privée API et votre Région
3. Si vous utilisez des identifiants temporaires, renseignez également le Jeton de session
4. Vérifiez que votre adresse e-mail d’expédition ou votre domaine a bien été vérifié dans Amazon SES
5. Cliquez sur Envoyer un e-mail de test pour valider la connexion
6. Enregistrez votre intégration

Brevo

Éléments nécessaires :

• Une clé API Brevo

Étapes :

1. Dans votre compte Brevo, générez une clé API dans Paramètres → Clés API
2. Collez-la dans le champ Clé API de Drimify
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

Drimify

Aucune authentification n’est requise. Les e-mails sont envoyés via l’infrastructure de messagerie interne de Drimify (notification@digitaservice.com).
Éléments nécessaires :

• Un nom d’expéditeur
• Une adresse e-mail de réponse (par exemple contact@yourcompany.com)
• Une adresse e-mail en Cci, si nécessaire

Étapes :

1. Sélectionnez Drimify comme fournisseur
2. Renseignez le Nom de l’expéditeur et l’Adresse e-mail de réponse
3. Ajoutez une Adresse e-mail en Cci si nécessaire
4. Sélectionnez les espaces de travail qui doivent pouvoir utiliser cette intégration, puis enregistrez-la

Mailgun

Éléments nécessaires :

• Une clé API Mailgun
• Votre domaine d’envoi enregistré dans Mailgun
• Votre région API (US ou EU)

Étapes :

1. Dans votre compte Mailgun, récupérez votre clé API et votre domaine d’envoi
2. Dans Drimify, renseignez votre Clé API, votre Domaine API et votre Région API
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

Mailjet

Éléments nécessaires :

• Une clé d’accès API et une clé privée API Mailjet

Étapes :

1. Dans votre compte Mailjet, accédez à Paramètres du compte → API REST → Gestion des clés API
2. Copiez votre Clé d’accès API et votre Clé privée API
3. Renseignez ces deux clés dans Drimify
4. Cliquez sur Envoyer un e-mail de test pour valider la connexion
5. Enregistrez votre intégration

Mandrill

Éléments nécessaires :

• Une clé API Mandrill (Mandrill est un module complémentaire de Mailchimp dédié aux e-mails transactionnels)

Étapes :

1. Dans votre compte Mandrill, accédez à Paramètres → Clés API et générez une clé
2. Collez la Clé API dans Drimify
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

SendGrid

Éléments nécessaires :

• Une clé API SendGrid disposant des autorisations Mail Send

Étapes :

1. Dans votre compte SendGrid, accédez à Paramètres → Clés API et créez une clé disposant des autorisations Mail Send
2. Collez la Clé API dans Drimify
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

Tipimail

Éléments nécessaires :

• Un identifiant utilisateur API et une clé API Tipimail (Tipimail est le service d’e-mails transactionnels de Sarbacane)

Étapes :

1. Dans votre compte Tipimail, accédez à Paramètres → SMTP et API et récupérez votre Identifiant utilisateur API et votre Clé API
2. Renseignez ces deux éléments dans Drimify
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

SMTP personnalisé

Éléments nécessaires :

• Le nom d’hôte de votre serveur SMTP
• Le port SMTP (généralement 587 pour TLS ou 465 pour SSL)
• L’identifiant SMTP (généralement votre adresse e-mail)
• Le mot de passe SMTP

Étapes :

1. Récupérez vos identifiants SMTP auprès de votre hébergeur de messagerie ou dans la configuration de votre serveur
2. Dans Drimify, renseignez les champs Hôte, Port, Identifiant et Mot de passe
3. Cliquez sur Envoyer un e-mail de test pour valider la connexion
4. Enregistrez votre intégration

Mis à jour le : 03/11/2026