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.
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.
4. Cliquez sur Enregistrer.
5. Dans l'onglet Recevoir des données, cliquez sur Créer un nouvel événement de réception.
É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.
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.
10. Cliquez sur Copier l'URL pour récupérer l'adresse de l'endpoint dans le presse-papiers.
É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.
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".
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.
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.
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 :
- Intégration personnalisée pour envoyer des données, pour envoyer des données depuis Connectif vers des systèmes ou applications externes.
- Détecter et réagir aux liens web créés en dehors de Connectif, pour identifier et réagir aux clics sur tout lien de votre site web.
-
Intégration avec Facebook et Instagram, pour gérer les audiences de votre compte Facebook Ads avec Connectif.
-
Formulaires intégrés, pour détecter et capturer dans Connectif les formulaires déjà existants sur votre site.