# Вкладка вложений

Этот блок поддерживает следующие типы вложений:

* Ссылка
* Видео
* Изображение
* Файл
* Аудио

<div data-with-frame="true"><figure><img src="/files/375816a5d39a8a155f0971660084f5e3ac6c331a" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
В одном блоке НЕЛЬЗЯ комбинировать разные типы вложений!

Вложения, загружаемые в конструктор, не должны превышать 20 МБ.

Отправка до 10 вложений <mark style="color:красный;">**одного и того же типа**</mark> в одном блоке разрешена.
{% endhint %}

Также вы можете сгенерировать изображение с помощью **"Сгенерировать изображение"** кнопки и отправить его своему клиенту.

<div data-with-frame="true"><figure><img src="/files/e710939040af3be88bbc42ccf224fd8d540944e6" alt="" width="375"><figcaption></figcaption></figure></div>

## Как отправлять вложения

Чтобы отправить вложение, создайте пустой блок и откройте редактор блока (правое меню).

{% hint style="danger" %}
Важно!&#x20;

1. Загруженное вложение не должно превышать 20 МБ. Отправка до 10 вложений <mark style="color:красный;">**одного и того же типа**</mark> в одном блоке разрешена.
2. Не рекомендуется <mark style="color:красный;">**отправлять блок с несколькими вложениями**</mark> в рассылке, чтобы не столкнуться с лимитами API разных мессенджеров.
3. <mark style="color:красный;">**НЕ**</mark> назначайте <mark style="color:красный;">**одно и то же имя**</mark> разным вложениям **в рамках одного проекта**!
4. Если вы загружаете новое вложение с тем же именем, что и существующее, система доставит исходный файл. Чтобы избежать ошибок и обеспечить корректную работу блока, всегда присваивайте вложениям уникальные имена.
   {% endhint %}

{% hint style="warning" %}
**Обратите внимание!**

**Особенности Telegram:**

* Кнопки <mark style="color:красный;">**не будет отображаться**</mark> при отправке более одного вложения в блоке.
* *Исключение:* Если текст блока превышает 1024 символа, сообщение будет разделено на два — кнопки будут показаны вместе с текстом, а вложения будут отправлены отдельным сообщением.
* Форматирование текста Markdown и HTML **не** работает при отправке более одного вложения в блоке.
  {% endhint %}

Все настройки вложений находятся в настройках блока, доступных по нажатию на **"Вложение"** .

<div data-with-frame="true"><figure><img src="/files/8a84d8da8092117a38f9da4a199ca2e6cd13f8d2" alt="" width="375"><figcaption></figcaption></figure></div>

&#x20;Давайте подробнее рассмотрим новые появившиеся кнопки для типов вложений.

### Ссылка

Первая кнопка — **Ссылка**:

<div data-with-frame="true"><figure><img src="/files/18e24aed9b1ed226aa5ca67ee20f4a59d1ecd092" alt="" width="563"><figcaption></figcaption></figure></div>

1. Нажмите кнопку, чтобы открыть настройки вложения.
2. **Вариант A:** введите URL в указанное поле, чтобы поделиться ссылкой.
3. **Вариант B:** загрузите файл; клиент увидит его как отдельную ссылку для скачивания.

{% hint style="info" %}
Прикреплённый файл будет отправлен в виде ссылки с сервера mavibot.ai.
{% endhint %}

{% hint style="info" %}
Загруженный файл имеет приоритет над ссылкой. Если указаны оба варианта, будет отправлен загруженный файл.
{% endhint %}

Под полем URL есть три флажка:

<div data-with-frame="true"><figure><img src="/files/d1a180c10552fad15062db94a04147d49c02fbd5" alt="" width="245"><figcaption></figcaption></figure></div>

1. **Уведомление о клике:** Если включено, бот зафиксирует клик пользователя, отправив сообщение в формате `link_was_pressed [link1] [link2]`.

<div data-with-frame="true"><figure><img src="/files/9ba1faeeeea410d2ebeb117d4f6a74a4c9635e93" alt="" width="320"><figcaption></figcaption></figure></div>

Для чего это используется?

<div data-with-frame="true"><figure><img src="/files/e2dc63ebfd972f9d92a63922461beeed605238d4" alt="" width="375"><figcaption></figcaption></figure></div>

Это событие позволяет отслеживать, какие пользователи нажали на ссылку. Когда флажок включён, система отправляет в диалог callback в формате:

`link_was_pressed {url}` &#x20;

В этом callback `link_was_pressed` — это фиксированный префикс, а `{url}` — переменная, представляющая конкретный URL, который вы настроили в блоке.

<div data-with-frame="true"><figure><img src="/files/e4c417e11298cfa4141661bb82678512926aa79b" alt="" width="563"><figcaption></figcaption></figure></div>

Например, вы можете затем отправлять клиентам напоминания.

