Intégration personnalisée pour recevoir des données depuis des systèmes externes

Dans Connectif, il est possible de recevoir des données depuis des systèmes externes pour utiliser des informations qui ne sont pas enregistrées par défaut dans la plateforme. Grâce à une intégration personnalisée, vous pourrez synchroniser les données de vos contacts en fonction des événements générés sur d'autres plateformes.

Dans cet article, vous apprendrez comment créer une intégration personnalisée pour recevoir des données.

  

Temps d'implémentation : 20 minutes.
Difficulté : Moyenne
Quand l'utiliser : Lorsque vous devez recevoir dans Connectif des données générées par des systèmes ou applications externes.

 

ÉTAPE 1 - Création de l'intégration personnalisée

1. Accédez à "Intégrations > Personnalisées" et cliquez sur  Créer une nouvelle intégration.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 1-min.png

 

Si vous travaillez avec un ERP, nous vous recommandons de suivre ces étapes pour synchroniser les données avec votre compte Connectif.

2. Définissez le champ "Nom" pour identifier l'intégration.

3. (Facultatif) Personnalisez la couleur, ajoutez une description ou catégorisez l'intégration.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 2-min (1).png

4. Cliquez sur  Enregistrer.

5. Dans l'onglet Recevoir des données, cliquez sur  Créer un nouvel événement de réception.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 3-min.png

 

ÉTAPE 2 - Configuration de l'événement "Recevoir des données"

(Dans cette section, vous allez configurer les champs où seront stockées les données reçues).

6. Cliquez sur   Ajouter un nouveau champ pour créer un champ personnalisé et remplissez les informations nécessaires dans le bloc de droite.

  

Pour en savoir plus sur les champs personnalisés, cliquez ici.

 

Il est important que le champ email soit de type email et soit marqué comme Obligatoire et Clé primaire, car il sera utilisé pour identifier le contact.

7. Répétez l'action indiquée au point précédent autant de fois que nécessaire pour recevoir les données. 

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 4-min.png

8. Cliquez sur  Enregistrer et, dans l'écran de confirmation, cliquez sur  Retour à la liste des événements.

 

ÉTAPE 3 - Obtention de l'endpoint de notification

(Dans cette section, vous apprendrez comment générer l'adresse pour notifier le type d'événement créé, appelée endpoint).

  

Le fonctionnement de l'endpoint est analogue au concept de webhook : il s'agit d'un système qui attend qu'un événement se produise et réagit en transférant les données vers une autre application ou système, dans ce cas vers Connectif, en utilisant un appel HTTP.

9. Dans l'onglet Recevoir des données, cliquez sur  Éditer.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 6-min.png

10. Cliquez sur  Copier l'URL pour récupérer l'adresse de l'endpoint dans le presse-papiers.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 7-min (2).png

 

ÉTAPE 4 - Envoi des données à Connectif

(Dans cette section, vous apprendrez comment établir la communication avec l'endpoint et envoyer les données).

11. Réalisez l'appel à l'endpoint pour notifier les données de l'événement. La capture suivante est un appel JSON réalisé avec Postman, en suivant l'exemple illustré dans l'article.

 

Découvrez comment notifier des événements personnalisés via JavaScript dans cet article.

Intégration_personnalisée_pour_recevoir_des_données_-_7.png

 

L'appel doit être une requête POST vers l'endpoint sélectionné au format JSON. Dans le corps de la requête, il est nécessaire de spécifier les ID des champs configurés dans l'événement.

 

ÉTAPE 5 - Synchronisation des données avec les informations de contact

(Dans cette section, vous apprendrez comment synchroniser les données dans Connectif via un workflow).

12. Accédez à “Workflows”, cliquez sur  Créer un nouveau workflow et sélectionnez Créer un workflow vierge.

13. Créez la structure de votre workflow avec un nœud de type déclencheur "Déclencheur [nom de votre intégration]" et un nœud de type action "Définir champ".

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 8-min.png

14. Dans le nœud "Déclencheur Recevoir des données de...", cliquez sur  (Modifier la configuration du nœud).

15. Vérifiez que les données collectées par le nœud "Déclencheur Recevoir des données de...", provenant de l'événement dans le système externe, sont correctes.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 9-min.png

  

Si les données ne sont pas correctes, vous pouvez les modifier depuis la configuration de l'événement de réception (ÉTAPE 2).

16. Cliquez sur  Enregistrer.

17. Dans le nœud “Définir champ”, cliquez sur  (Modifier la configuration du nœud).

18. Associez les variables pour affecter les informations collectées par l'intégration personnalisée aux champs de contact correspondants.

Intégration personnalisée pour recevoir des données depuis des systèmes externes (interface 2024) - 10-min.png

  

Pour en savoir plus sur l'affectation des variables dans le nœud "Définir champ", cliquez ici.

19. Cliquez sur  Mettre à jour.

20. Dans le workflow, cliquez sur  Enregistrer pour enregistrer les modifications et sur  Démarrer pour l'activer.

 

Extra : Création d'un Segment Dynamique Plus pour l'intégration

Avec Connectif, vous pouvez créer un Segment Dynamique Plus pour filtrer par les activités et les champs liés à l'intégration personnalisée.

 

Si vous souhaitez apprendre comment créer un Segment Dynamique Plus avec les contacts de votre intégration, consultez cet article.

Une fois que vous avez créé un segment de contacts pour l'intégration personnalisée, celui-ci ne pourra pas être supprimé. De plus, si l'un de ses champs est utilisé comme condition de segmentation, il ne pourra pas être supprimé ni modifié. 

 

 

 Succès !
Votre intégration personnalisée est prête à recevoir des données.


Continuez à apprendre !

Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de continuer avec les articles suivants :