Якорь Top Top
| CSS Stylesheet |
|---|
.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; } |
...
На платформе TWIN существуют системные переменные, которые можно использовать в любом сценарии. Системные переменные не нужно объявлять и записывать в них данные – вы можете сразу использовать их в своих сценариях.
При указании переменных в сообщениях блоков нужно использовать фигурные скобки. Например, чтобы добавить в сценарий переменную «системные.сегодня» укажите ее следующим образом: {системные.сегодня}.
| Подсказка |
|---|
Помимо системных переменных можно использовать в сценариях свои собственные переменные. Имя переменной может быть любым. Однако, существует ограничение: имя переменной не должно содержать точку. Данный символ используется только в именах встроенных переменных. Примеры:
|
...
В сценариях можно использовать следующие переменные группы «Системные»:
{системные.сейчас}
...
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {now}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в магазин.
Бот произносит сообщение: «Внимание! В течение этого месяца у нас проходит грандиозная распродажа! Цены снижены до 30%. Сегодня {системные.сейчас}. Торопитесь успеть!»
Чтобы бот отображал время для конкретного часового пояса, нужно использовать дополнительный блок Арифметическая операция. Для параметра Тип нужно выбрать значение Дата. В поле Смещение от даты нужно ввести название системной переменной {системные.сейчас} и задать смещение в секундах. Смещение происходит от текущего времени по UTC. То есть если вы хотите, чтобы бот указал текущее время, например, в Волгограде (UTC + 3), нужно задать смещение равное 10800 (количество секунд в 3 часах). Результат нужно сохранить в пользовательскую переменную. После этого пользовательскую переменную можно использовать в тексте сообщения.
{компания.сейчас}
...
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {company.now}. В исходящей телефонии аналог не работает. |
{системные.сегодня}
...
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {today}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент создает заказ и хочет узнать, когда он сможет его забрать.
Бот отвечает клиенту: «Заказ будет готов к получению {системные.сегодня}, начиная с 18.00».
Чтобы бот вместе с датой отображал еще и время, нужно использовать блок Арифметическая операция. Для параметра Тип нужно выбрать значение Дата. В поле Смещение от даты нужно ввести название системной переменной {системные.сегодня} и задать смещение в секундах. Смещение происходит от начала суток (00.00). То есть если вы хотите, чтобы бот отобразил текущую дату и указал время, например, 9.00, нужно задать смещение равное 32400 (количество секунд в 9 часах). Результат нужно сохранить в пользовательскую переменную. После этого пользовательскую переменную можно использовать в тексте сообщения.
{компания.сегодня}
...
| Message Box | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Якорь | ||||
|---|---|---|---|---|
|
На платформе TWIN существуют системные переменные, которые можно использовать в любом сценарии. Системные переменные не нужно объявлять и записывать в них данные – вы можете сразу использовать их в своих сценариях.
При указании переменных в сообщениях блоков нужно использовать фигурные скобки. Например, чтобы добавить в сценарий переменную «системные.сегодня» укажите ее следующим образом: {системные.сегодня}.
| Подсказка |
|---|
Помимо системных переменных можно использовать в сценариях свои собственные переменные. Имя переменной может быть любым. Однако, существует ограничение: имя переменной не должно содержать точку. Данный символ используется только в именах встроенных переменных. Примеры:
|
| Якорь | ||||
|---|---|---|---|---|
|
В сценариях можно использовать следующие переменные группы «Системные»:
{системные.сейчас}
Переменная {системные.сейчас}возвращает текущие дату и время по UTC (например, 2019-11-22 04:06:58). Текущие дата и время определяются во время диалога с клиентом.
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {now}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в магазин.
Бот произносит сообщение: «Внимание! В течение этого месяца у нас проходит грандиозная распродажа! Цены снижены до 30%. Сегодня {системные.сейчас}. Торопитесь успеть!»
Чтобы бот отображал время для конкретного часового пояса, нужно использовать дополнительный блок Арифметическая операция. Для параметра Тип нужно выбрать значение Дата. В поле Смещение от даты нужно ввести название системной переменной {системные.сейчас} и задать смещение в секундах. Смещение происходит от текущего времени по UTC. То есть если вы хотите, чтобы бот указал текущее время, например, в Волгограде (UTC + 3), нужно задать смещение равное 10800 (количество секунд в 3 часах). Результат нужно сохранить в пользовательскую переменную. После этого пользовательскую переменную можно использовать в тексте сообщения.
...
{компания.сейчас}
Переменная {компания.сейчас}возвращает текущие дату и время с учетом часового пояса, в котором расположена компания (например, 2019-11-22 04:06:58). Текущие дата и время определяются
...
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {company.today}. В исходящей телефонии аналог не работает. |
{системные.время}
Переменная {системные.время} возвращает текущее время без указания даты (например, 04:06:58). Текущее время определяется во время диалога с клиентом.
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {time}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в справочную аэропорта, чтобы уточнить, до какого времени осуществляется посадка на рейс.
Бот отвечает клиенту: «Посадка на рейс в Лондон заканчивается в 18.45. Сейчас: {системные.время}».
{компания.время}
Переменная {компания.время} возвращает текущее время без указания даты (например, 04:06:58). При этом учитывается часовой пояс, в котором расположена компания. Текущее время определяется во время диалога с клиентом.
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {company.timenow}. В исходящей телефонии аналог не работает. |
...
{системные.
...
сегодня}
Переменная {системные.месяц} возвращает первое число текущего месяца в формате ГГГГ-ММ-ДД сегодня}возвращает текущую дату без указания времени (например, 20222019-0911-0122). Текущий месяц Текущая дата определяется во время диалога с клиентомдиалога с клиентом.
| Подсказка |
|---|
Для входящей телефонии и чатов данная переменная имеет аналог {today}. В исходящей телефонии аналог не работает. |
Пример использования:
Используя виджет на сайте магазина, клиент спрашивает, когда начались распродажиКлиент создает заказ и хочет узнать, когда он сможет его забрать.
Бот отвечает клиенту: «Распродажи в нашем магазине начались «Заказ будет готов к получению {системные.месяц}».
{системные.телефон}
Переменная {системные.телефон} возвращает номер телефона клиента, который указан в задании на обзвон для выполнения вызова.
| Подсказка |
|---|
Эта переменная предназначена для сценариев, которые используются в телефонии и мессенджерах. Для входящей телефонии переменная имеет аналог {phone}. В исходящей телефонии аналог не работает. |
Пример использования:
Клиент звонит в магазин, чтобы узнать срок действия заказа.
Бот отвечает клиенту: «Уточните, заказ оформлен на номер {системные.телефон}?» После завершения разговора бот отправляет шаблонное SMS-сообщение с информацией о заказе на номер клиента:
{системные.предыдущий}
Переменная {системные.предыдущий} возвращает ID сценария, из которого система перенаправила бота в другой сценарий во время диалога с пользователем (также см. Как перевести диалог бота с клиентом в другой сценарий).
Пример использования:
При переходе в новый сценарий можно выполнить проверку, из какого сценария был выполнен переход. Эта проверка позволяет перенаправить клиента на отдельную ветку, которая не содержит вопросы, которые бот задавал клиенту в предыдущем сценарии.
{системные.дозвон}
Переменная {системные.дозвон} возвращает количество успешных дозвонов до кандидата в рамках задания на обзвон.
| Примечание |
|---|
Тестировать данную переменную необходимо с помощью исходящих звонков. При тестировании в редакторе переменная системные.дозвон будет иметь пустое значение. Данный способ НЕ сработает, если в задании есть несколько одинаковых номеров кандидата, в таком случае будет использовано первое приветствие. Должны быть установлены правила/шаблон перезвона, либо перезвон должен быть вызван из сценария. |
| Информация |
|---|
Успешные дозвоны можно спутать с результативными вызовами. Дозвон считается успешным, если клиент ответил на звонок. При этом продолжительность разговора не имеет значения. Вызов считается результативным, если его продолжительность превышает установленное в настройках задания на обзвон значение. |
{системные.запись}
Переменная {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии. Переменная используется только в исходящих вызовах.
| Информация |
|---|
На данный момент переменная {системные.запись} используется только в отчетах, сформированных для получения информации о заданиях на обзвон. Отчеты можно сформировать на странице Отчеты в разделе Статистика. Ссылка на файл расположена в колонке Адрес записи звонка. Формат файла: ".mp3". |
{recordPath}
Переменная {recordPath} содержит ссылку на скачивание аудиозаписи текущего диалога. Используется в телефонии CIS.
...
Детектор эмоций предназначен для определения эмоциональной окраски ответа клиента. Эмоциональная окраска определяется по голосу. Поэтому переменные детектора эмоций работают только в тех сценариях, которые используются в телефонии.
Переменная {детектор.эмоции} может возвращать следующие значения:
...
Пример использования:
В зависимости от эмоциональной окраски ответа клиента бот может направить развитие диалога в ту или иную сторону:
{детектор.эмоции}=negative
| Информация |
|---|
При решении 99% задач данная функция не используется. Определить негатив в диалоге с клиентом вы можете с помощью намерений, которые будут отслеживать использование негативных слов (например, мат и/или брань). При помощи детектора эмоций вы можете распознавать эмоциональную окраску речи пользователя в обычных ситуациях (например, при отмене заказа). Старайтесь использовать детектор эмоций только в тех случаях, где это действительно необходимо (там, где вы не можете определить эмоциональную окраску с помощью намерений). |
...
{переменная|падеж:имя_падежа} – формат записи имен пользовательских переменных, который позволяет склонять их значения по падежам.
Пример использования:
{userName|падеж:родительный} - где userName, например: Иван Иванович.
Например, требуется задать вопрос: «Могу я услышать Ивана Ивановича?». Чтобы бот использовал значение переменной в родительном падеже, в сообщении, которое будет озвучено ботом в блоке Вопрос, нужно указать следующее: «Могу я услышать {userName|падеж:родительный}?»
Поддерживаются все падежи:
...
сегодня}, начиная с 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}
Переменная {tryNumber} возвращает количество попыток дозвона в рамках задания на обзвон. Используется в телефонии CIS.
{userAnswer}
Переменная {userAnswer} используется для хранения ответа пользователя, который применяется к блоку вопроса при включенной опции Использовать ответ пользователя. Эта переменная позволяет системе сохранить и использовать ответ пользователя для дальнейшего анализа и обработки.
{системные.запись}
Переменная {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии. Переменная используется только в исходящих вызовах.
| Информация |
|---|
На данный момент переменная {системные.запись} используется только в отчетах, сформированных для получения информации о заданиях на обзвон. Отчеты можно сформировать на странице Отчеты в разделе Статистика. Ссылка на файл расположена в колонке Адрес записи звонка. Формат файла: ".mp3". |
{recordPath}
Переменная {recordPath} содержит ссылку на скачивание аудиозаписи текущего диалога. Используется в телефонии CIS.
| Якорь | ||||
|---|---|---|---|---|
|
...
- {communicationType} – строка, тип коммуникации с клиентом. Допустимые значения: TEXT, VOICE;
- {channelType} – строка, тип канала общения. Допустимые значения: WEB, MOBILE, MESSENGER;
- {messenger} – строка, тип мессенджера. Допустимые значения: WHATSAPP, VIBER, TELEGRAM, VKONTAKTE, FACEBOOK*, SKYPE, SLACK, YANDEX, ALICE, THREADS, AVITO.
Пример использования:
Во время диалога бот может уточнить у клиента, удобно ли ему общаться в текущем мессенджере. Впоследствии бот может перевести диалог на телефон.
...
- {channelType} – строка, тип канала общения. Допустимые значения: WEB, MOBILE, MESSENGER.
- {messenger} – строка, тип мессенджера. Допустимые значения: WHATSAPP, VIBER, TELEGRAM, VKONTAKTE, FACEBOOK*, SKYPE, SLACK, YANDEX, ALICE, THREADS, AVITO.
| Якорь | ||||
|---|---|---|---|---|
|
...
- {системные.сейчас} возвращает текущие дату и время по 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 предыдущего сценария, из которого система во время диалога с пользователем перенаправила бота в другой сценарий.{системные.дозвон} возвращает количество успешных дозвонов до кандидата в рамках задания на обзвонвремя диалога с пользователем перенаправила бота в другой сценарий.
- {системные.дозвон} возвращает количество дозвонов до кандидата в рамках задания на обзвон. Считаются все результативные звонки по номеру кандидата.
- {tryNumber} количество попыток дозвона по номеру кандидата, считается с 0. Аналог {системные.попытка}.
- {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии.
- {системные.расшифровка} – возвращает строку с полным текстом диалога.
- {recordPath} возвращает ссылку на скачивание аудиозаписи текущего диалога в телефонии CIS.
Возможные значения переменной детектор.эмоции
- диалога.
- {recordPath} возвращает ссылку на скачивание аудиозаписи текущего диалога в телефонии CIS.
- {системные.попытка} считаются все попытки дозвона по номеру кандидата.
- tryCandidate - количество попыток дозвона до кандидата, считается с 0.
- answeredCandidate - количество дозвонов до кандидата, считается с 0.
- resultCandidate - количество результативных дозвонов до кандидата, считается с 0.
- humanCandidate - количество дозвонов до кандидата, где ответивший был НЕ автоответчик, считается с 0.
- answeredNumber - количество дозвонов по номеру кандидата, считается с 0.
- humanNumber - количество дозвонов по номеру кандидата, где ответивший был НЕ автоответчик, считается с 0.
- resultNumber - количество результативных дозвонов по номеру кандидата, считается с 0. Аналог {системные.дозвон}
- {детектор.эмоции}=negative – негативная эмоциональная окраска.
- {детектор.эмоции}=positive – позитивная эмоциональная окраска. {детектор.эмоции}=neutral – нейтральная эмоциональная окраска
- .
Склонение значений пользовательских переменных по падежам
...
Button Hyperlink custom-icon top-button id top-button title .В начало type standard class top-button url #Top
...