respond-io
New
🚀 TikTok Business Messaging è dal vivo! Trasforma le conversazioni in conversioni senza soluzione di continuità. Scopri di più.
arrow-icon

Home >

Prodotto >
Variabili Dinamiche >
Panoramica Delle Variabili Dinamiche

Panoramica Delle Variabili Dinamiche

Avatar
Susan Swier
· 13 May 2024
4 min di lettura

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:

  1. Le variabili di contatto Standard rappresentano campi di contatto standard come nome, cognome ed email.

  2. Le variabili del campo di contatto personalizzato rappresentano campi personalizzati aggiunti allo spazio.

  3. 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 flusso di lavoro: Variabili di innesco, Variabili di uscita e variabili create attraverso Fai una domanda passo.

Variabili Dinamiche: Esempi

Le variabili dinamiche possono essere incluse aggiungendo il prefisso "$" al campo 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 di contatto's. Se il contatto non ha un paese memorizzato, non verrà sostituito e la stringa verrà inviata.

$contact.id

Viene sostituito dal contatto ID del contatto.

Variabili Personalizzate Del Campo Di Contatto

Variabile

Descrizione

$contact.field_name

Viene sostituito dal valore nel campo personalizzato. Ad esempio, se esiste il campo personalizzato "City" e un contatto ha il valore "New York", invio di $contact. ity 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.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-01-10 09:15:27)

$system.current_date

Viene sostituita dalla data corrente nel fuso orario dello spazio di lavoro.

Formato: AAAA-MM-GG (es. 2023-01-10)

$system.current_time

Viene sostituito dall'ora corrente nel fuso orario dello spazio di lavoro.

Format: hh:mm:ss (e.g. 09:15:27)

Variabili Assegnatarie

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.

Workflow - Variabili Di Attivazione

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.

Attiva le variabili per il trigger aperto di conversazione

Variabile

Descrizione

$conversation.opened_timestamp

La data e l'ora in cui si è aperta la conversazione.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$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 contatto o contatto 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

Attiva le variabili per il trigger chiuso di conversazione

Variabile

Descrizione

$conversation.opened_timestamp

La data e l'ora in cui la conversazione è stata aperta.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$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.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$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.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$conversation.first_assegnatario

L'ID utente del primo assegnatario.

$conversation.first_response_time

Il tempo necessario per dare la prima risposta dal momento in cui la conversazione è stata aperta.

Nessun valore è mostrato se si verifica uno dei seguenti valori:
- la conversazione è chiusa senza alcuna risposta.
- se la prima risposta è fornita da API o il Contatto è stato assegnato all'utente prima, e poi la conversazione è aperta dall'agente.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$conversation.first_response_by

L'ID utente dell'utente che ha dato la prima risposta.

$conversation.last_assignment_timestamp

La data e l'ora dell'ultima conversazione assegnata.

Nessun valore è mostrato se si verifica uno dei seguenti valori:
- la conversazione è chiusa senza un assegnatario.
- non avviene alcuna assegnazione nella conversazione, ad esempio la conversazione è stata assegnata all'utente prima dell'apertura della conversazione.

Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)

$conversation.last_assignee

L'ID utente dell'ultimo assegnatario.

$conversation.time_to_first_assignment

Il tempo necessario per assegnare la conversazione al primo utente.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.first_assignment_to_first_response_time

Il tempo necessario per dare la prima risposta dal momento in cui la conversazione è stata assegnata per la prima volta.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.last_assignment_to_response_time

Il tempo necessario per dare la prima risposta da parte dell'ultimo assegnatario dal momento in cui è stata assegnata l'ultima conversazione.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.resolution_time

Il tempo necessario per risolvere la conversazione dal momento in cui è stata aperta la conversazione.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.first_assignment_to_close_time

Il tempo necessario per risolvere la conversazione dal momento in cui è stata assegnata la conversazione.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.last_assignment_to_close_time

Il tempo necessario per risolvere la conversazione dal momento in cui è stata assegnata l'ultima conversazione.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.average_response_time

Il tempo medio necessario per dare risposte al contatto.

Format: hh:mm:ss (e.g. 00:19:08)

$conversation.assignments_count

Il numero di incarichi 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 di trasmissione).

$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.

Attiva le variabili per Click-To-Chat Ads Trigger

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 nuovo

$clicktochat.ad_id

Il numero CTC ad ID.

$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 di ID adset ad 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.

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.

Condividi questo articolo
Telegram
Facebook
Linkedin
Twitter

Articoli correlati 👩‍💻

Come usare le variabili dinamiche
Scopri i quattro luoghi in cui usare variabili dinamiche: nel modulo Messaggi, nei Snippet, nei flussi di lavoro e nel flusso di dialogo.

Non riesci a trovare quello che stai cercando? 🔎