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

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

Слот Attachment — Слот, предназначенный для отправки файлов-вложений указанного типа от Агента Собеседнику. Например, с помощью этого слота можно отправить Собеседнику аудио, видео или изображение, которое отобразится корректно в мессенджере с предпросмотром. Один слот Attachment отправляет один файл.\
![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-xmjDEQWJdR/0639c6c7546efa83d432ca2449b7db34f97681a3cbed86880289363713589e8378b0d8f7d5d8405f7921a399caca1461c26db396857a07d4f4d4f54814ac35b3058fed80c95fcf8fac022b8b5cfbfee40d164722d8fec0752a91139a680f17c0f5efd302)![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-5MWQ7VCasq/d00888a9cadd29edbe73d3731d4c037935ed4b8fe932c272f3f004d71da44768e1a48c7f7c7daf6f567004cbe94023a88238a4a1ce512e80a375f1a875a0cddc0446a8544f86929186cc0e917c63b9baf0003a99cb82dfe1b80ddb9a5fa994c958c07a3a)

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

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

![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ZFnsG7Q47-/d7c36010f3b7be6625a1da9d96535158576cf6c0e20800bdb1ccaf5015506e5993882b105ba74685fd5e7f233dba5083bf716f9084abd30d21fdc071c7db5fd040843067f66f0fcac3d7d5c1c884f391af1a7068a08bb1f14dfbf47aa935b4d589a03494)

1. Name\* — название слота, которое будет отображено в Дерево сценария. Максимальная длина значения поля — 40 символов.
2. Source\* — ссылка на файл или Контекстная переменная, содержащая ссылку на файл, который должен быть отправлен.
3.
   1. Обрезка пробелов: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) обрезаются пробелы и переносы строк в начале и в конце поля Source.
4. Caption — сопутствующее текстовое сообщение к файлу или переменная, с текстом, который должен быть приложен файлу. Переносы строки сохраняются.
5.
   1. Длинные сообщения будут обрезаны до 1024 символов (такая длина сообщения удовлетворяет требованиям всех поддерживаемых мессенджеров и омниканальных платформ).
   2. Допускается конкатенация строк и переменны, путем включения переменных в формате \{{ var \}} в текст, например: вот ваш файл \{{ filename \}}.
   3. Крайние пробелы у итогового сообщения будут обрезаны.
6. Primary type\* — тип отправляемого файла, для корректного отображения и предпросмотра Конечный канал. Допустимые варианты:
7.
   * Image
   * Audio
   * Video
   * File
8.
   1. Валидация: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) проверяется наличие выбранного типа файла:
   2.
      1. при отсутствии типа выбранного типа файла выводится ошибка Please choose a primary type
      2. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-K94qGWCkGJ/7daccd9ae85a9db135cad818a6a808d3bcf3b3f4ca0b22ed324e335eda496aedd92b77f27d64ef3a521b3dadb4fc5dee84cbe8388cdf287ffbcbe09343d8432a0a92df627257de40edc533e7cf6063815caf26631029e06735eef6d6550d571c01115033)

Пользователь самостоятельно выбирает желаемый тип , которым файл должен отобразиться Собеседнику. Например, в Telegram изображение может быть отправлено типом Image, тогда оно будет отображаться прямо в мессенджере, или типом File, тогда оно будет отражено файлом, который можно скачать![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-rxyR0PWYcB/8bd002f05ff8bd590b4ae8dd6bd25e1696e55cca1a1239fc0e7d1cd088d06c5e70e7144af4673c4c60c82fcb9d8a805ba1083d2370308ea996b5b0c0eddbe2d347b791127c2bec37acf9a22056fa69c92eca74df80adc60d25a9fcb610a0ac0a13bdb9a3)

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

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

## Работа слота

![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-4pbhcQzwEI/3d7ec6f50d84dbb9046d5a0f2ed756584ab15f9229e1dab67653b7e65b2c3f4ab423b2e13ff2a45ebe7a0c2a682fb8d30ef2244dd986a06d6b83bee5c62c74f099a8e425aa582416d9a2cb5874c66a6a7270c687858baac1eb90e07d5695f4d3170db4c7)

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

1. Агент получает значения в полях Source и Caption, выполняет конкатенацию в этих полях, если она присутствует, обрезает значение Caption до 1024 символа
2. Агент выполняет отправку файла, доступного по ссылке в поле Source, и сопутствующего сообщения из поля Caption в Конечный канал с указанием Primary type — типом, которым файл должен дойти до Собеседника. &#x20;
3. Конечный канал валидирует ссылку из поля Source на предмет:
4.
   * это прямая ссылка на файл (файл скачивается по этой ссылке)
   * файл по ссылке соответствует Primary type
   * файл по ссылке удовлетворяет критериям для Primary type в этом Конечный канал по размеру и контенту
   * > Важно: для определения требований к файлам каждого типа необходимо ознакомиться с официальной документацией тех каналов, в которые вы выводите Агента, в каждом мессенджере и соцсети свои требования, которые могут быть в любой момент изменены разработчиками этих каналов.
5. В случае успешной валидации файла из Source он доставляется указанным  Primary type Собеседнику, к файлу прикрепляется сопутствующее сообщение (не более 1024 символа из поля Caption)
6. > Важно: доставка файлов большого размера до Собеседника может занять продолжительное время, это нужно учитывать при построении Сценарий агента, Собеседник может успеть написать до того, как ему будет доставлен большой файл
7. В случае неуспешной валидации файла из Source или ошибки отправки из Конечный канал, Агент повторяет отправку данных из слота Attachment, но уже в виде 2х текстовых сообщений: первое — значение из поля Source, второе — значение из поля Caption. Перед такой отправкой также происходит конкатенация и получение значений переменных, если они используются в этих полях
8. Если Конечный канал в принципе не поддерживает отправку файлов, значение полей Source и Caption отправляются двумя текстовыми сообщениями. Перед такой отправкой также происходит конкатенация и получение значений переменных, если они используются в этих полях

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

| Функционал общения                                   | Конечный канал               | Доступность в канале | Примечания                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------------------- | ---------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Передача файлов в виде файлов от Агента (Attachment) | Webim (External Bot API 2.0) | Нет                  |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Передача файлов в виде файлов от Агента (Attachment) | Jivo                         | Нет                  |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Передача файлов в виде файлов от Агента (Attachment) | Webim (External Bot API 1.0) | Нет                  | Слот Attachment передаст текстовую ссылку                                                                                                                                                                                                                                                                                                                                                                                              |
| Передача файлов в виде файлов от Агента (Attachment) | Livetex                      | Да                   | В виджете на сайте высылает файлы двумя сообщениями, одно сообщение отправляет ссылку на файл, второе файл для скачивания, оба открываются в браузере.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VSdZKyvQae/2cdd70a52c65452cb83fc30d4c2d09658b281ef275510a5123b7b3080bd2bae91cbd15295cae0a99cf18b8cfc2d91e095c0383fe9bd040f9d197f33b5e022fb51a5858164e3e9fb4f395cc98153cdc6cfe63741cdee2ff1c2a360e5cc6b2d918b8525d26) |
| Передача файлов в виде файлов от Агента (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](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                     | Да                   |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
