Comment synchroniser les membres d’une organisation entre un logiciel externe et Yapla

La plateforme est ouverte et permet de créer des communications automatiques avec des logiciels externes et Yapla via Internet. Différentes techniques permettent de synchroniser des données entres les deux systèmes.

LES TECHNIQUES DISPONIBLES

API - https://app.swaggerhub.com/apis/membogo
Webhooks - https://support.yapla.com/hc/fr-ca/articles/360033245694-Ajouter-un-webhook
Import Excel - Importation manuelle des données dans Yapla à l’aide d’un assistant.
Export Excel - Exportation des données manuellement pour les réintégrer dans un système externe.

API

L’API de Yapla permet d’accéder à l'ensemble des fonctions Yapla à partir d’un programme externe. La version 2.0 de l’API est compatible RESTful, cette dernière fait appel à des requêtes HTTP pour obtenir, placer, publier et supprimer des données. Cette technique permet d’échanger tout type de données avec tout système externe connecté à Internet via le protocol HTTP. Pour en savoir plus : https://app.swaggerhub.com/apis/membogo

WEBHOOKS

Un webhook est une fonction de rappel HTTP, définies par un utilisateur Yapla, qui récupère les données issues d’une événement. Par exemple, il est possible de configurer un webhook dans Yapla qui fait un appel HTTP à un système externe à chaque fois que la fiche d’un membre est modifiée.

Le serveur appelé, via un URL, reçoit une structure JSON contenant toutes les informations associées à l’événement. Les appels peuvent être sécurisés en cryptant les communications avec un certificat SSL (HTTPS) à partir du serveur appelé.

IMPORT EXCEL

Pour les synchronisations occasionnelles, nous offrons un système d’import manuel qui permet de synchroniser les membres, les organisations et les adhésions.

Cette technique est habituellement utilisée lors de la configuration initiale de la plateforme.

EXPORT EXCEL

En tout temps, il est possible d’exporter l’ensemble des données des membres d’un compte Yapla. Il suffit d’utiliser le bouton Export excel de l’interface Gestion des membres.

COMMENT RECEVOIR DES DONNÉES DE L’EXTÉRIEUR VERS YAPLA

La meilleure façon de synchroniser les membres d’un système existant avec Yapla est d’adopter l’approche suivante. Une première synchronisation manuelle qui reprend tous les membres à un moment précis pour les remonter dans Yapla. Suite à cette première étape, le système externe doit utiliser l’API de Yapla pour envoyer les données d’un membre précis pour chaque création ou mise à jour. Ainsi, Yapla a toujours les dernières données du système externe.

COMMENT ENVOYER DES DONNÉES DE YAPLA VERS L’EXTÉRIEUR

Le principe est le même, la première étape consiste à remonter les membres existants dans le système externe via un export Excel. Suite à cette première étape, il suffit de configurer un webhook dans Yapla qui appellera le système externe lors des deux événements suivants : Création d’un membre et Modification d’un membre.

SYNCHRONISATION BI-DIRECTIONNELLE

Il est possible de maintenir Yapla et un système externe synchroniser en tout temps. Cependant, un mécanisme de protection contre les boucles infinies doit être mis en place. Plus précisément, les modifications de membres envoyés par Yapla ne doivent pas être retourné à Yapla.

Pour toutes questions sur le sujet, communiquer avec support@yapla.com.