I merge field ti permettono di personalizzare messaggi e documenti inserendo automaticamente i dati salvati, come il nome di un contatto, l'email di un utente assegnato, gli orari degli appuntamenti o i totali delle fatture. Quando un messaggio viene inviato o un documento viene generato, ogni merge field viene sostituito con il valore corrispondente per quel destinatario o record specifico. Questo aiuta a mantenere la comunicazione coerente e accurata in email, SMS, fatture, Campaign e Workflow automatizzati.

Nota sul formato "Raw" per i numeri di telefono: I campi telefono in formato raw rimuovono spazi, parentesi e trattini. Il formato raw è particolarmente utile quando si utilizzano numeri di telefono in link, parametri di tracciamento o formati internazionali.

INDICE

Merge Field Contatto

Questi campi recuperano le informazioni salvate nel record del contatto. Sono comunemente usati per saluti, conferme e follow-up personalizzati.

NomeMerge FieldEsempio
Nome completo{{contact.name}}Jane Smith
Nome{{contact.first_name}}Jane
Cognome{{contact.last_name}}Smith
Email{{contact.email}}jane@smith.com
Telefono{{contact.phone}}(515) 555-2345
Telefono (formato raw){{contact.phone_raw}}+15155552345
Nome azienda{{contact.company_name}}Smith Plumbing
Indirizzo completo{{contact.full_address}}1234 W. Main St, Chicago, IL 60657
Indirizzo riga 1{{contact.address1}}1234 W. Main St
Città{{contact.city}}Chicago
Stato/Regione{{contact.state}}Illinois
CAP{{contact.postal_code}}60657
Fuso orario{{contact.timezone}}GMT-06:00 America/Chicago
Data di nascita{{contact.date_of_birth}}Jan 3, 1980
Fonte{{contact.source}}Referral
Sito web{{contact.website}}www.example.com
ID contatto{{contact.id}}FZDn5mYlkZuCCQe5Bep8

Merge Field Utente

Questi campi recuperano le informazioni sull'utente assegnato (o mittente) collegato all'attività, alla conversazione o all'appuntamento.

I merge field utente possono essere usati anche nelle esperienze post-prenotazione dei Calendar, incluso il messaggio "Thank you message" della pagina di conferma del Calendar e il passo successivo del Funnel dopo una prenotazione sul Calendar quando l'azione di reindirizzamento dell'elemento Calendar è impostata su "Go to next step".
NomeMerge FieldEsempio
Nome completo{{user.name}}John Doe
Nome{{user.first_name}}John
Cognome{{user.last_name}}Doe
Email{{user.email}}john@doe.com
Telefono{{user.phone}}(333) 555-9876
Telefono (formato raw){{user.phone_raw}}+13335559876
Firma email{{user.email_signature}}John Doejohn@doe.com(333) 555-9876
Link prenotazione{{user.calendar_link}}https://booking.example.com/schedule/john-doe
Telefono utente appuntamento (raw){{appointment.user.phone_raw}}+13335559876
Numero chiamate esterno{{user.call_provider_phone_number}}(234) 555-9876
Numero chiamate esterno (raw){{user.call_provider_phone_number_raw}}+12345559876

Importante: In alcuni account i nomi dei campi per il "numero di chiamate esterno" potrebbero essere diversi a seconda della configurazione. Usa il selettore di merge field nell'editor per inserire il nome esatto del campo disponibile nel tuo account.

Merge Field Appuntamento

Questi campi recuperano i dettagli da un record di appuntamento e sono comunemente usati in conferme, promemoria e messaggi di riprogrammazione.

