1. All Collections >
  2. Товар >
  3. Динамические переменные >
  4. Обзор динамических переменных

Обзор динамических переменных

Avatar
Susan Swier
менее минуты чтения

Динамические переменные могут быть использованы для персонализации исходящих сообщений. Обращение к контактам по имени в разговорах может быть ключевым компонентом построения отношений, позволяя им чувствовать себя замеченными и вовлеченными.

На платформе существует три типа динамических переменных:

  1. Стандартные переменные контактов представляют стандартные поля контакта, такие как имя, фамилия и email.

  2. Пользовательские поля контактов представляют настраиваемые поля, добавленные в пространство.

  3. Переменные рабочего процесса являются временными переменными, которые существуют только во время сессии рабочего процесса. После выхода Контакта значение переменной будет стерто.

Существуют три типа переменных рабочего процесса: триггерные переменные, переменные вывода и переменные, созданные с помощью задания шага вопроса.

Динамические переменные: Примеры

Динамические переменные могут быть включены путем добавления префикса "$" в поле контакта. Следующий синтаксис:

$contact, $assignee или $system

Платформа поддерживает интерполяцию статического текста + динамических переменных.

Стандартные переменные контактов

Переменная

Описание

.name $contact

Заменяется на полное имя контакта (Имя + Фамилия).

$contact.firstname

Заменяется на имя контакта.

$contact.lastname

Заменяется фамилией контакта.

$contact.email

Заменяется электронной почтой Контакта.

$contact.страна

Заменяется страной контакта. Если у контакта нет страны сохранения, он не будет заменен и будет отправлена текущая строка.

$contact.id

Заменяется идентификатором контакта Контакта.

Переменные поля пользовательских контактов

Переменная

Описание

$contact.field_name

Заменяется значением в настраиваемом поле. Например, если существует настраиваемое поле "City" и один контакт имеет значение "Нью-Йорк", отправка $contact. Они будут заменены на Нью-Йорк.

Системные переменные

Переменная

Описание

$system.current_datetime

Заменяется на текущую дату и время в часовом поясе Workspace.

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

$system.current_date

Заменяется на текущую дату в часовом поясе рабочей области.

Формат: ГГГГ-ММ-ДД (например, 2023-01-10)

$system.current_time

Заменяется текущим временем в часовом поясе рабочей области.

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

Назначенные переменные

Переменная

Описание

$assignee.id

Заменяется идентификатором пользователя получателя для Контакта.

.$assignee.name

Заменяется на полное имя ответственного за контакт (Имя + Фамилия).

$assignee.email

Заменяется на адрес электронной почты получателя для Контакта.

$assignee.firstname

Заменяется на имя получателя контакта.

$assignee.lastname

Заменяется фамилией ответственного за контакт.

$assignee.команда

Заменяется на имя команды исполнителя.

Рабочий процесс - Триггер переменные

Переменные триггера являются переменными, которые связаны с триггером рабочего процесса. Они доступны только в том случае, если для Рабочего процесса используется конкретный триггер.

Переменные триггера для открытого диалога

Переменная

Описание

$conversation.opened_timestamp

Дата и время начала разговора.

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

$conversation.opened_by_source

Источник (например, Contact, User, Workflow, Zapier, API, Make), который инициирует разговор.

$conversation.opened_by_channel

ID канала, который вызывает разговор открыт.

$conversation.contact_type

Тип контакта (Новый Контакт или Обратный Контакт) в разговоре.

$conversation.first_incoming_message

Первое входящее сообщение разговора после открытия чата.

$conversation.first_incoming_message_channel_id

ID канала первого входящего сообщения разговора после открытия разговора

Переменные триггера для закрытия разговоров.

Переменная

Описание

$conversation.opened_timestamp

Дата и время открытия беседы.

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

$conversation.opened_by_source

Источник (например, Контакт, Пользователь, Рабочий процесс, Zapier, API, Make), который вызывает открытие разговора.

$conversation.opened_by_channel

ID канала, который вызывает открытие разговора.

$conversation.closed_time

Дата и время закрытия беседы.

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

$conversation.closed_by_source

Источник (например, Контакт, Пользователь, Рабочий процесс, Zapier, API, Make), который вызывает закрытие разговора.

$conversation.closed_by

