Configurazione delle Integrazioni Webhook su Drimify

Le integrazioni webhook 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 collegare un Custom API, HubSpot o Salesforce — e per ciascuna integrazione, puoi specificare esattamente quali campi di dati vengono trasmessi.

Iniziare

Vai a Il Mio Account → Integrazioni.

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

Selezionare un Tipo di Integrazione

Apparirà una finestra modale intitolata “Seleziona Integrazione Webhook”.

Puoi filtrare per categoria utilizzando il menu a discesa (impostazione predefinita è Tutti). Le tre integrazioni disponibili sono:

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

Clicca sul riquadro dell'integrazione che desideri configurare.

Integrazione Custom API

Autenticazione

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

• Nome Integrazione: Un'etichetta per tuo riferimento personale (predefinito: “Custom API Integration”). Puoi rinominarla in qualcosa di più descrittivo.
• Endpoint API: L'URL completo del tuo ricevitore webhook (ad esempio: https://api.example.com/webhook). 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 degli scenari (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 Chiave API: Scegli il metodo di autenticazione utilizzato dal tuo endpoint.

• Quando Custom Header è selezionato, appare un campo aggiuntivo Nome Header Personalizzato in cui puoi inserire il nome della 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.

Integrazione HubSpot

Dopo aver selezionato HubSpot, il pannello visualizza:

• Nome Integrazione: Predefinito: “HubSpot Integration”.
• Chiave API / Access Token: Incolla qui il tuo HubSpot Private App Access Token. HubSpot ha deprecato le chiavi API legacy nel 2022, quindi devi usare un token Private App generato dal tuo account HubSpot in: Impostazioni → Integrazioni → Private Apps
• Verifica Connessione: Testa il token contro l'API di HubSpot prima di salvare.# Integrazione con Salesforce

Dopo aver selezionato Salesforce, il pannello visualizza:

• Nome Integrazione: Predefinito: “Salesforce Integration”.
• Dominio Salesforce: L'URL della tua istanza di Salesforce (ad esempio: yourcompany.my.salesforce.com).
• Consumer Key e Consumer Secret: Ottenuti da un'app connessa configurata in Salesforce sotto: Setup → Gestore delle Applicazioni → Nuova App Connessa Drimify utilizza il flusso delle credenziali del cliente OAuth 2.0.
• Nome campo id esterno: Il nome API del campo utilizzato per abbinare (upsert) i record — tipicamente qualcosa comeEmail_External_Id__c o un ID esterno personalizzato su oggetti Contatti o Lead. Questo campo deve essere contrassegnato come un ID Esterno in Salesforce.
• Fonte ID Esterno: Un menu a discesa che ti permette 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 impone campi obbligatori a livello di oggetti. Se stai eseguendo un upsert su Lead, Salesforce richiede come minimo:

• lastName — obbligatorio per la creazione del Lead

Se stai aggiornando i Contatti, Salesforce richiede:

• lastName — obbligatorio per la creazione dei Contatti

Sebbene l'Email non sia obbligatoria dallo schema predefinito di Salesforce, è quasi sempre necessaria come ID Esterno per abbinare e deduplicare correttamente i record durante gli upsert. Senza una corrispondenza affidabile dell'ID Esterno, Salesforce può creare record duplicati o restituire un errore.

Migliori Pratiche

Mappa sempre almeno:

• Cognome
• Email

quando si collega a Salesforce. Ommettere il Cognome farà fallire il webhook e il record non verrà creato o aggiornato.

Mappatura dei Campi

Disponibile per tutti e tre i tipi di integrazione, Mappa Campi ti consente di specificare esattamente quali campi dati Drimify vengono inviati alla tua integrazione e sotto quali nomi di chiave.

Clicca su + Aggiungi Campo per aggiungere una riga di mappatura.

Ogni riga è composta da:

• 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 (menu a tendina sulla destra) — il campo dati Drimify da mappare

Campi Sorgente Drimify Disponibili

Puoi aggiungere tutte le mappature necessarie.

Per rimuovere una mappatura, clicca sull'icona del cestino sul lato destro della riga.

Disponibile nei Spazi di Lavoro

Alla fine del modulo di integrazione, la sezione Disponibile nei Spazi di Lavoro ti consente di utilizzare l'interruttore accanto a ciascun spazio di lavoro per controllare quale spazio di lavoro può utilizzare l'integrazione.

Clicca su Seleziona Tutti per abilitare l'integrazione per tutti gli spazi di lavoro contemporaneamente.# Salva e Gestisci Integrazioni

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

Integrazioni Mailer

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

Aggiungi un'Integrazione Mailer

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

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• 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 le email (non applicabile per Drimify — vedi sotto)
• Email BCC (opzionale) – Aggiungi un indirizzo email per ricevere una copia di tutte le email inviate

Autenticazione

Ogni provider richiede credenziali specifiche. Consulta 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 l'integrazione funzioni correttamente. Apparirà una conferma "Email di test inviata con successo" se la connessione è valida.

Campi Parametro Template

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

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

Clicca su Aggiungi Campo per creare ulteriori mappature.

Disponibile nell'Area di Lavoro

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

Amazon SES

Cosa ti serve:

• Un utente AWS IAM con permessi ses:SendEmail
• API Access Key e API Private Key (da AWS IAM)
• La tua regione AWS (es. eu-west-1, us-east-1)
• Session Token (solo se si usano 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 access key
2. In Drimify, inserisci la tua API Access Key, API Private Key e Region
3. Se stai utilizzando credenziali temporanee, inserisci anche il Session Token
4. Assicurati che la tua email o dominio del mittente sia verificato in Amazon SES
5. Clicca su Inviaci Email di Test per convalidare la connessione
6. Salva la tua integrazione

Brevo

Cosa ti serve:

• Una chiave api di Brevo

Passaggi:

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

Drimify

Nessuna autenticazione richiesta. Le email vengono inviate tramite l'infrastruttura 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 fornitore
2. Inserisci il tuo Sender Name e Reply-To Email
3. Agiungi facoltativamente un BCC Email
4. Seleziona il workspace che deve utilizzare questa integrazione e salva

Mailgun

Cosa ti serve:

• Una chiave API Mailgun
• Il tuo dominio registrato su Mailgun
• La tua regione API (US o EU)

Passaggi:

1. Nel tuo account Mailgun, recupera la tua chiave api e dominio di invio
2. In Drimify, inserisci la tua API Key, API Domain e API Region
3. Clicca su Inviaci Email di Test per convalidare la connessione
4. Salva la tua integrazione

Mailjet

Cosa ti serve:

• Una Mailjet API Access Key e API Private Key

Passaggi:

1. Nel tuo account Mailjet, vai a Account Impostazioni → REST API → Gestione chiave api
2. Copia la tua API Access Key e API Private Key
3. Inserisci entrambe in Drimify
4. Clicca su Inviaci Email di Test per convalidare la connessione
5. Salva la tua integrazione

Mandrill

Cosa ti serve:

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

Passaggi:

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

SendGrid

Cosa ti serve:

• Una chiave API SendGrid con permessi Mail Send

Passaggi:

1. Nel tuo account SendGrid, vai a Impostazioni → Chiavi API e crea una chiave con permessi Mail Send
2. Incolla la API Key in Drimify
3. Clicca su Inviaci 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 (solitamente 587 per TLS, 465 per SSL)
• Login SMTP (solitamente il tuo indirizzo email)
• Password SMTP

Passaggi:

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

Aggiornato il: 07/05/2026