Configurazione delle Integrazioni in Drimify (Webhooks & Mailers)

Le integrazioni di 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 personalizzata, a HubSpot o Salesforce — e per ogni integrazione, puoi specificare esattamente quali campi di dati vengono trasmessi.

Primi Passi

Vai a Il Mio Account → Integrazioni.

Se non è stata ancora configurata alcuna integrazione, vedrai la schermata segnaposto "Ancora nessuna integrazione webhook" o "Ancora nessuna integrazione di mailer". Clicca su + Aggiungi Nuova Integrazione (disponibile sia in alto a destra che al centro della pagina) per aprire il selettore di integrazione.

Integrazioni Webhook

Selezione di un Tipo di Integrazione

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

• API Personalizzata — per qualsiasi endpoint REST API che gestisci
• HubSpot — per CRM & automazione del marketing tramite HubSpot
• Salesforce — per CRM di Salesforce

Fai clic sulla tessera dell'integrazione che vuoi configurare.

Integrazione API Personalizzata

Autenticazione

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

• Nome Integrazione: Un'etichetta per il tuo riferimento personale (predefinito: "Integrazione API Personalizzata"). Puoi rinominarlo in qualcosa di più descrittivo.
• Endpoint API: L'URL completo del tuo ricevitore webhook (per 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 — Consigliato 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 utilizzato dal tuo endpoint.

• Quando viene selezionata Autenticazione di Base, appaiono due campi: Login (nome utente) e Password. Inseriscili così 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 in cui inserire il nome chiave dell'header.
• Chiave API: Il valore segreto inviato utilizzando il metodo di autenticazione selezionato.
• Verifica Connessione: Clicca su questo pulsante per testare se Drimify può raggiungere con successo il tuo endpoint utilizzando le credenziali fornite prima di salvare.

Recupero del token da un endpoint di autenticazione (pre-chiamata)

Alcune API richiedono di autenticare prima: chiami un endpoint di autenticazione con le tue credenziali, ricevi un token e utilizzi quel token nella chiamata webhook effettiva. Drimify supporta questa funzione automaticamente.

