Как создать Telegram-бота с нейросетью: Windsurf пишет код, n8n собирает логику

Обновлено: июнь 2026

Создать Telegram-бота с ИИ в 2026 году можно двумя путями: написать код через Windsurf или Cursor по вашему промпту на русском, либо собрать логику визуально в n8n - без единой строки кода. Ниже подробно про оба варианта: от получения токена BotFather до подключения нейросети и деплоя.

TL;DR. Два способа создать Telegram-бота с нейросетью: Windsurf/Cursor генерируют Python-код по промпту (библиотека python-telegram-bot, Claude Sonnet 4.6 или DeepSeek), n8n собирает логику визуально за 30-60 минут без программирования. Оба работают без VPN. Статья - пошаговый гайд с примерами промптов и настройками.

Шаг 1. Как получить токен для Telegram-бота

Без токена не работает ни один из подходов. Занимает ровно две минуты.

Открыть Telegram, найти @BotFather, написать /newbot. BotFather попросит придумать имя бота и username (должен заканчиваться на bot). После этого выдаст токен вида 1234567890:AABBCCxxxx. Скопировать и сохранить - он понадобится на следующем шаге.

Здесь есть нюанс. Токен нельзя коммитить в публичный репозиторий - его нужно хранить в файле .env. Windsurf автоматически добавляет .env в .gitignore, так что случайно утечет сложно. Но если работаете через n8n - токен хранится в настройках credential, не в коде вообще.

Шаг 2. Какой подход выбрать: Windsurf/Cursor или n8n?

Windsurf подходит, если нужна гибкая кастомная логика. n8n - если хочется запустить за вечер без программирования.

Выбор зависит от двух вещей: насколько нестандартная нужна логика, и готовы ли вы разбираться с кодом (пусть и написанным ИИ).

Если вы ни разу не запускали код - берите n8n. Если хотите понять, как бот устроен изнутри, и потом масштабировать - Windsurf.

Максим: «Все наши проекты продвигаем не через платные каналы, а через органику. Но и строим тоже органично: берем тот инструмент, который даст результат быстрее. GoBanana мы собрали за 6-8 часов - веб-версию Максим поднял сразу после выхода модели. Не потому что он суперпрограммист, а потому что Windsurf писал код, а он описывал задачи.»

Шаг 3. Как создать бота через Windsurf: пошаговый разбор

Windsurf устанавливается на компьютер, открывает Cascade-чат и пишет код по вашему описанию. Работает на Mac, Windows, Linux.

Установка и первый запуск

Скачать Windsurf с windsurf.com - это редактор кода, не браузерный инструмент. Установить, создать новую папку проекта. Открыть правую панель - это Cascade, главный AI-чат редактора.

Cascade умеет читать весь проект целиком, создавать файлы, устанавливать зависимости через терминал и запускать команды. Думайте о нем как о ChatGPT, который не просто советует, а сразу делает изменения в файлах.

Промпт для создания бота

Написать в Cascade на русском:

Создай Telegram-бота на Python с библиотекой python-telegram-bot.
Бот должен:
- Принимать текстовые сообщения
- Отправлять их в Claude Sonnet 4.6 через API Anthropic
- Помнить историю диалога для каждого пользователя по sender_id
- Хранить токен бота и API-ключ в .env файле
- Иметь команду /start с приветствием и /clear для очистки истории

Cascade создаст файлы main.py, requirements.txt, .env.example. Потом предложит установить зависимости - нажать «Accept» и подождать примерно минуту.

Выбор модели в Windsurf

Для написания кода бота из Cascade можно выбирать модель. На практике разница такая:

• Claude Sonnet 4.6 - точно выполняет задачу, не придумывает лишнего. Лучший выбор для старта.
• Gemini 3.1 Pro - хорошо смотрит на архитектуру, может предложить другой подход. Контекстное окно 1M токенов - удобно для больших проектов.
• DeepSeek V3.2 - самый дешевый, справляется с базовой логикой. Но в режиме агента иногда работает хуже.

Менять модель прямо в Cascade можно на ходу - это не сбрасывает контекст.

Важный лайфхак про контекст

Для каждой новой функции бота лучше начинать новый чат в Cascade. Если добавлять всё в одном длинном диалоге, ИИ начинает путаться в истории правок. Короткие прицельные промпты работают надежнее длинных.

Структура готового Python-бота

