InputFile
Действие InputFile позволяет боту запросить у пользователя файл
(например, фотографию товара или документ с данными юридического лица) и сохранить ссылку на него в переменную.
Параметры
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
prompt | Строка | Сообщение, которым бот должен запросить файл. Если вы хотите использовать в сообщении HTML-разметку, оставьте этот параметр пустым ( prompt =) и заполните параметр html. | Да |
varName | Строка | Имя переменной. Ссылка на отправленный пользователем файл будет сохранена в $session.<varName>. Используйте символы Aa–Zz, _, 0–9. Первым символом в имени должна быть буква. Нельзя использовать зарезервированные слова JavaScript. | Да |
html | Строка | Сообщение, которым бот должен запросить файл, с использованием HTML-разметки. Если вы не хотите использовать HTML-разметку, вы можете не указывать этот параметр и использовать только prompt. | Нет |
htmlEnabled | Логический | Если значение параметра true, в сообщении бота будет отправлено значение параметра html, а в сообщении об ошибке — failureMessageHtml. Если параметр не указан или установлен в false, будет использовано значение prompt и failureMessage соответственно. | Нет |
then | Строка | Стейт, в который перейдет диалог, если сценарий тега будет выполнен без ошибок. | Нет |
errorState | Строка | Стейт, в который перейдет диалог, если сценарий тега будет выполнен с ошибкой: например, если пользователь отправит вместо файла обычный запрос. | Нет |
actions | Массив объектов | Кнопки, которые будут отправлены вместе с запросом. Укажите значение в формате: | Нет |
Использование в сценарии
state: AttachFile
InputFile:
prompt = Загрузите в чат файл, и я загружу его в хранилище и отправлю вам ссылку.
varName = fileUrl
then = /AttachFile/Save
errorState = /AttachFile/Error
state: Save
a: Успех! Файл доступен по ссылке: {{$session.fileUrl}}
state: Error
a: Извините, у меня не получилось обработать файл.