Introduction
Les API et webhooks d’idloom sont des outils essentiels pour automatiser les processus et intégrer des systèmes externes. Grâce aux API, les utilisateurs peuvent synchroniser les données entre idloom et d’autres logiciels, simplifiant ainsi la gestion des événements. De leur côté, les webhooks déclenchent des actions en temps réel, assurant des notifications automatiques selon les événements déclenchés sur la plateforme.
Ces fonctionnalités s’adressent aux organisateurs d’événements, développeurs et administrateurs IT, permettant une personnalisation accrue et une gestion plus fluide des opérations.
Mise en route
Chez idloom, nous défendons fermement la propriété des données, et celles que vous collectez vous appartiennent entièrement. C’est pourquoi nos modules d’intégration sont disponibles dès la version light, vous permettant d’intégrer facilement idloom à votre écosystème logiciel, que vous soyez un utilisateur fréquent ou occasionnel.
Accédez à la section intégration de l’application Events et commencez une nouvelle intégration. Vous pouvez choisir parmi des intégrations natives prédéfinies ou en créer une personnalisée, que nous aborderons plus en détail ci-dessous.
Intégration Personnalisée
L’intégration se compose de quatre éléments principaux :
- Paramètres de base : Nommez l’intégration, associez-la à un ou plusieurs profils, et définissez si elle acceptera des appels API, et si oui, la clé API qui sera nécessaire.
- Configuration automatique : Créez une structure fixe pour vos formulaires d’inscription afin de garantir l’envoi de données structurées vers l’application externe.
- Mappage des champs : Personnalisez la structure des données envoyées pour assurer la compatibilité avec l’application externe.
- Webhooks : Activez et configurez les webhooks pour transmettre des données en temps réel en les associant à des événements déclenchés sur idloom.
Activer l’Accès aux Données des Profils
Avec l’intégration que vous configurez, vous pouvez accéder aux informations d’événements et d’inscriptions via les API ou déclencher des webhooks. Pour cela, connectez le profil concerné à l’intégration et activez l’accès API.
Pour assurer une meilleure sécurité des données :
- Créez des intégrations distinctes pour chaque profil.
- N’activez l’accès API que lorsque c’est nécessaire.
- Générez une nouvelle clé API lors de la transition vers la production, et renouvelez-la régulièrement (tous les 6 à 12 mois).
Créer et Gérer des Webhooks
Commencez par ajouter un webhook et sélectionnez le déclencheur que vous souhaitez activer pour celui-ci :
-
event.create, event.update, event.delete, event.manual: Ces déclencheurs envoient une charge utile REST de type event à votre point de terminaison, au format de la méthode API Get Events. Le déclencheur "manual" ajoute également une nouvelle option dans les actions liées aux événements, accessible via le menu contextuel de la liste ou le menu “Plus d’actions” dans l’écran des détails de l’événement.
-
guest.create, guest.update, guest.delete, guest.manual : Ces déclencheurs envoient une charge utile REST de participant à votre point de terminaison, utilisant le même format que la méthode API Get Attendees. Le déclencheur manuel ajoute également une nouvelle option dans les actions liées aux participants, accessible via le menu contextuel de la liste ou dans le menu “Plus d’actions” sur l’écran des détails du participant.
Ensuite, vous pouvez spécifier le nom du webhook, l’URL où envoyer la charge utile, et la méthode HTTP à utiliser (GET, POST, PUT, DELETE, PATCH). Si vous avez sélectionné un déclencheur manuel, le nom du webhook deviendra l’étiquette de la nouvelle fonction dans le menu.
Vous pouvez également configurer les en-têtes de requête, comme les Bearer Tokens ou d’autres paramètres de sécurité.
Pour limiter le webhook à des événements spécifiques, entrez simplement leurs valeurs UID, séparées par des virgules, disponibles dans la section Geek > Analytics & Tracking des paramètres de votre événement.
Activer les Webhooks des Intégration dans vos Profils
Vous y êtes presque. Si l’intégration liée aux profils permet d’accéder automatiquement à toutes les données via des appels API, cela ne s’applique pas aux webhooks.
Pour activer les webhooks pour une intégration spécifique, accédez à Profils, sélectionnez en un (corporate), puis rendez-vous dans Geek > Intégrations. Activez ensuite l’intégration souhaitée. Notez qu’une seule intégration ne peut être active par profil.
Remplacer l’Intégration Par Défaut du Profil pour un Événement Spécifique
Bonne nouvelle : peu importe les webhooks activés pour un profil, vous pouvez les remplacer pour un événement spécifique. Il suffit d’aller dans la section Geek > Intégrations des paramètres de l’événement, de choisir l’intégration à appliquer, d’ajuster ou de remplacer les mappings de champs si nécessaire, et même d’opter pour déclencher des webhooks uniquement lorsque l’inscription est payée.
Besoin de plus de personnalisation ?
Si vous avez besoin de traitements supplémentaires ou de validations avant l’envoi de la charge utile, ou d’une sécurité renforcée via SSL mutuel (two-way SSL), contactez votre gestionnaire de compte, qui transmettra votre demande à notre équipe technique.
Nous nous engageons à fournir la meilleure documentation possible, même pour les contenus techniques. Si vous avez des questions ou des suggestions, n’hésitez pas à nous contacter. Vos retours nous aideront à améliorer ce guide utilisateur ainsi que la section FAQ.
Profitez de cette fonctionnalité !
L'équipe idloom