# Intégration Make : générer des documents


Le module PDFMonkey pour [Make](https://www.make.com/) vous permet de générer des documents dans le cadre de vos scénarios automatisés. Combinez-le avec des déclencheurs provenant de constructeurs de formulaires, de CRM ou de bases de données pour produire et envoyer des fichiers sans écrire de code.

## Configuration {#setup}

Avant de commencer, assurez-vous de disposer des éléments suivants :

- Un compte PDFMonkey ([inscription ici](https://dashboard.pdfmonkey.io/register))
- Un compte [Make](https://www.make.com/)
- Un modèle publié dans PDFMonkey

Pour la création de compte et la configuration d’un modèle, consultez [De zéro à votre premier document](../premiers-pas/de-zero-a-votre-premier-document.md).

Pour connecter PDFMonkey à Make, ajoutez le module PDFMonkey à votre scénario et cliquez sur **Create a connection**. Saisissez votre clé secrète API depuis la page [Mon compte](https://dashboard.pdfmonkey.io/account).

## Générer un document {#generate-a-document}

Ajoutez le module PDFMonkey **Generate a Document** à votre scénario. Sélectionnez votre Workspace et votre Template, puis associez les champs des modules précédents aux variables définies dans votre modèle.

![Mapping des champs PDFMonkey dans Make](../img/make-pdfmonkey-field-mapping.webp)

> [!NOTE]
> **Nommage des variables**
>
> Les noms de variables dans votre modèle doivent suivre des règles de formatage spécifiques. Consultez la référence sur le [nommage des variables](../modeles-code/definir-des-donnees-dynamiques.md#naming-your-variables) pour les formats corrects et incorrects.


Après l’exécution du module, celui-ci retourne les données du document généré, incluant l’[URL de téléchargement](../generation-de-documents/url-de-telechargement.md) et le nom du fichier.

![Résultat de la génération de document dans Make](../img/make-document-generated.webp)

## Utiliser le fichier généré {#working-with-the-generated-file}

### Télécharger le fichier {#downloading-the-file}

Pour utiliser le fichier généré dans les modules suivants, téléchargez-le d’abord. Ajoutez le module HTTP **Get a File** et passez-lui l’**URL de téléchargement** retournée par le module PDFMonkey.

![Configuration du module HTTP Get a File](../img/make-http-get-file.webp)

> [!TIP]
> L’URL de téléchargement expire après 1 heure. Si vous prévoyez de l’utiliser plus tard, téléchargez le fichier immédiatement ou envoyez-le vers un stockage permanent. Consultez [URL de téléchargement](../generation-de-documents/url-de-telechargement.md) pour plus de détails.


### Envoyer par e-mail {#sending-by-email}

Ajoutez le module de votre fournisseur d’e-mail (ou le module intégré **Send an email** de Make) et joignez le fichier téléchargé. Personnalisez le champ **File name** pour éviter le nom par défaut `file.pdf` ; le module PDFMonkey retourne un nom de fichier que vous pouvez utiliser directement.

![Configuration de la pièce jointe e-mail avec nom de fichier personnalisé](../img/make-email-attachment.webp)

> [!TIP]
> Vous pouvez aussi définir un [nom de fichier personnalisé](../generation-de-documents/nom-de-fichier-personnalise.md) dans PDFMonkey pour qu’il arrive avec un nom pertinent dans chaque scénario.


## Exemple : formulaire Tally vers document {#example-tally-form}

Cet exemple montre un scénario complet qui reçoit une soumission de formulaire [Tally](https://tally.so/), génère un document et l’envoie par e-mail.

### Le formulaire Tally {#the-tally-form}

Le scénario utilise un formulaire Tally comme source de données :

![Formulaire Tally utilisé comme trigger du scénario](../img/make-tally-form.webp)

### Configuration du trigger {#setting-up-the-trigger}

Créez un nouveau scénario avec le trigger **Watch New Responses** de Tally. Make crée une URL de webhook et l’associe automatiquement à votre formulaire Tally.

![Configuration du webhook Tally dans Make](../img/make-tally-webhook-setup.webp)

Envoyez une réponse de test et cliquez sur **Run once** pour vérifier la connexion :

![Bouton Run once dans le scénario Make](../img/make-run-once-trigger.webp)

![Données du trigger reçues depuis Tally](../img/make-trigger-data-received.webp)

### Association des champs et génération {#mapping-fields-and-generating}

Avec les données du trigger disponibles, configurez le module PDFMonkey pour associer les champs Tally aux variables de votre modèle, puis ajoutez les modules HTTP et e-mail comme décrit dans [Utiliser le fichier généré](#working-with-the-generated-file).

> [!WARNING]
> **Publiez toujours votre modèle**
>
> Si les documents générés ne correspondent pas à votre modèle, vérifiez que vous l’avez bien publié. Oublier de publier après des modifications est une erreur courante, surtout lorsque vous alternez entre Make et PDFMonkey.


## Résolution de problèmes {#troubleshooting}

### Échappement JSON {#json-escaping}

Le module Make envoie les données au format JSON. Si vos données contiennent des guillemets doubles ou des sauts de ligne, le JSON devient invalide. Par exemple, un nom comme `Peter "Spider-Man" Parker` casse la structure JSON.

Remplacez `"` par `\"` dans les valeurs pour échapper les guillemets doubles :

![Configuration de l’échappement JSON dans Make](../img/make-json-escaping.webp)

Les sauts de ligne (`\n`) nécessitent le même traitement : remplacez `\n` par `\\n` pour garder le JSON valide.

### Modèle non publié {#template-not-published}

Si les documents générés ne reflètent pas vos dernières modifications du modèle, la cause la plus probable est un modèle non publié. Ouvrez votre modèle dans PDFMonkey et cliquez sur **Publish** avant de relancer le scénario.

### URL de téléchargement expirée {#download-url-expired}

L’[URL de téléchargement](../generation-de-documents/url-de-telechargement.md) est valide pendant 1 heure. Si un module situé plus loin dans votre scénario échoue parce que l’URL a expiré, rapprochez l’étape HTTP **Get a File** du module PDFMonkey pour que le téléchargement se fasse immédiatement.

Pour plus de détails, consultez [L’URL de téléchargement retourne une erreur 403](../depannage/l-url-de-telechargement-renvoie-403.md).

## Prochaines étapes {#next-steps}

- [De zéro à votre premier document](../premiers-pas/de-zero-a-votre-premier-document.md) : créez votre compte PDFMonkey et votre premier modèle
- [Définir les données dynamiques](../modeles-code/definir-des-donnees-dynamiques.md) : apprenez à structurer le payload JSON de vos modèles
- [Nom de fichier personnalisé](../generation-de-documents/nom-de-fichier-personnalise.md) : contrôlez le nom des fichiers générés
- [Statuts des documents](../generation-de-documents/statuts-des-documents.md) : comprenez le cycle de vie d’un document généré
- [Webhooks](../generation-de-documents/webhooks.md) : recevez des notifications en temps réel lorsque des documents sont générés
- Explorez d’autres intégrations : [Zapier](./zapier.md), [n8n](./n8n.md), [Workato](./workato.md)
