Skip to main content
Genera o recupera automaticamente un PDF e allegalo a un record in Twenty. Questo viene comunemente utilizzato per creare preventivi, fatture o report collegati ad Aziende, Opportunità o altri oggetti.

Panoramica

Questo flusso di lavoro usa un Attivatore manuale così gli utenti possono generare un PDF su richiesta per qualsiasi record selezionato. Una Funzione logica gestisce:
  1. Scaricare il PDF da un URL (da un servizio di generazione di PDF)
  2. Caricare il file su Twenty
  3. Creare un allegato collegato al record

Prerequisiti

Prima di configurare il flusso di lavoro:
  1. Crea una chiave API: vai su Impostazioni → API e crea una nuova chiave API. Ti servirà questo token per la funzione logica.
  2. Configura un servizio di generazione PDF (opzionale): se vuoi generare dinamicamente PDF (ad es. preventivi), usa un servizio come Carbone, PDFMonkey o DocuSeal per creare il PDF e ottenere un URL di download.

Configurazione passo-passo

Passaggio 1: Configura il trigger

  1. Vai su Flussi di lavoro e crea un nuovo flusso di lavoro
  2. Seleziona Attivatore manuale
  3. Scegli l’oggetto a cui vuoi allegare i PDF (ad es. Company o Opportunity)
Con un Attivatore manuale, gli utenti possono eseguire questo flusso di lavoro utilizzando un pulsante che appare in alto a destra una volta selezionato un record, per generare e allegare un PDF.

Passaggio 2: aggiungi una Funzione logica

  1. Aggiungi un’azione Code (funzione logica)
  2. Crea una nuova funzione con il codice seguente
  3. Configura i parametri di input

Parametri di input

Se alleghi a un oggetto diverso (Person, Opportunity, ecc.), rinomina di conseguenza il parametro (ad es. personId, opportunityId) e aggiorna la funzione logica.

Codice della Funzione logica

Passaggio 3: personalizza per il tuo caso d’uso

Per allegare a un oggetto diverso

Sostituisci targetCompanyId con il campo appropriato: Aggiorna sia il parametro della funzione sia l’oggetto variables.data nella mutation dell’allegato.

Per usare un URL PDF dinamico

Se usi un servizio di generazione PDF, puoi:
  1. Per prima cosa esegui un’azione HTTP Request per generare il PDF
  2. Passa l’URL PDF restituito alla funzione logica come parametro

Passaggio 4: Testa e attiva

  1. Salva il flusso di lavoro
  2. Vai a un record di Company
  3. Fai clic sul menu e seleziona il tuo flusso di lavoro
  4. Controlla la sezione Attachments nel record per verificare che il PDF sia stato allegato
  5. Attiva il flusso di lavoro

Integrazione con servizi di generazione PDF

Per creare preventivi o fatture dinamici:

Esempio: Genera preventivo → Allega PDF

Servizi di generazione PDF più diffusi

  • Carbone - Generazione di documenti basata su modelli
  • PDFMonkey - Creazione dinamica di PDF da modelli
  • DocuSeal - Piattaforma di automazione dei documenti
  • Documint - Generazione di documenti API-first
Ogni servizio fornisce un’API che restituisce un URL PDF, che puoi quindi passare alla funzione logica.

Risoluzione dei problemi

Correlati