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:- Scaricare il PDF da un URL (da un servizio di generazione di PDF)
- Caricare il file su Twenty
- Creare un allegato collegato al record
Prerequisiti
Prima di configurare il flusso di lavoro:- Crea una chiave API: vai su Impostazioni → API e crea una nuova chiave API. Ti servirà questo token per la funzione logica.
- 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
- Vai su Flussi di lavoro e crea un nuovo flusso di lavoro
- Seleziona Attivatore manuale
- Scegli l’oggetto a cui vuoi allegare i PDF (ad es. Company o Opportunity)
Passaggio 2: aggiungi una Funzione logica
- Aggiungi un’azione Code (funzione logica)
- Crea una nuova funzione con il codice seguente
- 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
SostituiscitargetCompanyId 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:- Per prima cosa esegui un’azione HTTP Request per generare il PDF
- Passa l’URL PDF restituito alla funzione logica come parametro
Passaggio 4: Testa e attiva
- Salva il flusso di lavoro
- Vai a un record di Company
- Fai clic sul menu ⋮ e seleziona il tuo flusso di lavoro
- Controlla la sezione Attachments nel record per verificare che il PDF sia stato allegato
- 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