Hoe je HubSpot merge tags instelt zodat je documenten écht werken

Je hebt de template gebouwd. Het ontwerp zag er geweldig uit. Toen drukte de eerste echte offerte een leeg totaalbedrag af en de verkeerde bedrijfsnaam. Niet omdat de template slecht was, maar omdat de tags niet klopten.

Dit komt vaker voor dan je denkt. De tags zijn de bedrading tussen jouw HubSpot CRM en het bestand dat je klant opent. Zorg dat ze kloppen, en documenten vullen zichzelf met live data. Zorg dat ze niet kloppen, en je stuurt verzorgde pdf's met beschamende lege plekken die niemand opmerkt totdat de koper dat wel doet.

Dit is de checklist die ik doorloop voordat ik data merge opschaal over meerdere reps. Naamgeving, objecten, regelitems, aangepaste eigenschappen en testen. Geen theorie, alleen wat er in de praktijk misgaat en hoe je dat voorkomt.

Voor het volledige overzicht van hoe documentgeneratie, data merge en eSignature samenkomen in HubSpot, zie the complete guide to document automation in HubSpot.

Waarom tagnaamgeving je eerste echte beslissing is

Elke tag is een belofte. Ze zegt: "dit veld in het document verwijst altijd naar dit veld op dit object." Zodra je per template namen begint te verzinnen, verlies je de mogelijkheid om blokken te hergebruiken, bij te houden wat er is samengevoegd, of iemand nieuw in te werken zonder een schattenjacht.

Ik gebruik standaard een eenvoudige regel. Gebruik het object en de interne naam van het veld in een voorspelbaar patroon, schrijf het in kleine letters waar je tooling dat toelaat, en spiegel wat je ziet in de HubSpot-eigenschapsinstellingen. Als je team hardop "deal dot close date" zegt, moet de tag in het bestand er precies zo uitzien, of je nu Google Docs of Microsoft Word.

gebruikt. Houd één bron van waarheid bij voor je tags. Een spreadsheet met drie kolommen is genoeg: leesbaar label, interne eigenschapsnaam en een voorbeeldwaarde uit een sandbox-deal.

Als marketing een label in HubSpot hernoemt, blijft de interne naam meestal ongewijzigd. Je document blijft dan werken. Maar als iemand deal_amount_v2 aanmaakt omdat ze haast hebben, worden je oude templates niet automatisch bijgewerkt. Een gedeelde lijst die je ook echt bijhoudt, is altijd beter dan individuele heldendaden.

Deal-, contact- en bedrijfsvelden overzichtelijk koppelen

De meeste klantgerichte documenten bestaan eigenlijk uit drie verhalen die aan elkaar zijn genaaid. De deal bevat de commerciële waarheid: bedragen, sluitingsdata, onderhandelde voorwaarden. Het bedrijf bevat de juridische identiteit: geregistreerde naam, factuuradres, btw-nummers.

Het contact bevat de mensen: wie tekent, wie de pdf ontvangt, telefoonnummers voor de begeleidende brief.

Ik begin templates door per alinea vast te leggen welk object eigenaar is van die informatie. Als twee alinea's de juridische naam van het bedrijf nodig hebben, moeten beide verwijzen naar hetzelfde bedrijfsveld en niet naar een dealveld dat iemand vorig kwartaal handmatig heeft ingetypt. Dubbele bronnen zijn hoe "Acme LLC" en "Acme Limited" in hetzelfde documentpakket terechtkomen.

Let op het verschil tussen het primaire bedrijf en het gekoppelde bedrijf op het contact, en welk bedrijf er daadwerkelijk aan de deal is gekoppeld. HubSpot-koppelingen zijn krachtig en makkelijk subtiel verkeerd in te stellen.

Als je het niet zeker weet, genereer dan vanuit de deal en haal het bedrijf op via de koppeling die je ops-team als de juiste beschouwt. Als je dat nog niet hebt vastgesteld, doe dat dan voordat je bedragen op briefpapier afdrukt.

Bepaal voor contacten welke rol elke tag veronderstelt. Facturatiecontact, ondertekenaar en sponsor zijn niet altijd dezelfde persoon. Als je zomaar contact samenvoegt zonder erover na te denken, adresseer je de factuur misschien aan degene die het record als laatste heeft geopend. Gebruik expliciete velden of op koppelingen gebaseerde logica, zodat de template aangeeft wie je echt bedoelt.

