Vai al contenuto principale

Compila i campi del tuo documento con i dati HubSpot

Accelera i tuoi flussi di lavoro per la firma compilando automaticamente i campi dei documenti utilizzando i dati di HubSpot.

Ferdinand avatar
Scritto da Ferdinand
Aggiornato questa settimana

📖 Indice

Grazie all’integrazione di Yousign per HubSpot, puoi creare documenti come preventivi o contratti direttamente da HubSpot. I campi chiave vengono compilati automaticamente utilizzando i dati del tuo CRM, senza più bisogno di fare copia-incolla!

Scopri la funzionalità


Quando invii un preventivo o un contratto a un lead o a un potenziale cliente, non è necessario copiare manualmente i dati da HubSpot nel documento. Ma puoi:

  1. Avviare una richiesta di firma direttamente da un record HubSpot.

  2. Selezionare un modello Yousign preconfigurato.

  3. Esaminare il documento in Yousign, dove i campi chiave come l’importo della trattativa, il nome dell’azienda e i dettagli del contatto vengono compilati automaticamente utilizzando i dati di HubSpot.

  4. Invia la richiesta in pochi clic.

Perché utilizzare questa funzionalità?

  • Risparmio di tempo - compila automaticamente i documenti senza dover inserire i dati manualmente.

  • Errori evitati - niente più errori di battitura o informazioni non aggiornate.

  • Processi centralizzati - non è più necessario passare da un tool all'altro.

Come funziona

Il tuo modello Yousign può includere tag HubSpot che collegano i campi del documento alle proprietà HubSpot (da Trattative, Aziende o Contatti). Questi tag consentono a Yousign di estrarre automaticamente i dati corretti quando crei una richiesta di firma da HubSpot.

Procedura passo dopo passo: configurazione del modello


1. Crea un nuovo modello nell'applicazione Yousign

Scopri come utilizzare i modelli in questo articolo.

2. Aggiungi campi al tuo modello.

Puoi utilizzare due tipi di campi:

3. Fai clic sul pulsante modifica per aprire le impostazioni del campo.

4. Aggiungi un tag HubSpot

In ogni campo, inserisci un tag HubSpot in questo formato:

hs.{objectType}.{propertyName}

Esempi:

  • hs.contact.firstname → Kelly

  • hs.deal.amount → 50.000

  • hs.company.name → Initech Inc.

Tag HubSpot supportati


I tag HubSpot elencati qui di seguito includono le proprietà standard più utilizzate. Puoi copiarli e incollarli direttamente nei campi del modello Yousign per risparmiare tempo durante la configurazione.

Proprietà della trattativa - hs.deal {propertyName}

Proprietà

Tag HubSpot

Valore di esempio

Importo

hs.deal.amount

50.000

Importo nella valuta dell'azienda

hs.deal.amount_in_home_currency

46.000

Valore annuale contratto

hs.deal.hs_acv

120.000

Fatturato ricorrente annuale

hs.deal.hs_arr

100.000

Data di chiusura

hs.deal.closedate

2025-06-30T00:00:00Z

Descrizione trattativa

hs.deal.description

Licenza software aziendale per 500 utenti

Nome trattativa

hs.deal.dealname

Acme Corp – Q3 Expansion

Proprietario trattativa

hs.deal.hubspot_owner_id

John Smith

Tag trattativa

hs.deal.hs_tag_ids

Alta priorità, rinnovo

Tipo di trattativa

hs.deal.dealtype

New Business

Tasso di cambio

hs.deal.hs_exchange_rate

0.92

Ricavi mensili ricorrenti

hs.deal.hs_mrr

8333.33

Passaggio successivo

hs.deal.hs_next_step

Finalizzare il contratto e programmare l'onboarding.

Valore totale contratto

hs.deal.hs_tcv

150.000

Importo ponderato

hs.deal.hs_projected_amount

37.500

Importo ponderato nella valuta dell'azienda

hs.deal.hs_projected_amount_in_home_currency

34.500

Proprietà dell'azienda - hs.company {propertyName}

Proprietà

Tag HubSpot

Valore di esempio

Chi siamo

hs.company.about_us

Innovare il futuro delle soluzioni AI.

Fatturato annuale

hs.company.annualrevenue

7.500.000

Città

hs.company.city

Milano

Dominio azienda

hs.company.domain

techinnovators.com

Nome azienda

hs.company.name

Tech Innovators Inc.

Paese/Regione

hs.company.country

Italia

Descrizione

hs.company.description

Fornitore leader di servizi basati sul cloud.

Industria

hs.company.industry

Software per computer

Gruppo industriale

hs.company.hs_industry_group

Tecnologia

Impresa pubblica

hs.company.is_public

Numero dipendenti

hs.company.numberofemployees

250

Numero di telefono

hs.company.phone

+390280106007

CAP

hs.company.zip

20100

Contesto

hs.company.hs_quick_context

Espansione recente nei mercati europei.

Fascia di fatturato

hs.company.hs_revenue_range

5M €- 10M €

Stato/Regione

hs.company.state

Lombardia

Proprietà contatti - hs.contact.{propertyName} (solo campi di input di testo)

Proprietà

Tag HubSpot

Valore di esempio

Fatturato annuale

hs.contact.annualrevenue

5,000,000 €

Città

hs.contact.city

Milano

Nome azienda

hs.contact.company

Initech

Paese/Regione

hs.contact.country

Italia

Codice Paese/Regione

hs.contact.hs_country_region_code

IT

Account LinkedIn

hs.contact.linkedin_account

https://linkedin.com/in/emmajohnson

Data primo coinvolgimento

