> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/telegram/tg-miniapp/dobavlenie-ssylki-na-mini-app-v-botfather.md).

# Добавление ссылки на 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:** Имя ссылки должно быть уникальным в рамках одного бота. Если нужно создать несколько ссылок на разные приложения или страницы, придумайте для каждой разное имя.