Le modèle a l'air correct dans l'éditeur. Le fichier fusionné ressort de travers.

Sur un mois de séances de configuration, les cinq mêmes causes reviennent sans cesse. Aucune ne se trouve là où on regarderait en premier, et une seule concerne vraiment le modèle. Voici chaque symptôme, ce qu'il faut vérifier avant de tout reconstruire, et la solution.

Four checks in order before rebuilding a template: source file, image URL, CRM payload, then template structure.

Le texte dépasse le bord de son encadré

Vous fusionnez une valeur longue dans une proposition Google Slides, et elle continue, bien au-delà de l'espace réservé et jusqu'en dehors de la diapositive.

La cause n'est pas votre modèle. L'API Google Slides n'a pas d'ajustement automatique, donc un encadré de texte garde la taille qui lui a été donnée et le contenu fusionné ne s'y adapte pas. Un point de friction qui tient sur deux lignes pour une opportunité et sur huit pour la suivante débordera systématiquement sur la seconde.

Le réflexe est de plafonner la longueur. Résistez. Une limite de caractères coupe en pleine phrase et livre à votre prospect une proposition qui s'arrête au milieu d'une idée, ce qui est pire qu'un problème de mise en page, car cela ressemble à de la négligence plutôt qu'à un bug.

Corrigez plutôt cela par la mise en page. Donnez à chaque élément de longueur variable sa propre diapositive, et à chaque espace réservé son propre nom : pain_point_1 sur la première diapositive, pain_point_2 sur la deuxième. Vous obtenez un résultat prévisible quelle que soit la longueur du contenu, et le deck se lit mieux du même coup. Trois points de friction sur trois diapositives valent mieux que trois points de friction qui se disputent une seule.

L'image n'apparaît pas du tout

Les images produit sont correctement configurées, la fusion se déroule sans erreur, et les images sont tout simplement absentes.

Vérifiez l'extension de fichier dans l'URL de l'image. Les URL d'images optimisées pour le web se terminent souvent en .webp, parfois avec une double extension comme image.jpeg.webp, parce qu'un CDN a converti l'original pour la vitesse de chargement. Ce format n'est pas pris en charge pour la fusion, donc la référence ne pointe vers rien et le document est généré sans elle. Rien n'est faux dans le modèle, et c'est exactement pour cela que ce cas coûte une après-midi entière aux gens.

Pointez la balise vers un format pris en charge. Lorsque l'URL cache un vrai JPEG sous le suffixe converti, il suffit souvent de retirer le .webp final pour faire revenir l'image.

Une image qui apparaît bien mais atterrit au mauvais endroit est un problème différent, avec une solution en un clic : elle est ancrée en "déplacer avec le texte" alors qu'elle devrait être "aligné sur le texte". L'ancrage détermine le comportement de l'image quand le contenu autour d'elle grandit, et le contenu fusionné grandit toujours.

Chaque ligne affiche la même description

Les lignes de détail se fusionnent, les quantités et les prix sont corrects, et chaque ligne répète exactement la même description.

Cela ressemble à un problème de données et ce n'en est généralement pas un. Vérifiez d'abord ce que le CRM envoie réellement avant de toucher à quoi que ce soit : si la source transmet des descriptions uniques par ligne, alors vos données sont correctes et la balise dans le modèle est en cause. Une balise peut être corrompue ou mal insérée d'une manière invisible sur la page, car elle continue de ressembler à la bonne balise.

Supprimez-la et réinsérez-la depuis le tableau source plutôt que de modifier le texte sur place. C'est toute la solution, et cela prend une dizaine de secondes une fois que vous savez de quel côté se trouve le problème.

Cette dernière partie est la vraie leçon. Confirmez quel côté est en cause avant de tout reconstruire, car reconstruire un modèle en réponse à un problème de données vous coûte une matinée et ne résout rien.

La mise en page s'effondre quand les champs fusionnent

Les lignes ne s'étendent pas pour s'adapter à leur contenu. Les encadrés sont légèrement décalés. Un encadré d'initiales dérive loin de la ligne à laquelle il appartient.

Recherchez les dessins. Un encadré ou un séparateur ajouté comme dessin casse la reconnaissance d'image dont dépend le mappage des champs, et empêche la hauteur des lignes de s'ajuster à leur contenu. Les dessins ressemblent à de la structure pour vous, et à une image pour l'automatisation.

Reconstruisez la structure sous forme de tableau. Les tableaux vous donnent le contrôle que vous attendiez des encadrés dessinés, plus des hauteurs de ligne qui s'ajustent d'elles-mêmes, et Insertion > Ligne vous donne des séparateurs qui se comportent correctement. Pour tout ce qui se répète, placez toutes les données d'un élément sur une seule ligne, sur autant de colonnes que nécessaire, et laissez les lignes s'empiler. Les tableaux imbriqués ne sont pas un moyen de contourner cela ; ils ne tiennent pas la route.

