.top-button { background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/baseline_keyboard_arrow_up_white_18dp.png) !important; background-position: center; background-color: #47a7f5 !important; background-repeat: no-repeat; box-shadow: -1px 1.5px 3px #999; color: #47a7f5 !important; border-radius:50px !important; position: fixed; bottom: 45px; left: 93.5%; width: 50px; height: 50px !important; font-size: 12px !important; padding: 14.5px !important; z-index: 2; } .top-button:hover{ background-color: #65b9ff !important; color: #65b9ff !important; } .page-header{ background-color: #232838; background-repeat: no-repeat; background-position: center; width: auto; height: 100px; background-image: url(https://confluence.twin24.ai/download/attachments/23986188/logo_twin-02.png); background-size: 10em; color: #fff; font-size: 20px; padding: 20px; } .page-footer{ background-color: #232838; background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/decorated-pattern-dark.png); width: auto; height: 10px; color: #fff; text-align: end; font: small-caption; padding-inline-end: 30px; padding-top: 200px; padding-bottom: 30px; } .page-headline{ background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/Solid256dot8_2changed.png); background-repeat: no-repeat; background-position-x: -227px; background-position-y: center; padding: 20px; background-color: #007bff; width: auto; height: 10px; color: #fff; text-align: center; font: caption; font-weight: 600; } .tabs-menu{ padding-left: 85% !important; }

Средства форматирования даты и времени

При помощи программных средств можно отображать дату и время в желаемом формате. Например, клиент может написать в диалоге следующую фразу: «третьего октября в восемь». Ответ клиента можно сохранить в переменную, а в дальнейшем (при необходимости) отобразить в диалоге в нужном виде, например: 2022-10-03 в 08:00, 08:00 03-10, 22-10-03, 03.10.22, в 08:00, 08:00 АМ, Monday и др.

Программные средства форматирования даты и времени можно использовать в сценариях в виджетах, социальных сетях и мессенджерах. В телефонии форматирование даты и времени не поддерживается.

По умолчанию дата и время отображаются в сценариях в следующих форматах:

Дата: ГГГГ-ММ-ДД
Время: ЧЧ:ММ:СС
Дата и время: ГГГГ-ММ-ДД ЧЧ:ММ:СС

Для форматирования дат и времени служит следующий шаблон: {<имя переменной>|формат: код или коды форматирования}.

Список кодов форматирования:

В качестве примера ниже используются следующие дата и время: «3 октября 2022, 8:15 ».

Код форматирования	Описание/обозначение	Пример использования	Результат
a	"am" или "pm"	{имя переменной\|формат:а}	ам
A	"AM" или "PM"	{имя переменной\|формат:A}	АМ
d	день месяца (01-31)	{имя переменной\|формат:d}	03
D	сокращенное название дня недели (первые три буквы)	{имя переменной\|формат:D}	Mon
F	полное название месяца	{имя переменной\|формат:F}	October
g	часы (12-часовой формат без ведущих нулей)	{имя переменной\|формат:g}	8
G	часы (24-часовой формат без ведущих нулей)	{имя переменной\|формат:G}	8
h	часы (12-часовой формат)	{имя переменной\|формат:h}	08
H	часы (24-часовой формат)	{имя переменной\|формат:H}	08
i	минуты (00-59)	{имя переменной\|формат:i}	15
j	день месяца без ведущих нулей (1-31)	{имя переменной\|формат:j}	3
l	полное название дня недели	{имя переменной\|формат:l}	Monday
L	признак високосного года (0 – обычный год или 1 – високосный год)	{имя переменной\|формат:L}	0
m	номер месяца (01-12)	{имя переменной\|формат:m}	10
M	сокращенное название месяца (три буквы)	{имя переменной\|формат:M}	Oct
n	месяц (1-12)	{имя переменной\|формат:n}	10
s	секунды (00-59)	{имя переменной\|формат:s}	00
t	количество дней в данном месяце (28-31)	{имя переменной\|формат:t}	31
w	номер дня недели (0 – воскресенье, 6 – суббота)	{имя переменной\|формат:w}	1
y	год (последние два разряда)	{имя переменной\|формат:y}	22
Y	год (четыре разряда)	{имя переменной\|формат:Y}	2022
z	номер дня в году (0-365)	{имя переменной\|формат:z}	275

Вы можете использовать одновременно несколько кодов форматирования из списка выше. В качестве разделителя можно использовать различные символы: точка, запятая, точка с запятой, двоеточие, плюс, минус и др. В строке форматирования также можно использовать различные слова и фразы. Например:

При перечислении нескольких кодов форматирования разделитель также можно не использовать.

