Динамические переменные могут быть использованы для персонализации исходящих сообщений. Обращение к контактам по имени в разговорах может быть ключевым компонентом построения отношений, позволяя им чувствовать себя замеченными и вовлеченными.
На платформе существует три типа динамических переменных:
Стандартные переменные контактов представляют стандартные поля контакта, такие как имя, фамилия и электронная почта.
Переменные пользовательских полей контакта представляют настраиваемые поля, добавленные в проект.
Переменные автоматизированного алгоритма — временные переменные, которые существуют только во время сессии Автоматизированного алгоритма. После того как Контакт покинет автоматизированный алгоритм, значение переменной будет стерто.
Существуют три типа переменных автоматизированного алгоритма: триггерные переменные, переменные вывода и переменные, создаваемые на шаге «Ask a Question».
Примеры динамических переменных
Динамические переменные можно включить, добавив префикс "$" к полю Контакта. Ниже приведён синтаксис:
$contact, $assignee или $system
Платформа поддерживает интерполяцию статического текста + динамических переменных.
Стандартные переменные Контакта
Переменная | Описание |
|---|---|
$contact.name | Заменяется на полное имя Контакта (Имя + Фамилия). |
$contact.firstname | Заменяется на имя Контакта. |
$contact.lastname | Заменяется на фамилию Контакта. |
$contact.email | Заменяется на адрес электронной почты Контакта. |
$contact.country | Заменяется на страну Контакта. Если у Контакта не указана страна, переменная не будет заменена и будет отправлена исходная строка. |
$contact.id | Заменяется на идентификатор Контакта. |
Переменные пользовательских полей Контакта
Переменная | Описание |
|---|---|
$contact.field_name | Заменяется на значение из пользовательского поля. Например, если существует пользовательское поле «City», и у Контакта в нём значение «New York», то при отправке $contact.city оно будет заменено на New York. |
Системные переменные
Переменная | Описание |
|---|---|
$system.current_datetime | Заменяется на текущую дату и время в часовом поясе Проекта. |
$system.current_date | Заменяется на текущую дату в часовом поясе проекта. |
$system.current_time | Заменяется на текущее время в часовом поясе проекта. |
Переменные назначенного
Переменная | Описание |
|---|---|
$assignee.id | Заменяется на идентификатор пользователя, назначенного для Контакта. |
$assignee.name | Заменяется на полное имя назначенного пользователя для Контакта (Имя + Фамилия). |
$assignee.email | Заменяется на адрес электронной почты назначенного пользователя для Контакта. |
$assignee.firstname | Заменяется на имя назначенного пользователя для Контакта. |
$assignee.lastname | Заменяется на фамилию назначенного пользователя для Контакта. |
$assignee.team | Заменяется на название команды назначенного пользователя. |
Переменные запуска автоматизированного алгоритма
Переменные триггера являются переменными, которые связаны с запуском автоматизированного алгоритма. Они доступны только при использовании соответствующего запуска в автоматизированном алгоритме.
Переменные триггера для события открытия разговора
Переменная | Описание |
|---|---|
$conversation.opened_timestamp | Дата и время открытия разговора. |
$conversation.opened_by_source | Источник (например, Контакт, Пользователь, Автоматизированный алгоритм, 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 | Дата и время открытия разговора. |
$conversation.opened_by_source | Источник (например, Контакт, Пользователь, Автоматизированный алгоритм, Zapier, API, Make), который инициирует открытие разговора. |
$conversation.opened_by_channel | ID канала, который вызывает открытие разговора. |
$conversation.closed_time | Дата и время закрытия разговора. |
$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_timestamp | Дата и время первого назначения разговора. |
$conversation.first_assignee | ID пользователя первого исполнителя. |
$conversation.first_response_time | Время, необходимое для предоставления первого ответа с момента открытия разговора. |
$conversation.first_response_by | ID пользователя, который дал первый ответ. |
$conversation.last_assignment_timestamp | Дата и время последнего назначения разговора. |
$conversation.last_assignee | ID пользователя последнего исполнителя. |
$conversation.time_to_first_assignment | Время, необходимое для первоначального назначения разговора первому пользователю. |
$conversation.first_assignment_to_first_response_time | Время до первого ответа с момента первого назначения разговора. |
$conversation.last_assignment_to_response_time | Время до первого ответа последнего назначенного с момента последнего назначения разговора. |
$conversation.resolution_time | Время до закрытия разговора с момента его открытия. |
$conversation.first_assignment_to_close_time | Время до закрытия разговора с момента его первого назначения. |
$conversation.last_assignment_to_close_time | Время до закрытия разговора с момента его последнего назначения. |
$conversation.average_response_time | Среднее время ответа Контакту. |
$conversation.assignments_count | Количество назначений в разговоре. |
$conversation.incoming_messages_count | Количество входящих сообщений, полученных во время разговора. |
$conversation.outgoing_messages_count | Количество исходящих сообщений, отправленных во время разговора (без учёта сообщений для рассылки). |
$conversation.responses_count | Количество ответов, отправленных в разговоре. |
$conversation.category | Категория разговора, указанная в закрывающей заметке. |
$conversation.summary | Резюме заключительной заметки разговора. |
Переменные триггера для объявлений Click-to-Chat
Имя переменной | Описание |
|---|---|
$clicktochat.ad_timestamp | Отметка времени, когда было получено входящее сообщение. |
$clicktochat.ad_first_incoming_message | Первое сообщение в разговоре, полученное в результате объявления Click-to-Chat. |
$clicktochat.ad_channel_id | ID канала, через который было получено входящее рекламное сообщение. |
$clicktochat.ad_channel_type | Канал, через который проходит связанный с рекламой разговор. |
$clicktochat.ad_contact_type | Тип контакта, связанного с объявлением: новый или существующий |
$clicktochat.ad_id | ID объявления CTC. |
$clicktochat.ad_name | Название объявления CTC. |
$clicktochat.ad_campaign_id | ID кампании CTC. |
$clicktochat.ad_campaign_name | Название кампании CTC. |
$clicktochat.ad_adset_id | ID adset объявления CTC. |
$clicktochat.ad_adset_name | Название adset объявления CTC. |
$clicktochat.ad_ad_url | URL объявления CTC. |
$clicktochat.ad_reference | Ссылка, связанная с объявлением CTC. |
$clicktochat.ad_status | Статус объявления CTC. |
$clicktochat.ad_objective | Цель объявления CTC. |
$clicktochat.ad_optimization_goal | Цель оптимизации объявления CTC. |
$clicktochat.ad_destination_type | Тип назначения, связанный с объявлением CTC. |
Переменные триггера для рекламных сообщений TikTok
Переменная | Описание |
|---|---|
$tiktokmessagingad.ad_timestamp | Время клика по объявлению |
$tiktokmessagingad.ad_first_incoming_message | Первое сообщение, отправленное контактом |
$tiktokmessagingad.ad_channel_id | Идентификатор канала обмена сообщениями |
$tiktokmessagingad.ad_channel_type | Тип канала (например, TikTok) |
$tiktokmessagingad.ad_contact_type | Тип контакта (например, новый или существующий) |
$tiktokmessagingad.ad_id | ID объявления |
$tiktokmessagingad.ad_name | Название объявления |
$tiktokmessagingad.ad_campaign_id | ID кампании |
$tiktokmessagingad.ad_campaign_name | Название кампании |
$tiktokmessagingad.ad_adgroup_id | ID группы объявлений |
$tiktokmessagingad.ad_adgroup_name | Название группы объявлений |
$tiktokmessagingad.ad_advertiser_id | ID рекламодателя |
$tiktokmessagingad.ad_operation_status | Текущий статус объявления |
$tiktokmessagingad.ad_secondary_status | Вторичный статус объявления |
Если стандартное поле контакта имеет то же имя, что и пользовательское поле контакта, приоритет при извлечении данных будет отдан стандартной переменной контакта. Для корректного извлечения данных убедитесь, что все имена переменных уникальны.
