Dynamische Variablen Übersicht

Dynamische Variablen können verwendet werden, um ausgehende Nachrichten zu personalisieren. Kontakte persönlich in Gesprächen zu adressieren kann eine Schlüsselkomponente des Beziehungsaufbaus sein, indem sie das Gefühl haben, gesehen und eingebunden zu sein.

Es gibt drei Arten von dynamischen Variablen auf der Plattform:

Standard-Kontaktvariablen repräsentieren Standard-Kontaktfelder wie Vorname, Nachname und E-Mail.
Benutzerdefinierte Kontaktfeld-Variablen repräsentieren benutzerdefinierte Felder, die dem Raum hinzugefügt wurden.
Workflow-Variablen sind temporäre Variablen, die nur während einer Workflow-Sitzung existieren. Sobald der Kontakt den Workflow verlässt, wird der Wert der Variable gelöscht.

Es gibt drei Typen von Workflow-Variablen: Trigger-Variablen, Ausgabevariablen und Variablen, die durch einen Fragen-Schritt erzeugt werden.

Dynamische Variablen: Beispiele

Dynamische Variablen können eingebunden werden, indem Sie das "$" Präfix in das Kontaktfeld hinzufügen. Folgende Syntax:

$contact, $assignee oder $system

Die Plattform unterstützt die Interpolation statischer Texte + dynamischer Variablen.

Standard-Kontaktvariablen

Variable	Beschreibung
$contact.name	Wird durch den vollständigen Namen des Kontakts ersetzt (Vorname + Nachname).
$contact.firstname	Wird durch den Vornamen des Kontakts ersetzt.
$contact.lastname	Wird durch den Nachnamen des Kontakts ersetzt.
$contact.email	Wird durch die E-Mail des Kontakts ersetzt.
$contact.country	Wird durch das Land Kontakt's ersetzt. Wenn der Kontakt kein Land gespeichert hat, wird er nicht ersetzt und die eigentliche Zeichenkette wird gesendet.
$contact.id	Wird durch die Kontakt-ID des Kontakts ersetzt.

Eigene Kontaktfeld-Variablen

Variable	Beschreibung
$contact.field_name	Wird durch den Wert im benutzerdefinierten Feld ersetzt. Zum Beispiel, wenn das Benutzerdefinierte Feld "City" existiert und ein Kontakt den Wert "New York"hat, sende $contact. ity wird durch New York ersetzt.

Systemvariablen

Variable	Beschreibung
$system.current_datetime	Ersetzt durch das aktuelle Datum und Uhrzeit in der Zeitzone des Arbeitsbereichs. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-01-10 09:15:27)
$system.current_date	Wird durch das aktuelle Datum in der Zeitzone des Arbeitsbereichs ersetzt. Format: JJJJ-MM-TT (z.B. 2023-01-10)
$system.current_time	Wird durch die aktuelle Zeit in der Zeitzone des Arbeitsbereichs ersetzt. Format: hh:mm:ss (e.g. 09:15:27)

Zugewiesene Variablen

Variable	Beschreibung
$assignee.id	Wird durch die Benutzer-ID des Beauftragten für einen Kontakt ersetzt.
$assignee.name	Wird durch den vollen Namen des Beauftragten für einen Kontakt ersetzt (Vorname + Nachname).
$assignee.email	Wird durch die E-Mail des Beauftragten für einen Kontakt ersetzt.
$assignee.firstname	Wird durch den Vornamen des Beauftragten für einen Kontakt ersetzt.
$assignee.lastname	Wird durch den Nachnamen des Beauftragten für einen Kontakt ersetzt.
$assignee.team	Wird durch den Namen des Teams der Beauftragten ersetzt.

Workflow - Trigger-Variablen

Trigger-Variablen sind Variablen, die an einen Workflow-Trigger gebunden sind. Sie sind nur verfügbar, wenn der spezifische Trigger für den Workflow verwendet wird.

Auslösen von Variablen für die Unterhaltung Opened Trigger

Variable	Beschreibung
$conversation.opened_timestamp	Datum und Uhrzeit der Unterhaltung. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.opened_by_source	Die Quelle (z.B. Kontakt, Benutzer, Workflow, Zapier, API, Make), die die Unterhaltung auslöst.
$conversation.opened_by_channel	Die Kanal-ID, die die geöffnete Unterhaltung auslöst.
$conversation.contact_type	Der Kontakttyp (Neuer Kontakt oder wiederkehrender Kontakt) der Unterhaltung.
$conversation.first_incoming_message	Die erste eingehende Nachricht der Unterhaltung nach dem Öffnen der Unterhaltung.
$conversation.first_incoming_message_channel_id	Die Kanal-ID der ersten eingehenden Nachricht der Unterhaltung nach dem Öffnen der Unterhaltung

Trigger-Variablen für Unterhaltung geschlossen Trigger