Regelitems en herhaalbare rijen in HubSpot-backed templates

Regelitems zijn het punt waar een mooi ontwerp de operationele realiteit ontmoet. Je tabel verwacht misschien één bundelrij met een lange omschrijving, of tien SKU-rijen met smalle kolommen. HubSpot slaat gestructureerde rijen op met hoeveelheid, prijs, korting en productmetadata. Je template moet uitgaan van die structuur en niet van een alinea die iemand in een dealnoot heeft geplakt.

Voordat je data merge de schuld geeft, open dan vijf gewonnen deals en vijf open deals en vergelijk hoe volledig de regelitems zijn. Je zult handmatige invoer tegenkomen, gearchiveerde producten die nog steeds worden gebruikt, en kortingen die als notities zijn ingevoerd in plaats van als getallen.

Schone productdata en training van reps zijn net zo belangrijk als de tagsyntaxis. Portant haalt live CRM-data op, wat betekent dat het ook rommelige CRM-data trouw weergeeft. Dat is juist goed, want het dwingt je de bron te verbeteren.

Als je de tabel ontwerpt, laat dan ruimte voor lange productnamen en cellen die tekst kunnen afbreken. Test met je langste SKU-titel. Test met één regelitem en met twintig.

Lege tabellen moeten een duidelijke foutmelding geven in je proces en niet stilletjes naar een klant worden verzonden. Sommige teams voegen een workflowcontrole toe zodat deals zonder regelitems geen offerte kunnen genereren. Dat is een productbeslissing, maar het begint met eerlijk testen.

Aangepaste eigenschappen en interne labels

Aangepaste eigenschappen werken op dezelfde manier bij data merge, zolang je interne namen gebruikt en weet op welk object ze staan. Een veld dat op de deal is aangemaakt, bestaat niet op het contact. Punt.

De meest voorkomende fout die ik zie, is een prachtig genoemde eigenschap "Signer title" die op het contact staat, terwijl de template die probeert uit te lezen vanuit de deal. Die samenvoeging zal altijd leeg zijn, en niemand merkt het totdat een klant dat wel doet.

Keuzelijsten vereisen discipline. Als juridische zaken "Net 30" verwacht maar een oude waarde "Net30" nog steeds bestaat op oude deals, zullen je voorwaardelijke regels en je tags niet overeenkomen. Voer een opschoning van de eigenschap uit, migreer de waarden en voorkom nieuwe rommel aan de bron. Lees voor een volledige CRM-controle How to audit your HubSpot data so every sales document goes out right. Dit past goed bij templatewerk.

Geïntegreerde systemen die HubSpot-eigenschappen schrijven, kunnen vertraging hebben of waarden overschrijven. Als een veld eigendom is van je ERP, spreek dan af of sales het mag bewerken en wat het document moet doen als de synchronisatie leeg is.

Soms is het juiste antwoord: "niet genereren totdat het is ingevuld." Soms is het: "toon een fallbackregel." Beide zijn prima. Een verrassing niet.

Output testen voordat je opschaalt

Testen is niet het genereren van één perfecte demodeal uit de kickoff-workshop. Testen is een kleine matrix van lelijke realiteit.

Ik bewaar een set sandbox-deals met: een lange internationale bedrijfsnaam, een ontbrekend optioneel veld dat ik weet dat reps overslaan, een zwaar kortingsregel, een bundel met bijlagen, en een deal die elke aangepaste eigenschap gebruikt waarnaar de template verwijst.

Genereer voor elk geval de pdf- of Doc-uitvoer en lees die als een klant. Niet als de persoon die de template heeft gebouwd. Controleer kop- en voetteksten, pagina-einden binnen tabellen, valutaopmaak en lege regels waar een null doorheen is geslipt.

Als iets er niet goed uitziet, herstel dan de CRM-regel of de tag. Pas de verwachtingen van de klant niet aan.

Leg defecten vast in gewone taal gekoppeld aan record-ID's. Je toekomstige zelf zal zich niet meer herinneren waarom je op een dinsdag een tag hebt gewijzigd. Een korte notitie zoals "factureringsstad omgewisseld naar het adresveld van het gekoppelde bedrijf, deal 12345" bespaart uren.

Als je een breder beeld wilt van wat teams struikelt tijdens de uitrol, lees dan Document automation setup mistakes I see over and over. De helft ervan duikt voor het eerst op tijdens het testen.

