Обрезка пробелов: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) обрезаются пробелы и переносы строк в начале и в конце поля Source.

Caption — сопутствующее текстовое сообщение к файлу или переменная, с текстом, который должен быть приложен файлу. Переносы строки сохраняются.

Длинные сообщения будут обрезаны до 1024 символов (такая длина сообщения удовлетворяет требованиям всех поддерживаемых мессенджеров и омниканальных платформ).

Допускается конкатенация строк и переменны, путем включения переменных в формате {{ var }} в текст, например: вот ваш файл {{ filename }}.

Крайние пробелы у итогового сообщения будут обрезаны.

Primary type* — тип отправляемого файла, для корректного отображения и предпросмотра

@Конечный канал⁠

. Допустимые варианты:

Image

Audio

Video

File

Валидация: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) проверяется наличие выбранного типа файла:

при отсутствии типа выбранного типа файла выводится ошибка Please choose a primary type

⁠

Пользователь самостоятельно выбирает желаемый тип , которым файл должен отобразиться

@Собеседник⁠

у. Например, в

@Telegram⁠

изображение может быть отправлено типом Image, тогда оно будет отображаться прямо в мессенджере, или типом File, тогда оно будет отражено файлом, который можно скачать

⁠

Использование синтаксиса в Слоте

@Слот⁠

е Attachment допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в полях Source и Caption. Подробнее:

Синтаксис⁠

Работа слота

⁠

При выполнении слота Attachment:

⁠

@Агент⁠

получает значения в полях Source и Caption, выполняет конкатенацию в этих полях, если она присутствует, обрезает значение Caption до 1024 символа

⁠

@Агент⁠

выполняет отправку файла, доступного по ссылке в поле Source, и сопутствующего сообщения из поля Caption в

@Конечный канал⁠

с указанием Primary type — типом, которым файл должен дойти до

@Собеседник⁠

а.

⁠

@Конечный канал⁠

валидирует ссылку из поля Source на предмет:

это прямая ссылка на файл (файл скачивается по этой ссылке)

файл по ссылке соответствует Primary type

файл по ссылке удовлетворяет критериям для Primary type в этом

@Конечный канал⁠

по размеру и контенту

Важно: для определения требований к файлам каждого типа необходимо ознакомиться с официальной документацией тех каналов, в которые вы выводите
@Агент⁠
а, в каждом мессенджере и соцсети свои требования, которые могут быть в любой момент изменены разработчиками этих каналов.

В случае успешной валидации файла из Source он доставляется указанным Primary type

@Собеседник⁠

у, к файлу прикрепляется сопутствующее сообщение (не более 1024 символа из поля Caption)

Важно: доставка файлов большого размера до
@Собеседник⁠
а может занять продолжительное время, это нужно учитывать при построении
@Сценарий⁠
,
@Собеседник⁠
может успеть написать до того, как ему будет доставлен большой файл

В случае неуспешной валидации файла из Source или ошибки отправки из

@Конечный канал⁠

@Агент⁠

повторяет отправку данных из слота Attachment, но уже в виде 2х текстовых сообщений: первое — значение из поля Source, второе — значение из поля Caption. Перед такой отправкой также происходит конкатенация и получение значений переменных, если они используются в этих полях

Если

@Конечный канал⁠

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

Не все

@Конечный канал⁠

поддерживают передачу файлов

@Собеседник⁠

у “в виде файлов”, некоторые могут передать только ссылку на скачивание файла. В таблице указано, какие

@Конечный канал⁠

поддерживают передачу файлов “в виде файлов”.

Возможности передачи файлов в канал

Возможности передачи файлов в канал

Конечный канал

Наличие в канале

Описание

Webim (External bot API 2.0)

Нет

Jivo

Нет

Webim (External bot API 1.0)

Нет

Слот

@Attachment

⁠

передаст текстовую ссылку

Livetex

Да

Проблема: В виджете на сайте высылает файлы двумя сообщениями, одно сообщение отправляет ссылку на файл, второе файл для скачивания, оба открываются в браузере.