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 i campi standard del contatto, come nome, cognome e email
Variabili dei campi personalizzati del contatto rappresentano i campi personalizzati aggiunti allo spazio
Variabili di Workflow sono variabili temporanee che esistono solo durante una sessione di Workflow. Una volta che il contatto esce dal Workflow, 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". |
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.
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 sostituito 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 flusso di lavoro
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. Contatto, Utente, Flusso di lavoro, Zapier, API, Make) che attiva la conversazione. |
$conversation.opened_by_channel | L'ID del canale che attiva l'apertura della conversazione. |
$conversation.contact_type | Il tipo di contatto (nuovo o esistente) della conversazione. |
$conversation.first_incoming_message | Il primo messaggio in arrivo della conversazione dopo la sua apertura. |
$conversation.first_incoming_message_channel_id | L'ID del canale del primo messaggio in arrivo 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. Contatto, Utente, Flusso di lavoro, Zapier, API, Make) che attiva l'apertura della conversazione. |
$conversation.opened_by_channel | L'ID del canale che attiva l'apertura della conversazione. |
$conversation.closed_time | La data e l'ora in cui la conversazione è stata chiusa. |
$conversation.closed_by_source | La sorgente (es. Contatto, Utente, Flusso di lavoro, Zapier, API, Make) che ha causato la chiusura della conversazione. |
$conversation.closed_by | L'ID 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 o 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 in cui 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 la conversazione è stata aperta. |
$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 impiegato dall'ultimo assegnatario per fornire la prima risposta 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 | Numero di incarichi nella conversazione. |
$conversation.incoming_messages_count | Numero di messaggi in arrivo ricevuti durante la conversazione. |
$conversation.outgoing_messages_count | Numero di messaggi in uscita inviati durante la conversazione (esclusi i messaggi broadcast). |
$conversation.responses_count | Numero di risposte inviate nella conversazione. |
$conversation.category | La categoria della conversazione come specificata nella nota di chiusura. |
$conversation.summary | Il riassunto della nota di chiusura della conversazione. |
Variabili trigger per gli annunci Click-to-Chat
Nome Della Variabile | Descrizione |
|---|---|
$clicktochat.ad_timestamp | Timestamp in cui è stato ricevuto il messaggio in arrivo. |
$clicktochat.ad_first_incoming_message | Il primo messaggio nella conversazione risultante da un annuncio 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 esistente |
$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 | Il numero ID dell'adset dell'annuncio CTC. |
$clicktochat.ad_adset_name | Il nome dell'adset dell'annuncio 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 all'annuncio 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 |
Variabili trigger per l'evento "Chiamata terminata"
Variabile | Descrizione | Valori possibili |
|---|---|---|
$call.event_id | L'ID univoco dell'evento di chiamata. | Stringa |
$call.id | L'ID univoco della chiamata. | Stringa |
$call.direction | La direzione della chiamata. | In entrata, In uscita |
$call.language | La lingua della chiamata. | Codice lingua (es. eng) |
$call.status | Lo stato della chiamata. | Mancata, Completata |
$call.duration_seconds | La durata della chiamata in secondi. | Numero |
$call.start_time | Timestamp dell'inizio della chiamata | Data e ora |
$call.end_time | Timestamp della fine della chiamata | Data e ora |
$call.contact_id | L'ID univoco del contatto associato alla chiamata. | Stringa |
$call.contact_first_name | Il nome del contatto associato alla chiamata. | Stringa |
$call.contact_last_name | Il cognome del contatto associato alla chiamata. | Stringa |
$call.contact_phone | Il numero di telefono del contatto associato alla chiamata. | Stringa |
$call.user_id | L'ID univoco dell'agente che ha gestito la chiamata. | Stringa |
$call.user_first_name | Il nome dell'agente che ha gestito la chiamata. | Stringa |
$call.user_last_name | Il cognome dell'agente che ha gestito la chiamata. | Stringa |
$call.user_email | L'indirizzo email dell'agente che ha gestito la chiamata. | Stringa |
$call.channel_id | L'ID univoco del canale su cui si è verificata la chiamata. | Stringa |
$call.recording_url | L'URL della registrazione della chiamata, se la registrazione delle chiamate è abilitata. | URL |
$call.summary_title | Il titolo del riassunto della chiamata generato dall'IA. | Stringa |
$call.summary_summary | Il corpo del riassunto della chiamata generato dall'IA. | Stringa |
$call.summary_action_items | Azioni estratte dal riassunto della chiamata generato dall'IA | Stringa |
Nota: La trascrizione della chiamata non è disponibile come variabile trigger. Sono supportate solo le variabili elencate sopra.