Le même planning de prestations présenté de trois façons : encadrés dessinés, le tableau qui les remplace, et le résultat fusionné avec des lignes ajustées à leur contenu.

Cela vaut la peine de reconstruire un contrat complexe de cette manière même quand l'original a l'air correct, car la défaillance n'apparaît qu'une fois que de vraies données de longueur variable commencent à arriver.

Le fichier était déjà cassé avant même de commencer

Les balises sont signalées comme invalides dès le premier import, ou la mise en forme est déjà de travers avant même d'avoir fusionné quoi que ce soit.

Vérifiez d'où vient le fichier source. Un PDF exporté par un assistant IA se convertit mal, tout comme n'importe quel PDF qui était un fichier Word dans une vie antérieure. La mise en page survit visuellement à l'export mais s'effondre structurellement, ce qui est la pire combinaison possible car le fichier a l'air correct à l'ouverture.

Faites-le d'abord passer par Google Drive. Importez l'original, ouvrez-le pour que Drive le convertisse en Google Doc, et utilisez ce Doc comme modèle. La mise en forme tient bon et la reconnaissance des balises fonctionne correctement.

Une dernière chose utile à savoir : une erreur "balises invalides" signifie souvent que le workflow pointe vers le mauvais fichier source, et non que les balises manquent. Vérifiez la source avant de partir à la recherche de la balise.

Une vérification de cinq minutes avant le décollage

Effectuez ces cinq contrôles sur un nouveau modèle avant de le déployer à grande échelle, en utilisant de vrais enregistrements plutôt qu'un cas de test bien propre. Fusionnez l'opportunité la plus longue que vous ayez, pas la plus soignée.

SymptômeÀ vérifier en premierSolution
Le texte dépasse son encadréLe contenu est-il de longueur variableUne diapositive par élément, des noms d'espace réservé uniques
Image manquanteL'extension de fichier de l'URLUtiliser un format pris en charge, pas un .webp converti
Image au mauvais endroitL'ancrageAligné sur le texte, pas déplacer avec le texte
Contenu de ligne répétéCe que le CRM envoieRéinsérer la balise depuis le tableau source
La mise en page s'effondreDes dessins dans la mise en pageReconstruire sous forme de tableau, Insertion > Ligne pour les séparateurs
Balises invalides à l'importD'où vient le fichier sourceConvertir d'abord en Google Doc dans Drive

Le fil conducteur des six : le modèle est rarement ce qui est réellement cassé. Le fichier source, l'URL de l'image, l'ancrage et les données du CRM échouent chacun d'une manière qui ressemble à un problème de modèle, et chacun se vérifie plus vite qu'une reconstruction.

Une fois le modèle qui fonctionne correctement, les guides de configuration sont la prochaine étape : comment configurer les balises de fusion HubSpot couvre bien la nomenclature et le mappage, les modèles Microsoft Word pour HubSpot couvrent le côté Word, et les lignes de détail HubSpot pour des devis précis couvre les lignes répétables à l'origine de la plupart des problèmes ci-dessus.

Questions fréquentes

Pourquoi mon texte fusionné dépasse-t-il de l'encadré dans Google Slides ?
L'API Google Slides ne peut pas ajuster le texte automatiquement, donc un encadré garde la taille qui lui a été donnée, peu importe la longueur de la valeur fusionnée. Donnez au contenu de longueur variable sa propre diapositive avec un espace réservé au nom unique, plutôt que de plafonner le nombre de caractères, ce qui coupe les phrases en deux.

Pourquoi des images manquent-elles dans mes documents générés ?
Le plus souvent, l'URL de l'image se termine en .webp, souvent avec une double extension comme image.jpeg.webp, après qu'un CDN l'a convertie pour la vitesse de chargement. Ce format ne fusionnera pas. Pointez la balise vers un format pris en charge, et vérifiez que l'image est ancrée en aligné sur le texte plutôt que réglée sur déplacer avec le texte.

Pourquoi toutes mes lignes de détail affichent-elles la même description ?
Vérifiez d'abord ce que le CRM envoie. Si la source transmet des descriptions uniques, c'est la balise dans le modèle qui est corrompue plutôt que les données qui sont fausses, et supprimer puis réinsérer la balise depuis le tableau source résout le problème.

Pourquoi les balises sont-elles signalées comme invalides dès l'import d'un modèle ?
Soit le fichier est un PDF exporté depuis un autre outil, qui se convertit mal, soit le workflow pointe vers le mauvais fichier source. Importez l'original dans Google Drive, ouvrez-le pour que Drive le convertisse en Google Doc, et utilisez-le comme modèle.

Si vous configurez des modèles à partir de vraies données CRM et que vous voulez éliminer ces défaillances dès le départ, partez d'un modèle qui fonctionne et fusionnez une opportunité réelle avant de le déployer auprès de toute l'équipe.