# Персоналізовані зображення

{% hint style="success" %}
Доступно лише на тарифі «Business».
{% endhint %}

Персоналізовані зображення — це індивідуальні ілюстрації або мініатюри, які можна унікально адаптувати для кожного користувача у вашому проєкті. Зазвичай така кастомізація передбачає зміну певних елементів, наприклад тексту, для різних цілей — наприклад, відображення імені користувача на зображенні, щоб підвищити залученість.

Давайте створимо одне разом.

#### **Створення персоналізованого зображення**

Щоб створити персоналізоване зображення, вам потрібно буде скористатися конструктором сертифікатів. Доступ до нього можна отримати в розділі створення курсу.

У конструкторі сертифікатів ви можете налаштовувати персоналізовані зображення для розсилки через чат-бота.

**Крок 1: Налаштуйте сертифікат і його текст**

1. Натисніть **«Створити сертифікат».**
2. Завантажте обране зображення як шаблон сертифіката.

<figure><img src="/files/ea111712658389a125b5232f4f200ed21dd6b548" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Обов’язково активуйте прапорець «Використовувати шаблон як кастомне зображення».
{% endhint %}

Тепер перейдіть до налаштувань сертифіката та розташуйте потрібні елементи в бажаному порядку:

<figure><img src="/files/69f584c71f094e00bed43a52ea887cd8313b113d" alt=""><figcaption></figcaption></figure>

Введіть заповнювач для імені отримувача (який буде динамічно підставлятися через чат-бота), а також будь-який додатковий текст, який ви хочете відобразити на зображенні. Тут також можна налаштувати інші параметри відображення.

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

<figure><img src="/files/219fdbac49a6cde149acd34955e8b2c6ed27dff9" alt=""><figcaption></figcaption></figure>

Щоб доставляти ці персоналізовані зображення, вам потрібно буде використовувати функцію чат-бота в месенджері, інтегрованому з системою MaviBot.

### Надсилання файла через чат-бота

Перейдіть до сценарію чат-бота, де ви хочете надсилати персоналізовані зображення. Там вам потрібно буде використати функцію:\
`get_custom_image(image_id, name_on_image, avatar)`

{% hint style="warning" %}

## Зверніть увагу

Кожного разу, коли ви використовуєте цю функцію, вона витрачає стільки ж ресурсів, скільки й надсилання 10 звичайних повідомлень.
{% endhint %}

<table><thead><tr><th width="294">Параметр</th><th>Опис</th></tr></thead><tbody><tr><td><mark style="color:red;">!</mark> image_id</td><td>ID зображення</td></tr><tr><td><mark style="color:red;">!</mark> name_on_image</td><td>ім’я користувача</td></tr><tr><td>avatar </td><td>аватар користувача<br>Якщо вам потрібно включити персоналізоване зображення, передайте значення «1».</td></tr></tbody></table>

Тут ви можете знайти ID зображення:

<figure><img src="/files/bd8a8bea8719bccf62bed00f171358e2501b14fe" alt=""><figcaption></figcaption></figure>

Як приклад, візьмімо простий сценарій чат-бота, який надсилатиме зображення в чаті:

<figure><img src="/files/f4ce33f28703dbefabbaa02af5c230a767e95f85" alt=""><figcaption></figcaption></figure>

Отже, у другому блоці ми попросимо клієнта назвати своє ім’я, а в налаштуваннях стрілки, що веде до третього блоку, вкажемо, що користувач вводить дані, і збережемо його ім’я у змінну:

<div><figure><img src="/files/3a55ccd09c4d56b7fcafe76f4b64994bb9eece79" alt=""><figcaption></figcaption></figure> <figure><img src="/files/c9209d335fa250fc2daa16f25fc4b9d8e067cae2" alt=""><figcaption></figcaption></figure></div>

У фінальному блоці сценарію, який відповідає за надсилання зображення, вставте функцію в поле калькулятора. Використовуйте такий формат, включно з `image_id` і вашим `name` змінну.

<figure><img src="/files/bcbbb30d457dd13a2985cda0f7ce760617688b21" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

## Зверніть увагу

Поле `get_custom_image` Функція повертає словник. Щоб відобразити зображення в чаті, не виводьте змінну результату (наприклад, `image_1`) безпосередньо. Натомість потрібно звернутися до значення, що зберігається під `'url'` ключем (наприклад, `image_for_user`).

Якщо все налаштовано правильно, зображення буде надіслано й одразу відображено в чаті.
{% endhint %}

{% hint style="success" %}

## Правила найменування змінних

Під час назви змінної в калькуляторі переконайтеся, що ім’я:

* Містить лише латинські літери та цифри (наприклад, `picture` є правильним).
* Не містить пробілів (використовуйте підкреслення: наприклад, `apple_on_table`).
* Розміщує цифри в кінці (наприклад, `apple1`, а не `1apple`).
  {% endhint %}

Зверніть увагу, що ми використали синтаксис `#{full_name}` для динамічної підстановки значення, наданого користувачем, у змінну.

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


---

# 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/yak-zrobiti.../personalizovani-zobrazhennya.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.