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
| Parametro | Valore |
|---|---|
companyId | {{trigger.object.id}} |
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:
| Oggetto | Nome del campo |
|---|---|
| Azienda | targetCompanyId |
| Persona | targetPersonId |
| Opportunità | targetOpportunityId |
| Oggetto personalizzato | targetYourCustomObjectId |
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
| Passaggio | Azione | Scopo |
|---|---|---|
| 1 | Attivatore manuale (Company) | L’utente avvia l’operazione su un record |
| 2 | Cerca record | Ottieni i dettagli di Opportunity o delle righe articolo |
| 3 | Richiesta HTTP | Chiama l’API di generazione PDF con i dati del record |
| 4 | Funzione serverless | Scarica e allega il PDF generato |
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
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| ”Download del PDF non riuscito” | Verifica che l’URL del PDF sia accessibile e restituisca un PDF valido |
| ”Caricamento non riuscito” | Verifica che la tua chiave API sia valida e abbia i permessi di scrittura |
| ”Creazione dell’allegato non riuscita” | Assicurati che il nome del campo ID dell’oggetto corrisponda all’oggetto di destinazione |