Voorwaardelijke logica en wanneer je vertakkingen maakt in templates

Niet elke alinea hoort bij elke deal. MSA's hebben mogelijk alleen een bijlage nodig voor enterprise-niveaus. Servicetekst kan afhangen van een keuzelijst. Dat is waar conditional logic zijn waarde bewijst.

Het patroon dat ik prettig vind, is eenvoudig. Stuur zichtbaarheid aan op basis van expliciete HubSpot-velden, niet op basis van gissingen in vrije tekst. Booleans en gecontroleerde keuzelijsten zijn makkelijker te testen dan open notities.

Documenteer de regels naast de template. Als deal.segment gelijk is aan "Enterprise," toon dan schema A. Als het veld leeg is, gebruik dan het standaardschema als standaard en markeer de deal voor beoordeling. Ambiguïteit in je logica wordt later ambiguïteit in je omzetverantwoording en niet alleen een vreemde pdf.

Conditionals maken slechte data ook sneller zichtbaar dan standaard tags, wat eigenlijk nuttig is. Als een branch nooit wordt geactiveerd, weet je dat je veld altijd leeg is. Herstel het veld of verwijder de branch zodat medewerkers niet denken dat ze iets hebben verstuurd dat ze niet hebben verstuurd.

Google Docs, Word en één tagvocabulaire bijhouden

De meeste teams standaardiseren op Google Docs of Microsoft Word voor het maken van sjablonen. Het doel is hetzelfde: één vocabulaire van tags die je CRM invult. Kies de editor die je juridische en marketingteams daadwerkelijk zullen onderhouden, en bescherm de taglijst als een gedeeld bedrijfsmiddel.

Welke editor je ook kiest, dupliceer hetzelfde veld niet onder twee verschillende tagspellingen in verschillende bestanden. Als prijsinformatie in deal.amount staat in één sjabloon en een typfout-variant in een ander, stuur je beide versies mee totdat iemand het opmerkt in een klantgesprek. Centraliseer startdocumenten zodat mensen goedgekeurde blokken kopiëren in plaats van nieuwe te bedenken.

Versiebeheer is hier ook belangrijk. Wanneer finance de betalingsvoorwaarden bijwerkt, moet je weten welke sjabloonversies live zijn en welke historische PDF welke formulering gebruikte. Tags lossen versiebeheer niet zelfstandig op, maar consistente naamgeving maakt het bijhouden van wijzigingen een stuk eenvoudiger.

Veelgestelde vragen

Hoe moet ik tags benoemen in HubSpot-documentsjablonen?

Gebruik een consistent patroon zoals object punt interne naam, bijvoorbeeld deal.amount en contact.email. Houd de schrijfwijze consistent in alle sjablonen, leg de lijst vast in een gedeeld overzicht en vermijd afkortingen die maar één persoon begrijpt.

Van welke HubSpot-objecten halen de meeste verkoopsjablonen gegevens op?

De meeste offertes en voorstellen halen dealvelden op voor commerciële voorwaarden, bedrijfsvelden voor juridische identiteit en adresblokken, contactvelden voor ondertekenaars en leveringsgegevens, en regelitems voor SKU-tabellen en totalen.

Hoe verschijnen HubSpot-regelitems in geautomatiseerde documenten?

Regelitems worden samengevoegd als gestructureerde rijen, zodat hoeveelheid, stuksprijs, omschrijving en kortingen in tabellen kunnen worden ingevuld. De nauwkeurigheid hangt af van schone producten, consistente eenheden en deals die de regelitems bevatten die je verwacht op het moment van genereren.

Werken aangepaste eigenschappen op dezelfde manier als standaard HubSpot-velden in tags?

Ja, als de eigenschap bestaat op het object dat je samenvoegt en je de interne API-naam gebruikt. Let op keuzelijstwaarden, verplichte regels en velden die eigendom zijn van integraties die mogelijk leeg of verouderd zijn voor bepaalde records.

Wat is de veiligste manier om tags te testen voordat je ze uitrolt naar het hele team?

Maak een kleine testmatrix van deals met randgevallen zoals lange bedrijfsnamen, ontbrekende optionele velden, kortingen en meerdelige bundels. Genereer documenten van elk geval en herstel naamgeving of CRM-regels voordat je medewerkers op grote schaal traint.