# telegram-mini-app

Скилл помогает проектировать Telegram Mini Apps: подключать Web App API и TON Connect, добавлять оплату и вход через Telegram. Пригодится для веб-приложения, которое открывается внутри Telegram.

- скилл · `type=skill` · Claude Code · 128 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/telegram-mini-app
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/telegram-mini-app

## Что делает

Скилл охватывает устройство Mini App, работу с Telegram Web App API и авторизацию пользователя через Telegram. Он описывает базовую HTML-структуру и вариант для React: получение данных пользователя, вызовы `ready`, `expand` и `close`, а также запуск приложения ботом через команду с кнопкой.

Для Web3-сценариев есть настройка TON Connect в React, подключение кошелька и отправка транзакции в TON. Отдельные разделы посвящены оплатам, включая Telegram Stars, реферальным механикам и игровым наградам. Это рекомендации и примеры для разработки, а не готовое приложение. Проверяйте `initData` от Telegram: скилл отмечает его отсутствие как серьёзную проблему.

Также рассматриваются мобильная вёрстка, тема Telegram и состояния загрузки. TON Connect на мобильных устройствах указан как проблемный участок; эту интеграцию стоит отдельно проверить на целевых телефонах.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --skill enterprise-communication/telegram-mini-app
```

2. **Через Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill telegram-mini-app -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/telegram-mini-app/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/telegram-mini-app/

### Codex

**Вручную: положить файлы**
- Файл: `.agents/skills/telegram-mini-app/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/telegram-mini-app/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates telegram-mini-app
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/telegram-mini-app/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/telegram-mini-app
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/telegram-mini-app/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/telegram-mini-app

## Когда брать
- подключить Telegram Web App API к интерфейсу
- получить данные пользователя из Telegram
- добавить вход через TON Connect и отправку транзакции
- настроить оплату через Telegram Stars
- спроектировать реферальную механику для Mini App

## Примеры запросов агенту
- Спроектируй React Mini App и добавь хук для работы с Telegram Web App API.
- Подключи TON Connect к приложению и подготовь кнопку отправки транзакции.
- Добавь оплату через Telegram Stars и реферальную ссылку для пользователей.

## Похожие
- [access](https://affpapa.org/nevibecode/skills/access-2.md) — скилл · 3867 установок
- [configure](https://affpapa.org/nevibecode/skills/configure-2.md) — скилл · 3861 установка
- [claude-to-im](https://affpapa.org/nevibecode/skills/claude-to-im.md) — скилл · 7100 установок
- [mode-creator](https://affpapa.org/nevibecode/skills/mode-creator.md) — скилл · 1300 установок
- [telegram-bot-builder](https://affpapa.org/nevibecode/skills/sickn33-telegram-bot-builder.md) — скилл · 3700 установок
- [chat-sdk](https://affpapa.org/nevibecode/skills/vercel-chat-sdk.md) — скилл · 5400 установок

## Другие версии с тем же именем
- [telegram-mini-app · sickn33](https://affpapa.org/nevibecode/skills/sickn33-telegram-mini-app.md) — 1700 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md