На платформе TWIN существуют системные переменные, которые можно использовать в любом сценарии. Системные переменные не нужно объявлять и записывать в них данные – вы можете сразу использовать их в своих сценариях.
При указании переменных в сообщениях блоков нужно использовать фигурные скобки. Например, чтобы добавить в сценарий переменную «системные.сегодня» укажите ее следующим образом: {системные.сегодня}.
Помимо системных переменных можно использовать в сценариях свои собственные переменные. Имя переменной может быть любым. Однако, существует ограничение: имя переменной не должно содержать точку. Данный символ используется только в именах встроенных переменных. Примеры:
|
В сценариях можно использовать следующие переменные группы «Системные»:
Переменная {системные.сейчас} возвращает текущие дату и время по UTC (например, 2019-11-22 04:06:58). Текущие дата и время определяются во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {now}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в магазин.
Бот произносит сообщение: «Внимание! В течение этого месяца у нас проходит грандиозная распродажа! Цены снижены до 30%. Сегодня {системные.сейчас}. Торопитесь успеть!»
Чтобы бот отображал время для конкретного часового пояса, нужно использовать дополнительный блок Арифметическая операция. Для параметра Тип нужно выбрать значение Дата. В поле Смещение от даты нужно ввести название системной переменной {системные.сейчас} и задать смещение в секундах. Смещение происходит от текущего времени по UTC. То есть если вы хотите, чтобы бот указал текущее время, например, в Волгограде (UTC + 3), нужно задать смещение равное 10800 (количество секунд в 3 часах). Результат нужно сохранить в пользовательскую переменную. После этого пользовательскую переменную можно использовать в тексте сообщения.
Переменная {компания.сейчас} возвращает текущие дату и время с учетом часового пояса, в котором расположена компания (например, 2019-11-22 04:06:58). Текущие дата и время определяются во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {company.now}. В исходящей телефонии аналог не работает. |
Переменная {системные.сегодня} возвращает текущую дату без указания времени (например, 2019-11-22). Текущая дата определяется во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {today}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент создает заказ и хочет узнать, когда он сможет его забрать.
Бот отвечает клиенту: «Заказ будет готов к получению {системные.сегодня}, начиная с 18.00».
Чтобы бот вместе с датой отображал еще и время, нужно использовать блок Арифметическая операция. Для параметра Тип нужно выбрать значение Дата. В поле Смещение от даты нужно ввести название системной переменной {системные.сегодня} и задать смещение в секундах. Смещение происходит от начала суток (00.00). То есть если вы хотите, чтобы бот отобразил текущую дату и указал время, например, 9.00, нужно задать смещение равное 32400 (количество секунд в 9 часах). Результат нужно сохранить в пользовательскую переменную. После этого пользовательскую переменную можно использовать в тексте сообщения.
Переменная {компания.сегодня} возвращает текущую дату без указания времени (например, 2019-11-22). При этом учитывается часовой пояс, в котором расположена компания. Текущая дата определяется во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {company.today}. В исходящей телефонии аналог не работает. |
Переменная {системные.время} возвращает текущее время без указания даты (например, 04:06:58). Текущее время определяется во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {time}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в справочную аэропорта, чтобы уточнить, до какого времени осуществляется посадка на рейс.
Бот отвечает клиенту: «Посадка на рейс в Лондон заканчивается в 18.45. Сейчас: {системные.время}».
Переменная {компания.время} возвращает текущее время без указания даты (например, 04:06:58). При этом учитывается часовой пояс, в котором расположена компания. Текущее время определяется во время диалога с клиентом.
Для входящей телефонии и чатов данная переменная имеет аналог {company.time}. В исходящей телефонии аналог не работает. |
Переменная {системные.телефон} возвращает номер телефона клиента, который указан в задании на обзвон для выполнения вызова.
Эта переменная предназначена для сценариев, которые используются в телефонии и мессенджерах. Для входящей телефонии переменная имеет аналог {phone}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в магазин, чтобы узнать срок действия заказа.
Бот отвечает клиенту: «Уточните, заказ оформлен на номер {системные.телефон}?» После завершения разговора бот отправляет шаблонное SMS-сообщение с информацией о заказе на номер клиента:
Переменная {системные.предыдущий} возвращает ID сценария, из которого система перенаправила бота в другой сценарий во время диалога с пользователем (также см. Как перевести диалог бота с клиентом в другой сценарий).
Пример использования:
При переходе в новый сценарий можно выполнить проверку, из какого сценария был выполнен переход. Эта проверка позволяет перенаправить клиента на отдельную ветку, которая не содержит вопросы, которые бот задавал клиенту в предыдущем сценарии.
Переменная {системные.дозвон} возвращает количество дозвонов до кандидата в рамках задания на обзвон. Считаются все результативные звонки по номеру кандидата.
Тестировать переменную необходимо с помощью исходящих звонков. При тестировании в редакторе переменная {системные.дозвон} будет иметь пустое значение. Если в задании на обзвон несколько кандидатов с одинаковыми номерами телефона, то счетчик {системные.дозвон} будет работать в рамках каждого кандидата независимо друг от друга. Установите правила или шаблоны перезвона, либо инициируйте перезвон из сценария, чтобы счетчик корректно учитывать перезвоны в контексте каждого кандидата. |
Успешные дозвоны можно спутать с результативными вызовами. Дозвон считается успешным, если клиент ответил на звонок. При этом продолжительность разговора не имеет значения. Вызов считается результативным, если его продолжительность превышает установленное в настройках задания на обзвон значение. |
Переменная {tryNumber} возвращает количество попыток дозвона в рамках задания на обзвон. Используется в телефонии CIS.
Переменная {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии. Переменная используется только в исходящих вызовах.
На данный момент переменная {системные.запись} используется только в отчетах, сформированных для получения информации о заданиях на обзвон. Отчеты можно сформировать на странице Отчеты в разделе Статистика. Ссылка на файл расположена в колонке Адрес записи звонка. Формат файла: ".mp3". |
Переменная {recordPath} содержит ссылку на скачивание аудиозаписи текущего диалога. Используется в телефонии CIS.
{переменная|падеж:имя_падежа} – формат записи имен пользовательских переменных, который позволяет склонять их значения по падежам.
Пример использования:
{userName|падеж:родительный} - где userName, например: Иван Иванович.
Например, требуется задать вопрос: «Могу я услышать Ивана Ивановича?». Чтобы бот использовал значение переменной в родительном падеже, в сообщении, которое будет озвучено ботом в блоке Вопрос, нужно указать следующее: «Могу я услышать {userName|падеж:родительный}?»
Поддерживаются все падежи:
В системе существуют следующие переменные, значения которых являются постоянными и ни при каких обстоятельствах не изменяются в процессе диалога:
Пример использования:
Например, после завершения диалога бот может отправить письмо на электронную почту клиента с полным текстом диалога:
Ниже приводится список переменных, значения которых можно изменять в процессе диалога:
Значения данных переменных бот может получать по различным каналам связи (например, Viber, WhatsApp, Telegram и др.). Чтобы изменить значение любой из этих переменных, нужно определить соответствующую переменную в сценарии.
Имя и значение переменной задаются без фигурных скобок. Фигурные скобки используются только при указании переменных в сообщениях, которые воспроизводятся ботом. |
(Данный функционал недоступен в полном объеме. На текущий момент указанные ниже переменные можно использовать, например, чтобы определить, в каком мессенджере происходит диалог с клиентом). |
Пример использования:
Во время диалога бот может уточнить у клиента, удобно ли ему общаться в текущем мессенджере. Впоследствии бот может перевести диалог на телефон.
Временная метка Unix-времени (например, 1658125300) отображает количество секунд, которое прошло с 1 января 1970 года (00:00:00 UTC). |
Данные переменные используются для входящей телефонии и в чатах в основном для отладочных целей.
Список переменных будет обновляться по мере появления новых переменных на платформе TWIN. |
При помощи программных средств можно отображать дату и время в желаемом формате. Например, клиент может написать в диалоге следующую фразу: «третьего октября в восемь». Ответ клиента можно сохранить в переменную, а в дальнейшем (при необходимости) отобразить в диалоге в нужном виде, например: 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 секунд |
* Деятельность организации Meta Platforms Inc. и ее продуктов Instagram и Facebook запрещена в Российской Федерации. |