{% hint style="info" %}
Чтобы узнать, как настроить ответ бота на callback нажатия ссылки, см. раздел ниже под названием [Отслеживание кликов по ссылкам.](#tracking-link-clicks)
{% endhint %}

Вы можете задать свой домен для генерации ссылок с уведомлениями о клике.

Для этого перейдите в настройки проекта:

<div data-with-frame="true"><figure><img src="/files/43cdb33a638ae42dff06def5169ec3da69747f45" alt=""><figcaption></figcaption></figure></div>

Нажмите кнопку «Установить собственный домен...» и введите свой домен в модальном окне:

<div data-with-frame="true"><figure><img src="/files/421c386c3f6d36940eb429c6b0c0ffab37aff1f3" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
[Процесс создания и настройки собственного домена описан здесь.](/doc/ru/websites/saity/builder.md#domain)
{% endhint %}

Когда уведомление о клике включено, ссылка, отправляемая пользователю, будет иметь следующий вид:

`https://{your_domain}/{proxy_id}/s`

<div data-with-frame="true"><figure><img src="/files/93c20bfdfc294319f072e0ac89d88e1737b63b5e" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/a0b2753d47b095f6ae5b13fcd39bb67d48d3c09a" alt="" width="375"><figcaption></figcaption></figure></div>

2. **флажок "Показывать предпросмотр ссылки"** флажок

<div data-with-frame="true"><figure><img src="/files/c92a775eccc2953f05608f126cff8707e2c4de69" alt="" width="344"><figcaption></figcaption></figure></div>

Это создаёт расширенный предпросмотр ссылки в мессенджере, позволяя пользователю увидеть фрагмент содержимого файла (например, заголовок, изображение или описание) до его открытия.

3. **"Изображение под текстом"** флажок

<div data-with-frame="true"><figure><img src="/files/19faf9378f6b1cd08f6f43801f6079b6acd26aba" alt="" width="375"><figcaption></figcaption></figure></div>

### Видеовложение

Кнопка видеовложения

<div data-with-frame="true"><figure><img src="/files/c27652dc9bcfc77a77e00c5e5a54b42c143e757d" alt="" width="375"><figcaption></figcaption></figure></div>

Используйте этот вариант при отправке видео. По умолчанию WhatsApp отображает видео только как ссылки.

**Чтобы отображать видео YouTube как ссылки в&#x20;*****всем*****&#x20;мессенджерах:**

* сократите URL с помощью любого сокращателя ссылок или
* отправьте его как вложение с **уведомлением о клике** включённым.

{% hint style="info" %}
Примечание!&#x20;

Telegram автоматически преобразует небольшие видео-вложения (меньше \~2 МБ) в GIF.
{% endhint %}

Для больших видео, хранящихся во внешнем хранилище, лучше прикреплять их в виде ссылок. В блоке действует прямое ограничение на загрузку видеофайлов — 20 МБ.

{% hint style="warning" %}
Обратите внимание!&#x20;

Видео прикрепляется в формате MP4.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/303f1c39cc81ec2a9fa09f5bde9d20c821fba130" alt="" width="375"><figcaption></figcaption></figure></div>

### Изображение

**кнопка "Изображение"** — используйте её, чтобы отправлять нужные изображения в боте.

<div data-with-frame="true"><figure><img src="/files/33fe1aa51e628b9af6ea3c12e44412338162fa57" alt="" width="563"><figcaption></figcaption></figure></div>

Как и любое другое вложение, изображение можно загрузить прямо с компьютера или указав его URL.

### Файл

**Файл** иконка — используйте её для отправки документов и любых других файлов.

<div data-with-frame="true"><figure><img src="/files/ea31f5abffcc0d5b9c9ea3b4b5e2d05c8395eee0" alt="" width="563"><figcaption></figcaption></figure></div>

### **Аудио**

**Иконка аудио:** используйте эту иконку при прикреплении или отправке файла в аудиоформате (например, MP3, WAV).

<div data-with-frame="true"><figure><img src="/files/2b75c55b1554a2bf47875c4c5c60ddb39ce88ce2" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d952e5e47825f9f949d132ce001d55f965a6174a" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Для Instagram формат файла должен быть .m4a.
{% endhint %}

## Отправка нескольких файлов

Чтобы отправить несколько вложений (видео, файлы, изображения или аудио):

1. Перейдите в **"Вложение"** раздел в редакторе блока.
2. Выберите нужный тип вложения.
3. Загружайте необходимые файлы по одному.

<div data-with-frame="true"><figure><img src="/files/b0ea24b67cdb417fc32f8773f563441b5f206b58" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %} <mark style="color:красный;">**Пожалуйста, учитывайте следующие ограничения при отправке нескольких вложений:**</mark>

**Общие ограничения:**

* **Количество:** можно добавить до 10 файлов одного типа одновременно.
* **Размер:** каждый отдельный файл не должен превышать 20 МБ.

**Особенности Telegram:**

* **Форматирование текста:** форматирование markdown или HTML отключено в сообщениях, содержащих несколько файлов.
* **Кнопки:** интерактивные кнопки не отправляются вместе с несколькими вложениями файлов.
  {% endhint %}

**В Telegram:**&#x20;

* Кнопки отключаются, когда блок содержит более одного вложения.

*<mark style="color:синий;">Исключение:</mark>* Если текст блока превышает 1024 символа, сообщение будет разделено. Кнопки будут отправлены вместе с текстом, а вложения — отдельным сообщением.

* <mark style="color:красный;">**Форматирование текста Markdown и HTML не работает**</mark> при отправке более одного вложения в блоке.

### Отправка вложений: примеры

Перейдём к практическим примерам. Мы настроим бота на автоматическую отправку сообщений с интервалом в 2 секунды.

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

<div data-with-frame="true"><figure><img src="/files/79de17c19321e406da9a345ca7d951e1161af744" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/80b25bd49c58a7caeb0dc888e895df50f7647259" alt="" width="375"><figcaption></figcaption></figure></div>


---

# 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://docs.mavibot.ai/doc/ru/chatbot/builder/attachments/tab.md?ask=<question>
```

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.