--- title: "Integrazioni API e Webhook" url: "https://eturnity.productfruits.help/it/article/integrazioni-api-e-webhook" language: "it" last_updated: "2025-10-17T15:13:11.553Z" --- # Integrazioni API e Webhook Scopri le funzionalità API aperte e webhook di Eturnity che consentono l'integrazione perfetta dei tuoi sistemi con le nostre soluzioni solari. Collega i tuoi sistemi aziendali per ricevere dati di progetto automatizzati, ottimizzare i flussi di lavoro ed eliminare l'inserimento manuale dei dati. ## 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: [**Documentazione Tecnica Webhook**](https://api.eturnity.io/doc/webhooks/) **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](https://zapier.com/apps) ## 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/**](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](mailto: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.