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 beim Kontakt kein Land gespeichert ist, wird die Variable 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. |
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.
Systemvariablen
Variable | Beschreibung |
|---|---|
$system.current_datetime | Wird durch das aktuelle Datum und die Uhrzeit in der Zeitzone des Arbeitsbereichs ersetzt. |
$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 des 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, zu der die Unterhaltung geöffnet wurde. |
$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 das Öffnen der Unterhaltung ausgelöst hat. |
$conversation.contact_type | Der Kontakttyp (Neuer Kontakt oder wiederkehrender Kontakt) der Unterhaltung. |
$conversation.first_incoming_message | Die erste eingehende Nachricht 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 |
$conversation.first_incoming_message_type | Der Nachrichtentyp der ersten eingehenden Nachricht, nachdem die Unterhaltung geöffnet wurde (z. B. Instagram Story-Antworten, Instagram Story-Erwähnungen oder Reaktion). |
$conversation.opened_by_widget_name | Der Name des Growth-Widgets, das die Unterhaltung ausgelöst hat. |
$conversation.opened_by_widget_website | Die Website, auf der das Growth-Widget eingebettet ist. |
$conversation.opened_by_widget_page_url | Die URL der Seite, auf der das Growth-Widget eingebettet ist. |
Trigger-Variablen für „Unterhaltung geschlossen“
Variable | Beschreibung |
|---|---|
$conversation.opened_timestamp | Datum und Uhrzeit, zu der 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 das Öffnen der Unterhaltung ausgelöst hat. |
$conversation.closed_time | Datum und Uhrzeit, zu denen 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 die Unterhaltung 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 vom Öffnen der Unterhaltung bis zur ersten Antwort verstrichen ist. |
$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 ab dem Zeitpunkt der ersten Zuweisung der Unterhaltung bis zur ersten Antwort verging. |
$conversation.last_assignment_to_response_time | Die Zeit, die der letzte Beauftragte ab dem Zeitpunkt der letzten Zuweisung bis zur ersten Antwort benötigt hat. |
$conversation.resolution_time | Die Zeit, die vom Öffnen der Unterhaltung bis zu ihrem Abschluss benötigt wurde. |
$conversation.first_assignment_to_close_time | Die Zeit, die ab dem Zeitpunkt der ersten Zuweisung benötigt wurde, um die Unterhaltung zu schließen. |
$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 eingehenden Nachrichten, die während der Unterhaltung empfangen wurden. |
$conversation.outgoing_messages_count | Die Anzahl der während der Unterhaltung gesendeten ausgehenden Nachrichten (ausgenommen Broadcast‑Nachrichten). |
$conversation.responses_count | Die Anzahl der in der Unterhaltung gesendeten Antworten. |
$conversation.category | Die Kategorie der Unterhaltung, wie in der Schlussnote angegeben. |
$conversation.summary | Die Zusammenfassung der Abschlussnotiz der Unterhaltung. |
$conversation.sentiment | Das Sentiment-Label, das beim Schließen der Unterhaltung vergeben wurde: positiv, neutral, negativ oder nicht verfügbar. |
$conversation.sentiment_reason | Die Ein‑Satz‑Begründung für das Etikett. |
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, über den die werbebezogene Unterhaltung stattfindet. |
$clicktochat.ad_contact_type | Die Art des Kontakts, der der Anzeige zugeordnet ist: neu oder wiederkehrend |
$clicktochat.ad_id | Die CTC-Anzeigen-ID. |
$clicktochat.ad_name | Der Name der CTC-Anzeige. |
$clicktochat.ad_campaign_id | Die ID der CTC-Werbekampagne. |
$clicktochat.ad_campaign_name | Der CTC-Kampagnenname. |
$clicktochat.ad_adset_id | Die CTC-Adset-ID. |
$clicktochat.ad_adset_name | Name des CTC-Adsets. |
$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 mit der CTC-Anzeige verknüpften Ziels. |
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 |
Trigger-Variablen für den 'Call Ended'-Trigger
Variable | Beschreibung | Mögliche Werte |
|---|---|---|
$call.event_id | Die eindeutige ID des Anrufereignisses. | String |
$call.id | Die eindeutige ID des Anrufs. | String |
$call.direction | Die Richtung des Anrufs. | Eingehend, Ausgehend |
$call.language | Die Sprache des Anrufs. | Sprachcode (z. B. eng) |
$call.status | Der Status des Anrufs. | Verpasst, Abgeschlossen |
$call.duration_seconds | Die Dauer des Anrufs in Sekunden. | Zahl |
$call.start_time | Zeitstempel des Beginns des Anrufs. | Datum/Uhrzeit |
$call.end_time | Zeitstempel des Endes des Anrufs. | Datum/Uhrzeit |
$call.contact_id | Die eindeutige ID des mit dem Anruf verknüpften Kontakts. | String |
$call.contact_first_name | Der Vorname des mit dem Anruf verknüpften Kontakts. | String |
$call.contact_last_name | Der Nachname des mit dem Anruf verknüpften Kontakts. | String |
$call.contact_phone | Die Telefonnummer des mit dem Anruf verknüpften Kontakts. | String |
$call.user_id | Die eindeutige ID des Agenten, der den Anruf bearbeitet hat. | String |
$call.user_first_name | Der Vorname des Agenten, der den Anruf bearbeitet hat. | String |
$call.user_last_name | Der Nachname des Agenten, der den Anruf bearbeitet hat. | String |
$call.user_email | Die E-Mail-Adresse des Agenten, der den Anruf bearbeitet hat. | String |
$call.channel_id | Die eindeutige ID des Kanals, auf dem der Anruf stattgefunden hat. | String |
$call.recording_url | Die URL der Anrufaufzeichnung, falls die Aufzeichnung aktiviert ist. | URL |
$call.summary_title | Der Titel der KI-erstellten Anrufzusammenfassung. | String |
$call.summary_summary | Der Text der KI-erstellten Anrufzusammenfassung. | String |
$call.summary_action_items | Die aus der KI-erstellten Anrufzusammenfassung extrahierten Maßnahmen. | String |
$call.sentiment | Die beim Beenden des Anrufs zugewiesene Stimmungsbezeichnung. | positiv, neutral, negativ, nicht verfügbar |
$call.sentiment_reason | Die einzeilige Begründung für das Stimmungslabel. | Zeichenkette |
Hinweis: Das Anruftranskript ist nicht als Trigger-Variable verfügbar. Nur die oben aufgeführten Variablen werden unterstützt.