Отправка файлов Собеседнику | Слот Attachment

Назначение и общая информация

Слот Attachment — Слот, предназначенный для отправки файлов-вложений указанного типа от Агента Собеседнику. Например, с помощью этого слота можно отправить Собеседнику аудио, видео или изображение, которое отобразится корректно в мессенджере с предпросмотром. Один слот Attachment отправляет один файл.

Создание и настройки слота Attachment

Атрибуты слота

  1. Name* — название слота, которое будет отображено в Дерево сценария. Максимальная длина значения поля — 40 символов.

  2. Source* — ссылка на файл или Контекстная переменная, содержащая ссылку на файл, который должен быть отправлен.

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

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

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

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

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

  4. Primary type* — тип отправляемого файла, для корректного отображения и предпросмотра Конечный канал. Допустимые варианты:

    • Image

    • Audio

    • Video

    • File

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

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

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

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

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

Работа слота

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

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

  2. Агент выполняет отправку файла, доступного по ссылке в поле Source, и сопутствующего сообщения из поля Caption в Конечный канал с указанием Primary type — типом, которым файл должен дойти до Собеседника.

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

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

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

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

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

  4. В случае успешной валидации файла из Source он доставляется указанным Primary type Собеседнику, к файлу прикрепляется сопутствующее сообщение (не более 1024 символа из поля Caption)

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

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

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

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

Функционал общения
Конечный канал
Доступность в канале
Примечания

Передача файлов в виде файлов от Агента (Attachment)

Webim (External Bot API 2.0)

Нет

Передача файлов в виде файлов от Агента (Attachment)

Jivo

Нет

Передача файлов в виде файлов от Агента (Attachment)

Webim (External Bot API 1.0)

Нет

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

Передача файлов в виде файлов от Агента (Attachment)

Livetex

Да

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

Передача файлов в виде файлов от Агента (Attachment)

Edna Chat Center

Нет

Передача файлов в виде файлов от Агента (Attachment)

Telegram

Да

Telegram может принимать и предавать собеседникам вложения типа “file” только форматов gif, pdf и zip. Возможна поддержка других форматов, но Telegram её не гарантирует.При попытке передать изображение в слоте Attachment, если указана ссылка на файл из Telegram, то файл придет в виде ссылки, а не изображения

Передача файлов в виде файлов от Агента (Attachment)

360dialog (Whatsapp)

Частично

Картинку не передает, видео передает, аудио передает в виде аудиофайла, файл передает в виде файла для скачивания

Передача файлов в виде файлов от Агента (Attachment)

Дебаг виджет

Передача файлов в виде файлов от Агента (Attachment)

Chat2Desk

Да

В виджет приходит иконка, ведущая на ссылку вида https://storage.chat2desk.com/companies/company_236200/messages/199219/Kalimba.mp3, при переходе автоматически воспроизводится содержимое.Изображения передаются в виде изображений.

Передача файлов в виде файлов от Агента (Attachment)

Chat API

Нет

Передача файлов в виде файлов от Агента (Attachment)

Viber

Нет

Передача файлов в виде файлов от Агента (Attachment)

VK

Нет

Передача файлов в виде файлов от Агента (Attachment)

Microsoft Teams

Да

Передача файлов в виде файлов от Агента (Attachment)

Edna Pulse

Да

Передача файлов в виде файлов от Агента (Attachment)

Bitrix24

Да

Передача файлов в виде файлов от Агента (Attachment)

VK Teams

Частично

Приложение отправляется ссылкой из поля Source Слота Attachment , которую VK Teams преобразует в файл

Передача файлов в виде файлов от Агента (Attachment)

Line messenger

Нет

Передача файлов в виде файлов от Агента (Attachment)

360dialog (cloud)

Частично

Картинку не передает, видео передает, аудио передает в виде аудиофайла, файл передает в виде файла для скачивания

Передача файлов в виде файлов от Агента (Attachment)

Widget

Нет

Передача файлов в виде файлов от Агента (Attachment)

Omnidesk

Да

Last updated