# Рефералы

### Настройка мини-приложения в [@BotFather](https://t.me/BotFather)

#### Шаг 1. Откройте BotFather

1. Перейдите по ссылке: [@BotFather](https://t.me/BotFather)
2. Нажмите кнопку **«Открыть»**, как показано на скриншоте:

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

1. Или в чате нажмите на аватарку или имя бота в верхней части, чтобы открыть его профиль.
2. В профиле нажмите кнопку **«Открыть приложение» (или «Открыть бот»)**.

***

#### Шаг 2. Выберите или создайте бота

* Если у вас **ещё нет бота**, создайте его:
  1. Нажмите кнопку **Создать нового бота**
  2. Придумайте имя и username (например, `mycompany_bot`)
  3. Скопируйте токен — он пригодится для API и интеграций
* Если бот уже есть — выберите его из списка.
* Внутри вашего бота выберите miniapp&#x20;
*

```
<figure><img src="/files/auaa3mKX6ps2gx6DMf1G" alt=""><figcaption></figcaption></figure>
```

***

#### Шаг 3. Настройка кнопки меню (Menu Button)

> ⚠️ Это необходимо для отображения Mini App в Telegram до его запуска

1. Нажмите кнопку **Menu Button**
2. Укажите:
   * **URL вашего сайта** (например: `https://yourapp.example.com`)
   * **Название кнопки**, которое увидит пользователь (например: `Открыть меню`)
3. Сохраните изменения

***

#### Шаг 4. Настройка Mini App

1. Вернитесь назад и нажмите на кнопку **Mini App**
2. Введите:

   * **URL** вашего веб-приложения (тот же, что и выше)
   * Выберите **вариант отображения** (например: `Full screen`, `Fullsize`, `Compact`) — это зависит от UX

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

***

#### Шаг 5. Настройка DirectLink

1. В том же разделе Mini App найдите опцию **Direct Link**
2. Введите:
   * **URL** сайта
   * **Название** — это заголовок, который будет отображаться в превью-ссылке (например: `Delever`)
   * **Описание** — краткий текст под заголовком (например: `Закажите доставку за 1 клик`)
   * **Изображение (preview image)** — картинка, которая отображается в превью (рекомендуется 640x360 или 1:1 формат)
   * В поле `directlink` укажите короткое имя, : `dlvr`
3. Сохраните — Telegram сгенерирует ссылку вида:

   ```
   https://t.me/yourbot/delever
   ```

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

***

#### Шаг 6. Продолжите настройку в админ-панели Delever

После настройки Mini App в BotFather:

1. Перейдите в **админ-панель Delever**
2. Перейдите в раздел Маркетинг **→ Рефералы**
3. Продолжите создание реферала, используя только что созданный DirectLink

***

Готово! Ваш Mini App теперь интегрирован с Telegram и доступен пользователям.


---

# 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://delever.gitbook.io/delever/user-guide/admin-panel/marketing/referaly.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.
