Modèles de documents PDF pour les workflows HubSpot

L’écran Document templates est l’endroit où vous créez et gérez les modèles PDF que remplit l’action de workflow HubSpot Generate Document. Chaque modèle définit la mise en page d’un PDF et les propriétés de contact à y insérer.

Avant de commencer

Vous devez avoir le rôle Owner ou Admin. Les Members et les personnes ayant le rôle Billing voient une liste vide et ne peuvent pas ouvrir, créer ni modifier de modèles.
HubSpot doit être connecté à votre organisation. Voir Configuration de HubSpot.

Ouvrir Document templates

Sélectionnez Settings dans la barre latérale gauche, puis Document templates sous Integrations. L’écran comporte une liste Templates d’un côté et l’éditeur de modèles de l’autre. La liste affiche le nom de chaque modèle. Lorsqu’elle est vide, elle indique « No document templates yet. »

Créer un modèle

Saisissez un Name pour le modèle.
Rédigez le Template JSON. L’éditeur démarre avec un exemple que vous pouvez modifier.
Sélectionnez Create template.

La définition comprend un title de document facultatif et une liste de blocks, rendus de haut en bas. Un modèle doit contenir au moins un bloc et peut en compter jusqu’à 80.

Bloc	Rendu
`heading`	Une ligne de titre
`paragraph`	Un paragraphe de texte courant
`table`	Un tableau composé de lignes de cellules
`spacer`	Un espace vertical entre les blocs

Pour insérer une propriété de contact, placez un token de la forme contact.<property> entre doubles accolades, comme {{contact.firstname}}. Vous pouvez utiliser des tokens dans le titre, dans le texte des titres et des paragraphes, et dans les cellules de tableau. Lorsque l’action Generate Document s’exécute, Flowella remplace chaque token par la valeur du contact inscrit.

{
  "title": "Letter for {{contact.firstname}}",
  "blocks": [
    { "type": "heading", "text": "Hello {{contact.firstname}}" },
    { "type": "paragraph", "text": "Email: {{contact.email}}" },
    { "type": "spacer" },
    {
      "type": "table",
      "rows": [
        ["Name", "{{contact.firstname}} {{contact.lastname}}"],
        ["Phone", "{{contact.phone}}"]
      ]
    }
  ]
}

Si le JSON ne peut pas être lu, Flowella affiche « Template JSON is invalid » et ne l’enregistre pas.

Modifier ou supprimer un modèle

Sélectionnez le modèle dans la liste Templates. L’éditeur affiche son Name, son Template ID et son Template JSON.
Modifiez le nom ou le JSON, puis sélectionnez Save changes.

Pour commencer plutôt un nouveau modèle, sélectionnez New template. L’éditeur est alors vidé. Pour supprimer le modèle, sélectionnez Delete.

Delete supprime immédiatement le modèle, sans demander de confirmation. Tout workflow HubSpot qui utilise encore son ID échouera avec DOCUMENT_TEMPLATE_NOT_FOUND.

Utiliser un modèle dans HubSpot

Sélectionnez le modèle dans la liste Templates.
À côté de Template ID, sélectionnez Copy ID.
Dans votre workflow HubSpot, collez l’ID dans le champ Document template ID de l’action Generate Document.

Lorsque le workflow s’exécute, Flowella remplit le modèle avec les propriétés du contact inscrit et enregistre le PDF dans vos fichiers HubSpot en tant que fichier public : toute personne disposant du lien peut donc l’ouvrir. N’insérez pas de données personnelles sensibles dans les modèles de documents. L’action renvoie l’URL du fichier et l’ID du fichier HubSpot pour les étapes suivantes du workflow. Voir Generate Document pour les paramètres de l’action.

Si le document n’est pas créé

Lorsque l’action ne parvient pas à créer le PDF, l’étape du workflow échoue avec un code d’erreur :

Code d’erreur	Signification	Que faire
`DOCUMENT_TEMPLATE_NOT_FOUND`	Aucun modèle portant cet ID n’existe dans votre organisation. Il a peut-être été supprimé.	Copiez à nouveau l’ID depuis Document templates et collez-le dans l’action.
`DOCUMENT_TOKEN_MISSING`	Un token du modèle pointe vers une propriété de contact vide pour ce contact.	Renseignez la propriété dans HubSpot, ou retirez le token du modèle.
`HUBSPOT_NOT_CONNECTED`	Flowella ne parvient pas à joindre votre compte HubSpot.	Reconnectez HubSpot sous Settings, puis HubSpot.

Voir aussi

Generate Document (HubSpot)

L’action de workflow qui remplit ces modèles.

AI Document Reader (HubSpot)

L’action complémentaire qui lit des documents pour alimenter les propriétés de contact.

Premiers pas

Essentiels

Utiliser l'application

Paramètres

Configuration Meta et WhatsApp

Intégration HubSpot

Flows et campagnes

Référence API

Dépannage

Journal des modifications

Modèles de documents PDF pour les workflows HubSpot

Avant de commencer

Ouvrir Document templates

Créer un modèle

Modifier ou supprimer un modèle

Utiliser un modèle dans HubSpot

Si le document n’est pas créé

Voir aussi

Generate Document (HubSpot)

AI Document Reader (HubSpot)

​Avant de commencer

​Ouvrir Document templates

​Créer un modèle

​Modifier ou supprimer un modèle

​Utiliser un modèle dans HubSpot

​Si le document n’est pas créé

​Voir aussi

Generate Document (HubSpot)

AI Document Reader (HubSpot)

Avant de commencer

Ouvrir Document templates

Créer un modèle

Modifier ou supprimer un modèle

Utiliser un modèle dans HubSpot

Si le document n’est pas créé

Voir aussi