# Отправка файлов Собеседнику | Слот 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 — типом, которым файл должен дойти до Собеседника. 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 | Да | В виджет приходит иконка, ведущая на ссылку вида , при переходе автоматически воспроизводится содержимое.Изображения передаются в виде изображений. | | Передача файлов в виде файлов от Агента (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 | Да | | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://chatme-ai-4.gitbook.io/docs/proekty-na-platforme/proekt-i-ego-soderzhimoe/agenty-na-platforme/kak-postroit-scenarii-agenta/kak-sozdavat-i-nastraivat-sloty/otpravka-failov-sobesedniku-or-slot-attachment.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.