NomeMerge FieldEsempio
Titolo{{appointment.title}}Appointment with Bob
Data/ora inizio{{appointment.start_time}}Wed, Nov 5, 2025 3:30 PM
Solo data inizio{{appointment.only_start_date}}Nov 5, 2025
Solo ora inizio{{appointment.only_start_time}}3:30 PM
Data/ora fine{{appointment.end_time}}Wed, Nov 5, 2025 4:00 PM
Solo data fine{{appointment.only_end_date}}Nov 5, 2025
Solo ora fine{{appointment.only_end_time}}4:00 PM
Giorno della settimana{{appointment.day_of_week}}Monday
Numero del mese{{appointment.month}}11
Fuso orario{{appointment.timezone}}CST
Link annullamento{{appointment.cancellation_link}}https://booking.example.com/cancel?event\_id=123
Link riprogrammazione{{appointment.reschedule_link}}https://booking.example.com/reschedule?event\_id=123
Luogo incontro{{appointment.meeting_location}}123 W Main St, Chicago, IL 60657
Note{{appointment.notes}}This is our second meeting.
Link aggiungi al calendario{{appointment.add_to_calendar}}https://booking.example.com/add-to-calendar?event\_id=123
Link Google Calendar{{appointment.add_to_google_calendar}}https://booking.example.com/google/calendar/add-event/calendarid
Link iCal/ICS{{appointment.add_to_ical}}https://booking.example.com/get-ics?event\_id=123
Ripetizioni ricorrenti{{appointment.recurring.repeats}}0
Numero ripetizioni{{appointment.recurring.times_to_repeat}}1
Nome utente assegnato{{appointment.user.name}}John Doe
Email utente assegnato{{appointment.user.email}}john@doe.com
Telefono utente assegnato{{appointment.user.phone}}(333) 555-9876
Telefono utente assegnato (raw){{appointment.user.phone_raw}}+13335559876
Firma utente assegnato{{appointment.user.email_signature}}John Doejohn@doe.com

Merge Field Calendar

Questi campi recuperano i dettagli dal Calendar associato all'evento.

NomeMerge FieldEsempio
Nome Calendar{{calendar.name}}Lawn Services Calendar

Merge Field Campaign

Questi campi supportano gli eventi di Campaign pianificati e le variabili di tempistica.

NomeMerge FieldEsempio
Data/ora evento{{campaign.event_date_time}}Nov 5, 2025 3:30 PM
Data evento{{campaign.event_date}}Nov 5, 2025
Ora evento{{campaign.event_time}}3:30 PM

Merge Field Messaggio

Questi campi sono utili quando si fa riferimento al contenuto di un messaggio all'interno di un Workflow o di un'automazione.

NomeMerge FieldEsempio
Corpo del messaggio{{message.body}}Hi, just a quick reminder about our call tomorrow morning.
Oggetto del messaggio{{message.subject}}Meeting Reminder

Merge Field Account

Questi campi recuperano i dettagli aziendali o a livello di account usati per branding, ricevute e identità aziendale standard.

NomeMerge FieldEsempio
Nome account{{location.name}}WidgetWorks
Indirizzo completo{{location.full_address}}555 Oak St, Tampa, FL 33602
Indirizzo riga 1{{location.address}}555 Oak St
Città{{location.city}}Tampa
Stato/Regione{{location.state}}Florida
Paese{{location.country}}US
CAP{{location.postal_code}}33602
Email{{location.email}}name@domain.com
Telefono{{location.phone}}(333) 555-3344
Telefono (formato raw){{location.phone_raw}}+13335553344
Sito web{{location.website}}mywebsiteurl.com
URL logo{{location.logo_url}}https://files.example.com/logo.png
Nome proprietario{{location_owner.first_name}}Lisa
Cognome proprietario{{location_owner.last_name}}White
Email proprietario{{location_owner.email}}lisa@white.com
ID account{{location.id}}DP4mTqaz7L9XpweFvRjC

Merge Field "Right Now"

Questi campi inseriscono i valori dell'ora corrente nel momento in cui il messaggio viene generato.

NomeMerge FieldEsempio
Secondi{{right_now.second}}9
Minuti{{right_now.minute}}10
Ora (24h){{right_now.hour}}14
Ora (AM/PM){{right_now.hour_ampm}}2
AM/PM{{right_now.ampm}}PM
Giorno della settimana{{right_now.day_of_week}}Tuesday
Nome del mese{{right_now.month_name}}November
Giorno{{right_now.day}}4
Mese (numero){{right_now.month}}11
Anno{{right_now.year}}2025
Data (MM/GG/AAAA){{right_now.middle_endian_date}}11/4/2025
Data (GG/MM/AAAA){{right_now.little_endian_date}}4/11/2025

Merge Field Attribuzione

Questi campi supportano i dettagli di tracciamento legati alla prima fonte di attribuzione di un contatto e alla più recente. I valori provengono comunemente dai parametri di tracciamento inclusi nei link.

Prima Attribuzione

