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:- Descărcarea PDF-ului dintr-un URL (de la un serviciu de generare PDF)
- Încărcarea fișierului în Twenty
- Crearea unui atașament asociat înregistrării
Cerințe
Înainte de a configura fluxul de lucru:- 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ă.
- 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
- Accesați Workflows și creați un nou flux de lucru
- Selectați Manual Trigger
- Alegeți obiectul la care doriți să atașați fișiere PDF (de ex., Companie sau Oportunitate)
Pasul 2: Adăugați o funcție logică
- Adăugați o acțiune Code (funcție logică)
- Creați o funcție nouă cu codul de mai jos
- Configurați parametrii de intrare
Parametri de intrare
| Parametru | Valoare |
|---|---|
companyId | {{trigger.object.id}} |
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țitargetCompanyId cu câmpul corespunzător:
| Obiect | Nume câmp |
|---|---|
| Companie | targetCompanyId |
| Persoană | targetPersonId |
| Oportunitate | targetOpportunityId |
| Obiect personalizat | targetYourCustomObjectId |
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:- Mai întâi creați o acțiune HTTP Request pentru a genera PDF-ul
- Transmiteți URL-ul PDF returnat către funcția logică ca parametru
Pasul 4: Testați și activați
- Salvați fluxul de lucru
- Navigați la o înregistrare de tip Company
- Faceți clic pe meniul ⋮ și selectați fluxul dvs. de lucru
- Verificați secțiunea Attachments din înregistrare pentru a confirma că PDF-ul a fost atașat
- 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
| Pas | Acțiune | Scop |
|---|---|---|
| 1 | Manual Trigger (Company) | Utilizatorul inițiază dintr-o înregistrare |
| 2 | Căutare înregistrare | Obțineți detalii despre Opportunity sau despre poziții |
| 3 | Solicitare HTTP | Apelați API-ul de generare PDF cu datele înregistrării |
| 4 | Funcție serverless | Descărcați și atașați PDF-ul generat |
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
Depanare
| Problemă | Soluție |
|---|---|
| ”Nu s-a reușit descărcarea PDF-ului” | Verificați că URL-ul PDF este accesibil și returnează un PDF valid |
| ”Nu s-a reușit încărcarea” | Verificați că cheia API este validă și are permisiuni de scriere |
| ”Nu s-a reușit crearea atașamentului” | Asigurați-vă că numele câmpului ID al obiectului corespunde obiectului țintă |