Variable	Beschreibung
$conversation.opened_timestamp	Datum und Uhrzeit, an dem die Unterhaltung eröffnet wurde. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.opened_by_source	Die Quelle (z.B. Kontakt, Benutzer, Workflow, Zapier, API, Make), die die geöffnete Unterhaltung auslöst.
$conversation.opened_by_channel	Die Kanal-ID, die die geöffnete Unterhaltung auslöst.
$conversation.closed_time	Das Datum und die Uhrzeit, an der die Unterhaltung geschlossen wurde. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.closed_by_source	Die Quelle (z.B. Kontakt, Benutzer, Workflow, Zapier, API, Make), die die Unterhaltung auslöst.
$conversation.closed_by	Die Benutzer-ID des Benutzers, der die Unterhaltung geschlossen hat. Wenn die Unterhaltung durch Bot, Workflow oder API geschlossen wird, ist dieses Feld leer.
$conversation.closed_by_team	Die Team-ID des Benutzers, der das Gespräch geschlossen hat.
$conversation.contact_type	Der Kontakttyp (Neuer Kontakt oder wiederkehrender Kontakt) der Unterhaltung.
$conversation.assignee_team	Der Teamname des Benutzers, der die Unterhaltung zugewiesen hat.
$conversation.first_assignment_timestamp	Datum und Uhrzeit der ersten Zuweisung der Unterhaltung. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_assignee	Die Benutzer-ID des ersten Beauftragten.
$conversation.first_antwort_time	Die Zeit, die benötigt wird, um die erste Antwort ab dem Zeitpunkt zu geben, als die Unterhaltung geöffnet wurde. Es wird kein Wert angezeigt, wenn einer der folgenden Punkte auftritt: - die Unterhaltung wird ohne Antwort geschlossen. - wenn die erste Antwort von der API geliefert wird oder der Kontakt dem Benutzer zugewiesen wurde, und dann wird das Gespräch durch den Agenten eröffnet. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_antwort_by	Die Benutzer-ID des Benutzers, der die erste Antwort gegeben hat.
$conversation.last_assignment_timestamp	Datum und Uhrzeit der letzten Zuweisung der Unterhaltung. Es wird kein Wert angezeigt, wenn einer der folgenden Punkte auftritt: - die Unterhaltung wird ohne Zuweiser geschlossen. - In der Unterhaltung passiert keine Zuordnung, z.B. die Unterhaltung wurde dem Benutzer vor dem Öffnen der Unterhaltung zugewiesen. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.last_assignee	Die Benutzer-ID des letzten Beauftragten.
$conversation.time_to_first_assignment	Die Zeit, die benötigt wird, um die Unterhaltung zuerst dem ersten Benutzer zuzuweisen. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_first_response_time	Die Zeit, die benötigt wird, um die erste Antwort zu geben von der Zeit, als die Unterhaltung zum ersten Mal zugewiesen wurde. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_response_time	Die Zeit, die benötigt wird, um die erste Antwort des letzten Beauftragten ab dem Zeitpunkt zu geben, als die Unterhaltung zuletzt zugewiesen wurde. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.Auflösung	Die Zeit, die benötigt wird, um die Unterhaltung zu lösen von der Zeit, als die Unterhaltung geöffnet wurde. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_close_time	Die Zeit, die benötigt wird, um die Unterhaltung zu lösen, von der Zeit, als die Unterhaltung zum ersten Mal zugewiesen wurde. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_close_time	Die Zeit, die benötigt wird, um die Unterhaltung zu lösen, von der Zeit, als die Unterhaltung zuletzt zugewiesen wurde. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.Durchschnittliche Antwort_Zeit	Die durchschnittliche Zeit, die benötigt wird, um Antworten auf Kontakte zu geben. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.assignments_count	Die Anzahl der Aufgaben in der Unterhaltung.
$conversation.incoming_messages_count	Die Anzahl der eingehenden Nachrichten, die während der Unterhaltung empfangen wurden.
$conversation.outgoing_messages_count	Die Anzahl der ausgehenden Nachrichten, die während der Unterhaltung gesendet werden (ohne Broadcast-Nachrichten).
$conversation.responses_count	Die Anzahl der Antworten, die in der Unterhaltung gesendet werden.
$conversation.category	Die Kategorie der Unterhaltung, wie in der Schlussnote angegeben.
$conversation.summary	Die Zusammenfassung der letzten Notiz der Unterhaltung.

Auslösen von Variablen für Klick-zu-Chat Anzeigen Auslöser

Variablenname	Beschreibung
$clicktochat.ad_timestamp	Der Zeitstempel, wenn die eingehende Nachricht empfangen wurde.
$clicktochat.ad_first_incoming_message	Die erste Nachricht in der Unterhaltung, die durch Klicken in die Chat-Anzeige entsteht.
$clicktochat.ad_channel_id	Die ID des Kanals, über den die eingehende Anzeigenachricht empfangen wurde.
$clicktochat.ad_channel	Der Kanal, durch den das Werbe-bezogene Gespräch stattfindet.
$clicktochat.ad_contact_type	Die Art des Kontakts, der der Anzeige zugeordnet ist: neu oder zurück
$clicktochat.ad_id	Die CTC Anzeigen-ID-Nummer.
$clicktochat.ad_name	Der CTC Anzeigenname.
$clicktochat.ad_campaign_id	Die CTC Werbe-Kampagnen-ID Nummer.
$clicktochat.ad_campaign_name	Der CTC-Kampagnenname.
$clicktochat.ad_adset_id	Die CTC Adset ID Nummer.
$clicktochat.ad_adset_name	Der CTC Adset-Name.
$clicktochat.ad_ad_url	Die URL der CTC-Anzeige.
$clicktochat.ad_referenz	Die Referenz, die der CTC-Anzeige zugeordnet ist.
$clicktochat.ad_status	Der Status der CTC-Anzeige.
$clicktochat.ad_objective	Das Ziel der CTC-Anzeige.
$clicktochat.ad_optimization_goal	Das Optimierungsziel der CTC-Anzeige.
$clicktochat.ad_destination_type	Der Typ des Ziels, der mit der CTC-Anzeige verknüpft ist.

Falls ein Standard-Kontaktfeld den gleichen Namen wie ein benutzerdefiniertes Kontaktfeld hat -Priorität für das Abrufen von Daten wird der Standard-Kontaktvariablen gegeben. Um die Daten korrekt abzurufen, stellen Sie sicher, dass alle Variablennamen eindeutig sind.