Quando il tipo di Autenticazione è Chiave API, Bearer Token, o Header Personalizzato, appare una casella di controllo "Recupera questo token da un endpoint di autenticazione". Se selezionata, il campo delle credenziali statiche viene sostituito dalle impostazioni di pre-chiamata di seguito (per Header Personalizzato, il campo del nome header rimane visibile — il token recuperato viene inviato in quell'header).

Il token recuperato viene posizionato secondo il tuo tipo di Autenticazione:

• Bearer Token → Authorization: Bearer <token>
• chiave api → X-API-KEY: <token>
• Header Personalizzato → <tuo nome header>: <token>

Scegli uno dei tre metodi

OAuth2 (client_credentials) — per server OAuth2 standard (es. Keycloak).

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

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

• Campi: Auth URL, Corpo (lista chiave/valore), Percorso del Token
• Drimify invia un POST con un corpo JSON costruito dalle tue righe chiave/valore (es. le righe email = a@b.com e password = secret producono {"email":"a@b.com","password":"secret"}).
• Percorso del Token indica a Drimify dove si trova il token nella risposta JSON, usando la notazione a punti — ad es. data.access_token, o semplicemente token se si trova al livello superiore.

Personalizzato — per qualsiasi cosa che non si adatti ai due metodi sopra.

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

Liste chiave/valore (Corpo e Headers)

Ogni riga ha una chiave, un valore e una casella "sensibile" (spunta selezionata di default). 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 quando si aggiunge una riga. I valori sensibili vengono oscurati dopo il salvataggio e non vengono mai più esposti, né nel modulo né nei registri.

Caching dei token e tentativi di riabilitazione

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

Verifica della Connessione con una chiamata preliminare

Il pulsante Verifica Connessione supporta completamente la chiamata preliminare: autentica prima con il tuo endpoint di autenticazione, poi esegue la chiamata di test con il token recuperato.

Integrazione HubSpot

Dopo aver selezionato HubSpot, il pannello visualizza:

• Nome Integrazione: Predefinito: "Integrazione HubSpot".
• API Chiave / Access Token: Incolla qui il token di Accesso della tua App Privata HubSpot. HubSpot ha deprecato le chiavi API legacy nel 2022, quindi devi usare un token per App Privata generato dal tuo account HubSpot in: Impostazioni → Integrazioni → Apps Private
• Verifica Connessione: Testa il token contro l'API 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 (per esempio: yourcompany.my.salesforce.com).
• Consumer Chiave e Consumer Secret: Ottenuti da un App Connessa configurata in Salesforce in: Setup → Gestore delle Applicazioni → Nuovo App Connessa. Drimify utilizza il flusso di credenziali del client OAuth 2.0.
• Nome id campo Esterno: Il nome API del campo utilizzato per confrontare (aggiornare/inserire) i record — tipicamente qualcosa come Email_External_Id__c o un campo id esterno personalizzato sull'oggetto Contatti o Lead. Questo campo deve essere contrassegnato come ID Esterno in Salesforce.
• Fonte ID Esterno: Un menu a tendina che ti consente di selezionare quale campo dati di Drimify dovrebbe essere utilizzato come chiave di confronto (per esempio: Email).
• Verifica Connessione: Testa la connessione OAuth a Salesforce prima di salvare.

⚠️ Campi Richiesti per Salesforce

Salesforce applica campi obbligatori a livello di oggetto. Se stai facendo l'upsert di un Lead, Salesforce richiede almeno:

• lastName — necessario per la creazione di un Lead

Se stai facendo l'upsert di Contatti, Salesforce richiede:

• lastName — necessario per la creazione di Contatti

Anche se l'Email non è obbligatoria secondo lo schema predefinito di Salesforce, è quasi sempre necessaria come ID Esterno per far combaciare correttamente e deduplicare i record durante gli upserts. Senza un affidabile corrispondenza di ID Esterno, Salesforce potrebbe creare record duplicati o restituire un errore.

Migliori Pratiche

Mappa sempre almeno:

• Cognome
• Email

quando ti connetti a Salesforce. Omesso il Cognome, il webhook fallirà e il record non sarà creato o aggiornato.

Mapping dei Campi

Disponibile per tutti e tre i tipi di integrazione, Map Fields ti permette di specificare esattamente quali campi dati di Drimify vengono inviati alla tua integrazione e con quali nomi di chiave.
Fai clic su + Aggiungi Field per aggiungere una riga di mapping.

Ogni riga consiste di:

• Campo Webhook (sinistra) — il nome della chiave che apparirà nel payload in uscita (definito da te per soddisfare i requisiti della tua integrazione)
• → Campo Sorgente (dropdown a 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 un valore statico per inviare un valore fisso, codificato ogni volta che il webhook si attiva — apparirà un input di testo aggiuntivo dove inserisci il valore (es. My_Value). Utile per passare costanti come un nome di evento, un identificatore di sorgente, o un tag di ambiente.

Campi Sorgente Disponibili su Drimify

Puoi aggiungere quanti mappings hai bisogno.
Per rimuovere un mapping, fai clic sull'icona del cestino sul lato destro della riga.

Disponibile nelle Aree di Lavoro

Alla fine del modulo di integrazione, la sezione Disponibile nelle Aree di Lavoro ti permette di usare l'interruttore accanto a ogni area di lavoro per controllare quale area di lavoro può utilizzare l'integrazione.
Fai clic su Seleziona Tutto per attivare l'integrazione per tutti gli spazi di lavoro contemporaneamente.

Salva e Gestisci Integrazioni

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

Integrazioni con Mailer

Le integrazioni con mailer ti permettono di inviare email transazionali (es. conferme, risultati o follow-up) direttamente dalle tue esperienze Drimify utilizzando il tuo provider di e-mail preferito.

Aggiungi Integrazione a Mailer

1. Vai su Integrazioni → Integrazioni Mailer
2. Fai clic su Aggiungi Integrazione Mailer
3. Seleziona il tuo provider:

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

Configura la tua Integrazione Mailer

Impostazioni Generali

Tutti i provider condividono le seguenti impostazioni generali:

• Nome Integrazione – Nome interno per identificare la tua integrazione
• Nome Mittente – Nome visualizzato come mittente dell'email
• Email Mittente – Indirizzo email utilizzato 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 credenziali specifiche. Vedi la sezione dedicata alla configurazione del provider per i dettagli.

Testa la Tua Connessione

Dopo aver inserito le tue credenziali, fai clic 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

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

• Nome parametro – Il nome della variabile atteso nel tuo template email
• Campo – Il dato corrispondente di Drimify (ad esempio, Nome, Email, Punteggio, ecc.)

Fai clic su Aggiungi Campo per creare ulteriori associazioni.

Disponibile nei spazi di lavoro

Seleziona quale spazio di lavoro può utilizzare questa integrazione mailer.

Configurazione Specifica del Provider

Amazon SES

Cosa ti serve:

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

Passaggi:

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 Accesso API, Chiave Privata API e Regione
3. Se usi credenziali temporanee, inserisci anche il Token di Sessione
4. Assicurati che la tua email o dominio sia verificato in Amazon SES
5. Clicca Invia Email di Test per convalidare la connessione
6. Salva la tua integrazione

Brevo

Cosa ti serve:

• Una chiave api Brevo

Passaggi:

1. Nel tuo account Brevo, genera una chiave api sotto Impostazioni → Chiavi API
2. Incollala nel campo della Chiave API in Drimify
3. Clicca 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 BCC

Passaggi:

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

Mailgun

Cosa ti serve:

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

Passaggi:

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 Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Mailjet

Cosa ti serve:

• Una Chiave Accesso API Mailjet e una Chiave Privata API

Passaggi:

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

Mandrill

Cosa ti serve:

• Una chiave api Mandrill (Mandrill è un add-on di Mailchimp per email transazionali)

Passaggi:

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

SendGrid

Cosa ti serve:

• Una chiave api SendGrid con permessi di invio email

Passaggi:

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

Tipimail

Cosa ti serve:

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

Passaggi:

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

SMTP Personalizzato

Cosa ti serve:

• L'hostname del tuo server SMTP
• Porta SMTP (tipicamente 587 per TLS, 465 per SSL)
• Login SMTP (di solito il tuo indirizzo email)
• Password SMTP

Passaggi:

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 Invia Email di Test per convalidare la connessione
4. Salva la tua integrazione

Aggiornato il: 03/10/2026