1. All Collections >
  2. Produit >
  3. Variables dynamiques >
  4. Présentation des variables dynamiques

Présentation des variables dynamiques

Avatar
Susan Swier
5 min de lecture

Les variables dynamiques peuvent être utilisées pour personnaliser les messages sortants. S'adresser personnellement aux contacts dans les conversations peut renforcer les relations en les faisant se sentir considérés et inclus.

Il y a trois types de variables dynamiques sur la plateforme :

  1. Variables de contact standard : représentent les champs de contact standard tels que le prénom, le nom et l'adresse e-mail.

  2. Variables des champs de contact personnalisés : représentent des champs personnalisés ajoutés à l'espace.

  3. Variables de workflow : ce sont des variables temporaires qui n'existent que pendant une session de workflow. Une fois que le contact quitte le workflow, la valeur de la variable sera effacée.

Il y a trois types de variables de flux de travail : les variables de déclenchement, les variables de sortie et les variables créées par l'étape «Ask a Question».

Exemples de variables dynamiques

Les variables dynamiques peuvent être incluses en ajoutant le préfixe "$" au champ de contact. La syntaxe est la suivante :

$contact, $assignee ou $system

La plateforme prend en charge l'interpolation de texte statique et de variables dynamiques.

Variables de contact standard

Variable

Description

$contact.name

Est remplacé par le nom complet du contact (Prénom + Nom).

$contact.firstname

Est remplacé par le prénom du contact.

$contact.lastname

Est remplacé par le nom de famille du contact.

$contact.email

Est remplacé par l'adresse e-mail du contact.

$contact.country

Est remplacé par le pays du contact. Si le Contact n'a pas de pays stocké, il ne sera pas remplacé et la chaîne réelle sera envoyée.

$contact.id

Est remplacé par l'ID du contact.

Variables des champs de contact personnalisés

Variable

Description

$contact.field_name

Est remplacé par la valeur dans le champ personnalisé. Par exemple, si le champ personnalisé "Ville" existe et qu'un contact a la valeur "New York", l'envoi de $contact.city sera remplacé par New York.

Variables système

Variable

Description

$system.current_datetime

Est remplacé par la date et l'heure actuelles dans le fuseau horaire de l'espace de travail.

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

$system.current_date

Est remplacé par la date actuelle dans le fuseau horaire de l'espace de travail.

Format : YYYY-MM-DD (ex. 2023-01-10)

$system.current_time

Est remplacé par l'heure courante dans le fuseau horaire de l'espace de travail.

Format : hh:mm:ss (ex. 09:15:27)

Variables de la personne assignée

Variable

Description

$assignee.id

Est remplacé par l'ID utilisateur de la personne assignée au contact.

$assignee.name

Est remplacé par le nom complet de la personne assignée au contact (Prénom + Nom).

$assignee.email

Est remplacé par l'adresse e-mail de la personne assignée au contact.

$assignee.firstname

Est remplacé par le prénom de la personne assignée au contact.

$assignee.lastname

Est remplacé par le nom de famille de la personne assignée au contact.

$assignee.team

Est remplacé par le nom de l'équipe de la personne assignée.

Variables de déclenchement du flux de travail

Les variables de déclenchement sont des variables liées à un déclencheur de workflow. Elles ne sont disponibles que lorsque le déclencheur spécifique est utilisé pour le flux de travail.

Variables du déclencheur «conversation ouverte»

Variable

Description

$conversation.opened_timestamp

La date et l'heure de l'ouverture de la conversation.

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

$conversation.opened_by_source

La source (par exemple, Contact, Utilisateur, Flux de travail, Zapier, API, Make) qui déclenche la conversation.

$conversation.opened_by_channel

L'ID du canal qui déclenche l'ouverture de la conversation.

$conversation.contact_type

Le type de contact de la conversation (nouveau contact ou contact existant).

$conversation.first_incoming_message

Le premier message entrant de la conversation après l'ouverture de la conversation.

$conversation.first_incoming_message_channel_id

L'ID du canal du premier message entrant de la conversation après l'ouverture de la conversation

Variables du déclencheur «conversation fermée»

Variable

Description

$conversation.opened_timestamp

La date et l'heure où la conversation a été ouverte.

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

$conversation.opened_by_source

La source (par exemple, Contact, Utilisateur, Flux de travail, Zapier, API, Make) qui déclenche la conversation ouverte.

$conversation.opened_by_channel

L'ID du canal qui déclenche l'ouverture de la conversation.

$conversation.closed_time

La date et l'heure à laquelle la conversation a été fermée.

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

$conversation.closed_by_source

La source (par exemple, Contact, Utilisateur, Flux de travail, Zapier, API, Make) qui déclenche la conversation fermée.

$conversation.closed_by

L'identifiant de l'utilisateur qui a fermé la conversation. Si la conversation est fermée par bot, workflow ou API, ce champ sera vide.

$conversation.closed_by_team

L'ID d'équipe de l'utilisateur qui a fermé la conversation.

$conversation.contact_type

Le type de contact de la conversation (nouveau contact ou contact existant).

$conversation.assignee_team

Le nom de l'équipe qui a assigné la conversation.

$conversation.first_assignment_timestamp

La date et l'heure de la première affectation de la conversation.

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

$conversation.first_assignee

L'ID utilisateur du premier assigné.

$conversation.first_response_time

Le temps nécessaire pour fournir la première réponse à partir du moment où la conversation a été ouverte.

