Vue d’ensemble
Ce flux de travail utilise un Déclencheur manuel afin que les utilisateurs puissent générer un PDF à la demande pour tout enregistrement sélectionné. Une fonction logique gère :- Téléchargement du PDF depuis une URL (provenant d’un service de génération de PDF)
- Téléversement du fichier dans Twenty
- Création d’une pièce jointe liée à l’enregistrement
Prérequis
Avant de configurer le flux de travail :- Créer une clé API : Allez dans Settings → APIs et créez une nouvelle clé API. Vous aurez besoin de ce jeton pour la fonction logique.
- Configurer un service de génération de PDF (facultatif) : Si vous souhaitez générer des PDF dynamiquement (par exemple, des devis), utilisez un service comme Carbone, PDFMonkey ou DocuSeal pour créer le PDF et obtenir une URL de téléchargement.
Configuration pas à pas
Étape 1 : Configurer le déclencheur
- Allez dans Flux de travail et créez un nouveau flux de travail
- Sélectionnez Déclencheur manuel
- Choisissez l’objet auquel vous souhaitez joindre des PDF (par exemple, Entreprise ou Opportunité)
Étape 2 : Ajouter une fonction logique
- Ajoutez une action Code (fonction logique)
- Créez une nouvelle fonction avec le code ci-dessous
- Configurez les paramètres d’entrée
Paramètres d’entrée
| Paramètre | Valeur |
|---|---|
companyId | {{trigger.object.id}} |
Si vous l’attachez à un objet différent (Personne, Opportunité, etc.), renommez le paramètre en conséquence (par exemple,
personId, opportunityId) et mettez à jour la fonction logique.Code de la fonction logique
Étape 3 : Personnaliser selon votre cas d’utilisation
Pour joindre à un objet différent
RemplacezcompanyId par le champ approprié :
| Objet | Nom du champ |
|---|---|
| Entreprise | companyId |
| Personne | personId |
| Opportunité | opportunityId |
| Objet personnalisé | yourCustomObjectId |
variables.data dans la mutation de pièce jointe.
Pour utiliser une URL de PDF dynamique
Si vous utilisez un service de génération de PDF, vous pouvez :- Commencez par créer une action HTTP Request pour générer le PDF
- Transmettez l’URL du PDF retournée à la fonction logique en tant que paramètre
Étape 4 : Tester et activer
- Enregistrez le flux de travail
- Accédez à un enregistrement d’Entreprise
- Cliquez sur le menu ⋮ et sélectionnez votre flux de travail
- Vérifiez la section Pièces jointes de l’enregistrement pour confirmer que le PDF a été joint
- Activez le flux de travail
Combiner avec des services de génération de PDF
Pour créer des devis ou des factures dynamiques :Exemple : Générer un devis → Joindre le PDF
| Étape | Action | Objectif |
|---|---|---|
| 1 | Déclencheur manuel (Entreprise) | L’utilisateur lance l’action depuis un enregistrement |
| 2 | Rechercher un enregistrement | Obtenir les détails de l’Opportunité ou des lignes d’articles |
| 3 | Requête HTTP | Appeler l’API de génération de PDF avec les données de l’enregistrement |
| 4 | Fonction sans serveur | Télécharger et joindre le PDF généré |
Services populaires de génération de PDF
- Carbone - Génération de documents basée sur des modèles
- PDFMonkey - Création de PDF dynamiques à partir de modèles
- DocuSeal - Plateforme d’automatisation de documents
- Documint - Génération de documents axée sur l’API
Résolution des problèmes
| Problème | Solution |
|---|---|
| ”Échec du téléchargement du PDF” | Vérifiez que l’URL du PDF est accessible et renvoie un PDF valide |
| ”Échec du téléversement” | Vérifiez que votre clé API est valide et dispose des autorisations d’écriture |
| ”Échec de la création de la pièce jointe” | Assurez-vous que le nom du champ d’ID d’objet correspond à votre objet cible |