Vai al contenuto principale
La schermata Document templates è il luogo in cui create e gestite i modelli PDF che l’azione Generate Document dei workflow di HubSpot compila. Ogni modello definisce il layout di un PDF e le proprietà del contatto da inserirvi.

​
Prima di iniziare

  • Serve il ruolo Owner o Admin. I Member e le persone con il ruolo Billing vedono un elenco vuoto e non possono aprire, creare o modificare i modelli.
  • HubSpot deve essere collegato alla vostra organizzazione. Consultate Configurazione di HubSpot.

​
Aprire Document templates

Selezionate Settings nella barra laterale sinistra, poi Document templates sotto Integrations. La schermata ha un elenco Templates da un lato e l’editor dei modelli dall’altro. L’elenco mostra il nome di ogni modello; quando è vuoto, riporta “No document templates yet.”

​
Creare un modello

  1. Inserite un Name per il modello.
  2. Scrivete il Template JSON. L’editor parte con un esempio che potete modificare.
  3. Selezionate Create template.
La definizione imposta un title facoltativo del documento e un elenco di blocks, visualizzati dall’alto verso il basso. Un modello richiede almeno un blocco e può averne fino a 80. Per inserire una proprietà del contatto, inserite un token nella forma contact.<property> tra doppie parentesi graffe, come {{contact.firstname}}. Potete usare i token nel titolo, nel testo dei titoli e dei paragrafi e nelle celle delle tabelle. Quando viene eseguita l’azione Generate Document, Flowella sostituisce ogni token con il valore del contatto iscritto.
Se il JSON non può essere letto, Flowella mostra “Template JSON is invalid” e non lo salva.

​
Modificare o eliminare un modello

  1. Selezionate il modello nell’elenco Templates. L’editor mostra il suo Name, il suo Template ID e il suo Template JSON.
  2. Modificate il nome o il JSON, poi selezionate Save changes.
Per iniziare invece un nuovo modello, selezionate New template. L’editor viene svuotato. Per rimuovere il modello, selezionate Delete.
Delete rimuove subito il modello, senza chiedere conferma. Qualsiasi workflow HubSpot che usa ancora il suo ID non riuscirà con DOCUMENT_TEMPLATE_NOT_FOUND.

​
Usare un modello in HubSpot

  1. Selezionate il modello nell’elenco Templates.
  2. Accanto a Template ID, selezionate Copy ID.
  3. Nel vostro workflow HubSpot, incollate l’ID nel campo Document template ID dell’azione Generate Document.
Quando il workflow viene eseguito, Flowella compila il modello con le proprietà del contatto iscritto e salva il PDF nei file di HubSpot come file pubblico, quindi chiunque abbia il link può aprirlo. Non inserite dati personali sensibili nei modelli di documenti. L’azione restituisce l’URL del file e l’ID del file HubSpot per i passaggi successivi del workflow. Consultate Generate Document per le impostazioni dell’azione.

​
Se il documento non viene creato

Quando l’azione non riesce a creare il PDF, il passaggio del workflow non riesce con un codice di errore:

​
Risorse correlate

Generate Document (HubSpot)

L’azione dei workflow che compila questi modelli.

AI Document Reader (HubSpot)

L’azione complementare che legge i documenti e li trasferisce nelle proprietà dei contatti.
Ultima modifica il 30 ottobre 2026