Configurazione Integrazioni Webhook in Drimify

Le integrazioni webhook di Drimify ti permettono 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 un Custom API, HubSpot o Salesforce — e per ciascuno puoi definire esattamente quali campi dati verranno trasmessi.

Introduzione

Vai a Impostazioni → Integrazioni. Se non sono state ancora configurate integrazioni, vedrai la schermata segnaposto "Nessuna integrazione webhook ancora esistente". Clicca su + Aggiungi Nuova Piattaforma, Nuovo Login! Integrazione (disponibile sia nell'angolo in alto a destra che al centro della pagina) per aprire il selettore di integrazioni.

Selezione del Tipo di Integrazione

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

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

Clicca sulla tessera del tipo di integrazione che desideri 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 tuo riferimento personale (di default "Custom API Integration"). Puoi rinominarla in qualcosa di descrittivo.

Endpoint API L'URL completo del tuo ricevitore webhook (es. https://api.example.com/webhook). Deve essere un endpoint HTTPS.

Tipo di Chiave API Scegli il metodo di autenticazione utilizzato dal tuo endpoint. Le opzioni sono:

Quando Header Personalizzato è selezionato, appare un campo Nome Header Personalizzato dove inserire il nome chiave dell'header.

Chiave API Il valore segreto inviato con il metodo di autenticazione scelto.

Verifica Connessione Clicca 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 Di default "HubSpot Integration".

Chiave API / Token d'accesso Incolla qui il tuo Token di Accesso App Privata di HubSpot. HubSpot ha sostituito le chiavi API legacy nel 2022, quindi dovresti utilizzare un token App Privata generato dal tuo account HubSpot in 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 mostra:

Nome Integrazione Di default "Salesforce Integration".

Dominio Salesforce L'URL della tua istanza di Salesforce (es. yourcompany.my.salesforce.com).

Consumer Key e Consumer Secret Questi sono ottenuti da un'app connessa configurata in Salesforce in 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 utilizzato per corrispondere (upsert) i record — tipicamente Email_External_Id__c o un campo id esterno personalizzato su 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 di 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 campi richiesti a livello di oggetto. Se stai eseguendo un upsert di Leads, Salesforce richiede almeno:

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

Se stai eseguendo un upsert di Contatti, Salesforce richiede:

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

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

Best practice: Mappa sempre almeno Cognome ed Email quando ti connetti a Salesforce. Omettere il Cognome farà sì che il webhook restituisca un errore e il record non verrà creato o aggiornato.

Mappatura dei Campi

Disponibile in tutti e tre i tipi di integrazione, la Mappatura dei Campi ti permette di specificare esattamente quali campi dati di 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 (a sinistra) — il nome chiave che apparirà nel payload in uscita (questo lo definisci tu, in modo che corrisponda ai nomi campo attesi dalla tua integrazione)
• → Campo Sorgente (menu a tendina a destra) — il campo dati di Drimify da mappare ad esso

Campi Sorgente Drimify Disponibili

Puoi aggiungere tutte le righe di cui hai bisogno. Per rimuovere una mappatura, clicca sull'icona del cestino sul lato destro della riga.

Disponibile nei Spazi di Lavoro

In fondo a ogni modulo di integrazione c'è una sezione Disponibile nei Spazi di Lavoro. Usa l'interruttore accanto a ciascun spazio di lavoro per decidere quale spazio di lavoro può utilizzare questa integrazione. Clicca su Select All per abilitarla in tutti gli spazi di lavoro contemporaneamente.

Salva e Gestisci Integrazioni

Una volta che tutti i campi sono compilati, clicca su Save Changes per creare l'integrazione. Apparirà quindi nella lista principale delle Integrazioni. Puoi modificare o eliminare le integrazioni esistenti da quella lista in qualsiasi momento.

Clicca su Cancel per annullare le modifiche non salvate.

Aggiornato il: 06/03/2026