Custom Webhook
Usa l’endpoint webhook generico per inviare dati di attribution da qualsiasi integrazione personalizzata — il tuo backend, un form handler o uno strumento interno. Finseo rileva automaticamente i formati di payload conosciuti (HubSpot, Salesforce, Typeform, Jotform, …) e accetta anche JSON semplice.Ottieni il tuo URL webhook
- In Finseo apri Integrations → Custom Webhook → Connect.
- Copia il tuo URL webhook personale (contiene l’ID del tuo progetto e un token segreto):
Invia una richiesta
Fai POST di JSON con almeno unchannelId (o una freetextResponse che Finseo categorizza):
channelId, channelLabel, channelCategory, subChannel, freetextResponse, respondentEmail, respondentName, respondentExternalId, dealValue, dealCurrency, pageUrl, formId, metadata.
Test e mappatura dei campi
- La finestra di connessione ha un live listener: attivalo, invia una richiesta e Finseo mostra il payload ricevuto con il risultato del parsing.
- Per i payload non standard, usa Field Mapping per indicare a Finseo quale campo contiene la risposta di attribution.
Sicurezza
- Il parametro di query
tokenautentica le richieste — tratta l’URL come un segreto. Puoi rigenerare il token in qualsiasi momento nella finestra di connessione (il vecchio URL smette di funzionare immediatamente). - Facoltativamente, configura un webhook in uscita nelle impostazioni di Attribution per ricevere notifiche sulle nuove risposte nei tuoi sistemi.
Risoluzione dei problemi
Le richieste vengono rifiutate
Le richieste vengono rifiutate
Verifica che l’URL includa il
token corrente — dopo la rigenerazione, i vecchi URL non sono più validi. Il corpo deve essere JSON (o form-encoded per i provider conosciuti).La risposta finisce nel canale sbagliato
La risposta finisce nel canale sbagliato
Invia un
channelId esplicito invece di affidarti alla categorizzazione del testo libero, oppure modifica il Field Mapping.