# Вкладка вкладень

Цей блок підтримує такі типи вкладень:

* Посилання
* Відео
* Зображення
* Файл
* Аудіо

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

{% hint style="warning" %}
В одному блоці ВИ НЕ МОЖЕТЕ поєднувати різні типи вкладень!

Вкладення, завантажені в конструктор, не повинні перевищувати 20 МБ.

Надсилання до 10 вкладень <mark style="color:red;">**одного типу**</mark> в одному блоці дозволено.
{% endhint %}

Ви також можете згенерувати зображення за допомогою **кнопки «Згенерувати зображення»** і надіслати його вашому клієнту.

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

## Як надсилати вкладення

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

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

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

{% hint style="warning" %}
**Зверніть увагу!**

**Особливості Telegram:**

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

Усі налаштування вкладень знаходяться в налаштуваннях блоку, доступ до яких можна отримати, натиснувши **«Вкладення»** кнопку.

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

&#x20;Давайте детальніше розглянемо нові кнопки, що з’явилися для типів вкладень.

### Посилання

Перша кнопка — це **Посилання**:

<div data-with-frame="true"><figure><img src="/files/cbbd27a62ec42fb2019755b50fd462577d365443" 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/677190b9bd2868233d891a9ef1746af4a105d96e" alt="" width="245"><figcaption></figcaption></figure></div>

1. **Сповіщення про клік:** Якщо ввімкнено, бот зафіксує клік користувача, надіславши повідомлення у форматі `link_was_pressed [link1] [link2]`.

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

Для чого це використовується?

<div data-with-frame="true"><figure><img src="/files/3286ce8f026d65d418ca82b62de0a4478108d485" 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/0bdb149a24bbdc219159fada28adf3e27e401175" alt="" width="563"><figcaption></figcaption></figure></div>

Наприклад, ви можете продовжити, надсилаючи клієнтам нагадування.

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

Ви можете встановити власний домен для генерації посилань зі сповіщеннями про клік.

Для цього перейдіть до налаштувань вашого проєкту:

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

Натисніть кнопку «Встановити власний домен...» і введіть свій домен у модальному вікні:

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

{% hint style="info" %}
[Процес створення та налаштування власного домену описано тут.](/doc/uk/websites/saiti/builder.md#domain)
{% endhint %}

Коли сповіщення про клік увімкнено, посилання, надіслане користувачу, матиме такий вигляд:

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

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

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

2. **прапорець «Показувати попередній перегляд посилання»** прапорець

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

Це створює розширений попередній перегляд посилання в месенджері, даючи користувачу змогу побачити фрагмент вмісту файлу (наприклад, заголовок, зображення або опис) перед його відкриттям.

3. **«Зображення під текстом»** прапорець

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

### Вкладення відео

Кнопка вкладення відео

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

Використовуйте цю опцію під час надсилання відео. За замовчуванням WhatsApp показує відео лише як посилання.

**Щоб відображати відео YouTube як посилання в&#x20;*****всіх*****&#x20;месенджерах:**

* Скоротіть URL за допомогою будь-якого скорочувача 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/7304ff768fa448032fd64110fa677a8c619f4254" alt="" width="375"><figcaption></figcaption></figure></div>

### Зображення

**кнопка «Зображення»** — використовуйте її, щоб надсилати потрібні зображення в боті.

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

Як і будь-яке інше вкладення, зображення можна завантажити безпосередньо з комп’ютера або вказавши його URL.

### Файл

**Файл** іконка — використовуйте її, щоб надсилати документи та будь-які інші файли.

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

### **Аудіо**

**Іконка аудіо:** використовуйте цю іконку під час додавання або надсилання файлу в аудіоформаті (наприклад, MP3, WAV).

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

<div data-with-frame="true"><figure><img src="/files/cf7e27f0a9014c8194f5a0c8cecd422eafdad9e0" 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/9e7617a86d564407a74dfe0ceba96cda0a8594a7" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %} <mark style="color:red;">**Будь ласка, зверніть увагу на такі обмеження під час надсилання кількох вкладень:**</mark>

**Загальні обмеження:**

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

**Особливості Telegram:**

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

**У Telegram:**&#x20;

* Кнопки вимикаються, коли блок містить більше ніж одне вкладення.

*<mark style="color:blue;">Виняток:</mark>* Якщо текст блоку перевищує 1024 символи, повідомлення розділяється. Кнопки буде надіслано разом із текстом, а вкладення — в окремому повідомленні.

* <mark style="color:red;">**Форматування тексту Markdown і HTML не працює**</mark> під час надсилання більш ніж одного вкладення в блоці.

### Надсилання вкладень: приклади

Перейдемо до практичних прикладів. Ми налаштуємо бота на автоматичне надсилання повідомлень із 2-секундними інтервалами.

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

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

У прикладному сценарії послідовно демонструються різні типи вкладень — файл, посилання, відео, зображення та аудіо — із 2-секундною затримкою.

<div data-with-frame="true"><figure><img src="/files/82fb7fed898eb177fda3a7c9f114ae1f289ff2e4" 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/uk/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.