Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Якорь
Top
Top


CSS Stylesheet



Message Box
iconnone
titleНа этой странице:
typegeneric

...

Russian

Якорь
geninfo
geninfo

Общая информация

На платформе Twin существуют системные переменные, которые можно использовать в любом сценарии. Системные переменные не нужно объявлять и записывать в них данные – вы можете сразу использовать их в своих сценариях.

При указании переменных в сообщениях блоков нужно использовать фигурные скобки. Например, чтобы добавить в сценарий переменную «системные.сегодня» укажите ее следующим образом: {системные.сегодня}.

Подсказка

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

Примеры:

  • Правильные варианты: {Новая_переменная}, {Новая_Переменная}, {новаяПеременная}.
  • Неправильный вариант: {Новая.переменная}.

Якорь
geninfo2
geninfo2

Переменные группы «Системные»

В сценариях можно использовать следующие переменные группы «Системные»:

{системные.сейчас}

Переменная {системные.сейчас}возвращает текущие дату и время по 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}. В исходящей телефонии аналог не работает.



{системные.месяц}

Переменная {системные.месяц} возвращает первое число текущего месяца в формате ГГГГ-ММ-ДД (например, 2022-09-01). Текущий месяц определяется во время диалога с клиентом.

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

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

Бот отвечает клиенту: «Распродажи в нашем магазине начались {системные.месяц}».


{системные.телефон}

Переменная {системные.телефон} возвращает номер телефона клиента, который указан в задании на обзвон для выполнения вызова.

Подсказка

Эта переменная предназначена для сценариев, которые используются в телефонии и мессенджерах.

Для входящей телефонии переменная имеет аналог {phone}. В исходящей телефонии аналог не работает.

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

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

Бот отвечает клиенту: «Уточните, заказ оформлен на номер {системные.телефон}?» После завершения разговора бот отправляет шаблонное SMS-сообщение с информацией о заказе на номер клиента:




{системные.предыдущий}

Переменная {системные.предыдущий} возвращает ID сценария, из которого система перенаправила бота в другой сценарий во время диалога с пользователем (также см. Как перевести диалог бота с клиентом в другой сценарий).

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

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



{системные.дозвон}

Переменная {системные.дозвон} возвращает количество успешных дозвонов до кандидата в рамках задания на обзвон.

Примечание

Тестировать данную переменную необходимо с помощью исходящих звонков.

При тестировании в редакторе переменная системные.дозвон будет иметь пустое значение.

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

Должны быть установлены правила/шаблон перезвона, либо перезвон должен быть вызван из сценария.

Информация

Успешные дозвоны можно спутать с результативными вызовами. Дозвон считается успешным, если клиент ответил на звонок. При этом продолжительность разговора не имеет значения.

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

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

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

{системные.запись}

Переменная {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии. Переменная используется только в исходящих вызовах.

Информация

На данный момент переменная {системные.запись} используется только в отчетах, сформированных для получения информации о заданиях на обзвон. Отчеты можно сформировать на странице Отчеты в разделе Статистика. Ссылка на файл расположена в колонке Адрес записи звонка. Формат файла: ".mp3".

Якорь
emotdetector
emotdetector

Переменные детектора эмоций

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

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

В системе существуют следующие переменные детектора эмоцийПеременная {детектор.эмоции} может возвращать следующие значения

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

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

В зависимости от эмоциональной окраски ответа клиента бот может направить развитие диалога в ту или иную сторону:

{детектор.эмоции}=negative

Информация

При решении 99% задач данная функция не используется. Определить негатив в диалоге с клиентом вы можете с помощью намерений, которые будут отслеживать использование негативных слов (например, мат и/или брань). При помощи детектора эмоций вы можете распознавать эмоциональную окраску речи пользователя в обычных ситуациях (например, при отмене заказа). Старайтесь использовать детектор эмоций только в тех случаях, где это действительно необходимо (там, где вы не можете определить эмоциональную окраску с помощью намерений). 

Якорь
genderdetector
genderdetector

Переменные детектора пола

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

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

Информация

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

В системе существуют следующие переменные детектора пола: 

  • male – мужской
  • female – женский
  • unsure – система не смогла прийти к однозначному решению
  • unknown – не удалось определить пол или определение пола выключено/не поддерживается
Подсказка

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

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

Изображение ниже демонстрирует проверку пола клиента. Клиентов мужского пола бот перенаправляет на одну ветку, а клиентов женского пола - на другую.

  • {детектор.пол}=male
  • {детектор.пол}=female

Якорь
varendings
varendings

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

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

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

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

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

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

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

Якорь
unchangable
unchangable

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

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

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

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

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

Якорь
uservar
uservar

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

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

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

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

Подсказка

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

Якорь
chang
chang

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

Информация

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

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

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

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

Якорь
chang2
chang2

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

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

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

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

Подсказка

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


...

  • {системные.сейчас} возвращает текущие дату и время по 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 предыдущего сценария, из которого система во время диалога с пользователем перенаправила бота в другой сценарий.
  • {системные.дозвон} возвращает количество успешных дозвонов до кандидата в рамках задания на обзвон.
  • {системные.запись} возвращает ссылку на аудиозапись текущего диалога в телефонии.

...

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

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

...

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

  • {детектор.пол}=male – мужской пол.
  • {детектор.пол}=female – женский пол.
  • {детектор.пол}=unsure – система не смогла прийти к однозначному решению.
  • {детектор.пол}=unknown – не удалось определить пол или определение пола выключено/не поддерживается.

...