Configurer les Intégrations dans Drimify (Webhooks & Messageries)

Les intégrations Drimify vous permettent d'envoyer automatiquement les données des participants vers des services externes chaque fois qu'un utilisateur interagit avec votre application. Vous pouvez vous connecter à une API personnalisée, à HubSpot ou à Salesforce — et pour chaque intégration, vous pouvez préciser exactement quels champs de données sont transmis.

Commencer

Si aucune intégration n'a encore été configurée, vous verrez l'écran d'étiquette "Aucune intégration webhook pour le moment" ou "Aucune intégration de messagerie pour le moment".
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.

Intégrations Webhook

Sélection du Type d'Intégration

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

• API Personnalisée — pour tout endpoint REST de l'API que vous contrôlez
• HubSpot — pour l'automatisation CRM et Marketing via HubSpot
• Salesforce — pour le CRM de Salesforce

Cliquez sur la vignette de l'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 : Un libellé pour votre propre référence (par défaut : "Intégration API Personnalisée"). Vous pouvez le renommer avec quelque chose de plus descriptif.
• Point de Terminaison de l'API : L'URL complète de votre récepteur de 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 requête webhook à votre point de terminaison.
Options disponibles :

• 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 s'attend à recevoir les données.

• Type d'Authentification : Choisissez la méthode d'authentification utilisée par votre point de terminaison.