hs.contact.hs_sa_first_engagement_date

2024-05-15T14:30:00Z

Descrizione primo coinvolgimento

hs.contact.hs_sa_first_engagement_descr

Libro bianco scaricato

E-mail

hs.contact.email

emma.rossi@initech.com

Ruolo principale

hs.contact.hs_role

Marketing

Livello di seniority

hs.contact.hs_seniority

Direttore

Ruolo secondario

hs.contact.hs_sub_role

Marketing digitale

Numero di fax

hs.contact.fax

+39 02 9707086

Nome

hs.contact.firstname

Emma

Industria

hs.contact.industry

Tecnologia dell'informazione

Professione

hs.contact.jobtitle

Direttore marketing

Cognome

hs.contact.lastname

Rossi

Numero di cellulare

hs.contact.mobilephone

+39 340 5449900

Numero dipendenti

hs.contact.numemployees

100-500

Persona

hs.contact.hs_persona

Responsabile delle decisioni

Numero di telefono

hs.contact.phone

+39 340 5449900

CAP

hs.contact.zip

20100

Titolo

hs.contact.salutation

Sig.ra

Stato/Regione

hs.contact.state

Lombardia

Provincia

hs.contact.hs_state_code

MI

Indirizzo

hs.contact.address

123 Main Street

Fuso orario

hs.contact.hs_timezone

UTC/GMT +01:00 Italia

URL del sito web

hs.contact.website

https://www.initech.com

L'elenco dei tag non è esaustivo. Puoi utilizzare qualsiasi proprietà esistente di HubSpot- comprese quelle standard e quelle personalizzate - purché appartengano al tipo di oggetto corretto (trattativa, azienda o contatto).

Per trovare il nome della proprietà, accedi al tuo account HubSpot e vai su: "Impostazioni" > "Proprietà", fai clic su "Modifica proprietà" e cerca la voce "Nome interno".

Compatibilità dei tag HubSpot

⚠️ Le proprietà dei contatti (es. hs.contact.firstname) funzionano solo nei campi di input di testo.

Tipo di campo

Supporti

Campo di input testo

deal, company, contact

Campo di testo di sola lettura

solo deal, company

Formato tag

Per funzionare correttamente, un tag deve rispettare tutte queste regole:

  • Deve iniziare con hs.

  • Oggetti accettati: deal, company, o contact

  • Nome proprietà:

    • Deve utilizzare il "nome interno" della proprietà.

    • Deve iniziare con una lettera minuscola (a-z)

    • Può contenere solo lettere minuscole (a-z), numeri (0-9) e underscore (_)

    • Massimo 100 caratteri

Creazione e invio di una richiesta


Una volta che il modello è pronto, puoi creare una richiesta di firma utilizzando i dati di HubSpot:

  1. Accedi a un record di HubSpot (trattativa, azienda o contatto)

  2. Clicca su "Crea richiesta di firma".

  3. Seleziona il tuo modello Yousign

  4. Sostituisci i firmatari segnaposto con i contatti HubSpot

  5. Clicca su "Crea richiesta di firma".

  6. Clicca su "Continua su Yousign".

  7. I campi vengono compilati automaticamente. I dati di HubSpot sono stati inseriti automaticamente nei:

    • Campi di input di testo come "valore predefinito"

    • Campi di testo di sola lettura come "valore"

    → Se necessario puoi rivedere e modificare i valori.

  8. Invia la richiesta 🎉

Se un valore o un valore predefinito è già definito nel campo del modello, qualora vengano trovati dati corrispondenti in HubSpot., verrà sovrascritto.

Come vengono recuperati i dati


Quando crei una richiesta di firma da HubSpot:

Proprietà trattativa - hs.deal {propertyName}

  • Se crei la richiesta a partire da un record della trattativa → usiamo le proprietà della trattativa in questione

  • Altrimenti → usiamo la trattativa associata (in casi di più trattative associate, le ignoriamo tutte)

Proprietà azienda - hs.company {propertyName}

(stessa logica delle trattative)

  • Se crei la richiesta a partire da un record dell'azienda → usiamo le proprietà dell'azienda in questione

  • Altrimenti → usiamo l'azienda associata (in casi di più aziende associate, le ignoriamo tutte)

Proprietà contatto - hs.contact {propertyName}

  • Usiamo il contatto HubSpot che hai selezionato per sostituire il firmatario segnaposto nel modello.

    Esempio:

    Hai un firmatario segnaposto con un campo di input di testo etichettato hs.contact.firstname.

    In HubSpot, selezioni il contatto di Kelly Smith come firmatario segnaposto → Yousign riempirà il campo con il valore predefinito "Kelly".

Guida alla risoluzione dei problemi


Questa sezione illustra i problemi comuni che possono verificarsi quando si compilano i campi con i dati di HubSpot.

🕳️ Il campo è vuoto

  • Il tag HubSpot è scritto in modo errato o utilizza un nome di proprietà errato

    → Verifica i nomi interni nelle impostazioni di HubSpot

  • La proprietà HubSpot non ha alcun valore

✂ Il valore viene troncato

  • Il campo di input di testo ha un limite di caratteri troppo basso

    → Aumenta o rimuovi il limite nel modello

  • Il campo è troppo piccolo sul documento

    → Ridimensiona manualmente il campo durante l’anteprima

Aiutaci a migliorare questa funzionalità


Lavoriamo costantemente per migliorarci. Se hai suggerimenti, riscontri problemi o vuoi semplicemente condividere la tua esperienza, saremo felici di ascoltarti!

Hai ricevuto la risposta alla tua domanda?