Строка форматирования	Результат
{имя переменной\|формат:l d.m.y}	Monday 03.10.22
{имя переменной\|формат: текущий день: l, текущая дата: d.m.y}	текущий день: Monday, текущая дата: 03.10.22
{имя переменной\|формат:h:i:s}	08:15:00.
{имя переменной\|формат:g часов i минут s секунд}	8 часов 15 минут 00 секунд

Полный список переменных:

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

{системные.сейчас} возвращает текущие дату и время по UTC (например, 2019-11-22 04:06:58).
{компания.сейчас} возвращает текущие дату и время с учетом часового пояса, в котором расположена компания (например, 2019-11-22 04:06:58).
{системные.сегодня} возвращает текущую дату без указания времени (например, 2019-11-22).
{компания.сегодня} возвращает текущую дату без указания времени (например, 2019-11-22). При этом учитывается часовой пояс, в котором расположена компания.
{системные.время} возвращает текущее время без указания даты (например, 04:06:58).
{компания.время} возвращает текущее время без указания даты (например, 04:06:58). При этом учитывается часовой пояс, в котором расположена компания.
{системные.телефон} возвращает номер телефона клиента, который указан в задании на обзвон для выполнения вызова.
{системные.предыдущий} возвращает ID предыдущего сценария, из которого система во время диалога с пользователем перенаправила бота в другой сценарий.
{системные.дозвон} возвращает количество успешных дозвонов до кандидата в рамках задания на обзвон.
{системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии.
{системные.расшифровка} – возвращает строку с полным текстом диалога.
{recordPath} возвращает ссылку на скачивание аудиозаписи текущего диалога в телефонии CIS.

Возможные значения переменной детектор.эмоции

{детектор.эмоции}=negative – негативная эмоциональная окраска.
{детектор.эмоции}=positive – позитивная эмоциональная окраска.
{детектор.эмоции}=neutral – нейтральная эмоциональная окраска.

Склонение значений пользовательских переменных по падежам

{переменная|падеж:имя_падежа} – формат записи имен пользовательских переменных, который позволяет склонять их значения по падежам.

Переменные, значения которых не меняются в процессе диалога

{companyId} – возвращает строку с идентификатором компании, которой принадлежит бот.
{botId} – возвращает строку с идентификатором бота.
{dialogId} – возвращает строку с идентификатором текущего диалога.
{dialog} – возвращает строку с полным текстом диалога.
{referer} – возвращает строку с адресом главной страницы сайта, на которой размещен виджет (позволяет понять, с какого сайта пишет пользователь).
{utcNow} – возвращает текущие дату и время в часовом поясе по UTC.
{utcTime} – возвращает текущее время в часовом поясе по UTC.
{utcToday} – возвращает текущую дату в часовом поясе по UTC.

Переменные с информацией об участнике диалога

{clientId} – возвращает строку с внутренним идентификатором клиента в системе Twin (uuid).
{clientPhone} – возвращает строку с номером телефона клиента.
{clientEmail} – возвращает строку с адресом электронной почты клиента.
{clientName} – возвращает строку с именем клиента.
{clientNickname} – возвращает строку с псевдонимом клиента.
{clientExternalId} – возвращает строку с внешним идентификатором клиента в системе.
{clientMetadata} – возвращает массив, содержащий любые данные о клиенте (задается в следующем формате: {"{firstName}": "Иван", "{middleName}": "Иванович", "{lastName}": "Иванов"}.

Переменные, значения которых можно изменить только при переключении со звонка на чат и наоборот

{communicationType} – строка, тип коммуникации с клиентом. Допустимые значения: TEXT, VOICE.

Склонение значений пользовательских переменных по падежам

{переменная|падеж:имя_падежа} – формат записи имен пользовательских переменных, который позволяет склонять их значения по падежам.

Пример использования:

{userName|падеж:родительный} - где userName, например: Иван Иванович.

Например, требуется задать вопрос: «Могу я услышать Ивана Ивановича?». Чтобы бот использовал значение переменной в родительном падеже, в сообщении, которое будет озвучено ботом в блоке Вопрос, нужно указать следующее: «Могу я услышать {userName|падеж:родительный}?»

Поддерживаются все падежи:

Именительный (кто? что?) – пример: «это кто?» - «Иван Иванович»;
Родительный (кого? чего?) – пример: «нет кого?» - «Ивана Ивановича»;
Дательный (кому? чему?) – пример: «кому вы рады?» - «Ивану Ивановичу»;
Винительный (кого? что?) – пример: «кого/что вы видите?» - «Ивана Ивановича»;
Творительный (кем? чем?) – пример: «кем восхищаетесь?» - «Иваном Ивановичем»;
Предложный (о ком? о чем?) – пример: «о ком думаете?» - об «Иване Ивановиче».

Документация пользователя Twin > Системные переменные > o22.png

Переменные, значения которых не меняются в процессе диалога

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

{companyId} – возвращает строку с идентификатором компании, которой принадлежит бот.
{botId} – возвращает строку с идентификатором бота.
{dialogId} – возвращает строку с идентификатором текущего диалога.
{dialog} – возвращает строку с полным текстом диалога.
{referer} – возвращает строку с адресом главной страницы сайта, на которой размещен виджет (позволяет оператору понять, с какого сайта пишет пользователь).
{utcNow} – возвращает текущие дату и время в часовом поясе по UTC.
{utcTime} – возвращает текущее время в часовом поясе по UTC.
{utcToday} – возвращает текущую дату в часовом поясе по UTC
{messengerUserId} – возвращает идентификатор учетной записи пользователя в мессенджере.

Пример использования:

Например, после завершения диалога бот может отправить письмо на электронную почту клиента с полным текстом диалога:

Документация пользователя Twin > Системные переменные > prerivanie12.png

Переменные с информацией об участнике диалога

Ниже приводится список переменных, значения которых можно изменять в процессе диалога:

{clientId} – возвращает строку с внутренним идентификатором клиента в системе Twin (uuid).
{clientPhone} – возвращает строку с номером телефона клиента.
{clientEmail} – возвращает строку с адресом электронной почты клиента.
{clientName} – возвращает строку с именем клиента.
{clientNickname} – возвращает имя клиента (никнейм) в мессенджере, в котором клиент общался с ботом.
{clientExternalId} – возвращает строку с внешним идентификатором клиента в системе.
{clientMetadata} – возвращает массив, содержащий любые данные о клиенте (задается в следующем формате: {"{firstName}": "Иван", "{middleName}": "Иванович", "{lastName}": "Иванов"}.

Значения данных переменных бот может получать по различным каналам связи (например, Viber, WhatsApp, Telegram и др.). Чтобы изменить значение любой из этих переменных, нужно определить соответствующую переменную в сценарии.

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

Документация пользователя Twin > Системные переменные > prerivanie15.png

Переменные, значения которых можно изменить только при переключении со звонка на чат и наоборот

(Данный функционал недоступен в полном объеме. На текущий момент указанные ниже переменные можно использовать, например, чтобы определить, в каком мессенджере происходит диалог с клиентом).

{communicationType} – строка, тип коммуникации с клиентом. Допустимые значения: TEXT, VOICE;
{channelType} – строка, тип канала общения. Допустимые значения: WEB, MOBILE, MESSENGER;
{messenger} – строка, тип мессенджера. Допустимые значения: WHATSAPP, VIBER, TELEGRAM, VKONTAKTE, FACEBOOK*, SKYPE, SLACK, YANDEX, ALICE, THREADS.

Пример использования:

Во время диалога бот может уточнить у клиента, удобно ли ему общаться в текущем мессенджере. Впоследствии бот может перевести диалог на телефон.

Документация пользователя Twin > Системные переменные > prerivanie16.png

Переменные, значения которых меняются при каждом обращении к боту

{percept} – возвращает строку с последним ответом клиента на вопрос бота.
{clientLastAnswerTime} – возвращает время последнего ответа пользователя на вопрос бота. Значение отображается в виде временной метки Unix-времени.
{botLastAnswerTime} – возвращает время последнего ответа бота в секундах. Значение отображается в виде временной метки Unix-времени.

Временная метка Unix-времени (например, 1658125300) отображает количество секунд, которое прошло с 1 января 1970 года (00:00:00 UTC).

Данные переменные используются для входящей телефонии и в чатах в основном для отладочных целей.

Список переменных будет обновляться по мере появления новых переменных на платформе Twin.

{channelType} – строка, тип канала общения. Допустимые значения: WEB, MOBILE, MESSENGER.

{messenger} – строка, тип мессенджера. Допустимые значения: WHATSAPP, VIBER, TELEGRAM, VKONTAKTE, FACEBOOK*, SKYPE, SLACK, YANDEX, ALICE, THREADS.

Переменные, значения которых меняются при каждом обращении к боту

{percept} – возвращает строку с последним ответом клиента на вопрос бота.
{clientLastAnswerTime} – возвращает время последнего ответа пользователя на вопрос бота. Значение отображается в виде временной метки Unix-времени.
{botLastAnswerTime} – возвращает время последнего ответа бота в секундах. Значение отображается в виде временной метки Unix-времени.

* Деятельность организации Meta Platforms Inc. и ее продуктов Instagram и Facebook запрещена в Российской Федерации.