Übersicht
Dieser Workflow verwendet einen Manuellen Auslöser, damit Benutzer bei Bedarf für jeden ausgewählten Datensatz ein PDF generieren können. Eine Logikfunktion übernimmt:- Das Herunterladen des PDFs von einer URL (von einem PDF-Generierungsdienst)
- Das Hochladen der Datei in Twenty
- Das Erstellen eines Anhangs, der mit dem Datensatz verknüpft ist
Voraussetzungen
Bevor Sie den Workflow einrichten:- API-Schlüssel erstellen: Gehen Sie zu Einstellungen → APIs und erstellen Sie einen neuen API-Schlüssel. Sie benötigen dieses Token für die Logikfunktion.
- Richten Sie einen PDF-Generierungsdienst ein (optional): Wenn Sie PDFs dynamisch generieren möchten (z. B. Angebote), verwenden Sie einen Dienst wie Carbone, PDFMonkey oder DocuSeal, um das PDF zu erstellen und eine Download-URL zu erhalten.
Schritt-für-Schritt-Einrichtung
Schritt 1: Trigger konfigurieren
- Gehen Sie zu Workflows und erstellen Sie einen neuen Workflow
- Wählen Sie Manueller Auslöser
- Wählen Sie das Objekt aus, dem Sie PDFs anhängen möchten (z. B. Company oder Opportunity)
Schritt 2: Logikfunktion hinzufügen
- Fügen Sie eine Code-Aktion (Logikfunktion) hinzu
- Erstellen Sie eine neue Funktion mit dem folgenden Code
- Konfigurieren Sie die Eingabeparameter
Eingabeparameter
| Parameter | Wert |
|---|---|
companyId | {{trigger.object.id}} |
Wenn Sie an ein anderes Objekt anhängen (Person, Opportunity usw.), benennen Sie den Parameter entsprechend um (z. B.
personId, opportunityId) und aktualisieren Sie die Logikfunktion.Code der Logikfunktion
Schritt 3: An Ihren Anwendungsfall anpassen
An ein anderes Objekt anhängen
Ersetzen SietargetCompanyId durch das entsprechende Feld:
| Objekt | Feldname |
|---|---|
| Unternehmen | targetCompanyId |
| Person | targetPersonId |
| Opportunity | targetOpportunityId |
| Benutzerdefiniertes Objekt | targetYourCustomObjectId |
variables.data in der Attachment-Mutation.
So verwenden Sie eine dynamische PDF-URL
Wenn Sie einen PDF-Generierungsdienst verwenden, können Sie:- Führen Sie zuerst eine HTTP-Request-Aktion aus, um das PDF zu generieren
- Übergeben Sie die zurückgegebene PDF-URL als Parameter an die Logikfunktion
Schritt 4: Testen und aktivieren
- Speichern Sie den Workflow
- Navigieren Sie zu einem Company-Datensatz
- Klicken Sie auf das ⋮-Menü und wählen Sie Ihren Workflow aus
- Überprüfen Sie im Datensatz den Bereich Attachments, um zu verifizieren, dass das PDF angehängt wurde
- Aktivieren Sie den Workflow
Kombination mit PDF-Generierungsdiensten
Zum Erstellen dynamischer Angebote oder Rechnungen:Beispiel: Angebot generieren → PDF anhängen
| Schritt | Aktion | Zweck |
|---|---|---|
| 1 | Manueller Auslöser (Company) | Benutzer initiiert am Datensatz |
| 2 | Datensatz suchen | Opportunity- oder Positionsdetails abrufen |
| 3 | HTTP-Anfrage | PDF-Generierungs-API mit Datensatzdaten aufrufen |
| 4 | Serverlose Funktion | Das generierte PDF herunterladen und anhängen |
Beliebte PDF-Generierungsdienste
- Carbone – Vorlagenbasierte Dokumentenerstellung
- PDFMonkey – Dynamische PDF-Erstellung aus Vorlagen
- DocuSeal – Plattform für Dokumentenautomatisierung
- Documint – API-first-Dokumentenerstellung
Fehlerbehebung
| Problem | Lösung |
|---|---|
| ”PDF konnte nicht heruntergeladen werden” | Prüfen Sie, ob die PDF-URL erreichbar ist und ein gültiges PDF zurückgibt |
| ”Upload fehlgeschlagen” | Stellen Sie sicher, dass Ihr API-Schlüssel gültig ist und Schreibberechtigungen hat |
| ”Anhangserstellung fehlgeschlagen” | Stellen Sie sicher, dass der Feldname der Objekt-ID mit Ihrem Zielobjekt übereinstimmt |