Aucune valeur n'est montrée si l'un des éléments suivants se produit :
- la conversation est fermée sans aucune réponse.
- si la première réponse est fournie par l'API ou le contact a été assigné à l'utilisateur avant, puis la conversation est ouverte par l'agent.

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

$conversation.first_response_by

L'identifiant de l'utilisateur qui a donné la première réponse.

$conversation.last_assignment_timestamp

La date et l'heure de la dernière affectation de la conversation.

Aucune valeur n'est montrée si l'une des valeurs suivantes se produit :
- la conversation est fermée sans personne assignée.
- aucune affectation n'a lieu dans la conversation, par exemple si la conversation a été assignée à l'utilisateur avant son ouverture.

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

$conversation.last_assignee

L'ID utilisateur du dernier assigné.

$conversation.time_to_first_assignment

Le temps nécessaire pour assigner la conversation au premier utilisateur.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.first_assignment_to_first_response_time

Le temps nécessaire pour donner la première réponse à partir du moment où la conversation a été attribuée pour la première fois.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.last_assignment_to_response_time

Le temps nécessaire pour donner la première réponse du dernier assigné à partir du moment où la conversation a été assignée pour la dernière fois.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.resolution_time

Le temps nécessaire pour résoudre la conversation à partir du moment où la conversation a été ouverte.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.first_assignment_to_close_time

Le temps nécessaire pour résoudre la conversation à partir du moment où la conversation a été attribuée pour la première fois.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.last_assignment_to_close_time

Le temps nécessaire pour résoudre la conversation à partir du moment où la conversation a été attribuée pour la dernière fois.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.average_response_time

Le temps moyen nécessaire pour répondre au contact.

Format : hh:mm:ss (ex. 00:19:08)

$conversation.assignments_count

Le nombre d'affectations dans la conversation.

$conversation.incoming_messages_count

Le nombre de messages entrants reçus au cours de la conversation.

$conversation.outgoing_messages_count

Le nombre de messages sortants envoyés pendant la conversation (hors messages de diffusion).

$conversation.responses_count

Le nombre de réponses envoyées dans la conversation.

$conversation.category

La catégorie de la conversation telle que spécifiée dans la note de clôture.

$conversation.summary

Le résumé de la note de clôture de la conversation.

Variables du déclencheur pour les publicités Click-to-Chat

Nom de la variable

Description

$clicktochat.ad_timestamp

L'horodatage de la réception du message entrant.

$clicktochat.ad_first_incoming_message

Le premier message de la conversation résultant d'une publicité Click-to-Chat.

$clicktochat.ad_channel_id

L'ID du canal à travers lequel le message publicitaire entrant a été reçu.

$clicktochat.ad_channel_type

Le canal par lequel se déroule la conversation liée à la publicité.

$clicktochat.ad_contact_type

Le type de contact associé à l'annonce : nouveau ou existant

$clicktochat.ad_id

Le numéro d'identification de l'ad CTC

$clicktochat.ad_name

Le nom de l'annonce CTC.

$clicktochat.ad_campaign_id

Le numéro d'identification de la campagne de la CTC

$clicktochat.ad_campaign_name

Le nom de la campagne CTC

$clicktochat.ad_adset_id

Le numéro d'identification adset de l'ad CTC

$clicktochat.ad_adset_name

Le nom de l'adset de l'annonce CTC

$clicktochat.ad_ad_url

L'URL de la publicité CTC.

$clicktochat.ad_reference

La référence associée à l'annonce CTC.

$clicktochat.ad_status

Le statut de l'annonce CTC.

$clicktochat.ad_objective

L'objectif de l'annonce de la CTC.

$clicktochat.ad_optimization_goal

L'objectif d'optimisation de l'annonce de la CTC.

$clicktochat.ad_destination_type

Le type de destination associé à l'annonce CTC.

Variables du déclencheur pour les publicités de messagerie TikTok

Variable

Description

$tiktokmessagingad.ad_timestamp

Heure du clic sur l'annonce

$tiktokmessagingad.ad_first_incoming_message

Premier message envoyé par le contact

$tiktokmessagingad.ad_channel_id

ID du canal de messagerie

$tiktokmessagingad.ad_channel_type

Type de canal (par exemple TikTok)

$tiktokmessagingad.ad_contact_type

Type de contact (par exemple nouveau ou existant)

$tiktokmessagingad.ad_id

ID de la publicité

$tiktokmessagingad.ad_name

Nom de l'annonce

$tiktokmessagingad.ad_campaign_id

ID de la campagne

$tiktokmessagingad.ad_campaign_name

Nom de la campagne

$tiktokmessagingad.ad_adgroup_id

ID du groupe d'annonces

$tiktokmessagingad.ad_adgroup_name

Nom du groupe d'annonces

$tiktokmessagingad.ad_advertiser_id

ID de l'annonceur

$tiktokmessagingad.ad_operation_status

Statut opérationnel de l'annonce

$tiktokmessagingad.ad_secondary_status

Statut secondaire de l'annonce

Si un champ de contact standard porte le même nom qu'un champ de contact personnalisé, la priorité lors de la récupération des données sera donnée à la variable de contact standard. Pour une récupération correcte des données, assurez-vous que tous les noms de variables sont uniques.

Partager cet article
Telegram
Facebook
Linkedin
Twitter

Vous ne trouvez pas ce que vous recherchez? 🔎