Configurazione del Webhook delle Integrazioni in Drimify

Il webhook delle integrazioni di Drimify ti permette di inviare automaticamente i dati dei partecipanti a servizi esterni ogni volta che un utente completa o interagisce con la tua app. Puoi connetterti a una Custom API, HubSpot o Salesforce — e per ciascuno puoi definire esattamente quali campi dati vengono trasmessi.

Per Iniziare

Vai a Il Mio Account → Integrazioni. Se non sono state ancora configurate integrazioni, vedrai la schermata segnaposto "Nessuna integrazione webhook ancora".

Clicca su + Aggiungi Nuova Piattaforma, Nuovo Login! Integration (disponibile sia nell'angolo in alto a destra che al centro della pagina) per aprire il selettore delle integrazioni.

Selezione di un Tipo di Integrazione

Apparirà un modale intitolato "Seleziona Integrazione Webhook". Puoi filtrare per categoria usando il menu a tendina (predefinito su Tutte). Le tre integrazioni disponibili sono:

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

Fai clic sul riquadro del tipo di integrazione che vuoi configurare.

Integrazione Custom API

Autenticazione

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

• Nome Integrazione Un'etichetta per il tuo riferimento personale (predefinito a "Integrazione Custom API"). Puoi rinominarla con qualcosa di descrittivo.
• API Endpoint L'URL completo del tuo ricevitore webhook (es. https://api.example.com/webhook). Questo deve essere un endpoint HTTPS.
• Tipo di API Key Scegli il metodo di autenticazione che il tuo endpoint usa. Le opzioni sono:

• Quando Intestazione Personalizzata è selezionato, compare un campo aggiuntivo Nome Intestazione Personalizzata dove inserisci il nome della chiave header.
• Chiave API Il valore segreto inviato con il metodo di autenticazione scelto.
• Verifica Connessione Clicca su questo pulsante per testare se Drimify può raggiungere con successo il tuo endpoint con le credenziali fornite prima di salvare.

Integrazione HubSpot

Dopo aver selezionato HubSpot, il pannello mostra:

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

Integrazione Salesforce

Dopo aver selezionato Salesforce, il pannello mostra:

• Nome Integrazione Predefinito a "Integrazione Salesforce".
• Dominio Salesforce L'URL della tua istanza Salesforce (es. yourcompany.my.salesforce.com).
• Consumer Key e Consumer Secret Questi sono ottenuti da un'app connessa configurata in Salesforce sotto Setup → Gestore Delle Applicazioni → Nuova Piattaforma, Nuovo Login! App Connessa. Drimify utilizza il flusso di credenziali client OAuth 2.0.
• Nome campo id Esterno Il nome API del campo usato per abbinare (upsert) i record — tipicamente 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 tendina per selezionare quale campo dati Drimify utilizzare come chiave di corrispondenza (es. Email).
• Verifica Connessione Testa la connessione OAuth di Salesforce prima di salvare.

⚠️ Campi Richiesti per Salesforce

Salesforce applica i campi richiesti a livello di oggetto. Se stai eseguendo un upsert su Leads, Salesforce richiede almeno:

• Cognome (lastName) — obbligatorio per la creazione di un Lead

Se stai eseguendo un upsert su Contatti, Salesforce richiede:

• Cognome (lastName) — obbligatorio per la creazione di Contatti

Email non è richiesta dallo schema di Salesforce di default, ma è quasi sempre necessaria come External ID per abbinare correttamente e deduplicare i record durante l'upsert. Senza un accurato match dell'ID esterno, Salesforce creerà record duplicati o restituirà un errore.

Pratica consigliata: Mappa sempre almeno Cognome e Email quando connetti Salesforce. Omettere il Cognome causerà un errore nel webhook e il record non sarà creato o aggiornato.

Mappatura del Campo

Disponibile per tutti e tre i tipi di integrazione, la Mappatura del Campo ti consente di specificare esattamente quali dati Drimify vengono inviati alla tua integrazione, e con quali nomi chiave.

Clicca su + Aggiungi Campo per aggiungere una riga di mappatura. Ogni riga è composta da:

• Campo Webhook (sinistra) — il nome chiave che apparirà nel payload in uscita (definire questo in base ai nomi di campo attesi dalla tua integrazione)
• → Campo sorgente (dropdown destra) — il campo dati Drimify da mappare

Campi Sorgente Drimify Disponibili

Puoi aggiungere tutte le righe che ti servono. Per rimuovere una mappatura, clicca sull'icona del cestino sul lato destro della riga.

Disponibile nei Workspace

Alla fine di ogni modulo di integrazione c'è una sezione Disponibile nei Workspaces. Usa l'interruttore accanto a ogni workspace per controllare quale spazio può utilizzare l'integrazione. Clicca su Seleziona Tutto per abilitarla per tutti gli spazi di lavoro contemporaneamente.

Salva e Gestisci Integrazioni

Una volta riempiti tutti i campi, clicca su Salva Modifiche per creare l'integrazione. Apparirà poi nella lista principale delle Integrazioni. Puoi modificare o eliminare le integrazioni esistenti da quella lista in qualsiasi momento.

Clicca su Annulla per cancellare eventuali modifiche non salvate.

Aggiornato il: 10/03/2026