Configurazione delle 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 collegarti a un Custom API, HubSpot o Salesforce — e definire esattamente quali campi dati trasmettere per ciascuno di essi.

Iniziare

Vai a Il Mio Account → Integrazioni. Se non sono state ancora configurate integrazioni, vedrai la schermata di default "Nessuna integrazione webhook ancora configurata". Clicca su + Aggiungi Nuova Integrazione (disponibile sia nell'angolo in alto a destra sia 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 tendina (di default su Tutto). Le tre integrazioni disponibili sono:

• Custom API — per qualsiasi endpoint REST API che controlli
• HubSpot — per l'automazione CRM e Marketing tramite HubSpot
• Salesforce — per Salesforce CRM

Clicca sulla tessera del tipo di integrazione che desideri configurare.

Integrazione Custom API

Autenticazione

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

• Nome Integrazione Un'etichetta per il tuo riferimento personale (di default "Integrazione Custom API"). Puoi rinominarlo con qualcosa di descrittivo.
• API Endpoint L'URL completo del ricevitore webhook (e.g., 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.

Le opzioni sono:

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

Scegli il metodo che corrisponde al modo in cui la tua API si aspetta di ricevere dati.

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

• Quando Header Personalizzato è selezionato, appare un campo aggiuntivo Nome Header Personalizzato dove inserisci il nome della 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ò contattare correttamente il tuo endpoint con le credenziali fornite prima di salvare.

Integrazione HubSpot

Dopo aver selezionato HubSpot, il pannello mostra:

• Nome Integrazione Di default "Integrazione HubSpot".
• Chiave API / Access Token Incolla qui il tuo Access Token dell'App Privata di HubSpot. HubSpot ha deprecato le chiavi API tradizionali nel 2022, quindi dovresti usare un token di 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 Predefinito a "Integrazione Salesforce".
• Dominio Salesforce L'URL della tua istanza di Salesforce (es. yourcompany.my.salesforce.com).
• Consumer Key e Consumer Secret Questi si ottengono da un'app connessa configurata in Salesforce sotto Setup → Gestione Applicazioni → Nuovo App Connessa. Drimify utilizza il flusso di credenziali client OAuth 2.0.
• Nome campo ID esterno Il nome API del campo utilizzato per confrontare (upsert) i record — tipicamente Email_External_Id__c o un ID esterno personalizzato sul'oggetto Contatti o Lead. Questo campo deve essere segnato come ID Esterno in Salesforce.
• Sorgente ID Esterno Un menu a tendina per selezionare quale campo dati Drimify utilizzare come chiave di confronto (es. Email).
• Verifica Connessione Testa la connessione OAuth di Salesforce prima di salvare.

⚠️ Campi Obbligatori per Salesforce

Salesforce applica campi richiesti a livello oggetto. Se stai aggiornando Lead, Salesforce richiede almeno:

• Cognome (lastName) — obbligatorio per la creazione Lead

Se stai aggiornando Contatti, Salesforce richiede:

• Cognome (lastName) — obbligatorio per la creazione Contatti

L'Email non è richiesta dallo schema Salesforce per impostazione predefinita, ma è quasi sempre necessaria come ID Esterno per confrontare correttamente e deduplicare i record in fase di upsert. Senza un confronto affidabile dell'ID esterno, Salesforce creerà record duplicati o restituirà un errore.

Best practice: Mappa sempre almeno Cognome ed Email quando colleghi a Salesforce. Omettere il cognome farà sì che il webhook ritorni un errore e il record non sarà creato o aggiornato.

Mappatura Campo

Disponibile su tutti e tre i tipi di integrazione, la Mappatura Campo ti permette di specificare esattamente quali campi 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 (lo definisci tu, corrispondendo ai nomi campo della tua integrazione)
• → Sorgente Campo (menu a tendina destra) — il campo dati Drimify da mappare a esso

Campi Sorgente Drimify Disponibili

Puoi aggiungere quante righe siano necessarie. 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 è presente una sezione Available in Workspaces. Usa l'interruttore accanto a ciascuno spazio di lavoro per controllare quale spazio di lavoro può utilizzare questa integrazione. Clicca su Seleziona Tutto per abilitarla per tutti gli spazi di lavoro contemporaneamente.## Salva e Gestisci Integrazioni

Una volta che tutti i campi sono compilati, clicca su Salva modifiche 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 Annulla per cancellare eventuali modifiche non salvate.

Aggiornato il: 22/04/2026