Le variabili dinamiche possono essere usate per personalizzare i messaggi in uscita. Rivolgersi personalmente ai contatti nelle conversazioni può essere un elemento chiave della costruzione di relazioni facendoli sentire visti e inclusi.
Esistono tre tipi di variabili dinamiche sulla piattaforma:
variabili di contatto standard rappresentano campi di contatto standard come nome, cognome e email.
Le variabili del campo di contatto personalizzato rappresentano campi personalizzati aggiunti allo spazio.
Le variabili Workflow sono variabili temporanee che esistono solo durante una sessione Workflow. Una volta che il contatto esce dal flusso di lavoro, il valore della variabile verrà cancellato.
Ci sono tre tipi di variabili di Workflow: variabili trigger, variabili di output e variabili create tramite il passaggio "Ask a Question".
Esempi di variabili dinamiche
Le variabili dinamiche possono essere incluse aggiungendo il prefisso "$" al campo di contatto. La sintassi è la seguente:
$contact, $assignee o $system
La piattaforma supporta l'interpolazione di testo statico + variabili dinamiche.
Variabili di contatto standard
Variabile | Descrizione |
|---|---|
$contact.name | Viene sostituito dal nome completo del contatto (Nome + Cognome). |
$contact.firstname | Viene sostituito dal nome del contatto. |
$contact.lastname | Viene sostituito dal cognome del contatto. |
$contact.email | Viene sostituito dall'email del contatto. |
$contact.country | È sostituito dal paese del contatto. Se il contatto non ha un paese memorizzato, non verrà sostituito e la stringa verrà inviata. |
$contact.id | Viene sostituito dall'ID del contatto. |
Variabili dei campi personalizzati del contatto
Variabile | Descrizione |
|---|---|
$contact.field_name | Viene sostituito dal valore nel campo personalizzato. Ad esempio, se esiste il campo personalizzato "Città" e un contatto ha il valore "New York", inviando $contact.city sarà sostituito da "New York". |
Variabili di sistema
Variabile | Descrizione |
|---|---|
$system.current_datetime | Viene sostituito dalla data e ora correnti nel fuso orario dello spazio di lavoro. |
$system.current_date | Viene sostituita dalla data corrente nel fuso orario dello spazio di lavoro. |
$system.current_time | Viene sostituito dall'ora corrente nel fuso orario dello spazio di lavoro. |
Variabili dell'assegnatario
Variabile | Descrizione |
|---|---|
$assignee.id | Viene sostituito dall'ID utente dell'assegnatario per un contatto. |
$assignee.name | Viene sostituito dal nome completo dell'assegnatario per un contatto (nome + cognome). |
$assignee.email | Viene sostituito dall'email dell'assegnatario per un contatto. |
$assignee.firstname | Viene sostituito dal nome dell'assegnatario per un contatto. |
$assignee.lastname | Viene sostituito dal cognome dell'assegnatario per un contatto. |
$assignee.team | Viene sostituito dal nome della squadra dell’assegnatario. |
Variabili trigger del workflow
Le variabili trigger sono variabili legate a un trigger del flusso di lavoro. Sono disponibili solo quando viene utilizzato il trigger specifico per il flusso di lavoro.
Variabili trigger per l'evento "Conversazione aperta"
Variabile | Descrizione |
|---|---|
$conversation.opened_timestamp | La data e l'ora in cui si è aperta la conversazione. |
$conversation.opened_by_source | La sorgente (es. Contact, User, Workflow, Zapier, API, Make) che attiva la conversazione. |
$conversation.opened_by_channel | L'ID del canale che innesca la conversazione aperta. |
$conversation.contact_type | Il tipo di contatto (nuovo o di ritorno) della conversazione. |
$conversation.first_incoming_message | Il primo messaggio in arrivo della conversazione dopo l'apertura della conversazione. |
$conversation.first_incoming_message_channel_id | L'ID del canale del primo messaggio in arrivo della conversazione dopo l'apertura della conversazione |
Variabili trigger per l'evento "Conversazione chiusa"
Variabile | Descrizione |
|---|---|
$conversation.opened_timestamp | La data e l'ora in cui la conversazione è stata aperta. |
$conversation.opened_by_source | La sorgente (es. Contact, User, Workflow, Zapier, API, Make) che attiva la conversazione aperta. |
$conversation.opened_by_channel | L'ID del canale che innesca la conversazione aperta. |
$conversation.closed_time | La data e l'ora in cui la conversazione è stata chiusa. |
$conversation.closed_by_source | La sorgente (es. Contact, User, Workflow, Zapier, API, Make) che attiva la conversazione chiusa. |
$conversation.closed_by | L'ID utente dell'utente che ha chiuso la conversazione. Se la conversazione è chiusa tramite bot, flusso di lavoro o API, questo campo sarà vuoto. |
$conversation.closed_by_team | L'ID del team dell'utente che ha chiuso la conversazione. |
$conversation.contact_type | Il tipo di contatto (Nuovo contatto o Contatto di ritorno) della conversazione. |
$conversation.assignee_team | Il nome del team dell'utente che ha assegnato la conversazione. |
$conversation.first_assignment_timestamp | La data e l'ora di quando la conversazione è stata assegnata per la prima volta. |
$conversation.first_assignee | L'ID utente del primo assegnatario. |
$conversation.first_response_time | Tempo impiegato per fornire la prima risposta dal momento in cui è stata aperta la conversazione. |
$conversation.first_response_by | L'ID utente dell'utente che ha dato la prima risposta. |
$conversation.last_assignment_timestamp | La data e l'ora di quando la conversazione è stata assegnata l'ultima volta. |
$conversation.last_assignee | L'ID utente dell'ultimo assegnatario. |
$conversation.time_to_first_assignment | Il tempo necessario per assegnare la conversazione al primo utente. |
$conversation.first_assignment_to_first_response_time | Tempo impiegato per fornire la prima risposta dal momento in cui la conversazione è stata assegnata per la prima volta. |
$conversation.last_assignment_to_response_time | Il tempo necessario per dare la prima risposta da parte dell'ultimo assegnatario dal momento in cui la conversazione è stata assegnata l'ultima volta. |
$conversation.resolution_time | Tempo impiegato per risolvere la conversazione dal momento in cui è stata aperta. |
$conversation.first_assignment_to_close_time | Tempo impiegato per risolvere la conversazione dal momento in cui la conversazione è stata assegnata per la prima volta. |
$conversation.last_assignment_to_close_time | Tempo impiegato per risolvere la conversazione dal momento in cui la conversazione è stata assegnata l'ultima volta. |
$conversation.average_response_time | Tempo medio impiegato per fornire risposte al contatto. |
$conversation.assignments_count | Il numero di assegnazioni nella conversazione. |
$conversation.incoming_messages_count | Il numero di messaggi in arrivo ricevuti durante la conversazione. |
$conversation.outgoing_messages_count | Il numero di messaggi in uscita inviati durante la conversazione (esclusi i messaggi broadcast). |
$conversation.responses_count | Il numero di risposte inviate nella conversazione. |
$conversation.category | La categoria di conversazione come specificato nella nota di chiusura. |
$conversation.summary | Il riassunto della nota conclusiva della conversazione. |
Variabili trigger per gli annunci Click-to-Chat
Nome Della Variabile | Descrizione |
|---|---|
$clicktochat.ad_timestamp | Il timestamp quando il messaggio in arrivo è stato ricevuto. |
$clicktochat.ad_first_incoming_message | Il primo messaggio nella conversazione risultante dalla pubblicità Click-to-Chat. |
$clicktochat.ad_channel_id | L'ID del canale attraverso il quale è stato ricevuto il messaggio dell'annuncio in arrivo. |
$clicktochat.ad_channel_type | Il canale attraverso il quale si sta svolgendo la conversazione correlata. |
$clicktochat.ad_contact_type | Il tipo di contatto associato all'annuncio: nuovo o di ritorno |
$clicktochat.ad_id | L'ID numerico dell'annuncio CTC. |
$clicktochat.ad_name | Il nome dell'annuncio CTC. |
$clicktochat.ad_campaign_id | Il numero ID della campagna pubblicitaria CTC. |
$clicktochat.ad_campaign_name | Nome della campagna CTC. |
$clicktochat.ad_adset_id | L'ID numerico dell'adset dell'annuncio CTC. |
$clicktochat.ad_adset_name | Il nome dell'adset di annunci CTC. |
$clicktochat.ad_ad_url | L'URL dell'annuncio CTC. |
$clicktochat.ad_reference | Il riferimento associato alla pubblicità CTC. |
$clicktochat.ad_status | Lo stato dell'annuncio CTC. |
$clicktochat.ad_objective | Obiettivo dell'annuncio CTC. |
$clicktochat.ad_optimization_goal | L'obiettivo di ottimizzazione dell'annuncio CTC. |
$clicktochat.ad_destination_type | Il tipo di destinazione associata alla pubblicità CTC. |
Variabili trigger per gli annunci di messaggistica TikTok
Variabile | Descrizione |
|---|---|
$tiktokmessagingad.ad_timestamp | Ora in cui è stato cliccato l'annuncio |
$tiktokmessagingad.ad_first_incoming_message | Primo messaggio inviato dal contatto |
$tiktokmessagingad.ad_channel_id | ID del canale di messaggistica |
$tiktokmessagingad.ad_channel_type | Tipo di canale (ad esempio TikTok) |
$tiktokmessagingad.ad_contact_type | Tipo di contatto (ad esempio nuovo o esistente) |
$tiktokmessagingad.ad_id | ID annuncio |
$tiktokmessagingad.ad_name | Nome dell'annuncio |
$tiktokmessagingad.ad_campaign_id | ID campagna |
$tiktokmessagingad.ad_campaign_name | Nome della campagna |
$tiktokmessagingad.ad_adgroup_id | ID gruppo di annunci |
$tiktokmessagingad.ad_adgroup_name | Nome del gruppo di annunci |
$tiktokmessagingad.ad_advertiser_id | ID inserzionista |
$tiktokmessagingad.ad_operation_status | Stato operativo dell'annuncio |
$tiktokmessagingad.ad_secondary_status | Stato secondario dell'annuncio |
Nel caso in cui un campo di contatto standard condivida lo stesso nome di un campo di contatto personalizzato, la priorità per il recupero dei dati sarà data alla variabile di contatto standard. Per il corretto recupero dei dati, assicurati che tutti i nomi delle variabili siano unici.