# main.py — упрощенная структура
import os
from dotenv import load_dotenv
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters
import anthropic

load_dotenv()
client = anthropic.Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))
user_histories = {}  # память по sender_id

async def handle_message(update: Update, context):
    user_id = update.effective_user.id
    if user_id not in user_histories:
        user_histories[user_id] = []

    user_histories[user_id].append({
        "role": "user",
        "content": update.message.text
    })

    response = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=1024,
        messages=user_histories[user_id]
    )

    reply = response.content[0].text
    user_histories[user_id].append({"role": "assistant", "content": reply})
    await update.message.reply_text(reply)

Windsurf сгенерирует всё это сам. Этот фрагмент - просто чтобы понимать, что происходит внутри.

Шаг 4. Как создать Telegram-бота через n8n без кода

n8n - визуальный конструктор автоматизаций. Бот собирается из блоков за 30-60 минут, деплоить ничего не нужно.

Что такое n8n

n8n - это инструмент автоматизаций, где логика строится визуально: блоки соединяются стрелками, данные текут между ними. Есть облачная версия (n8n.io, бесплатный тариф) и локальная установка через Docker.

Для Telegram-бота понадобятся три базовых блока: триггер, AI-агент, отправка ответа.

Базовая схема флоу

[Telegram Trigger] → [AI Agent] → [Telegram Send Message]

Так выглядит самый простой бот. Telegram Trigger получает входящее сообщение, AI Agent обрабатывает его через нейросеть, Telegram Send Message отправляет ответ обратно.

Пошаговая настройка в n8n

Шаг 1. Создать флоу, добавить узел Telegram Trigger. В настройках указать токен бота из BotFather. Выбрать тип события message.

Шаг 2. Добавить узел AI Agent. Подключить модель - OpenAI, Anthropic или другую через credentials. В поле prompt передать {{ $json.message.text }} - это текст входящего сообщения.

Шаг 3. Добавить узел Telegram Send Message. В поле Chat ID передать {{ $json.message.chat.id }}. В поле Text - ответ агента {{ $json.output }}.

Шаг 4. Активировать флоу. Готово - бот отвечает.

Здесь есть нюанс про attribution. По умолчанию Telegram-узел n8n добавляет подпись «was sent automatically from n8n». Чтобы убрать: в настройках узла Send Text Message найти вкладку «Append and add attribution» и снять галочку.

Добавить обработку голоса и фото

n8n умеет обрабатывать не только текст. Для голосовых и изображений нужна более сложная маршрутизация:

[Telegram Trigger]
    ↓
[Switch: тип сообщения]
    ├→ Текст → [AI Agent] → [Send Message]
    ├→ Фото → [Download File] → [OpenAI Analyze Image] → [Send Message]
    └→ Голос → [Download File] → [OpenAI Transcribe] → [AI Agent] → [Send Message]

Узел Switch проверяет метаданные сообщения - есть ли file_id (значит фото или голос) или нет (значит текст). Это тот же принцип, что и в Python, просто без кода.

Шаг 5. Как подключить нейросеть без VPN в России

DeepSeek работает напрямую. Для Claude и GPT используйте российские API-прокси.

Это реальная проблема для разработки бота в России. Прямой доступ к api.anthropic.com и api.openai.com требует зарубежной карты. Три рабочих варианта:

DeepSeek V3.2 - работает без VPN, принимает рублевые карты. Цена $0.28/1M токенов входящих токенов делает его практически бесплатным для небольших ботов. Качество ниже Claude, но для FAQ-бота или помощника по документации - достаточно.

Российские API-прокси для Claude и GPT - proxyapi.ru, openai-proxy.ru и аналоги. Они принимают платежи в рублях, работают без VPN. URL и формат запросов идентичны оригинальному API, меняется только base_url в настройках.

OpenRouter - агрегатор моделей с доступом к Claude, GPT, DeepSeek и десяткам других. Один аккаунт и один API-ключ вместо нескольких. Ещё один плюс: можно переключать модели прямо в промпте, не меняя код.

В n8n все три варианта подключаются через Credentials: указываете URL и ключ, дальше редактор сам подставляет их в запросы.

Шаг 6. Как задеплоить Telegram-бота

n8n деплоить не нужно. Для Python через Windsurf - Railway или Render, занимает 15 минут.

Для Python-бота нужен постоянно работающий сервер. Варианты:

