1.11.10 (07.04.2022)


Новое в релизе 1.11.10:

A также документационные обновления, связанные с использованием специальных тегов:

Переменные среды

В релизе 1.11.9 мы добавили возможность задавать токены для чувствительных данных в сценарии. Теперь вы можете также добавить переменные среды.

Переменная — это, как и токен, пара «ключ-значение», но между ними есть различия:

  • Шифрование: токены шифруются на стороне платформы, переменные — нет.
  • Видимость: значения переменных видны в интерфейсе, и их можно скопировать. При скачивании проекта переменные также могут быть экспортированы.
  • Права доступа: токенами может управлять только администратор, для переменных вы можете разграничить права доступа для пользователей.

Подробнее про токены и переменные среды

Переменные доступны для использования из сценария бота через вызов метода $env.get.

Таймаут выполнения запросов через $http.query

Таймаут выполнения запросов через вызов метода $http.query был уменьшен до 25 секунд. Старое значение составляло одну минуту.

Учитывайте это изменение, если из сценария бота вы отправляете запросы, выполнение которых занимает длительное время. Если таймаут будет дольше 25 секунд, запрос не будет выполнен.

Директивы Алисы в ответах бота

В этом релизе мы поддержали возможность отправлять директивы Алисы в ответах бота. Директива — это специальная команда, которая запускает процессы в Алисе, например, процесс авторизации или сценарий оплаты.

Подробнее о директивах разных типов см. в документации к платформе Яндекс Диалоги: audio_player, confirm_purchase, start_account_linking, start_purchase.

Чтобы передать директиву, добавьте ответ с типом raw в список ответов $response.replies и укажите необходимые свойства.

Обновления документации

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

Описания специальных тегов

Задокументировали готовые специальные теги:

Тег Описание
Email Отправляет сообщение на указанный email.
GoogleSheets Реализует интеграцию с сервисом Google Таблицы, с помощью которой вы сможете получать данные из таблиц или записывать данные в таблицы.
HttpRequest Отправляет HTTP-запрос. С помощью этого тега бот может получать данные из внешнего ресурса и сохранять их в переменные.
InputFile Позволяет получить от пользователя файл: например, фотографию товара или файл с данными юридического лица.
Sms Отправляет SMS на указанный номер телефона (только на российские номера).
TransferCallToOperator Переводит звонок на оператора, например, когда задачу нельзя решить без участия человека (для ботов в телефонном канале).
TransferToOperator Переводит диалог на оператора платформы онлайн-чатов (для текстовых ботов).

Инструкция по созданию специальных тегов

Готовые специальные теги покрывают часто используемые действия в сценарии. Если вам не хватает готовых специальных тегов, вы можете создать свои. Чтобы это сделать, воспользуйтесь новой инструкцией.