ID пользователя, который закрыл разговор. Если разговор закрыт ботом, рабочим процессом или API, это поле будет пустым.

$conversation.closed_by_team

ID команды пользователя, который закрыл разговор.

$conversation.contact_type

Тип контакта (Новый Контакт или Обратный Контакт) в разговоре.

$conversation.assignee_team

Имя команды пользователя, который назначил разговор.

$conversation.first_assignment_timamp

Дата и время первого назначения разговора.

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

$conversation.first_assignee

ID пользователя первого исполнителя.

$conversation.first_response_time

Время, необходимое для предоставления первого ответа с момента открытия беседы.

Нет значения, если возникает одно из следующих значений:
- разговор закрыт без ответа.
- если первый ответ предоставлен API или Контакт был назначен пользователю ранее, а затем разговор открыт агентом.

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

$conversation.first_response_by

ID пользователя, который дал первый ответ.

$conversation.last_assignment_timestamp

Дата и время последнего назначения разговора.

Не показывается значение, если возникает одно из следующих значений:
- разговор закрыт без исполнителя.
- в разговоре не происходит назначения, например, разговор был назначен пользователю до того, как разговор был открыт.

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

$conversation.last_assignee

ID пользователя последнего исполнителя.

$conversation.time_to_first_assignment

Время, необходимое для первого назначения разговора первому пользователю.

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

$conversation.first_assignment_to_first_response_time

Время, необходимое для предоставления первого ответа с момента первого назначения разговора.

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

$conversation.last_assignment_to_response_time

Время, необходимое для предоставления первого ответа последним назначенным лицом с момента последнего назначения разговора.

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

$conversation.resolution_time

Время, необходимое для разрешения разговора с момента его открытия.

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

$conversation.first_assignment_to_close_time

Время, необходимое для разрешения разговора с момента, когда разговор был впервые назначен.

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

$conversation.last_assignment_to_close_time

Время, необходимое для разрешения разговора с момента последнего назначения разговора.

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

$conversation.average_response_time

Среднее время, необходимое для ответа клиенту.
Format: hh:mm:ss (e.g. 00:19:08)

$conversation.assignments_count

Количество заданий в разговоре.

$conversation.incoming_messages_count

Количество входящих сообщений во время разговора.

$conversation.outgoing_messages_count

Количество исходящих сообщений, посланных во время разговора (за исключением сообщений).

$conversation.responses_count

Количество ответов, отправленных в разговоре.

$conversation.категория

Категория разговора, указанная в закрывающей заметке.

Итог $conversation

Резюме заключительной заметки разговора.

Переменные триггера для срабатывания клика в чате

Имя переменной

Описание

$clicktochat.ad_timestamp

Отметка времени при получении входящего сообщения.

$clicktochat.ad_first_incoming_message

Первое сообщение в разговоре, полученном от Click-to-Chat .

$clicktochat.ad_channel_id

ID канала, через который было получено входящее объявление.

Тип канала $clicktochat.

Канал, через который проходит связанный с рекламой разговор.

Тип контакта $clicktochat.

Тип контакта, связанного с рекламой: новый или возвращаемый

ID объявления $clicktochat.

Номер ID CTC.

Название объявления $clicktochat.

Название объявления КТК.

ID кампании $clicktochat.

Номер ID кампании КТК

Название кампании $clicktochat.

Название кампании КТК.

$clicktochat.ad_adset_id

Номер adset ID CTC.

$clicktochat.ad_adset_name

Имя объявления КТК.

URL объявления $clicktochat.

URL объявления КТК.

$clicktochat.ad_reference

Ссылка, связанная с рекламой КТК.

$clicktochat.ad_status

Статус объявления CTC

Цель объявления $clicktochat.

Цель КТК сделана.

$clicktochat.ad_optimization_goal

Цель оптимизации объявления КТК.

$clicktochat.ad_destination_type

Тип назначения, связанный с рекламой КТК.

В случае, если стандартное поле контакта разделяет то же имя, что и пользовательское поле контакта, приоритет для извлечения данных будет отдан стандартной переменной контакта. Для корректного извлечения данных убедитесь, что все имена переменных уникальны.

Поделиться этой статьей
Telegram
Facebook
Linkedin
Twitter

Не удается найти то, что вы ищете? 🔎