Для AI-агентов: markdown этой страницы — /docs/direct-link-app.mdиндекс документации — /llms.txt
Как включить галочку «Разрешить писать мне» при запуске мини-приложения
Обновлено
Когда покупатель впервые открывает мини-приложение по обычной ссылке, Telegram сначала запускает его, а разрешение писать спрашивает вторым окном. Если завести у бота Direct Link с коротким именем miniapp, Telegram покажет одно окно запуска, и галочка «Разрешить писать мне» в нём уже стоит. Шаг необязательный: без него всё работает, покупателю просто показывается второе окно.
Что нужно
Бот бизнеса, подключённый к TelegaFirst, и его мини-приложение: адрес
https://…/miniapp.Вы — владелец этого бота в @BotFather.
Обложка 640×360. Её не нужно рисовать: в CRM есть кнопка «Скачать обложку 640×360» — на ней название бизнеса и аватар бота.
Шаги
Откройте @BotFather, выберите Mini Apps, затем своего бота и нажмите Create Direct Link.
Адрес (URL) — тот же, что у главного мини-приложения бота:
https://…/miniapp. Точный адрес показан в CRM: Настройки → Внешний контур, карточка «Direct Link для бота»; агент берёт его изget_mini_app_links(полеweb_app_url). Адрес корня сайта не подходит: ссылки сstartappв таком мини-приложении не откроют нужную страницу.Title — название вашего бизнеса. Telegram показывает его в шапке открытого мини-приложения.
Обложка — картинка 640×360, скачайте её в CRM.
Short name —
miniapp, тем же словом, что и конец адреса…/miniapp, ровно так, латиницей.Вернитесь в 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, остаются в прежней форме: она рабочая, но без галочки.Главное мини-приложение бота менять не нужно: оно остаётся настроенным.