Configurazione Integrazioni in Drimify (Webhooks & Mailer)

Le integrazioni Drimify ti consentono di inviare automaticamente i dati dei partecipanti a servizi esterni ogni volta che un utente interagisce con la tua applicazione. Puoi connetterti a un API Personalizzato, HubSpot o Salesforce — e per ogni integrazione, puoi specificare esattamente quali campi dati vengono trasmessi.

Come Iniziare

Se non è stata ancora configurata alcuna integrazione, vedrai lo schermo segnaposto "Nessuna integrazione webhook ancora" o "Nessuna integrazione mailer ancora".
Fai clic su + Aggiungi Nuova Integrazione (disponibile sia in alto a destra che al centro della pagina) per aprire il selettore delle integrazioni.

Integrazioni Webhook

Selezione di un Tipo di Integrazione

Apparirà una finestra modale intitolata "Seleziona Integrazione Webhook".
Puoi filtrare per categoria utilizzando il menu a tendina (predefinito su Tutte). Le tre integrazioni disponibili sono:

• API Personalizzato — per qualsiasi endpoint REST api che controlli
• HubSpot — per CRM e automazione marketing tramite HubSpot
• Salesforce — per CRM Salesforce

Clicca sulla tessera dell'integrazione che desideri configurare.

Integrazione API Personalizzato

Autenticazione

Dopo aver selezionato Custom API, si apre il pannello Aggiungi Integrazione con i seguenti campi:

• Nome Integrazione: Un'etichetta per il tuo riferimento (default: "Integrazione API Personalizzata"). Puoi rinominarla in qualcosa di più descrittivo.
• Endpoint API: L'URL completo del tuo ricevitore webhook (ad esempio: https://api.example.com/webhook). Questo deve essere un endpoint HTTPS.
• Metodo HTTP:

Seleziona il metodo http utilizzato per inviare la richiesta webhook al tuo endpoint.
Opzioni disponibili:

• POST — Raccomandato per la maggior parte dei casi d'uso (crea una nuova risorsa o invia dati)
• PUT — Sostituisce completamente una risorsa esistente
• PATCH — Aggiorna parzialmente una risorsa esistente

Scegli il metodo che corrisponde a come la tua API si aspetta di ricevere i dati.

• Tipo di Autenticazione: Scegli il metodo di autenticazione usato dal tuo endpoint.

• Quando viene selezionata Autenticazione di Base, compaiono due campi: Login (username) e Password. Inseriscili come sono — Drimify costruisce automaticamente l'header Authorization: Basic per te. Non è necessario codificare nulla manualmente.
• Quando viene selezionato Header Personalizzato, appare un campo aggiuntivo Nome Header Personalizzato dove puoi inserire il nome chiave dell'header.
• Chiave API: Il valore segreto inviato utilizzando il metodo di autenticazione selezionato.
• Verifica Connessione: Clicca questo pulsante per testare se Drimify può raggiungere correttamente il tuo endpoint utilizzando le credenziali fornite prima di salvare.

Recupero del token da un endpoint di auth (pre-call)

Alcune API richiedono che tu ti autentichi prima: chiami un endpoint di auth con le tue credenziali, ricevi un token e utilizzi quel token nella chiamata webhook effettiva. Drimify supporta automaticamente questo.

