Přehled
Tento pracovní postup používá Ruční spouštěč, takže uživatelé mohou na požádání vygenerovat PDF pro libovolný vybraný záznam. O zpracování se stará logická funkce:- Stažení PDF z adresy URL (ze služby pro generování PDF)
- Nahrání souboru do Twenty
- Vytvoření přílohy propojené se záznamem
Předpoklady
Než nastavíte pracovní postup:- Vytvořte klíč API: Přejděte do Nastavení → API a vytvořte nový klíč API. Tento token budete potřebovat pro logickou funkci.
- Nastavte službu pro generování PDF (volitelné): Pokud chcete dynamicky generovat PDF (např. nabídky), použijte službu jako Carbone, PDFMonkey nebo DocuSeal k vytvoření PDF a získání adresy URL pro stažení.
Nastavení krok za krokem
Krok 1: Nakonfigurujte spouštěč
- Přejděte na Pracovní postupy a vytvořte nový pracovní postup
- Vyberte Ruční spouštěč
- Zvolte objekt, ke kterému chcete připojovat PDF (např. Společnost nebo Příležitost)
Krok 2: Přidejte logickou funkci
- Přidejte akci Code (logická funkce)
- Vytvořte novou funkci pomocí kódu níže
- Nakonfigurujte vstupní parametry
Vstupní parametry
| Parametr | Hodnota |
|---|---|
companyId | {{trigger.object.id}} |
Pokud připojujete k jinému objektu (Osoba, Příležitost apod.), přejmenujte parametr podle toho (např.
personId, opportunityId) a aktualizujte logickou funkci.Kód logické funkce
Krok 3: Přizpůsobte pro svůj případ použití
Chcete-li připojit k jinému objektu
NahraďtetargetCompanyId příslušným polem:
| Objekt | Název pole |
|---|---|
| Společnost | targetCompanyId |
| Osoba | targetPersonId |
| Příležitost | targetOpportunityId |
| Vlastní objekt | targetYourCustomObjectId |
variables.data v mutaci přílohy.
Chcete-li použít dynamickou adresu URL PDF
Pokud používáte službu pro generování PDF, můžete:- Nejprve proveďte akci HTTP Request pro vygenerování PDF
- Předejte vrácenou adresu URL PDF logické funkci jako parametr
Krok 4: Otestujte a aktivujte
- Uložte pracovní postup
- Přejděte na záznam společnosti
- Klikněte na nabídku ⋮ a vyberte svůj pracovní postup
- Zkontrolujte v části Přílohy u záznamu, že bylo PDF připojeno
- Aktivujte pracovní postup
Kombinace se službami pro generování PDF
Pro vytváření dynamických nabídek nebo faktur:Příklad: Vygenerovat nabídku → Připojit PDF
| Krok | Akce | Účel |
|---|---|---|
| 1 | Ruční spouštěč (Společnost) | Uživatel spustí na záznamu |
| 2 | Vyhledat záznam | Získat podrobnosti o příležitosti nebo řádkové položce |
| 3 | HTTP požadavek | Zavolat API pro generování PDF s daty záznamu |
| 4 | Serverless funkce | Stáhnout a připojit vygenerované PDF |
Oblíbené služby pro generování PDF
- Carbone - Generování dokumentů založené na šablonách
- PDFMonkey - Dynamické vytváření PDF ze šablon
- DocuSeal - Platforma pro automatizaci dokumentů
- Documint - Generování dokumentů primárně přes API
Řešení potíží
| Problém | Řešení |
|---|---|
| ”Nepodařilo se stáhnout PDF” | Zkontrolujte, že adresa URL PDF je dostupná a vrací platné PDF |
| ”Nepodařilo se nahrát” | Ověřte, že váš klíč API je platný a má oprávnění k zápisu |
| ”Vytvoření přílohy se nezdařilo” | Ujistěte se, že název pole ID objektu odpovídá cílovému objektu |