# Как включить галочку «Разрешить писать мне» при запуске мини-приложения

Source: <https://telegafirst.com/docs/direct-link-app>
Locale: ru
releaseGitSha: fc570c76ffc9cb87e2462d45b14f5c1b52fbaf0d
sourceContentDigest: bd70ed5c2e050cbedcc8232c66a7c71336a9b724225294b83cbe7555e002e672
Version: 2

Когда покупатель впервые открывает мини-приложение по обычной ссылке, Telegram сначала запускает его, а разрешение писать спрашивает вторым окном. Если завести у бота Direct Link с коротким именем `miniapp`, Telegram покажет одно окно запуска, и галочка «Разрешить писать мне» в нём уже стоит. Шаг необязательный: без него всё работает, покупателю просто показывается второе окно.

## Что нужно

* Бот бизнеса, подключённый к TelegaFirst, и его мини-приложение: адрес `https://…/miniapp`.
* Вы — владелец этого бота в @BotFather.
* Обложка 640×360. Её не нужно рисовать: в CRM есть кнопка «Скачать обложку 640×360» — на ней название бизнеса и аватар бота.

## Шаги

1. Откройте @BotFather, выберите Mini Apps, затем своего бота и нажмите Create Direct Link.
2. Адрес (URL) — тот же, что у главного мини-приложения бота: `https://…/miniapp`. Точный адрес показан в CRM: Настройки → Внешний контур, карточка «Direct Link для бота»; агент берёт его из `get_mini_app_links` (поле `web_app_url`). Адрес корня сайта не подходит: ссылки с `startapp` в таком мини-приложении не откроют нужную страницу.
3. Title — название вашего бизнеса. Telegram показывает его в шапке открытого мини-приложения.
4. Обложка — картинка 640×360, скачайте её в CRM.
5. Short name — `miniapp`, тем же словом, что и конец адреса `…/miniapp`, ровно так, латиницей.
6. Вернитесь в CRM и нажмите «Проверить» — или попросите своего ИИ вызвать `check_direct_app`.

После успешной проверки все ссылки на мини-приложение в Telegram откроются через окно с галочкой: платформа сама переключит их с `t.me/{бот}?startapp` на `t.me/{бот}/miniapp?startapp`.

## Что скажет проверка

Проверка спрашивает Telegram через служебный аккаунт и отвечает одним из вариантов:

| Ответ | Что значит | Что сделать |
| - | - | - |
| `none` | Direct Link на месте, адрес верный | Ничего: ссылки уже переключены |
| `create_direct_link` | У бота нет Direct Link с коротким именем `miniapp` | В @BotFather: Mini Apps → Create Direct Link, short name `miniapp` |
| `set_direct_link_url` | Адрес Direct Link не совпадает с адресом мини-приложения бизнеса | Вставьте в Direct Link адрес `web_app_url` |
| `set_main_app_url` | Главное мини-приложение бота открывает другой адрес | Вставьте `web_app_url` в Main App бота |
| `no_bot` | К бизнесу не подключён бот | Подключите бота |
| `no_address` | У бизнеса нет опубликованного сайта | Опубликуйте сайт, чтобы появился адрес мини-приложения |
| `no_supergroup` | Не привязана супергруппа Открытых линий | Привяжите её, проверка идёт через её служебный аккаунт |
| `check_unavailable` | Служебный аккаунт не ответил | Повторите проверку позже |
| `retry_later` | Бизнес проверяли меньше минуты назад: Telegram спрашивают не чаще раза в минуту, статус — по прошлой проверке | Повторите через минуту |

## Важно знать

* Ссылки, отправленные раньше, продолжают работать, просто без галочки.
* Если покупатель снимет галочку или позже запретит боту писать, мини-приложение спросит разрешение само.
* Страницы, которые уже опубликованы как статические и содержат прежнюю ссылку `t.me/{бот}?startapp`, остаются в прежней форме: она рабочая, но без галочки.
* Главное мини-приложение бота менять не нужно: оно остаётся настроенным.