Skip to main content
Generați sau preluați automat un PDF și atașați-l la o înregistrare în Twenty. Aceasta este utilizată frecvent pentru a crea oferte, facturi sau rapoarte care sunt asociate cu Companii, Oportunități sau alte obiecte.

Prezentare generală

Acest flux de lucru folosește un Manual Trigger pentru ca utilizatorii să poată genera un PDF la cerere pentru orice înregistrare selectată. O funcție logică se ocupă de:
  1. Descărcarea PDF-ului dintr-un URL (de la un serviciu de generare PDF)
  2. Încărcarea fișierului în Twenty
  3. Crearea unui atașament asociat înregistrării

Cerințe

Înainte de a configura fluxul de lucru:
  1. Creați o cheie API: Accesați Settings → APIs și creați o nouă cheie API. Veți avea nevoie de acest token pentru funcția logică.
  2. Configurați un serviciu de generare PDF (opțional): Dacă doriți să generați dinamic fișiere PDF (de ex., oferte), utilizați un serviciu precum Carbone, PDFMonkey sau DocuSeal pentru a crea PDF-ul și a obține un URL de descărcare.

Configurare pas cu pas

Pasul 1: Configurați declanșatorul

  1. Accesați Workflows și creați un nou flux de lucru
  2. Selectați Manual Trigger
  3. Alegeți obiectul la care doriți să atașați fișiere PDF (de ex., Companie sau Oportunitate)
Cu un Manual Trigger, utilizatorii pot rula acest flux de lucru folosind un buton care apare în dreapta sus după selectarea unei înregistrări, pentru a genera și atașa un PDF.

Pasul 2: Adăugați o funcție logică

  1. Adăugați o acțiune Code (funcție logică)
  2. Creați o funcție nouă cu codul de mai jos
  3. Configurați parametrii de intrare

Parametri de intrare

Dacă atașați la un alt obiect (Persoană, Oportunitate etc.), redenumiți parametrul în mod corespunzător (de ex., personId, opportunityId) și actualizați funcția logică.

Codul funcției logice

Pasul 3: Personalizați pentru cazul dvs. de utilizare

Pentru a atașa la un alt obiect

Înlocuiți targetCompanyId cu câmpul corespunzător: Actualizați atât parametrul funcției, cât și obiectul variables.data în mutația de atașare.

Pentru a utiliza un URL PDF dinamic

Dacă utilizați un serviciu de generare PDF, puteți:
  1. Mai întâi creați o acțiune HTTP Request pentru a genera PDF-ul
  2. Transmiteți URL-ul PDF returnat către funcția logică ca parametru

Pasul 4: Testați și activați

  1. Salvați fluxul de lucru
  2. Navigați la o înregistrare de tip Company
  3. Faceți clic pe meniul și selectați fluxul dvs. de lucru
  4. Verificați secțiunea Attachments din înregistrare pentru a confirma că PDF-ul a fost atașat
  5. Activați fluxul de lucru

Combinare cu servicii de generare PDF

Pentru crearea de oferte sau facturi dinamice:

Exemplu: Generați ofertă → Atașați PDF

Servicii populare de generare PDF

  • Carbone - Generare de documente pe bază de șabloane
  • PDFMonkey - Creare dinamică de PDF-uri din șabloane
  • DocuSeal - Platformă de automatizare a documentelor
  • Documint - Generare de documente orientată pe API
Fiecare serviciu oferă un API care returnează un URL către PDF, pe care îl puteți apoi transmite funcției logice.

Depanare

Conexe