Skip to main content
Générez ou récupérez automatiquement un PDF et joignez-le à un enregistrement dans Twenty. Cette fonctionnalité est couramment utilisée pour créer des devis, des factures ou des rapports liés aux Entreprises, aux Opportunités ou à d’autres objets.

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 :
  1. Téléchargement du PDF depuis une URL (provenant d’un service de génération de PDF)
  2. Téléversement du fichier dans Twenty
  3. Création d’une pièce jointe liée à l’enregistrement

Prérequis

Avant de configurer le flux de travail :
  1. 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.
  2. 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

  1. Allez dans Flux de travail et créez un nouveau flux de travail
  2. Sélectionnez Déclencheur manuel
  3. Choisissez l’objet auquel vous souhaitez joindre des PDF (par exemple, Entreprise ou Opportunité)
Avec un déclencheur manuel, les utilisateurs peuvent exécuter ce workflow en utilisant un bouton qui apparaît en haut à droite une fois qu’un enregistrement est sélectionné — cela exécute le workflow pour générer et joindre un PDF.

Étape 2 : Ajouter une fonction logique

  1. Ajoute une action Code (fonction logique)
  2. Créez une nouvelle fonction avec le code ci-dessous
  3. Configurez les paramètres d’entrée

Paramètres d’entrée

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

Remplacez targetCompanyId par le champ approprié : Mettez à jour à la fois le paramètre de la fonction et l’objet 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 :
  1. Commencez par créer une action HTTP Request pour générer le PDF
  2. Transmettez l’URL du PDF retournée à la fonction logique en tant que paramètre

Étape 4 : Tester et activer

  1. Enregistrez le flux de travail
  2. Accédez à un enregistrement d’Entreprise
  3. Cliquez sur le menu et sélectionnez votre flux de travail
  4. Vérifiez la section Pièces jointes de l’enregistrement pour confirmer que le PDF a été joint
  5. 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

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
Chaque service fournit une API qui retourne une URL PDF, que vous pouvez ensuite passer à la fonction logique.

Résolution des problèmes

Articles connexes