NomeMerge FieldEsempio
Fonte sessione{{contact.attributionSource.sessionSource}}Referral
URL di atterraggio{{contact.attributionSource.url}}https://example.com/form?utm\_source=ads
Campaign{{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
ID Campaign{{contact.attributionSource.campaignId}}23849260571384729
ID click annuncio{{contact.attributionSource.clickId}}ABC123XYZ
UTM keyword{{contact.attributionSource.utmKeyword}}running_shoes
UTM match type{{contact.attributionSource.utmMatchType}}exact
ID gruppo annunci{{contact.attributionSource.adGroupId}}123456
ID annuncio{{contact.attributionSource.adId}}78910

Ultima Attribuzione

NomeMerge FieldEsempio
Fonte sessione{{contact.lastAttributionSource.sessionSource}}Referral
URL di atterraggio{{contact.lastAttributionSource.url}}https://example.com/form?utm\_source=ads
Campaign{{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
ID Campaign{{contact.lastAttributionSource.campaignId}}23850176293047583
ID click annuncio{{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
ID gruppo annunci{{contact.lastAttributionSource.adGroupId}}654321
ID annuncio{{contact.lastAttributionSource.adId}}10987

Importante: Alcuni account potrebbero mostrare campi di attribuzione specifici per provider. Per un template di messaggio compatibile con il white-label, usa il selettore di merge field per inserire i nomi esatti dei campi "click ID" disponibili nel tuo account ed evita di includere nomi di provider nel testo circostante.

Merge Field Fattura

Questi campi recuperano i valori dai record di fattura e sono spesso usati in fatture, ricevute, conferme di pagamento e promemoria.

NomeMerge FieldEsempio
Nome fattura{{invoice.name}}Consulting Contract
Numero fattura{{invoice.number}}43255
Data emissione{{invoice.issue_date}}2025-04-05
Data scadenza{{invoice.due_date}}2025-10-05
Subtotale{{invoice.sub_total}}$500.00
Importo sconto{{invoice.discount_amount}}$50.00
Importo tasse{{invoice.tax_amount}}$25.00
Importo totale{{invoice.total_amount}}$475.00
Titolo fattura{{invoice.title}}Consulting Invoice
Link fattura{{invoice.url}}https://pay.example.com/invoice/abc123

Dettagli Azienda

NomeMerge FieldEsempio
Nome azienda{{invoice.company.name}}Test Solutions
Telefono azienda{{invoice.company.phone}}(888) 555-9876
Indirizzo azienda{{invoice.company.address}}1234 Maple St
Città azienda{{invoice.company.city}}Milwaukee
Stato azienda{{invoice.company.state}}Wisconsin
Paese azienda{{invoice.company.country}}US
Sito web azienda{{invoice.company.website}}www.example.com
URL logo azienda{{invoice.company.logo}}https://files.example.com/logo.png

Dettagli Cliente

NomeMerge FieldEsempio
Nome cliente{{invoice.customer.name}}Tom Taylor
Nome cliente (nome){{invoice.customer.first_name}}Tom
Nome cliente (cognome){{invoice.customer.last_name}}Taylor
Telefono cliente{{invoice.customer.phone}}(222) 555-3456
Email cliente{{invoice.customer.email}}tom@taylor.com
Azienda cliente{{invoice.customer.company}}Taylor Construction
Indirizzo cliente{{invoice.customer.address}}3333 N. Main St
Città cliente{{invoice.customer.city}}Chicago
Stato cliente{{invoice.customer.state}}Illinois
CAP cliente{{invoice.customer.postal_code}}60657

Dettagli Mittente

NomeMerge FieldEsempio
Nome mittente{{invoice.sender.name}}Bob Brown
Email mittente{{invoice.sender.email}}bob@brown.com

Informazioni Carta

NomeMerge FieldEsempio
Tipo carta{{invoice.card.brand}}Visa
Ultime 4 cifre{{invoice.card.last4}}7654

Merge Field Corso

Questi campi supportano i contenuti di corsi o lezioni quando si inviano messaggi relativi all'iscrizione o ai contenuti.

NomeMerge FieldEsempio
Titolo categoria{{courses.categoryTitle}}Getting Started with Knitting
Titolo prodotto{{courses.productTitle}}Basics of Knitting
Titolo post{{courses.postTitle}}The Best Types of Yarn

Merge Field Prenotazione Servizio

Questi campi recuperano i dettagli da un record di prenotazione servizio, inclusi orario, prezzo e informazioni sull'utente assegnato.

NomeMerge FieldEsempio
Titolo{{servicebooking.title}}Men's Haircut
Ora inizio{{servicebooking.start_time}}3:30 PM
Ora fine{{servicebooking.end_time}}4:30 PM
Data inizio{{servicebooking.start_date}}March 6, 2026
Data fine{{servicebooking.only_end_date}}March 7, 2026
Solo ora fine{{servicebooking.only_end_time}}4:30 PM
Giorno della settimana{{servicebooking.day_of_week}}Monday
Mese (numero){{servicebooking.month}}3
Nome del mese{{servicebooking.month_name}}March
Fuso orario{{servicebooking.timezone}}CST
Prezzo totale{{servicebooking.total_price}}$55
Luogo incontro{{servicebooking.meeting_location}}123 Main St, Chicago, IL 60657
Nome luogo incontro{{servicebooking.meeting_location_name}}Chair 4
Link riprogrammazione{{servicebooking.reschedule_link}}https://booking.example.com/reschedule?booking\_id=123
Link annullamento{{servicebooking.cancellation_link}}https://booking.example.com/cancel?booking\_id=123

Articoli di Servizio e Utente Assegnato

NomeMerge FieldEsempio
Nome servizio{{this.name}}Haircut - Regular
Prezzo servizio{{this.price}}$125
Durata servizio{{this.duration}}45 mins
Data inizio servizio{{this.only_start_date}}March 6, 2026
Ora inizio servizio{{this.only_start_time}}4:30 PM
Fuso orario servizio{{this.timezone}}GMT-06:00 America/Chicago
Nome addon{{this.addonName}}Hair Coloring
Prezzo addon{{this.addonPrice}}$25
Durata addon{{this.addonDuration}}15 mins
Quantità addon{{this.addonQuantity}}1
Nome utente assegnato{{this.user.name}}Jane Smith
Email utente assegnato{{this.user.email}}jane@smith.com
Telefono utente assegnato{{this.user.phone}}(515) 555-2345
Telefono utente assegnato (raw){{this.user.phone_raw}}+15155552345
Firma utente assegnato{{this.user.email_signature}}Jane Smithjane@smith.com

Valori Predefiniti o di Fallback per Campi Vuoti

Alcuni merge field potrebbero essere vuoti se i dati salvati mancano. Quando un merge field non ha valore, può essere sostituito con un valore di fallback. Questo aiuta a mantenere i messaggi leggibili ed evita saluti con spazi vuoti imbarazzanti.

Il valore di fallback può essere impostato cliccando sul tag del valore personalizzato nell'editor email.

Schermata 1 — Lista dei Merge Field

Merge Field Voice AI

I merge field di Voice AI, chiamati anche Valori Personalizzati nei prompt di Voice AI, permettono al tuo agente vocale AI di personalizzare le conversazioni telefoniche usando le informazioni già salvate in HITLEAD. Questi valori possono recuperare dettagli relativi al contatto, all'azienda, all'appuntamento, al Calendar, all'account o alla location quando sono disponibili nel contesto della chiamata.

Voice AI supporta i Valori Personalizzati nei prompt degli agenti e nei campi messaggio supportati. Usa il selettore di Valori Personalizzati all'interno del builder di Voice AI quando aggiungi informazioni dinamiche a un prompt.

Tipo di campoEsempio Merge FieldEsempio d'uso
Nome contatto{{contact.first_name}}"Ciao {{contact.first_name}}, grazie per aver chiamato."
Nome completo contatto{{contact.name}}"Vedo che il tuo nome è {{contact.name}}."
Email contatto{{contact.email}}"Abbiamo la tua email come {{contact.email}}."
Telefono contatto{{contact.phone}}"{{contact.phone}} è ancora il numero migliore per contattarti?"
Nome azienda{{company.name}}"Vedo che chiami da {{company.name}}."
Nome location{{location.name}}"Grazie per aver chiamato {{location.name}}."
Telefono location{{location.phone}}"Puoi anche raggiungerci al {{location.phone}}."
Email location{{location.email}}"Il nostro team può fare seguito da {{location.email}}."
Ora inizio appuntamento{{appointment.start_time}}"Il tuo appuntamento è programmato per {{appointment.start_time}}."
Nome Calendar{{calendar.name}}"Questo appuntamento è prenotato sul Calendar {{calendar.name}}."
Importante: I merge field disponibili possono variare in base al campo del prompt di Voice AI, alla direzione della chiamata, al record del contatto, al contesto dell'appuntamento e ai dati disponibili nell'account. Se un valore manca nel record, il merge field potrebbe apparire vuoto durante la conversazione.

Per le istruzioni di configurazione, consulta How to Use Custom Values in Voice AI Agent Prompts.

Merge Field Conversation AI

I merge field di Conversation AI aiutano gli agenti AI a personalizzare le conversazioni automatizzate usando i dati disponibili di contatti, aziende, location e altri dati supportati di HITLEAD. Questi valori sono utili quando si configurano prompt del bot, Bot Goals, risposte generate dall'AI e azioni di Conversation AI supportate.

Usa il selettore di Valori Personalizzati quando aggiungi merge field in Conversation AI. Questo aiuta a garantire che il valore selezionato sia supportato in quella parte della configurazione del bot.

Tipo di campoEsempio Merge FieldEsempio d'uso
Nome contatto{{contact.first_name}}"Ciao {{contact.first_name}}, come posso aiutarti oggi?"
Nome completo contatto{{contact.name}}"Grazie, {{contact.name}}. Posso aiutarti con questo."
Email contatto{{contact.email}}"Ho la tua email come {{contact.email}}."
Telefono contatto{{contact.phone}}"{{contact.phone}} è il numero migliore per il follow-up?"
Nome azienda{{company.name}}"Vedo che questo riguarda {{company.name}}."
Email azienda{{company.email}}"Abbiamo l'email aziendale come {{company.email}}."
Telefono azienda{{company.phone}}"Il numero di telefono aziendale nel file è {{company.phone}}."
Nome location{{location.name}}"Stai chattando con {{location.name}}."
Email location{{location.email}}"Il nostro team può fare seguito da {{location.email}}."
Telefono location{{location.phone}}"Puoi anche contattarci al {{location.phone}}."

I Bot Goals di Conversation AI includono impostazioni dei prompt, azioni e strumenti di test che aiutano a definire come l'agente AI comunica e risponde. Dopo aver aggiunto i merge field, testa la risposta del bot per confermare che i valori corretti vengano popolati prima di abilitare il bot per le conversazioni live.

Importante: La disponibilità dei merge field può dipendere dall'area di Conversation AI che si sta modificando, dal canale selezionato, dalla configurazione del bot e dall'esistenza dei dati correlati al contatto, all'azienda o alla location. Se un campo non ha dati salvati, il valore potrebbe risultare vuoto.

Per le istruzioni di configurazione, consulta Bot Goals Overview - Conversation AI e Conversation AI Bot Explained.

Domande Frequenti

D: Cosa succede se un merge field non ha valore?

Il merge field viene solitamente sostituito con uno spazio vuoto, che può rimuovere parte di una frase (ad esempio, "Ciao ,").

D: Qual è la differenza tra un campo telefono standard e uno in formato raw?

Il formato raw del telefono rimuove caratteri come parentesi e trattini ed è in genere migliore per link, parametri di tracciamento e formati internazionali.

D: I merge field possono essere usati in fatture e messaggi relativi ai pagamenti?

Sì. I merge field possono inserire numeri di fattura, totali, date di scadenza, dettagli del cliente e link.

D: Perché vedo merge field diversi rispetto a un altro account?

I merge field disponibili possono variare in base agli strumenti abilitati, alla configurazione e al tipo di record che stai modificando.

D: Come posso evitare saluti vuoti quando manca il nome?

Usa blocchi di contenuto condizionali in modo da mostrare un saluto quando il nome esiste e un altro quando non c'è.

Hai bisogno di aiuto?

Se i merge field non si popolano come previsto, verifica che il record contenga le informazioni necessarie (come nome, email o orario dell'appuntamento). Per problemi con template e automazioni, controlla che il merge field corretto sia stato inserito dal selettore e che il messaggio venga inviato nel contesto corretto (contatto, appuntamento, fattura o prenotazione).

Se hai ancora bisogno di assistenza, usa le opzioni di aiuto in-app disponibili nel tuo account e includi il nome del merge field, dove viene usato e un esempio dell'output che stai vedendo.