# Як отримувати зображення та файли від користувача

У цьому розділі пояснюється, як визначити, коли користувач надсилає файл, отримати його посилання та як правильно з ним працювати.

Щоб визначити, коли користувач надіслав вкладення (наприклад, зображення, файл, відео або аудіо), потрібно використовувати умову тригера:

`attachment_message`

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

Після того як користувач надсилає файл, генеруються такі системні змінні:

* `#{attachments}`: Містить URL-адреси всіх вкладень із повідомлення користувача, у форматі масиву JSON. Використовуйте це, коли потрібно обробляти кілька файлів або працювати зі структурою даних програмно.
* `#{attachment_url}`: Містить прямий URL-адресу у вигляді простого тексту для першого (або єдиного) вкладення. Це найзручніша змінна для негайного використання, наприклад для відображення посилання в повідомленні або передавання його до іншої функції.

Щоб зрозуміти практичну різницю, ви можете показати обидві змінні в повідомленні бота.  `#{attachments}` змінна покаже структурований масив JSON, тоді як `#{attachment_url}` покаже просту, клікабельну URL-адресу.

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

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

Для цього оголосіть нову змінну в **Калькуляторі** редактора блоків і призначте їй значення `#{attachment_url}` .

**Приклад:**\
`user_file = #{attachment_url}`&#x20;

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

Призначте значення `attachment_url` змінній `url_image1`.


---

# 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/images.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.