Railway - самый простой деплой: подключить GitHub-репозиторий, указать переменные окружения из .env, нажать Deploy. Бесплатный тариф дает 500 часов в месяц - для личного бота хватит.

Render - похожий сервис, есть бесплатный постоянный инстанс (с ограничениями по мощности). Для небольшого бота работает стабильно.

VPS (любой хостинг) - полный контроль, но требует базовых знаний Linux. Windsurf поможет написать инструкцию по деплою прямо в Cascade.

Для n8n облачной версии деплой не нужен совсем. Флоу запущен, пока работает аккаунт n8n.io.

Что выбрать: итоговая карта по сценариям

Короткий ответ: новичкам - n8n, тем кто хочет разобраться и масштабировать - Windsurf.

По факту, многие начинают с n8n, чтобы быстро проверить идею, а потом переписывают логику в Python, когда бот начинает расти. Это нормально.

Частые вопросы о создании ботов с нейросетью

Можно ли создать бот в Telegram бесплатно? Да. n8n имеет бесплатный облачный тариф для старта. Windsurf бесплатен для разработки, платить придется только за API нейросети. DeepSeek V3.2 стоит $0.28 за 1M токенов - практически бесплатно для небольшого бота.

Нужно ли знать Python? Нет. Через n8n бот собирается полностью визуально. Через Windsurf Python-код пишет ИИ по вашему описанию на русском - вы только проверяете и запускаете. По факту достаточно понять структуру файлов и уметь вставить токен в .env.

Какую нейросеть лучше подключить? Для баланса цены и качества - Claude Sonnet 4.6 ($3/1M токенов). Для экономии - DeepSeek V3.2 ($0.28/1M). Для сложной логики - Claude Opus 4.6. Все три работают без VPN через российские прокси-API.

Windsurf или Cursor - что лучше для бота? Для новичков Windsurf проще: встроенный Cascade-чат, preview прямо в редакторе, автозапуск команд через терминал. Cursor быстрее на автодополнении и удобнее, если уже знаком с VS Code. Оба справляются с Python-ботом за один вечер.

Сколько времени займет создать бота? Простой бот с AI-ответами через n8n собирается за 30-60 минут. Через Windsurf - 1-2 часа с учетом того, что ИИ сам пишет код. Обработка голоса и фото в обоих случаях добавляет ещё час.

Как бот запоминает историю диалога? В Python (через Windsurf): хранить историю в словаре по sender_id. В n8n: добавить узел Memory внутри AI Agent - он ведет контекст сессии автоматически.

Можно ли создать бота с ИИ без VPN в России? Да. DeepSeek работает напрямую. Для Claude и GPT используйте российские API-прокси - они принимают рублевые карты и не требуют зарубежных платежных методов.

Глоссарий

BotFather - официальный бот Telegram для создания и управления ботами. Через него получают токен.

Токен бота - отдельный ключ вида 1234567890:AABB..., который идентифицирует бота в Telegram API.

python-telegram-bot - библиотека Python для работы с Telegram Bot API. Windsurf подключает её автоматически.

Cascade - AI-чат внутри Windsurf, который видит весь проект и может менять файлы напрямую.

n8n - визуальный инструмент автоматизаций. Логика бота собирается из блоков без кода.

AI Agent (в n8n) - узел, который подключает нейросеть и управляет диалогом, памятью и инструментами.

sender_id - отдельный идентификатор пользователя в Telegram, нужен для хранения отдельной истории для каждого.

.env файл - файл с секретными переменными (токен, API-ключ). Не попадает в репозиторий благодаря .gitignore.

OpenRouter - агрегатор AI-моделей, дает доступ к Claude, GPT, DeepSeek через один API-ключ.

Webhook vs Polling - два способа получать сообщения от Telegram. Polling (опрос сервера) проще для старта, webhook - для продакшена.

Куда двигаться дальше

Обзоры инструментов на VibeCoderz: Windsurf, Cursor, Claude Code. Там же можно сравнить цены и возможности каждого под конкретные задачи.

Если нужны AI-агенты под конкретную профессию или нишу - смотрите каталог агентов на VibeCoderz. Там 297 ниш, в том числе агент для технической поддержки и автоматизации сервисов.

Разобраться с деплоем, выбором стека или архитектурой бота под конкретную задачу можно на консультации с Максимом - он проходил этот путь на реальных проектах с сотнями тысяч пользователей.

Обновлено: июнь 2026. Цены на модели и тарифы инструментов актуальны на дату публикации.