# Добавление ссылки на Mini App в BotFather

Для интеграции мини-приложения Программы лояльности с Telegram-ботом необходимо создать специальную прямую ссылку (Direct Link). Эта ссылка позволяет открывать ваше приложение одной кнопкой прямо из чата. Вся процедура выполняется через Mini App в чат-боте [@BotFather](https://telegram.me/BotFather).

### Предварительные требования

1. **Созданное мини-приложение:** Перейдите в раздел [Мини-приложения](https://my.fstrk.io/marketing/mini-apps/) и создайте там приложение
2. **Готовая ссылка на мини-приложение:** из настроек мини-приложения скопируйте ссылку на него, она понадобится вам для дальнейшей настройки.

### Пошаговая инструкция

#### Шаг 1: Запуск интерфейса управления

1. Перейдите в Telegram и откройте бота [@BotFather](https://t.me/botfather).
2. В диалоге с [@BotFather](https://t.me/botfather) найдите и **нажмите кнопку `Open`**. Это действие откроет мини-приложение (Mini App) по управлению вашими ботами.

#### Шаг 2: Переход в раздел Mini Apps

1. В открывшемся интерфейсе мини-приложения выберите из списка бота, которого нужно связать с вашим Mini App.
2. В меню управления этим ботом найдите и перейдите в раздел **`MiniApps`**.

#### Шаг 3: Создание прямой ссылки (Direct Link)

1. Внутри раздела **`MiniApps`** нажмите на кнопку **`+ Create Direct Link`**.

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

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

2. Заполните открывшуюся форму:

* Вставьте полный URL-адрес вашего мини-приложения.
* Заполните Metadata:&#x20;
  * Загрузите иконку (аватарку) для приложения. Используйте изображение с разрешением 640 на 360 пикселей.
  * Title: Заголовок
  * Description: описание к вашему мини-приложению
* **Directlink:** Придумайте уникальный для этого бота идентификатор ("хвост" для ссылки). Например: `loyalty_program`. Название должно быть латинскими буквами, можно использовать нижние подчёркивания.

  * **Важно:** Это имя сформирует конечную часть вашей специальной ссылки на бота.

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

#### Шаг 4: Получение ссылки

После сохранения настроек система сгенерирует прямую ссылку на ваш бот для открытия Mini App. Ссылка будет иметь стандартный формат:\
`https://t.me/ваш_бот/указанный_directlink`

**Сохраните эту ссылку.** Она является конечным URL для запуска вашего приложения извне.

### Интеграция на платформе Fasttrack

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

1. В редакторе сценариев создайте **Inline-кнопку** (кнопку, которая появляется под сообщением).
2. Для типа действия кнопки выберите **`Ссылка`**.
3. В поле для URL вставьте **полученную на Шаге 4 ссылку** формата `https://t.me/ваш_бот/...`.
4. Нажмите на кнопку Добавить.

### Примечания

* **Уникальность directlink:** Имя ссылки должно быть уникальным в рамках одного бота. Если нужно создать несколько ссылок на разные приложения или страницы, придумайте для каждой разное имя.


---

# 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.fstrk.io/knowledge_base/telegram/tg-miniapp/dobavlenie-ssylki-na-mini-app-v-botfather.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.