Eturnitys offene API- und Webhook-Lösungen
Bei Eturnity bieten wir eine offene API für alle unsere Produkte und ermöglichen damit eine reibungslose Integration Ihrer Systeme mit unseren Solarlösungen. Wir unterstützen bidirektionalen Datenaustausch:
Ausgehende Daten (Webhooks): Wir senden automatisch umfassende Projektdaten an Ihre Systeme, wenn bestimmte Ereignisse auftreten
Eingehende Daten (API): Ihre Systeme können Daten an Eturnity senden und Projekte, Komponenten und Kunden programmgesteuert verwalten
Dies ermöglicht eine vollständige Automatisierung der Arbeitsabläufe und eliminiert manuelle Dateneingaben zwischen Systemen.
Unser Webhook-System liefert vollständige Projektinformationen einschließlich:
Kundendetails - Kundeninformationen und Kontaktdaten
PV-Anlagendaten - Anlagengröße, technische Spezifikationen und Leistungskennzahlen
Kosteninformationen - Preisdetails, Wirtschaftlichkeitsberechnungen und Finanzanalysen
Projektspezifikationen - Komponentenlisten, Installationsdetails und Systemkonfigurationen
Zusätzliche Elemente - Dokumente, Angebote und Projektmeilensteine
Webhooks - Ausgehende Daten von Eturnity
Webhooks senden automatisch Daten von Eturnity an Ihre Systeme, wenn bestimmte Ereignisse auftreten. Diese sind Auslöser, die aktiviert werden, wenn bestimmte Aktionen in Eturnity stattfinden und ermöglichen Echtzeit-Benachrichtigungen und Datensynchronisierung.
Webhook-Technische Dokumentation und Beispiel-Payloads
Für detaillierte technische Informationen, einschließlich Beispiel-Payloads, die alle Datenelemente zeigen, die wir bereitstellen können, besuchen Sie bitte unsere umfassende Webhook-Dokumentation:
Tipp: Nach dem Öffnen des Links verwenden Sie die Navigation auf der linken Seite, um auf die Dokumentation für Ihr spezifisches Eturnity-Produkt zuzugreifen und die neueste Webhook-Version zu finden.
Diese Dokumentation umfasst:
Vollständige Beispiel-Payloads, die alle verfügbaren Datenfelder zeigen
Datenstruktur-Spezifikationen für Kundendetails, PV-Anlagendaten und Kosten
Authentifizierungsanforderungen und Sicherheitsprotokolle
Integrationsbeispiele und bewährte Praktiken
Datenauslöser nach Eturnity-Produkt
Je nach dem von Ihnen verwendeten Eturnity-Produkt können Datenauslöser variieren:
Eturnity Expert
In Eturnity Expert werden Webhooks ausgelöst, wenn die folgenden Ereignisse auftreten:
Neue Projekterstellung – Wenn ein neues Projekt erstellt wird
Projektstatus- oder Marker-Updates – Wenn sich der Status eines Projekts ändert oder benutzerdefinierte Meilenstein-Marker aktualisiert werden
Änderungen der Projektleiter-Zuweisung – Wenn der zugewiesene Projektleiter geändert wird
Dokumentenerstellung – Wenn Dokumente erstellt werden
Abschluss der Dokumentenunterzeichnung – Wenn ein Dokument als unterzeichnet markiert wird
Eturnity-Rechner
Für Solarrechner, Konfigurator und Heizungsrechner werden Webhooks ausgelöst, wenn:
Solar-Berechnungsformular gesendet – Wenn ein Benutzer eine Solar-Berechnungsanfrage abschließt und sendet
Konfigurator-Formular gesendet – Wenn ein Benutzer eine Systemkonfigurationsanfrage abschließt und sendet
Heizungs-Berechnungsformular gesendet – Wenn ein Benutzer eine Heizungsberechnungsanfrage abschließt und sendet
Webhook-Integrationsoptionen
Wir bieten zwei Hauptansätze, um Webhook-Daten von Eturnity zu erhalten:
Option 1: Direkte Integration
Für die direkte Integration stellen Sie Ihre eigene technische Infrastruktur bereit, um unsere Webhook-Daten zu empfangen:
Benutzerdefinierte Endpunkt-Einrichtung - Sie stellen die Endpunkt-URL bereit, an die wir die Payload senden
Datenverarbeitung - Die Verwaltung und Verarbeitung der Daten auf Ihrer Infrastruktur liegt in Ihrer Verantwortung
Flexible Auslöser - Sie legen fest, welche Ereignisse Webhook-Benachrichtigungen auslösen sollen
Vollständige Kontrolle - Komplette Anpassung der Datenverarbeitung und -bearbeitung
Wichtig: Wir stellen den Code entsprechend der Payload bereit. Die Verwaltung und Verarbeitung der Daten auf Ihrer Infrastruktur liegt in Ihrer Verantwortung.
Option 2: Integration über Zapier
Zapier ist eine No-Code-Automatisierungsplattform, die als Brücke zwischen Eturnity und Tausenden von anderen Geschäftsanwendungen fungiert. Anstatt benutzerdefinierte technische Endpunkte zu erstellen, bietet Zapier eine benutzerfreundliche Oberfläche zum Verbinden von Systemen und Automatisieren von Arbeitsabläufen.
Warum Zapier-Integration wählen:
Keine Programmierung erforderlich - Richten Sie Integrationen über eine visuelle Oberfläche ohne Codierung ein
Keine Infrastruktur erforderlich - Zapier übernimmt die gesamte technische Endpunkt-Verwaltung für Sie
Vorgefertigte Verbindungen - Vorgefertigte Integrationen zu beliebten CRM-, E-Mail-Marketing- und Geschäftstools
Visueller Workflow-Builder - Drag-and-Drop-Oberfläche zur Erstellung von Automatisierungsregeln
Sofortige Aktivierung - Beginnen Sie in Minuten statt Wochen der Entwicklung
Was Zapier für Sie tut:
Anstatt dass Ihr IT-Team benutzerdefinierte Webhook-Empfänger erstellt, führt Zapier folgende Aufgaben aus:
Empfängt Webhook-Daten von Eturnity automatisch
Verarbeitet und formatiert die Daten nach Ihren Regeln
Sendet die Daten an Ihre gewählten Anwendungen (CRM, E-Mail-Tools, Tabellenkalkulationen usw.)
Verwaltet alle technischen Aspekte wie Authentifizierung, Fehlerbehandlung und Wiederholungen
Eine vollständige Liste der unterstützten Anwendungen finden Sie hier: Zapier Apps & Integrationen
API - Verwaltung von Eturnity-Daten aus externen Systemen
Zusätzlich zum Empfangen von Daten von Eturnity über Webhooks können Sie auch Daten an Eturnity senden und Projekte extern verwalten mit unserer umfassenden API.
Die Eturnity-API ermöglicht eine nahtlose Verwaltung Ihrer Projekte, Komponenten und anderen Ressourcen innerhalb des Eturnity-Ökosystems unter Verwendung von Standard-HTTP-Anfragen.
API-Dokumentation und Zugang
Um verschiedene API-Versionen zu erkunden, verwenden Sie das Dropdown-Menü in der Navigation oben in unserer API-Dokumentation.
Die API ist jetzt über unsere neue Backend-URL zugänglich: https://api.eturnity.io/doc/
Was Sie mit der API tun können
Projekte erstellen und aktualisieren - Programmgesteuerte Verwaltung von Projektdaten aus Ihren Systemen
Komponenten verwalten - Vorhandene Komponenteninformationen aktualisieren (Hinzufügen oder Löschen von Komponenten ist nicht möglich)
Kundenverwaltung - Kundendaten zwischen Systemen synchronisieren
Bidirektionale Integration - API-Aufrufe mit Webhook-Benachrichtigungen für vollständige Synchronisierung kombinieren
Nächste Schritte zum Einstieg
Add-on-Funktion: API- und Webhook-Integrationen sind als separates Add-on verfügbar, das gekauft werden muss. Wenden Sie sich an unser Customer Success Team oder senden Sie eine E-Mail an support@eturnity.com für Preise und Aktivierung.
Für Webhook-Einrichtung (Datenempfang von Eturnity)
Um mit dem Empfang von Webhook-Daten von Eturnity zu beginnen, benötigen wir von Ihnen folgende Angaben:
Für direkte Webhook-Integration
Endpunkt-URL - Die URL, an die Sie Webhook-Daten empfangen möchten
Gewünschte Auslöser - Legen Sie fest, welche Ereignisse die Datenübertragung auslösen sollen (Projekterstellung, PDF-Generierung usw.)
Authentifizierungseinstellungen (optional) - Wie Sie die Webhook-Verbindung sichern möchten
Für Zapier-Webhook-Integration
Teilen Sie uns einfach mit, dass Sie die Zapier-Integration nutzen möchten:
Einladungsprozess - Wir senden Ihnen eine Einladung, unserer App auf Zapier beizutreten
Keine Endpunkt-Einrichtung erforderlich - Zapier übernimmt die technische Verbindung automatisch
Auslöser direkt verwalten - Konfigurieren Sie Auslöser in Ihrem Zapier-Konto-Interface
Schnelle Aktivierung - Beginnen Sie innerhalb von Minuten nach der Einrichtung mit dem Datenempfang
Für API-Zugang (Daten an Eturnity senden)
Um mit der Verwaltung von Eturnity-Daten aus Ihren externen Systemen zu beginnen:
API-Zugangsdaten anfordern - Wenden Sie sich an den Support, um API-Zugang und Authentifizierungsdaten zu erhalten
API verwenden - Sobald Sie die Zugangsdaten erhalten haben, können Sie sich direkt von Ihren Systemen aus mit der Eturnity-API verbinden. Von diesem Punkt an können alle Integrationen, Konfigurationen und der Datenaustausch auf Ihrer Seite verwendet werden
Testumgebung - Richten Sie eine Entwicklungsumgebung für sicheres API-Testen ein
Support und Unterstützung
Wenn Sie Fragen zu unseren API- und Webhook-Integrationen haben, technischen Support benötigen oder Preise besprechen möchten, helfen wir Ihnen gerne:
Kontaktoptionen
Customer Success Team - Wenden Sie sich an Ihren dedizierten Customer Success-Vertreter für Preisinformationen und Add-on-Aktivierung
E-Mail-Support:support@eturnity.com - Für technische Fragen, Integrations-Support und allgemeine Anfragen
Benutzerdefinierte Integrationsanfragen
Wenn Sie spezifische Integrationsbedürfnisse haben, die von unseren Standardoptionen nicht abgedeckt werden, wenden Sie sich bitte an unser Support-Team. Wir sind immer daran interessiert, neue Integrationsmöglichkeiten zu erkunden und können möglicherweise benutzerdefinierte Lösungen basierend auf der Nachfrage entwickeln.
Bereit, Ihre Integration zu starten? Wenden Sie sich an unser Customer Success Team oder senden Sie eine E-Mail an support@eturnity.com, um Ihre Anforderungen zu besprechen, Preisinformationen zu erhalten und Ihr API- und Webhook-Add-on zu aktivieren. Wir führen Sie durch den gesamten Einrichtungsprozess, um eine reibungslose Integration mit Ihren Unternehmenssystemen zu gewährleisten.