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.
Beispiele für dynamische Variablen
Dynamische Variablen kannst du hinzufügen, indem du dem Kontaktfeld das Präfix "$" voranstellst. 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 des Kontakts ersetzt. Wenn für den Kontakt kein Land gespeichert ist, wird es nicht ersetzt und die ursprüngliche Zeichenkette wird gesendet. |
$contact.id | Wird durch die Kontakt-ID des Kontakts ersetzt. |
Benutzerdefinierte Kontaktfeldvariablen
Variable | Beschreibung |
|---|---|
$contact.field_name | Wird durch den Wert im benutzerdefinierten Feld ersetzt. Zum Beispiel, wenn das benutzerdefinierte Feld "Stadt" existiert und ein Kontakt den Wert "New York" hat, wird $contact.city durch New York ersetzt. |
Systemvariablen
Variable | Beschreibung |
|---|---|
$system.current_datetime | Ersetzt durch das aktuelle Datum und Uhrzeit in der Zeitzone des Arbeitsbereichs. |
$system.current_date | Wird durch das aktuelle Datum in der Zeitzone des Arbeitsbereichs ersetzt. |
$system.current_time | Wird durch die aktuelle Zeit in der Zeitzone des Arbeitsbereichs ersetzt. |
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.
Trigger-Variablen für „Unterhaltung geöffnet“
Variable | Beschreibung |
|---|---|
$conversation.opened_timestamp | Datum und Uhrzeit der Unterhaltung. |
$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“
Variable | Beschreibung |
|---|---|
$conversation.opened_timestamp | Datum und Uhrzeit, an dem die Unterhaltung eröffnet wurde. |
$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. |
$conversation.closed_by_source | Die Quelle (z.B. Kontakt, Benutzer, Workflow, Zapier, API, Make), die die Unterhaltung schließt. |
$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. |
$conversation.first_assignee | Die Benutzer-ID des ersten Beauftragten. |
$conversation.first_response_time | Die Zeit, die seit Beginn der Konversation bis zur ersten Antwort vergeht. |
$conversation.first_response_by | Die Benutzer-ID des Benutzers, der die erste Antwort gegeben hat. |
$conversation.last_assignment_timestamp | Datum und Uhrzeit der letzten Zuweisung der Unterhaltung. |
$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. |
$conversation.first_assignment_to_first_response_time | Die Zeit, die benötigt wurde, um ab dem Zeitpunkt der ersten Zuweisung der Konversation die erste Antwort zu geben. |
$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. |
$conversation.resolution_time | Die Zeit, die seit dem Öffnen der Konversation zum Abschluss der Konversation benötigt wurde. |
$conversation.first_assignment_to_close_time | Die Zeit, die zum Auflösen der Konversation ab dem Zeitpunkt der ersten Zuweisung der Konversation benötigt wurde. |
$conversation.last_assignment_to_close_time | Die Zeit, die seit der letzten Zuweisung bis zur Schließung der Unterhaltung vergangen ist. |
$conversation.average_response_time | Die durchschnittliche Zeit, die benötigt wird, um auf einen Kontakt zu antworten. |
$conversation.assignments_count | Die Anzahl der Zuweisungen in der Unterhaltung. |
$conversation.incoming_messages_count | Die Anzahl der während der Unterhaltung empfangenen eingehenden Nachrichten. |
$conversation.outgoing_messages_count | Die Anzahl der während der Konversation gesendeten ausgehenden Nachrichten (ausgenommen Broadcast-Nachrichten). |
$conversation.responses_count | Die Anzahl der im Gespräch gesendeten Antworten. |
$conversation.category | Die Kategorie der Unterhaltung, wie in der Schlussnote angegeben. |
$conversation.summary | Die Zusammenfassung der Abschlussnotiz der Unterhaltung. |
Trigger-Variablen für Klick-zu-Chat-Anzeigen
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_type | 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 wiederkehrend |
$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_reference | 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. |
Trigger-Variablen für TikTok-Messaging-Anzeigen
Variable | Beschreibung |
|---|---|
$tiktokmessagingad.ad_timestamp | Zeitpunkt des Klicks auf die Anzeige |
$tiktokmessagingad.ad_first_incoming_message | Erste vom Kontakt gesendete Nachricht |
$tiktokmessagingad.ad_channel_id | ID des Nachrichtenkanals |
$tiktokmessagingad.ad_channel_type | Kanaltyp (z. B. TikTok) |
$tiktokmessagingad.ad_contact_type | Art des Kontakts (z. B. neu oder bestehend) |
$tiktokmessagingad.ad_id | Anzeigen-ID |
$tiktokmessagingad.ad_name | Name der Anzeige |
$tiktokmessagingad.ad_campaign_id | Kampagnen-ID |
$tiktokmessagingad.ad_campaign_name | Kampagnenname |
$tiktokmessagingad.ad_adgroup_id | Anzeigengruppen-ID |
$tiktokmessagingad.ad_adgroup_name | Name der Anzeigengruppe |
$tiktokmessagingad.ad_advertiser_id | Advertiser-ID |
$tiktokmessagingad.ad_operation_status | Betriebsstatus der Anzeige |
$tiktokmessagingad.ad_secondary_status | Sekundärstatus der Anzeige |
Wenn ein Standard-Kontaktfeld denselben Namen wie ein benutzerdefiniertes Kontaktfeld hat, hat die Standard-Kontaktvariable bei der Datenabfrage Vorrang. Damit die Daten korrekt abgerufen werden, stell sicher, dass alle Variablennamen eindeutig sind.