Quando il tipo di Autenticazione è Chiave API, Bearer Token o Header Personalizzato, viene visualizzata una casella di controllo "Recupera questo token da un endpoint di auth". Quando selezionata, il campo credenziale statica viene sostituito dalle impostazioni pre-call di seguito (per Header Personalizzato, il campo nome header rimane visibile — il token recuperato viene inviato in quell'header).

Il token recuperato viene posizionato in base al tuo tipo di Autenticazione:

• Bearer Token → Authorization: Bearer <token>
• chiave api → X-API-KEY: <token>
• Header Personalizzato → <your header name>: <token>### Scegli uno dei tre metodi

OAuth2 (client_credentials) — per server OAuth2 standard (ad esempio Keycloak).

• Campi: Token URL, Client ID, Client Secret, Scope (opzionale)
• Drimify invia una richiesta OAuth2 client_credentials standard e legge il token da access_token. La durata del token è presa dal expires_in del server.

Login JSON — per endpoint di login che accettano un corpo JSON e restituiscono un token.

• Campi: Auth URL, Body (elenco chiave/valore), Token path
• Drimify invia un POST con un corpo JSON creato dalle tue righe chiave/valore (ad esempio, le righe email = a@b.com e password = secret producono {"email":"a@b.com","password":"secret"}).
• Token path indica a Drimify dove si trova il token nella risposta JSON, utilizzando la notazione a punti — ad esempio data.access_token, o solo token se è al livello superiore.

Personalizzato — per qualsiasi cosa che non rientra nei due metodi sopra.

• Campi: Auth URL, Metodo HTTP (POST o GET), Headers (elenco chiave/valore), Body (elenco chiave/valore), Codifica del body (JSON o form-urlencoded), Token path
• Con il metodo GET, non c'è un corpo di richiesta — passa i parametri tramite gli Headers o l'Auth URL.
• Se aggiungi un header Content-Type da solo, ha la precedenza su quello implicato dalla codifica del body.

Elenchi chiave/valore (Body e Headers)

Ogni riga ha una chiave, un valore e una casella "sensibile" (selezionata per impostazione predefinita). Le righe possono essere aggiunte e rimosse, ma non modificate sul posto — per modificare una riga, rimuovila e aggiungila di nuovo. Il flag sensibile può essere impostato solo durante l'aggiunta di una riga. I valori sensibili sono mascherati dopo il salvataggio e non vengono mai più esposti, né nel modulo né nei registri.

Caching e ritentativi del Token

• I token OAuth2 sono memorizzati nella cache per la durata fornita da expires_in.
• Per Login JSON e Personalizzato, imposta Validità del Token (minuti) — il predefinito è 60 minuti se lasciato vuoto.
• I token in cache sono conservati per un massimo di 7 giorni.
• Se il tuo endpoint restituisce 401 mentre un token in cache è in uso, Drimify scarta il token, si ri-autentica e riprova la chiamata una volta.
• Se la pre-chiamata fallisce (errore, timeout, o nessun token trovato al Token path), il webhook non viene inviato non autenticato — la consegna fallisce, viene registrata e viene ritentata dalla coda di consegna come di consueto.

Verifica La Connessione con una pre-chiamata

Il pulsante Verifica Connessione supporta completamente la pre-chiamata: prima si autentica con il tuo endpoint di autenticazione, quindi esegue la chiamata di prova con il token ottenuto.

Integrazione HubSpot

Dopo aver selezionato HubSpot, il pannello visualizza:

• Nome Integrazione: Predefinito: "Integrazione HubSpot".
• Chiave API / Access Token: Incolla qui il tuo HubSpot Private App Access Token. Nel 2022, HubSpot ha deprecato le chiavi API legacy, quindi devi usare un token Private App generato dal tuo account HubSpot sotto: Impostazioni → Integrazioni → App Private
• Verifica Connessione: Testa il token contro l'API di HubSpot prima di salvare.

Integrazione Salesforce

Dopo aver selezionato Salesforce, il pannello visualizza:

• Nome Integrazione: Predefinito: "Integrazione Salesforce".
• Dominio Salesforce: L'URL della tua istanza Salesforce (ad esempio: yourcompany.my.salesforce.com).
• Consumer Chiave e Consumer Secret: Ottenuti da un'app Connessa configurata in Salesforce sotto: **Setup → Gestore Delle Applicazioni → Nuovo App Connesso **Drimify utilizza il flusso di credenziali del client OAuth 2.0.
• **Nome campo id Esterno: **Il nome API del campo usato per abbinare (upsert) i record — tipicamente qualcosa come Email_External_Id__c o un campo id esterno personalizzato su oggetti Contatti o Lead. Questo campo deve essere contrassegnato come ID Esterno in Salesforce.
• Fonte ID Esterno: Un menu a discesa che ti consente di selezionare quale campo dati Drimify deve essere utilizzato come chiave di corrispondenza (ad esempio: Email).
• Verifica Connessione: Testa la connessione OAuth di Salesforce prima di salvare.## ⚠️ Campi Richiesti da Salesforce

Salesforce richiede campi a livello di oggetto. Se stai effettuando un upsert su Lead, Salesforce richiede almeno:

• lastName — necessario per la creazione del Lead

Se stai effettuando un upsert su Contatti, Salesforce richiede:

• lastName — necessario per la creazione dei Contatti

Anche se l'Email non è richiesta dallo schema predefinito di Salesforce, è quasi sempre necessaria come ID Esterno per abbinare correttamente e deduplicare i record durante gli upsert. Senza un corrispondente affidabile dell'ID Esterno, Salesforce potrebbe creare record duplicati o restituire un errore.

Migliori Pratiche

Mappa sempre almeno:

• Cognome
• Email

quando connetti a Salesforce. Omettere il Cognome causerà il fallimento del webhook e il record non sarà creato o aggiornato.

Mappatura dei Campi

Disponibile per tutti e tre i tipi di integrazione, Map Fields ti permette di specificare esattamente quali campi dati Drimify vengono inviati alla tua integrazione, e sotto quali nomi chiave.
Clicca su + Aggiungi Campo per aggiungere una riga di mappatura.

Ogni riga consiste di:

• Campo Webhook (sinistra) — il nome chiave che apparirà nel payload in uscita (definito da te per soddisfare i requisiti della tua integrazione)
• → Campo Sorgente (menu a tendina sulla destra) — il valore sorgente per questo campo. Puoi:
• • Selezionare un campo dati Drimify (es. Riferimento App, Email, Punteggio) per inviare un valore dinamico raccolto dal partecipante
  • Selezionare Valore Statico per inviare un valore fisso e predefinito ogni volta che il webhook viene attivato — apparirà un input di testo aggiuntivo dove inserire il valore (es. Il_Mio_Valore). Utile per trasmettere costanti come un nome evento, un identificatore di origine o un tag di ambiente.

Campi Sorgente Disponibili di Drimify

Puoi aggiungere quante mappature siano necessarie.
Per rimuovere una mappatura, clicca sull'icona del cestino sul lato destro della riga.

Disponibile nei Workspaces

In fondo al modulo di integrazione, la sezione Disponibile nei Workspaces ti permette di utilizzare il toggle accanto a ogni workspace per controllare quale workspace può usare l'integrazione.
Clicca su Seleziona Tutto per attivare l'integrazione per tutti i workspace contemporaneamente.

Salva e Gestisci Integrazioni

Una volta completati tutti i campi, clicca su Salva Modifiche per creare l'integrazione. L'integrazione apparirà quindi nella lista principale delle Integrazioni. Puoi modificare o eliminare integrazioni esistenti da questa lista in qualsiasi momento. Clicca su Annulla per cancellare le modifiche non salvate.

Integrazioni di Mailer

Le integrazioni di mailer ti permettono di inviare email transazionali (es. conferme, risultati o follow-up) direttamente dalle tue esperienze Drimify utilizzando il tuo provider email preferito.### Aggiungi a Mailer Integrazione

1. Vai a Integrationi → Mailer Integrationi
2. Clicca su Aggiungi Mailer Integratione
3. Seleziona il tuo provider:

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• Tipimail
• Personalizzato SMTP

Configura la tua Mailer Integrazione

Impostazioni Generali

Tutti i provider condividono le seguenti impostazioni generali:

• Nome dell'Integratione – Nome interno per identificare la tua integrazione
• Nome del Mittente – Nome mostrato come mittente dell'email
• Email del Mittente – Indirizzo email usato per inviare email (non applicabile per Drimify — vedi sotto)
• Email BCC (opzionale) – Aggiungi un indirizzo email per ricevere una copia di tutte le email in uscita

Autenticazione

Ogni provider richiede specifiche credenziali. Vedi la sezione di configurazione specifica del provider per i dettagli.

Testa la Tua Connessione

Dopo aver inserito le tue credenziali, clicca su Invia Email di Test per verificare che la tua integrazione funzioni correttamente. Apparirà una conferma "Email di test inviata con successo" se la connessione è valida.

Campi dei Parametri del Modello

Mappa i campi dati Drimify con le variabili dei template del tuo provider di email. Questa sezione è disponibile per i provider che supportano template di email dinamici: Brevo, Mailgun, Mailjet, Mandrill, SendGrid, e Tipimail.

• Nome del Parametro – La variabile nome attesa nel tuo template email
• Campo – Il dato Drimify corrispondente (es. Nome, Email, Punteggio, ecc.)

Clicca su Aggiungi Campo per creare ulteriori associazioni.

Disponibile nel Area di Lavoro

Seleziona quale spazio di lavoro può utilizzare questa integrazione mailer.### Configurazione Specifica del Provider

Amazon SES

Cosa ti serve:

• Un utente IAM di AWS con permessi ses:SendEmail
• Chiave di Accesso API e Chiave Privata API (dall'IAM di AWS)
• La tua regione AWS (es. eu-west-1, us-east-1)
• Token di Sessione (solo se utilizzi credenziali temporanee/STS)
• Un email mittente o dominio verificato in Amazon SES

Procedura:

1. In AWS IAM, crea un utente con permessi di invio SES e genera una coppia di chiavi di accesso
2. In Drimify, inserisci la tua Chiave di Accesso API, Chiave Privata API e Regione
3. Se usi credenziali temporanee, inserisci anche il Token di Sessione
4. Assicurati che il tuo email mittente o dominio sia verificato in Amazon SES
5. Clicca su Invia Email di Test per convalidare la connessione
6. Salva la tua integrazione

Brevo

Cosa ti serve:

• Una chiave api di Brevo

Procedura:

1. Nel tuo account Brevo, genera una chiave api sotto Impostazioni → Chiavi API
2. Incollala nel campo Chiave API in Drimify
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Drimify

Non è richiesta autenticazione. Le email vengono inviate tramite l'infrastruttura email interna di Drimify (notification@digitaservice.com).
Cosa ti serve:

• Un nome mittente
• Un indirizzo email di risposta (es. contact@yourcompany.com)
• Facoltativamente, un indirizzo email in copia nascosta (BCC)

Procedura:

1. Seleziona Drimify come tuo provider
2. Inserisci il tuo Nome Mittente e Email di Risposta
3. Facoltativamente, aggiungi un Email BCC
4. Seleziona lo spazio di lavoro che deve utilizzare questa integrazione e salva

Mailgun

Cosa ti serve:

• Una chiave api di Mailgun
• Il tuo dominio di invio registrato in Mailgun
• La tua regione API (US o EU)

Procedura:

1. Nel tuo account Mailgun, recupera la tua chiave api e il dominio di invio
2. In Drimify, inserisci la tua Chiave API, Dominio API e Regione API
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Mailjet

Cosa ti serve:

• Una Chiave di Accesso API di Mailjet e Chiave Privata API

Procedura:

1. Nel tuo account Mailjet, vai a Impostazioni Account → REST API → Gestione Chiavi API
2. Copia la tua Chiave di Accesso API e Chiave Privata API
3. Inserisci entrambe in Drimify
4. Clicca su Invia Email di Test per convalidare la connessione
5. Salva la tua integrazione

Mandrill

Cosa ti serve:

• Una chiave api di Mandrill (Mandrill è un'integrazione di email transazionale di Mailchimp)

Procedura:

1. Nel tuo account Mandrill, vai a Impostazioni → Chiavi API e genera una chiave
2. Incolla la Chiave API in Drimify
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

SendGrid

Cosa ti serve:

• Una chiave api di SendGrid con permessi di Invio Email

Procedura:

1. Nel tuo account SendGrid, vai a Impostazioni → Chiavi API e crea una chiave con permessi di Invio Email
2. Incolla la Chiave API in Drimify
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Tipimail

Cosa ti serve:

• Un Utente API di Tipimail e chiave api (Tipimail è il servizio di email transazionali di Sarbacane)

Procedura:

1. Nel tuo account Tipimail, vai a Impostazioni → SMTP & API e recupera il tuo Utente API e Chiave API
2. Inserisci entrambe in Drimify
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

SMTP Personalizzato

Cosa ti serve:

• Il nome host del tuo server SMTP
• Porta SMTP (tipicamente 587 per TLS, 465 per SSL)
• Login SMTP (di solito il tuo indirizzo email)
• Password SMTP

Procedura:

1. Recupera le tue credenziali SMTP dal tuo provider di hosting email o configurazione del server
2. In Drimify, inserisci il tuo Host, Porta, Login e Password
3. Clicca su Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Aggiornato il: 24/07/2026