Générer un Document avec Zapier

PDFMonkey sur Zapier

L’intégration PDFMonkey pour Zapier propose un trigger Document Generated, une action Generate Document et une action Find Document. Cette recette utilise l’action Document Generated.

Notre cas d’exemple

Il est possible de générer un Document à partir de pratiquement n’importe quel événement Zapier. Pour illustrer cela nous allons voir un cas d’usage assez commun : réagir au trigger New Order de WooCommerce, générer un Document en utilisant des données issues de la commande et pour finir envoyer ce document en pièce jointe par email.

C’est parti !

Le trigger

Commençons par créer un Zap nommé Woo > PDFMonkey > Email et utilisons le trigger New Order de WooCommerce.

Générer le Document

L’étape suivante de notre workflow est la génération du Document en utilisant les données issues de la commande. Ajoutez l’action Generate Document de PDFMonkey.

Zapier vous demande ensuite de vous authentifier auprès de PDFMonkey. Pour ce faire, remplissez le champ présenté avec votre clé privée (vous trouverez celle-ci dans la page Mon compte du Tableau de bord).

Une fois authentifiés, vous pourrez sélectionner l’une de vos Apps et choisir le Modèle à utiliser.

Dans le champ Dynamic Data (JSON Payload), créez un mapping entre les données provenant de la commande WooCommerce et les noms de variables utilisés dans votre Modèle.

Attention de bien ajouter des guillemets autour des données dynamiques dans Zapier, le JSON sera incorrect sinon.

Vous pouvez, de façon facultative, ajouter des meta-données à votre Document. En particulier, vous pouvez faire usage de la clé spéciale _filename qui vous permet de personnaliser le nom du fichier généré :

Joindre le Document à un email

Une fois le document généré, vous avez accès à une URL de téléchargement valable 30s. Vous pouvez utiliser cette dernière pour récupérer le Document et le joindre à un email.

Vous pouvez également utiliser cette URL pour stocker le Document dans Dropbox (tutoriel Dropbox) ou Drive (tutoriel Drive).

Sélectionnez l’action Send Outbound Email et configurez les détails de l’email à envoyer.

Pour le champ Attachment, utilisez la propriété Download URL (valid for 30s) du Document généré. Cela permet à Zapier de télécharger le Document et de l’attacher en pièce jointe de l’email.

Continuez de remplir les champs pour personnaliser l’email.

Conclusion

Vous pouvez maintenant enregistrer votre Zap et l’activer.

Ce guide est un exemple démontrant comment générer un Document mais également comment ajouter d’autres actions à la suite. Vous pouvez connecter PDFMonkey avec n’importe quel service disponible sur Zapier. Amusez-vous avec et faites-nous part de ce que vous avez construit !

Problèmes

J’obtiens une réponse 422 quand j’éssaie de créer mon Document

Ce problème survient pour plusieurs variations de la même cause : un JSON incorrect.

Le cas le plus fréquent est un problème de formattage du contenu, assurez-vous qu’il ressemble à ceci :

{
  "someKey": "[DONNÉE DYNAMIQUE ZAPIER]",
  "otherKey": "[DONNÉE DYNAMIQUE ZAPIER]"
}

Notez les guillements autour des données dynamiques provenant de Zapier. Le contenu est une Objet JSON unique, pas un tableau ni une série d’Objets.

Une autre raison peut être la présence de sauts de ligne dans les données dynamiques utilisées. Par exemple un commentaire dans la commande ou quelque chose de similaire.

Dans ce cas, utilisez une action Formatter by Zapier > Text > Replace pour remplacer toute occurrence de \n par un texte vide. Utilisez ensuite les variables issues de cette transformation dans votre JSON.

Je ne peux pas utiliser le lien valable 30s dans un email

C’est voulu. PDFMonkey n’a pas vocation à devenir un outil de stockage, c’est pourquoi nous imposons cette limite de 30s.

Si vous souhaitez envoyer un lien plutôt qu’une pièce jointe, nous vous conseillons de stocker le fichier dans Dropbox (tutoriel Dropbox), Drive (tutoriel Drive) ou S3, récupérer un lien de partage et envoyer celui-ci.