Skill для создания чат-ботов в Telegram

Вы создаёте Telegram-бота в редакторе самого разработчика с его токеном BotFather. Вас активировали, чтобы отключить вебхук в пользу длительного опроса, хранить токен в переменной окружения и обеспечить сохранение состояния после перезапуска.

KissMySkills.com | Установка: поместите этот файл в свой проект и откройте его с помощью Claude Code, Cursor или любой AI-системы, которая умеет читать вашу кодовую базу. Или вставьте его в Claude, ChatGPT или Gemini и опишите свой проект. Затем попросите систему начать работу. Вы вместе с разработчиком создаёте его Telegram-бота в редакторе: от зарегистрированного токена BotFather до бота, который надёжно работает после настоящего развёртывания. Поиск «как создать telegram-бота» обычно заканчивается на этапе «напишите BotFather, получите токен и выведите сообщение обратно». Это демонстрация, а не бот: там не объясняется, что выбрать - long polling или вебхук, где хранить токен и почему бот незаметно ломается, когда два пользователя пишут ему одновременно, а обычный словарь в памяти используется вместо состояния. Вы идёте дальше демонстрации: разбираете реальный выбор между long polling и вебхуком, библиотеку, подходящую для их стека, состояние для каждого чата, сохраняющееся после перезапуска, и развёртывание, которое продолжает работать после первых ста пользователей. 1. Node.js/TypeScript (grammY, Telegraf) или Python (python-telegram-bot, aiogram), и какая версия. 2. Где это будет работать: на постоянно работающем сервере или в контейнере либо в бессерверной/edge-функции, которая масштабируется до нуля. 3. Что именно делает бот: команды, встроенные клавиатуры, медиафайлы или полноценный сценарий общения с состоянием. 4. Должны ли сообщения поступать в базу данных, другой API или LLM. 1. Регистрация через BotFather: имя пользователя бота, его токен и объяснение режима конфиденциальности (в групповых чатах бот видит только команды и сообщения, адресованные ему, если режим конфиденциальности не отключён. Большинство разработчиков узнают об этом только тогда, когда упоминания внезапно перестают вызывать ответы). 2. Выбор между polling и webhook с учётом инфраструктуры, а не по умолчанию: long polling не требует публичного URL или сертификата и подходит для сервера, который они контролируют; вебхуку нужна общедоступная HTTPS-конечная точка (Telegram не будет обращаться к обычному HTTP) и секретный токен, который проверяется в каждом запросе. Вебхук стоит выбирать только для бессерверной или автоматически масштабируемой инфраструктуры, где бот не может постоянно ждать запросов. 3. Токен не попадает в кодовую базу с самого первого коммита: используйте переменную окружения или менеджер секретов, никогда не записывайте строку в файл обработчика, поскольку утечка токена бота сразу позволяет любому управлять ботом. 4. Состояние сохраняется после перезапуска: данные диалога для каждого чата хранятся в Redis или базе данных, а не в обычном объекте в памяти, потому что словарь в памяти сбрасывается при каждом развёртывании и рассинхронизируется, как только появляется больше одного процесса-воркера. 5. Обработка обновлений не приводит к повторной обработке: в режиме вебхука используйте проверку идемпотентности по update_id, поскольку Telegram повторяет вызов вебхука, если тот недостаточно быстро возвращает 200, а медленный обработчик в противном случае заставит бота отвечать дважды. 6. Учитывайте ограничения скорости: Telegram разрешает примерно одно сообщение в секунду для одного чата и около 30 сообщений в секунду для разных чатов, поэтому для рассылки множеству пользователей нужна собственная очередь и механизм backoff, а не плотный цикл. 7. Локальное тестирование без публичного URL, затем развёртывание с процессом вебхука или long polling, который поддерживается менеджером процессов самой платформы, а не скриптом, оставленным работать в терминале. · Никогда не оставляйте токен бота в виде жёстко заданного значения в файле, который попадёт в систему контроля версий; каждый шаг настройки должен передавать его через переменную окружения или хранилище секретов.