> 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="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2F8h09fjIBIbMPR7IZXG3d%2Fimage.png?alt=media&amp;token=f03be7b0-af09-41b7-9249-fd932c4cef4d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FJpPjAAesS3CbXH3lct59%2Fimage.png?alt=media&amp;token=9c4e30e5-a7bc-400b-969d-87ffa16a08bc" alt=""><figcaption></figcaption></figure>

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

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

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

  <figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FPyBAvnrKOwfNBrUfrflZ%2Fimage.png?alt=media&amp;token=205d1c75-b094-49b0-aefb-6c26a15b8e63" 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:** Имя ссылки должно быть уникальным в рамках одного бота. Если нужно создать несколько ссылок на разные приложения или страницы, придумайте для каждой разное имя.