Samenvoeg velden (merge fields) overzicht
Merge fields helpen je om berichten en documenten te personaliseren door automatisch opgeslagen gegevens in te voegen, zoals de naam van een contact, het e-mailadres van de toegewezen gebruiker, afspraaktijden of factuurtotalen. Wanneer een bericht wordt verzonden of een document wordt gegenereerd, wordt elk merge field vervangen door de bijbehorende waarde voor die specifieke ontvanger of dat specifieke record. Zo houd je communicatie consistent en voorkom je fouten in e-mails, sms’jes, facturen, campagnes en geautomatiseerde workflows.
Let op ‘Raw’-telefoonnummernotatie: telefoonvelden in raw-notatie halen spaties, haakjes en streepjes weg. Raw is vooral handig als je telefoonnummers gebruikt in links, tracking-parameters of internationale notaties.
Contact merge fields
Deze velden halen informatie op uit het contactrecord. Je gebruikt ze vaak voor begroetingen, bevestigingen en persoonlijke follow-ups.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Volledige naam | {{contact.name}} | Jane Smith |
| Voornaam | {{contact.first_name}} | Jane |
| Achternaam | {{contact.last_name}} | Smith |
| {{contact.email}} | jane@smith.com | |
| Telefoon | {{contact.phone}} | (515) 555-2345 |
| Telefoon (raw-notatie) | {{contact.phone_raw}} | +15155552345 |
| Bedrijfsnaam | {{contact.company_name}} | Smith Plumbing |
| Volledig adres | {{contact.full_address}} | 1234 W. Main St, Chicago, IL 60657 |
| Adresregel 1 | {{contact.address1}} | 1234 W. Main St |
| Plaats | {{contact.city}} | Chicago |
| Staat/Regio | {{contact.state}} | Illinois |
| Postcode | {{contact.postal_code}} | 60657 |
| Tijdzone | {{contact.timezone}} | GMT-06:00 America/Chicago |
| Geboortedatum | {{contact.date_of_birth}} | Jan 3, 1980 |
| Bron | {{contact.source}} | Referral |
| Website | {{contact.website}} | www.example.com |
| Contact-ID | {{contact.id}} | FZDn5mYlkZuCCQe5Bep8 |
Gebruiker merge fields
Deze velden halen informatie op over de toegewezen gebruiker (of afzender) die gekoppeld is aan de activiteit, het gesprek of de afspraak.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Volledige naam | {{user.name}} | John Doe |
| Voornaam | {{user.first_name}} | John |
| Achternaam | {{user.last_name}} | Doe |
| {{user.email}} | john@doe.com | |
| Telefoon | {{user.phone}} | (333) 555-9876 |
| Telefoon (raw-notatie) | {{user.phone_raw}} | +13335559876 |
| E-mailsignatuur | {{user.email_signature}} | John Doejohn@doe.com(333) 555-9876 |
| Boekingslink | {{user.calendar_link}} | https://booking.example.com/schedule/john-doe |
| Telefoon van afspraakgebruiker (raw) | {{appointment.user.phone_raw}} | +13335559876 |
| Extern belnummer | {{user.call_provider_phone_number}} | (234) 555-9876 |
| Extern belnummer (raw) | {{user.call_provider_phone_number_raw}} | +12345559876 |
Afspraak merge fields
Deze velden halen details op uit een afspraakrecord. Je gebruikt ze vaak in bevestigingen, reminders en berichten om te verzetten.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Titel | {{appointment.title}} | Appointment with Bob |
| Startdatum/-tijd | {{appointment.start_time}} | Wed, Nov 5, 2025 3:30 PM |
| Alleen startdatum | {{appointment.only_start_date}} | Nov 5, 2025 |
| Alleen starttijd | {{appointment.only_start_time}} | 3:30 PM |
| Einddatum/-tijd | {{appointment.end_time}} | Wed, Nov 5, 2025 4:00 PM |
| Alleen einddatum | {{appointment.only_end_date}} | Nov 5, 2025 |
| Alleen eindtijd | {{appointment.only_end_time}} | 4:00 PM |
| Dag van de week | {{appointment.day_of_week}} | Monday |
| Maandnummer | {{appointment.month}} | 11 |
| Tijdzone | {{appointment.timezone}} | CST |
| Annuleringslink | {{appointment.cancellation_link}} | https://booking.example.com/cancel?event_id=123 |
| Link om te verzetten | {{appointment.reschedule_link}} | https://booking.example.com/reschedule?event_id=123 |
| Meetinglocatie | {{appointment.meeting_location}} | 123 W Main St, Chicago, IL 60657 |
| Notities | {{appointment.notes}} | This is our second meeting. |
| Link om toe te voegen aan agenda | {{appointment.add_to_calendar}} | https://booking.example.com/add-to-calendar?event_id=123 |
| Google Calendar-link | {{appointment.add_to_google_calendar}} | https://booking.example.com/google/calendar/add-event/calendarid |
| iCal/ICS-link | {{appointment.add_to_ical}} | https://booking.example.com/get-ics?event_id=123 |
| Herhaling (recurring repeats) | {{appointment.recurring.repeats}} | 0 |
| Aantal herhalingen | {{appointment.recurring.times_to_repeat}} | 1 |
| Naam toegewezen gebruiker | {{appointment.user.name}} | John Doe |
| E-mail toegewezen gebruiker | {{appointment.user.email}} | john@doe.com |
| Telefoon toegewezen gebruiker | {{appointment.user.phone}} | (333) 555-9876 |
| Telefoon toegewezen gebruiker (raw) | {{appointment.user.phone_raw}} | +13335559876 |
| Signatuur toegewezen gebruiker | {{appointment.user.email_signature}} | John Doejohn@doe.com |
Agenda (Calendar) merge fields
Deze velden halen details op uit de agenda (Calendar) die bij de afspraak is gekoppeld.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Agendanaam | {{calendar.name}} | Lawn Services Calendar |
Campagne merge fields
Deze velden ondersteunen geplande campagne-events en timing-variabelen.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Eventdatum/-tijd | {{campaign.event_date_time}} | Nov 5, 2025 3:30 PM |
| Eventdatum | {{campaign.event_date}} | Nov 5, 2025 |
| Eventtijd | {{campaign.event_time}} | 3:30 PM |
Bericht (Message) merge fields
Deze velden zijn handig als je in een workflow of automatisering naar de inhoud van een bericht wilt verwijzen.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Berichttekst | {{message.body}} | Hi, just a quick reminder about our call tomorrow morning. |
| Onderwerp | {{message.subject}} | Meeting Reminder |
Account merge fields
Deze velden halen bedrijfs- of accountdetails op. Je gebruikt ze vaak voor branding, receipts en standaard bedrijfsgegevens.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Accountnaam | {{account.name}} | WidgetWorks |
| Volledig adres | {{account.full_address}} | 555 Oak St, Tampa, FL 33602 |
| Adresregel 1 | {{account.address}} | 555 Oak St |
| Plaats | {{account.city}} | Tampa |
| Staat/Regio | {{account.state}} | Florida |
| Land | {{account.country}} | US |
| Postcode | {{account.postal_code}} | 33602 |
| {{account.email}} | name@domain.com | |
| Telefoon | {{account.phone}} | (333) 555-3344 |
| Telefoon (raw-notatie) | {{account.phone_raw}} | +13335553344 |
| Website | {{account.website}} | mywebsiteurl.com |
| Logo-URL | {{account.logo_url}} | https://files.example.com/logo.png |
| Voornaam gebruiker | {{account_owner.first_name}} | Lisa |
| Achternaam gebruiker | {{account_owner.last_name}} | White |
| E-mail gebruiker | {{account_owner.email}} | lisa@white.com |
| Account-ID | {{account.id}} | DP4mTqaz7L9XpweFvRjC |
Right Now merge fields
Deze velden voegen de actuele tijdwaarden in op het moment dat het bericht wordt gegenereerd.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Seconde | {{right_now.second}} | 9 |
| Minuut | {{right_now.minute}} | 10 |
| Uur (24u) | {{right_now.hour}} | 14 |
| Uur (AM/PM) | {{right_now.hour_ampm}} | 2 |
| AM/PM | {{right_now.ampm}} | PM |
| Dag van de week | {{right_now.day_of_week}} | Tuesday |
| Maandnaam | {{right_now.month_name}} | November |
| Dag | {{right_now.day}} | 4 |
| Maand (nummer) | {{right_now.month}} | 11 |
| Jaar | {{right_now.year}} | 2025 |
| Datum (MM/DD/YYYY) | {{right_now.middle_endian_date}} | 11/4/2025 |
| Datum (DD/MM/YYYY) | {{right_now.little_endian_date}} | 4/11/2025 |
Attribution merge fields
Deze velden ondersteunen trackingdetails die gekoppeld zijn aan de eerste en meest recente attribution-bron van een contact. Waarden komen vaak uit tracking-parameters die in links worden meegegeven.
Eerste attribution
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Sessiesource | {{contact.attributionSource.sessionSource}} | Referral |
| Landing-URL | {{contact.attributionSource.url}} | https://example.com/form?utm_source=ads |
| Campagne | {{contact.attributionSource.campaign}} | fall_sale |
| UTM source | {{contact.attributionSource.utmSource}} | ads |
| UTM medium | {{contact.attributionSource.utmMedium}} | banner |
| UTM content | {{contact.attributionSource.utmContent}} | ad12 |
| Referrer | {{contact.attributionSource.referrer}} | https://referrer.example.com |
| Campaign ID | {{contact.attributionSource.campaignId}} | 23849260571384729 |
| Ad click ID | {{contact.attributionSource.clickId}} | ABC123XYZ |
| UTM keyword | {{contact.attributionSource.utmKeyword}} | running_shoes |
| UTM match type | {{contact.attributionSource.utmMatchType}} | exact |
| Ad group ID | {{contact.attributionSource.adGroupId}} | 123456 |
| Ad ID | {{contact.attributionSource.adId}} | 78910 |
Meest recente attribution
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Sessiesource | {{contact.lastAttributionSource.sessionSource}} | Referral |
| Landing-URL | {{contact.lastAttributionSource.url}} | https://example.com/form?utm_source=ads |
| Campagne | {{contact.lastAttributionSource.campaign}} | xmas_sale |
| UTM source | {{contact.lastAttributionSource.utmSource}} | ads |
| UTM medium | {{contact.lastAttributionSource.utmMedium}} | banner |
| UTM content | {{contact.lastAttributionSource.utmContent}} | ad18 |
| Referrer | {{contact.lastAttributionSource.referrer}} | https://referrer.example.com |
| Campaign ID | {{contact.lastAttributionSource.campaignId}} | 23850176293047583 |
| Ad click ID | {{contact.lastAttributionSource.clickId}} | XYZ789ABC |
| UTM campaign | {{contact.lastAttributionSource.utmCampaign}} | blowout_sale |
| UTM keyword | {{contact.lastAttributionSource.utmKeyword}} | hvac_repair |
| UTM match type | {{contact.lastAttributionSource.utmMatchType}} | broad |
| Ad group ID | {{contact.lastAttributionSource.adGroupId}} | 654321 |
| Ad ID | {{contact.lastAttributionSource.adId}} | 10987 |
Factuur (Invoice) merge fields
Deze velden halen waarden op uit factuurrecords. Je gebruikt ze vaak in facturen, receipts, betaalbevestigingen en betaalreminders.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Factuurnaam | {{invoice.name}} | Consulting Contract |
| Factuurnummer | {{invoice.number}} | 43255 |
| Datum van uitgifte | {{invoice.issue_date}} | 2025-04-05 |
| Vervaldatum | {{invoice.due_date}} | 2025-10-05 |
| Subtotaal | {{invoice.sub_total}} | $500.00 |
| Kortingsbedrag | {{invoice.discount_amount}} | $50.00 |
| Belastingbedrag | {{invoice.tax_amount}} | $25.00 |
| Totaalbedrag | {{invoice.total_amount}} | $475.00 |
| Factuurtitel | {{invoice.title}} | Consulting Invoice |
| Factuurlink | {{invoice.url}} | https://pay.example.com/invoice/abc123 |
Bedrijfsgegevens (Company Details)
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Bedrijfsnaam | {{invoice.company.name}} | Test Solutions |
| Bedrijfstelefoon | {{invoice.company.phone}} | (888) 555-9876 |
| Bedrijfsadres | {{invoice.company.address}} | 1234 Maple St |
| Bedrijf plaats | {{invoice.company.city}} | Milwaukee |
| Bedrijf staat | {{invoice.company.state}} | Wisconsin |
| Bedrijf land | {{invoice.company.country}} | US |
| Bedrijfswebsite | {{invoice.company.website}} | www.example.com |
| Bedrijfslogo-URL | {{invoice.company.logo}} | https://files.example.com/logo.png |
Klantgegevens (Customer Details)
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Klantnaam | {{invoice.customer.name}} | Tom Taylor |
| Klant voornaam | {{invoice.customer.first_name}} | Tom |
| Klant achternaam | {{invoice.customer.last_name}} | Taylor |
| Klant telefoon | {{invoice.customer.phone}} | (222) 555-3456 |
| Klant e-mail | {{invoice.customer.email}} | tom@taylor.com |
| Klant bedrijf | {{invoice.customer.company}} | Taylor Construction |
| Klant adres | {{invoice.customer.address}} | 3333 N. Main St |
| Klant plaats | {{invoice.customer.city}} | Chicago |
| Klant staat | {{invoice.customer.state}} | Illinois |
| Klant postcode | {{invoice.customer.postal_code}} | 60657 |
Afzendergegevens (Sender Details)
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Naam afzender | {{invoice.sender.name}} | Bob Brown |
| E-mail afzender | {{invoice.sender.email}} | bob@brown.com |
Kaartinformatie (Card Information)
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Kaartmerk | {{invoice.card.brand}} | Visa |
| Laatste 4 cijfers | {{invoice.card.last4}} | 7654 |
Cursus (Course) merge fields
Deze velden ondersteunen cursus- of lesinhoud bij het versturen van inschrijvings- of contentberichten.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Categorietitel | {{courses.categoryTitle}} | Getting Started with Knitting |
| Producttitel | {{courses.productTitle}} | Basics of Knitting |
| Posttitel | {{courses.postTitle}} | The Best Types of Yarn |
Service Booking merge fields
Deze velden halen details op uit een service booking-record, inclusief planning, prijzen en informatie over de toegewezen gebruiker.
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Titel | {{servicebooking.title}} | Men’s Haircut |
| Starttijd | {{servicebooking.start_time}} | 3:30 PM |
| Eindtijd | {{servicebooking.end_time}} | 4:30 PM |
| Startdatum | {{servicebooking.start_date}} | March 6, 2026 |
| Einddatum | {{servicebooking.only_end_date}} | March 7, 2026 |
| Alleen eindtijd | {{servicebooking.only_end_time}} | 4:30 PM |
| Dag van de week | {{servicebooking.day_of_week}} | Monday |
| Maand (nummer) | {{servicebooking.month}} | 3 |
| Maandnaam | {{servicebooking.month_name}} | March |
| Tijdzone | {{servicebooking.timezone}} | CST |
| Totaalprijs | {{servicebooking.total_price}} | $55 |
| Meetinglocatie | {{servicebooking.meeting_location}} | 123 Main St, Chicago, IL 60657 |
| Naam meetinglocatie | {{servicebooking.meeting_location_name}} | Chair 4 |
| Link om te verzetten | {{servicebooking.reschedule_link}} | https://booking.example.com/reschedule?booking_id=123 |
| Annuleringslink | {{servicebooking.cancellation_link}} | https://booking.example.com/cancel?booking_id=123 |
Service-regels en toegewezen gebruiker (Service Line Items and Assigned User)
| Naam | Merge field | Voorbeeld |
|---|---|---|
| Servicenaam | {{this.name}} | Haircut - Regular |
| Serviceprijs | {{this.price}} | $125 |
| Serviceduur | {{this.duration}} | 45 mins |
| Service startdatum | {{this.only_start_date}} | March 6, 2026 |
| Service starttijd | {{this.only_start_time}} | 4:30 PM |
| Service tijdzone | {{this.timezone}} | GMT-06:00 America/Chicago |
| Addon-naam | {{this.addonName}} | Hair Coloring |
| Addon-prijs | {{this.addonPrice}} | $25 |
| Addon-duur | {{this.addonDuration}} | 15 mins |
| Addon-aantal | {{this.addonQuantity}} | 1 |
| Naam toegewezen gebruiker | {{this.user.name}} | Jane Smith |
| E-mail toegewezen gebruiker | {{this.user.email}} | jane@smith.com |
| Telefoon toegewezen gebruiker | {{this.user.phone}} | (515) 555-2345 |
| Telefoon toegewezen gebruiker (raw) | {{this.user.phone_raw}} | +15155552345 |
| Signatuur toegewezen gebruiker | {{this.user.email_signature}} | Jane Smithjane@smith.com |
Standaard- of fallback-waarden bij lege velden (Default or Fallback Values for Empty Fields)
Sommige merge fields kunnen leeg zijn als de opgeslagen data ontbreekt. Als een merge field geen waarde heeft, wordt het meestal vervangen door niets.
Een praktische workaround is om één blok content te tonen wanneer een veld wél een waarde heeft, en een ander blok wanneer het leeg is. Zo blijven berichten leesbaar en voorkom je ongemakkelijke lege begroetingen.
Zet Conditional Sending aan, kies een veld zoals First Name, stel de conditie in (bijvoorbeeld ‘is not empty’) en bepaal welke content alleen zichtbaar is wanneer de conditie waar is. Daarna kun je een apart blok instellen dat getoond wordt wanneer de conditie niet waar is.
Veelgestelde vragen
V: Wat gebeurt er als een merge field geen waarde heeft?
Antwoord: Het merge field wordt meestal vervangen door een lege waarde. Daardoor kan een deel van een zin wegvallen, bijvoorbeeld: “Hi ,”.
V: Wat is het verschil tussen een standaard telefoonveld en een raw-telefoonveld?
Antwoord: Raw-telefoonnotatie haalt tekens zoals haakjes en streepjes weg. Dit is meestal beter voor links, tracking-parameters en internationale notaties.
V: Kun je merge fields gebruiken in facturen en betaalberichten?
Antwoord: Ja. Merge fields kunnen onder andere factuurnummers, totalen, vervaldata, klantgegevens en links invullen.
V: Waarom zie ik andere merge fields dan een ander account?
Antwoord: Beschikbare merge fields kunnen verschillen per ingeschakelde tools, configuratie en het type record dat je bewerkt.
V: Hoe voorkom ik lege begroetingen als de voornaam ontbreekt?
Antwoord: Gebruik conditionele contentblokken, zodat één begroeting wordt getoond wanneer de voornaam bestaat en een andere wanneer die ontbreekt.
Hulp nodig?
Als merge fields niet worden ingevuld zoals je verwacht, controleer dan of het record de benodigde informatie bevat, zoals een voornaam, e-mailadres of afspraaktijd. Bij problemen met templates en automatiseringen is het belangrijk dat je het juiste merge field hebt ingevoegd via de merge field picker en dat het bericht wordt verzonden vanuit de juiste context, zoals contact, afspraak, factuur of booking.
Als je daarna nog hulp nodig hebt, gebruik dan de in-app help-opties in je account en voeg de naam van het merge field toe, waar je het gebruikt en een voorbeeld van de output die je ziet.