• Lorsque Authentification Basique est sélectionnée, deux champs apparaissent : Login (nom d'utilisateur) et Mot de Passe. Entrez-les tels quels — Drimify construit automatiquement l'en-tête Authorization: Basic pour vous. Vous n'avez pas besoin d'encoder quoi que ce soit vous-même.
• Lorsque En-tête Personnalisé est sélectionné, un champ supplémentaire Nom de l'En-tête Personnalisé apparaît où vous pouvez entrer le nom de l'en-tête de la clé.
• Clé API : La valeur secrète envoyée utilisant la méthode d'authentification sélectionnée.
• Vérifier la Connexion : Cliquez sur ce bouton pour tester si Drimify peut atteindre avec succès votre point de terminaison en utilisant les identifiants fournis avant de sauvegarder.

Récupération du jeton d'un point de terminaison d'authentification (pré-appel)

Certaines API nécessitent que vous vous authentifiiez d'abord : vous appelez un point de terminaison d'authentification avec vos identifiants, recevez un jeton, et utilisez ce jeton lors de l'appel webhook réel. Drimify prend en charge cela automatiquement.

Lorsque le type d'authentification est Clé API, Jeton Bearer ou En-tête Personnalisé, une case à cocher "Récupérer ce jeton d'un point de terminaison d'authentification" apparaît. Une fois cochée, le champ de l'identifiant statique est remplacé par les paramètres pré-appel ci-dessous (pour l'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 placé selon votre type d'authentification :

• Jeton Bearer → Authorization: Bearer <token>
• clé API → X-API-KEY: <token>
• En-tête Personnalisé → <votre nom d'en-tête>: <token>

Choisir l'une des trois méthodes

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

• Champs : Token URL, Client ID, Client Secret, Scope (facultatif)
• Drimify envoie une requête OAuth2 client_credentials standard et lit le jeton à partir de access_token. La durée de vie du jeton est déterminée par le expires_in du serveur.

Login JSON — pour les points d'accès de connexion qui acceptent un corps JSON et retournent un jeton.

• Champs : Auth URL, Body (liste clé/valeur), Token path
• Drimify envoie une requête POST avec un corps JSON construit à partir de vos paires clé/valeur (par exemple, les lignes email = a@b.com et password = secret produisent {"email":"a@b.com","password":"secret"}).
• Token path indique à Drimify l'emplacement du jeton dans la réponse JSON, en utilisant la notation par points — par exemple data.access_token, ou simplement token si c'est au premier niveau.

Personnalisée — pour tout ce qui ne correspond pas aux deux méthodes ci-dessus.

• Champs : Auth URL, Méthode HTTP (POST ou GET), Headers (liste clé/valeur), Body (liste clé/valeur), Encodage du Body (JSON ou form-urlencoded), Token path
• Avec la méthode GET, il n'y a pas de corps de requête — passez les paramètres via les Headers ou l'Auth URL.
• Si vous ajoutez un en-tête Content-Type vous-même, il prend le pas sur celui impliqué par l'encodage du corps.

Listes clé/valeur (Body et Headers)

Chaque ligne a une clé, une valeur, et une case à cocher "sensible" (cochée par défaut). Les lignes peuvent être ajoutées et supprimées, mais pas modifiées sur place — pour modifier une ligne, supprimez-la et ajoutez-la à nouveau. Le drapeau sensible ne peut être défini que lorsque vous ajoutez une ligne. Les valeurs sensibles sont masquées après enregistrement et ne sont jamais exposées à nouveau, ni dans le formulaire ni dans les journaux.

Mise en cache des jetons et réessais

• Les jetons OAuth2 sont mis en cache pour la durée indiquée par expires_in.
• Pour les méthodes Login JSON et Personnalisée, définissez la validité du jeton (minutes) — par défaut, elle est de 60 minutes si laissé vide.
• Les jetons en cache sont conservés pendant un maximum de 7 jours.
• Si votre point d'accès retourne un 401 alors qu'un jeton en cache est utilisé, Drimify rejette le jeton, se ré-authentifie, et réessaie l'appel une fois.
• Si l'appel préalable échoue (erreur, délai d'attente, ou aucun jeton trouvé à l'emplacement Token path), le webhook n'est pas envoyé sans authentification — la livraison échoue, est enregistrée, et est réessayée par la file d'attente de livraison comme d'habitude.

Vérifier la Connexion avec un appel préalable

Le bouton Vérifier la Connexion prend entièrement en charge l'appel préalable : il s'authentifie d'abord contre votre point d'accès d'authentification, puis exécute 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 votre Jeton d'Accès App Privée HubSpot. HubSpot a abandonné les clés API anciennes en 2022, vous devez donc utiliser un jeton App Privée généré depuis votre compte HubSpot sous : Réglages → Intégrations → Apps Privées
• Vérifier la Connexion : Teste le jeton contre l'API HubSpot avant de l'enregistrer.

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 : Obtenus à partir d'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 id Externe : Le nom API du champ utilisé pour faire correspondre (upsert) les enregistrements — généralement quelque chose comme Email_External_Id__c ou un champ id externe personnalisé sur l'objet Contact ou Lead. Ce champ doit être marqué comme un ID Externe dans Salesforce.
• Source de l'ID Externe : Un menu déroulant vous permettant de sélectionner quel champ de données Drimify doit être utilisé comme clé de correspondance (par exemple : Email).
• Vérifier la Connexion : Teste la connexion OAuth Salesforce avant de l'enregistrer.

⚠️ Champs Requis Salesforce

Salesforce impose des champs au niveau des objets requis. Si vous êtes en train d'upserter des Prospects, Salesforce exige au minimum :

• lastName — requis pour la création de Lead

Si vous êtes en train d'upserter des Contacts, Salesforce exige :

• lastName — requis pour la création de Contact

Bien que l'Email ne soit pas requis par le schéma par défaut de Salesforce, il est presque toujours nécessaire en tant qu'ID externe pour correctement apparier et dédupliquer les enregistrements lors des upserts. Sans un appariement fiable de l'ID externe, Salesforce peut créer des doublons ou retourner une erreur.

Meilleure Pratique

Toujours mapper au moins :

• Nom
• Email

lors de la connexion à Salesforce. Omettre le Nom entraînera l'échec du webhook et l'enregistrement ne sera ni créé ni mis à jour.

Mappage des Champs

Disponible pour les trois types d'intégration, Map Fields vous permet de spécifier exactement quels champs de données Drimify sont envoyés à votre intégration, et sous quels noms de clé.
Cliquez sur + Ajouter Field 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 (défini par vous pour répondre à vos besoins d'intégration)
• → Champ Source (liste déroulante à droite) — la valeur source pour ce champ. Vous pouvez soit :
• • Sélectionner un champ de données Drimify (par exemple, Référence De L’app, Email, Score) pour envoyer une valeur dynamique collectée du participant
  • Sélectionner Valeur statique pour envoyer une valeur fixe, codée en dur à chaque fois que le webhook est déclenché — une entrée de texte supplémentaire apparaîtra où vous pourrez entrer la valeur (par exemple, My_Value). Utile pour passer des constantes telles que le nom d'un événement, un identifiant de source, ou un tag d'environnement.

Champs Sources Drimify Disponibles

Vous pouvez ajouter autant de mappages que nécessaire.
Pour supprimer un mappage, cliquez sur l'icône de corbeille à droite de la ligne.

Disponible dans les Espaces de Travail

Au bas du formulaire d'intégration, la section Available in Workspaces vous permet d'utiliser le basculement à côté de chaque espace de travail pour contrôler quel espace de travail peut utiliser l'intégration.
Cliquez sur Select All pour activer l'intégration pour tous les espaces de travail en une fois.

Sauvegarder et Gérer les Intégrations

Une fois que tous les champs sont renseignés, cliquez sur Save Changes pour créer l'intégration. L'intégration apparaîtra alors dans la liste principale des Intégrations. Vous pouvez modifier ou supprimer des intégrations existantes de cette liste à tout moment. Cliquez sur Cancel pour annuler les modifications non enregistrées.

Intégrations de Messagerie

Les intégrations de messagerie vous permettent d'envoyer des emails transactionnels (par exemple, confirmations, résultats ou suivis) directement depuis vos expériences Drimify en utilisant votre fournisseur d'email préféré.

Ajouter une Intégration Messagerie

1. Allez à Intégrations → Intégrations Messagerie
2. Cliquez sur Ajouter une Intégration Messagerie
3. Sélectionnez votre fournisseur :

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

Configurer votre Intégration Messagerie

Paramètres Généraux

Tous les fournisseurs partagent les paramètres généraux suivants :

• Nom de l'Intégration – Nom interne pour identifier votre intégration
• Nom de l'Expéditeur – Nom affiché comme expéditeur de l'e-mail
• Email de l'Expéditeur – Adresse e-mail utilisée pour envoyer les e-mails (non applicable pour Drimify — voir ci-dessous)
• Email CCI (facultatif) – Ajouter une adresse e-mail pour recevoir une copie de tous les e-mails sortants

Authentification

Chaque fournisseur requiert des identifiants spécifiques. Consultez la section de configuration spécifique au fournisseur ci-dessous pour plus de détails.

Tester Votre Connexion

Après avoir saisi vos identifiants, cliquez sur Envoyer un E-mail de Test pour vérifier si votre intégration fonctionne correctement. Une confirmation "E-mail de test envoyé avec succès" apparaîtra si la connexion est valide.

Champs De Paramètres Du Modèle

Associez les champs de données Drimify aux variables de modèle de votre fournisseur d'e-mails. 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 – Le nom de la variable attendue dans votre modèle d'e-mail
• Champ – Les données Drimify correspondantes (e.g. Prénom, Email, Score, etc.)

Cliquez sur Ajouter un Champ pour créer des mappages supplémentaires.

Disponible dans les Espaces de Travail

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

Configuration Spécifique au Fournisseur

Amazon SES

Ce dont vous avez besoin :

• Un utilisateur AWS IAM avec les autorisations ses:SendEmail
• Clé d'accès API et Clé privée API (issues d'AWS IAM)
• Votre région AWS (par exemple eu-west-1, us-east-1)
• Jeton de session (uniquement si vous utilisez des identifiants temporaires/STS)
• Une adresse e-mail ou domaine de l'expéditeur vérifié dans Amazon SES

Étapes :

1. Dans AWS IAM, créez un utilisateur avec les autorisations d'envoi SES et générez une paire de clés d'accès
2. Dans Drimify, saisissez votre Clé d'Accès API, Clé Privée API, et Région
3. Si vous utilisez des identifiants temporaires, saisissez également le Jeton de Session
4. Assurez-vous que votre adresse e-mail ou domaine de l'expéditeur est vérifié dans Amazon SES
5. Cliquez sur Envoyer un Email de Test pour valider la connexion
6. Sauvegardez votre intégration

Brevo

Ce dont vous avez besoin :

• Une clé api Brevo

Étapes :

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

Drimify

Aucune authentification requise. Les e-mails sont envoyés via l'infrastructure interne de mail de Drimify (notification@digitaservice.com).
Ce dont vous avez besoin :

• Un nom d’expéditeur
• Une adresse e-mail de réponse (par exemple contact@votreentreprise.com)
• Facultativement, une adresse e-mail en BCC

Étapes :

1. Sélectionnez Drimify comme votre fournisseur
2. Entrez votre Nom d'Expéditeur et E-mail de Réponse
3. Ajoutez éventuellement une E-mail BCC
4. Sélectionnez l'espace de travail qui doit utiliser cette intégration et sauvegardez

Mailgun

Ce dont vous avez besoin :

• 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 domaine d'envoi
2. Dans Drimify, saisissez votre Clé API, Domaine API, et Région API
3. Cliquez sur Envoyer un Email de Test pour valider la connexion
4. Sauvegardez votre intégration

Mailjet

Ce dont vous avez besoin :

• Une Clé d'Accès API et Clé Privée API Mailjet

Étapes :

1. Dans votre compte Mailjet, allez à Paramètres du Compte → REST API → Gestion des clés api
2. Copiez votre Clé d'Accès API et Clé Privée API
3. Entrez-les dans Drimify
4. Cliquez sur Envoyer un Email de Test pour valider la connexion
5. Sauvegardez votre intégration

Mandrill

Ce dont vous avez besoin :

• Une clé api Mandrill (Mandrill est un add-on d'emails transactionnels de Mailchimp)

Étapes :

1. Dans votre compte Mandrill, allez à Paramètres → Clés API et générez une clé
2. Collez la Clé API dans Drimify
3. Cliquez sur Envoyer un Email de Test pour valider la connexion
4. Sauvegardez votre intégration

SendGrid

Ce dont vous avez besoin :

• Une clé api SendGrid avec des autorisations d'envoi de Mail

Étapes :

1. Dans votre compte SendGrid, allez à Paramètres → Clés API et créez une clé avec les autorisations Mail Send
2. Collez la Clé API dans Drimify
3. Cliquez sur Envoyer un Email de Test pour valider la connexion
4. Sauvegardez votre intégration

Tipimail

Ce dont vous avez besoin :

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

Étapes :

1. Dans votre compte Tipimail, allez à Paramètres → SMTP & APIs et récupérez votre Utilisateur API et Clé API
2. Entrez-les dans Drimify
3. Cliquez sur Envoyer un Email de Test pour valider la connexion
4. Sauvegardez votre intégration

SMTP Personnalisé

Ce dont vous avez besoin :

• Le nom d'hôte de votre serveur SMTP
• Port SMTP (généralement 587 pour TLS, 465 pour SSL)
• Identifiant SMTP (généralement votre adresse e-mail)
• Mot de passe SMTP

Étapes :

1. Récupérez vos identifiants SMTP auprès de votre fournisseur d'hébergement d'e-mail ou de la configuration du serveur
2. Dans Drimify, entrez votre Hôte, Port, Identifiant, et Mot de Passe
3. Cliquez sur Envoyer un Email de Test pour valider la connexion
4. Sauvegardez votre intégration

Mis à jour le : 03/10/2026