Bienvenue sur le guide de configuration de l’intégration de Yapla avec Hector. À la fin de ce guide, vous allez pouvoir synchroniser automatiquement vos membres Yapla avec des utilisateurs Hector.
Configuration
✅ Étape 1 : Connexion à Hector
Pour activer l’intégration avec Yapla, connectez-vous à votre compte administrateur Hector. Seuls les administrateurs peuvent configurer les intégrations.
🔗 Étape 2 : Accéder aux paramètres d’intégration Yapla
- Dans Hector, allez dans Réglages.
- Sous la section Intégrations, trouvez Yapla (dans l’onglet Ressources) et cliquez sur Ajouter.
- Dans les paramètres d’intégration Yapla, trois champs obligatoires doivent être complétés pour établir la connexion entre les deux plateformes. Consultez la section suivante pour savoir où trouver ces informations dans Yapla.
🔐 Étape 3 : Obtenir vos identifiants Yapla
- Dans Yapla, accédez à votre Configuration1.
- Dans le menu API2, vous trouverez :
- URL de connexion → à copier dans le champ Lien de l’Api dans Hector
- Clé API → à copier dans le champ Clé d’Api
Important : Si vous générez une nouvelle clé API dans Yapla, vous devez immédiatement la mettre à jour dans Hector pour maintenir l’intégration.
- Facultatif : Entrez un Identifiant de campagne si vous souhaitez synchroniser les membres d’une campagne spécifique (la valeur par défaut est
0, correspondant à la campagne en cours).
✅ Étape 4 : Valider les paramètres et sauvegarder
Cliquez sur Valider1 dans Hector pour simuler une requête d’exemple vers Yapla. Cela permettra de vérifier que vos identifiants et votre configuration sont valides. Assurez-vous que l’intégration est Activé2, puis cliquez sur Sauvegarder et Intégrer3 pour enregistrer votre configuration et activer l’intégration.
Fonctionnement de l’intégration
🔄 À quoi s’attendre lors de la synchronisation
Une fois la synchronisation activée, Hector commencera à se synchroniser avec Yapla en fonction de vos paramètres d’intégration et de la fréquence de synchronisation définie.
⚠️ Remarque : Il s’agit d’une synchronisation unidirectionnelle de Yapla vers Hector. Hector n’envoie aucune mise à jour vers Yapla.
🕒 Fréquence de synchronisation
Hector se synchronise avec Yapla toutes les 15 minutes. Tout membre ajouté, mis à jour ou désactivé dans Yapla sera automatiquement reflété dans Hector selon les règles définies dans votre intégration.
🔁 Première synchronisation
- Tous les membres de Yapla sont récupérés.
- Les utilisateurs Hector existants avec une adresse courriel correspondante sont mis à jour. Si l’utilisateur correspondant est inactif dans Yapla, il sera également inactivé dans Hector.
- Seulement les membres actifs de Yapla non présents dans Hector sont créés comme nouveaux utilisateurs.
- Si un membre Yapla existe à la fois comme actif et inactif avec la même adresse courriel, seul l’utilisateur actif sera synchronisé.
🧱 Mapping des champs lors de la création de l’utilisateur
Lorsqu’un membre Yapla est créé dans Hector, les champs suivants sont renseignés :
| Champ Yapla | Champ Hector | Notes |
|---|---|---|
| Prénom | Prénom | |
| Nom | Nom | |
| Courriel | Courriel | Utilisé pour correspondre aux utilisateurs existants |
| Téléphone | Téléphone | |
| Langue | Langue | |
| Adresse | Adresse | |
| Code postal | Code postal | |
| Ville | Ville | |
| Province | État | |
| Pays | Pays | |
| Statut | Activé | Par défaut, défini à « Actif » |
| Code unique | Généré automatiquement | |
| Mot de passe | Un mot de passe est généré, mais il n’est pas communiqué. Un réinitialisation est nécessaire pour l’accès. | |
| Rôle | Rôle par défaut défini dans Réglages → Ressources → Utilisateur → Options → Rôle par défaut | |
| Groupes | Groupes par défaut définis dans Réglages → Ressources → Utilisateur → Options → Groupe par défaut | |
| Département | Département par défaut défini dans Réglages → Ressources → Utilisateur → Options → Département par défaut |
🔄 Mapping des champs lors de la mise à jour de l’utilisateur
Lorsqu’un membre Yapla est mis à jour, les modifications sont reflétées dans Hector en mappant les champs suivants :
| Champ Yapla | Champ Hector | Notes |
|---|---|---|
| Prénom | Prénom | Mis à jour si modifié |
| Nom | Nom | Mis à jour si modifié |
| Courriel | Courriel | Mis à jour si modifié |
| Téléphone | Téléphone | Mis à jour si modifié |
| Langue | Langue | Mis à jour si modifié |
| Adresse | Adresse | Mis à jour si modifié |
| Code Postal | Code Postal | Mis à jour si modifié |
| Province | État | Mis à jour si modifié |
| Pays | Pays | Mis à jour si modifié |
| Statut | Activé | Désactive l’utilisateur si le statut n’est plus Actif |
⛔ Gestion des membres inactifs ou supprimés
- Si le statut d’un membre Yapla n’est plus Actif, l’utilisateur correspondant dans Hector sera marqué comme inactif.
- Les membres inactifs de Yapla non présents dans Hector ne seront pas créés.
- Si un membre est supprimé dans Yapla, il cessera de se synchroniser, mais ne sera pas supprimé de Hector.
💡 Astuce : Utilisez les paramètres de rétention des utilisateurs d’Hector pour supprimer automatiquement les utilisateurs inactifs après un certain délai.