Solutions API Ouvertes et Webhook d'Eturnity
Chez Eturnity, nous fournissons une API ouverte pour tous nos produits, offrant une intégration fluide de vos systèmes avec nos solutions solaires. Nous supportons l'échange de données bidirectionnel :
Données sortantes (Webhooks) : Nous envoyons automatiquement des données complètes de projet à vos systèmes lorsque des événements spécifiques se produisent
Données entrantes (API) : Vos systèmes peuvent transmettre des données à Eturnity et gérer automatiquement les projets, composants et clients via l’API
Cela permet une automatisation complète des flux de travail et élimine la saisie manuelle des données entre systèmes.
Notre système webhook fournit des informations complètes de projet incluant :
Détails du client - Informations client et données de contact
Données du système photovoltaïque - Taille du système, spécifications techniques et métriques de performance
Informations sur les coûts - Détails des prix, calculs de rentabilité et analyse financière
Spécifications du projet - Listes de composants, détails d'installation et configurations système
Éléments supplémentaires - Documents, propositions et jalons de projet
Webhooks - Données Sortantes d'Eturnity
Les webhooks envoient automatiquement des données d'Eturnity vers vos systèmes lorsque des événements spécifiques se produisent. Ce sont des déclencheurs qui s'activent lorsque certaines actions se produisent dans Eturnity, permettant des notifications en temps réel et la synchronisation des données.
Documentation Technique Webhook et Exemples de Payload
Pour des informations techniques détaillées, incluant des exemples de payload qui montrent tous les éléments de données que nous pouvons fournir, veuillez visiter notre documentation webhook complète :
Conseil : Après avoir ouvert le lien, utilisez la navigation sur le côté gauche pour accéder à la documentation de votre produit Eturnity spécifique et pour trouver la dernière version webhook.
Cette documentation inclut :
Exemples complets de payload montrant tous les champs de données disponibles
Spécifications de structure de données pour les détails client, données système photovoltaïque et coûts
Exigences d'authentification et protocoles de sécurité
Exemples d'intégration et meilleures pratiques
Déclencheurs de Données par Produit Eturnity
Selon le produit Eturnity que vous utilisez, les déclencheurs de données peuvent varier :
L'Expert d'Eturnity
Dans l'Expert d'Eturnity, les webhooks sont déclenchés lorsque les événements suivants se produisent :
Création de nouveau projet – Lorsqu'un nouveau projet est créé
Mises à jour du statut ou marqueur de projet – Lorsque le statut d'un projet change ou que les marqueurs de jalons personnalisés sont mis à jour
Changements d'affectation de chef de projet – Lorsque le chef de projet assigné est changé
Création de document – Lorsque des documents sont créés
Achèvement de signature de document – Lorsqu'un document est marqué comme signé
Calculateurs Eturnity
Pour le Calculateur Solaire, Configurateur et Calculateur Chauffage, les webhooks sont déclenchés quand :
Soumission du formulaire de calcul solaire – Lorsqu'un utilisateur complète et soumet une demande de calcul solaire
Soumission du formulaire configurateur – Lorsqu'un utilisateur complète et soumet une demande de configuration système
Soumission du formulaire de calcul chauffage – Lorsqu'un utilisateur complète et soumet une demande de calcul chauffage
Options d'Intégration Webhook
Nous offrons deux approches principales pour recevoir des données webhook d'Eturnity :
Option 1 : Intégration Directe
Pour l'intégration directe, vous fournissez votre propre infrastructure technique pour recevoir nos données webhook :
Configuration d'endpoint personnalisé - Vous fournissez l'URL d'endpoint où nous envoyons le payload
Traitement des données - La gestion et le traitement des données sur votre infrastructure sont de votre responsabilité
Déclencheurs flexibles - Vous spécifiez quels événements devraient déclencher les notifications webhook
Contrôle complet - Personnalisation complète de la façon dont les données sont gérées et traitées
Important : Nous fournissons le code correspondant au payload. La gestion et le traitement des données sur votre infrastructure sont de votre responsabilité.
Option 2 : Intégration via Zapier
Zapier est une plateforme d'automatisation sans code qui agit comme un pont entre Eturnity et des milliers d'autres applications d'entreprise. Au lieu de construire des endpoints techniques personnalisés, Zapier fournit une interface conviviale pour connecter les systèmes et automatiser les flux de travail.
Pourquoi Choisir l'Intégration Zapier :
Aucune programmation requise - Configurez les intégrations via une interface visuelle sans codage
Aucune infrastructure nécessaire - Zapier gère toute la gestion technique des endpoints pour vous
Connexions prêtes à l'emploi - Intégrations pré-construites avec des CRM populaires, outils de marketing par email et outils d'entreprise
Constructeur de flux de travail visuel - Interface glisser-déposer pour créer des règles d'automatisation
Activation instantanée - Commencez en quelques minutes au lieu de semaines de développement
Ce que Zapier Fait pour Vous :
Au lieu que votre équipe IT construise des récepteurs webhook personnalisés, Zapier :
Reçoit les données webhook d'Eturnity automatiquement
Traite et formate les données selon vos règles
Envoie les données à vos applications choisies (CRM, outils email, feuilles de calcul, etc.)
Gère tous les aspects techniques comme l'authentification, la gestion des erreurs et les nouvelles tentatives
Vous pouvez trouver une liste complète des applications supportées ici : Applications & Intégrations Zapier
API - Gestion des Données Eturnity depuis les Systèmes Externes
En plus de recevoir des données d'Eturnity via les webhooks, vous pouvez aussi envoyer des données à Eturnity et gérer les projets extérieurement en utilisant notre API complète.
L'API Eturnity permet une gestion transparente de vos projets, composants et autres ressources dans l'écosystème Eturnity en utilisant des requêtes HTTP standard.
Documentation API et Accès
Pour explorer différentes versions API, utilisez le menu déroulant situé dans la navigation en haut de notre documentation API.
L'API est maintenant accessible via notre nouvelle URL backend : https://api.eturnity.io/doc/
Ce que Vous Pouvez Faire avec l'API
Créer et mettre à jour des projets - Gérer programmatiquement les données de projet depuis vos systèmes
Gérer les composants - Mettre à jour les informations de composants existants (ajouter ou supprimer des composants n'est pas possible)
Gestion client - Synchroniser les données client entre systèmes
Intégration bidirectionnelle - Combiner les appels API avec les notifications webhook pour une synchronisation complète
Étapes Suivantes pour Commencer
Fonctionnalité Add-on : Les intégrations API et webhook sont disponibles comme add-on séparé qui doit être acheté. Contactez notre équipe customer success ou envoyez un email à support@eturnity.com pour les prix et l'activation.
Pour la Configuration Webhook (Recevoir des Données d'Eturnity)
Pour commencer à recevoir des données webhook d'Eturnity, nous aurons besoin que vous nous fournissiez :
Pour l'Intégration Webhook Directe
URL d'Endpoint - L'URL où vous voulez recevoir les données webhook
Déclencheurs souhaités - Spécifiez quels événements devraient déclencher la transmission de données (création de projet, génération PDF, etc.)
Préférences d'authentification (optionnel) - Comment vous voulez sécuriser la connexion webhook
Pour l'Intégration Webhook Zapier
Faites-nous simplement savoir que vous souhaitez utiliser l'intégration Zapier :
Processus d'invitation - Nous vous enverrons une invitation pour rejoindre notre app sur Zapier
Aucune configuration d'endpoint nécessaire - Zapier gère la connexion technique automatiquement
Gérer les déclencheurs directement - Configurez les déclencheurs dans l'interface de votre compte Zapier
Activation rapide - Commencez à recevoir des données en quelques minutes après la configuration
Pour l'Accès API (Envoyer des Données à Eturnity)
Pour commencer à gérer les données Eturnity depuis vos systèmes externes :
Demande d'identifiants API - Contactez le support pour obtenir l'accès API et les identifiants d'authentification
Commencer à utiliser l'API - Une fois que vous recevez les identifiants, vous pouvez vous connecter à l'API Eturnity directement depuis vos systèmes. À partir de ce point, toute intégration, configuration et échange de données peut être utilisé de votre côté
Environnement de test - Configurez un environnement de développement pour des tests API sécurisés
Support et Assistance
Si vous avez des questions sur nos intégrations API et webhook, avez besoin de support technique ou voulez discuter des prix, nous sommes là pour vous aider :
Options de Contact
Équipe Customer Success - Contactez votre représentant customer success dédié pour les informations de prix et l'activation d'add-on
Support Email :support@eturnity.com - Pour les questions techniques, le support d'intégration et les demandes générales
Demandes d'Intégration Personnalisées
Si vous avez des besoins d'intégration spécifiques qui ne sont pas couverts par nos options standard, veuillez contacter notre équipe de support. Nous sommes toujours intéressés à explorer de nouvelles possibilités d'intégration et pourrions être capables de développer des solutions personnalisées basées sur la demande.
Prêt à démarrer votre intégration ? Contactez notre équipe customer success ou envoyez un email à support@eturnity.com pour discuter de vos exigences, obtenir des informations de prix et activer votre add-on API et webhook. Nous vous guiderons à travers tout le processus de configuration pour assurer une intégration fluide avec vos systèmes d'entreprise.