Soluzioni API Aperte e Webhook di Eturnity
In Eturnity, forniamo un'API aperta per tutti i nostri prodotti, offrendo un'integrazione fluida dei tuoi sistemi con le nostre soluzioni solari. Supportiamo lo scambio dati bidirezionale:
Dati in uscita (Webhook): Inviamo automaticamente dati completi del progetto ai tuoi sistemi quando si verificano eventi specifici
Dati in entrata (API): I tuoi sistemi possono inviare dati a Eturnity e gestire progetti, componenti e clienti in modo programmato
Questo consente l'automazione completa del flusso di lavoro ed elimina l'inserimento manuale dei dati tra sistemi.
Il nostro sistema webhook fornisce informazioni complete del progetto inclusi:
Dettagli del cliente - Informazioni del cliente e dati di contatto
Dati del sistema fotovoltaico - Dimensioni del sistema, specifiche tecniche e metriche di prestazione
Informazioni sui costi - Dettagli sui prezzi, calcoli di redditività e analisi finanziarie
Specifiche del progetto - Elenchi dei componenti, dettagli di installazione e configurazioni del sistema
Elementi aggiuntivi - Documenti, proposte e milestone del progetto
Webhook - Dati in Uscita da Eturnity
I webhook inviano automaticamente dati da Eturnity ai tuoi sistemi quando si verificano eventi specifici. Questi sono trigger che si attivano quando certe azioni accadono in Eturnity, abilitando notifiche in tempo reale e sincronizzazione dei dati.
Documentazione tecnica Webhook e Payload di esempio
Per informazioni tecniche dettagliate, inclusi payload di esempio che mostrano tutti gli elementi dati che possiamo fornire, visita la nostra documentazione webhook completa:
Suggerimento: Dopo aver aperto il link, utilizza la navigazione sul lato sinistro per accedere alla documentazione per il tuo prodotto Eturnity specifico e per trovare l'ultima versione webhook.
Questa documentazione include:
Payload di esempio completi che mostrano tutti i campi dati disponibili
Specifiche della struttura dati per dettagli del cliente, dati del sistema fotovoltaico e costi
Requisiti di autenticazione e protocolli di sicurezza
Esempi di integrazione e migliori pratiche
Trigger di dati per prodotto Eturnity
A seconda del prodotto Eturnity che stai utilizzando, i trigger di dati possono variare:
Eturnity Expert
In Eturnity Expert, i webhook vengono attivati quando si verificano i seguenti eventi:
Creazione di nuovo progetto – Quando viene creato un nuovo progetto
Aggiornamenti di stato o tag progetto – Quando cambia lo stato di un progetto o vengono aggiornati i tag milestone personalizzati
Cambiamenti di assegnazione del responsabile del progetto – Quando viene cambiato il responsabile del progetto assegnato
Creazione di documenti – Quando vengono creati documenti
Completamento della firma del documento – Quando un documento viene contrassegnato come firmato
Calcolatori Eturnity
Per Calcolatore Solare, Configuratore e Calcolatore Termico, i webhook vengono attivati quando:
Invio modulo calcolo solare – Quando un utente completa e invia una richiesta di calcolo solare
Invio modulo configuratore – Quando un utente completa e invia una richiesta di configurazione del sistema
Invio modulo calcolo termico – Quando un utente completa e invia una richiesta di calcolo termico
Opzioni di Integrazione Webhook
Offriamo due approcci principali per ricevere dati webhook da Eturnity:
Opzione 1: Integrazione Diretta
Per l'integrazione diretta, fornisci la tua infrastruttura tecnica per ricevere i nostri dati webhook:
Configurazione endpoint personalizzato - Fornisci l'URL dell'endpoint dove inviamo il payload
Elaborazione dati - La gestione e l'elaborazione dei dati sulla tua infrastruttura sono di tua responsabilità
Trigger flessibili - Specifica quali eventi dovrebbero attivare le notifiche webhook
Controllo completo - Personalizzazione completa di come i dati vengono gestiti ed elaborati
Importante: Forniamo il codice corrispondente al payload. La gestione e l'elaborazione dei dati sulla tua infrastruttura sono di tua responsabilità.
Opzione 2: Integrazione tramite Zapier
Zapier è una piattaforma di automazione no-code che funge da ponte tra Eturnity e migliaia di altre applicazioni aziendali. Invece di costruire endpoint tecnici personalizzati, Zapier fornisce un'interfaccia user-friendly per connettere sistemi e automatizzare flussi di lavoro.
Perché Scegliere l'Integrazione Zapier:
Nessuna programmazione richiesta - Configura le integrazioni attraverso un'interfaccia visuale senza codifica
Nessuna infrastruttura necessaria - Zapier gestisce tutta la gestione tecnica degli endpoint per te
Connessioni preconfigurate - Integrazioni pre-costruite con CRM popolari, strumenti di email marketing e business
Builder di workflow visuale - Interfaccia drag-and-drop per creare regole di automazione
Attivazione istantanea - Inizia in pochi minuti invece di settimane di sviluppo
Cosa Fa Zapier per te:
Invece che il tuo team IT costruisca ricevitori webhook personalizzati, Zapier:
Riceve dati webhook da Eturnity automaticamente
Elabora e formatta i dati secondo le tue regole
Invia i dati alle tue applicazioni scelte (CRM, strumenti email, fogli di calcolo, ecc.)
Gestisce tutti gli aspetti tecnici come autenticazione, gestione errori e tentativi
Puoi trovare un elenco completo delle applicazioni supportate qui: App & Integrazioni Zapier
API - Gestione dei Dati Eturnity da Sistemi Esterni
Oltre a ricevere dati da Eturnity tramite webhook, potete anche inviare dati a Eturnity e gestire progetti esternamente utilizzando la nostra API completa.
L'API Eturnity consente la gestione senza problemi dei tuoi progetti, componenti e altre risorse all'interno dell'ecosistema Eturnity utilizzando richieste HTTP standard.
Documentazione API e Accesso
Per esplorare diverse versioni API, utilizza il menu dropdown situato nella navigazione in cima alla nostra documentazione API.
L'API è ora accessibile tramite il nostro nuovo URL backend: https://api.eturnity.io/doc/
Cosa Potete Fare con l'API
Creare e aggiornare progetti - Gestire programmaticamente i dati di progetto dai tuoi sistemi
Gestire componenti - Aggiornare informazioni di componenti esistenti (aggiungere o eliminare componenti non è possibile)
Gestione clienti - Sincronizzare i dati cliente tra sistemi
Integrazione bidirezionale - Combinare chiamate API con notifiche webhook per sincronizzazione completa
Passi Successivi per Iniziare
Funzionalità Add-on: Le integrazioni API e webhook sono disponibili come add-on separato che deve essere acquistato. Contatta il nostro team customer success o inviate un'email a support@eturnity.com per prezzi e attivazione.
Per Configurazione Webhook (Ricevere Dati da Eturnity)
Per iniziare a ricevere dati webhook da Eturnity, avremo bisogno che ci fornisca:
Per Integrazione Webhook Diretta
URL Endpoint - L'URL dove ricevere i dati webhook
Trigger desiderati - Specifica quali eventi dovrebbero attivare la trasmissione dati (creazione progetto, generazione PDF, ecc.)
Preferenze di autenticazione (opzionale) - Come vuoi proteggere la connessione webhook
Per Integrazione Webhook Zapier
Semplicemente facci sapere che vorresti usare l'integrazione Zapier:
Processo di invito - Ti invieremo un invito per unirvi alla nostra app su Zapier
Nessuna configurazione endpoint necessaria - Zapier gestisce la connessione tecnica automaticamente
Gestire i trigger direttamente - Configura i trigger nell'interfaccia del tuo account Zapier
Attivazione rapida - Inizia a ricevere dati entro minuti dalla configurazione
Per Accesso API (Inviare Dati a Eturnity)
Per iniziare a gestire i dati Eturnity dai tuoi sistemi esterni:
Richiesta credenziali API - Contatta il supporto per ottenere accesso API e credenziali di autenticazione
Iniziare a usare l'API - Una volta ricevute le credenziali, puoi connetterti all'API Eturnity direttamente dai tuoi sistemi. Da questo punto in poi, tutte le integrazioni, configurazioni e scambi di dati possono essere utilizzati
Ambiente di test - Configura l'ambiente di sviluppo per test API sicuri
Supporto e Assistenza
Se hai domande sulle nostre integrazioni API e webhook, hai bisogno di supporto tecnico o vuoi discutere i prezzi, siamo qui per aiutarti:
Opzioni di Contatto
Team Customer Success - Contattate il vostro rappresentante customer success dedicato per informazioni sui prezzi e attivazione add-on
Supporto Email:support@eturnity.com - Per domande tecniche, supporto integrazioni e richieste generali
Richieste di Integrazione Personalizzate
Se hai esigenze di integrazione specifiche che non sono coperte dalle nostre opzioni standard, contatta il nostro team di supporto. Siamo sempre interessati a esplorare nuove possibilità di integrazione e potremmo essere in grado di sviluppare soluzioni personalizzate basate sulla domanda.
Pronto a iniziare la tua integrazione? Contatta il nostro team customer success o invia un'email a support@eturnity.com per discutere i tuoi requisiti, ottenere informazioni sui prezzi e attivare l'add-on API e webhook. Ti guideremo attraverso l'intero processo di configurazione per assicurare un'integrazione fluida con i tuoi sistemi aziendali.