AI-боты и агенты для бизнеса

Модуль 0 — Подготовка рабочего места

0.1 Что мы построим

За этот курс ты шаг за шагом соберёшь бота-сотрудника для своего бизнеса — из трёх частей:

• Telegram-бот-продавец — встречает клиента, отвечает на вопросы как живой (на базе Claude или GPT) и ведёт к покупке круглосуточно.
• Мозг на твоей базе знаний — бот знает твои товары/услуги, цены и правила, говорит твоим тоном, а не шаблонами.
• AI-агент на автопилоте — принимает заявки и заказы, шлёт их тебе в Telegram и в CRM-таблицу, делает рутину по расписанию через n8n / Make — без твоего участия, 24/7.

Два инструмента, которые всё это делают:

• Claude Code — пишет код за тебя. Ты описываешь задачу обычными словами — он собирает бота.
• n8n или Make — визуальный «конструктор автоматизаций»: блоки соединяешь мышкой, код не нужен. Через них бот связывается с Telegram, AI, таблицами и CRM.

0.2 Создаём аккаунт Claude (мозг бота)

Бот отвечает клиентам не сам — за него думает большая языковая модель (LLM). Мы возьмём Claude от Anthropic (можно и GPT от OpenAI — покажу оба). Чтобы бот обращался к модели автоматически, нужен API-ключ — твой личный «пропуск».

Вариант А. Claude (рекомендую)

1. Зарегистрируйся в Claude

   Открой claude.ai, нажми Sign up, зайди через Google или почту. Это бесплатный чат-аккаунт.

2. Получи API-ключ

   Для автоматической работы бота нужен ключ. Перейди на console.anthropic.com, войди тем же аккаунтом, открой раздел API Keys → Create Key. Скопируй ключ (начинается на sk-ant-...) — он показывается один раз.

3. Пополни баланс на небольшую сумму

   В разделе Billing добавь $5–10. Оплата идёт по факту — за каждый ответ бота списываются копейки. Этого хватит на сотни тестов.

Вариант Б. GPT (OpenAI) — альтернатива

1. Зарегистрируйся в OpenAI

   Открой platform.openai.com, создай аккаунт.

2. Создай API-ключ

   Раздел API keys → Create new secret key. Скопируй ключ (начинается на sk-...) и пополни баланс на $5–10 в разделе Billing.

0.3 Устанавливаем Claude Code

Claude Code работает в «терминале». Сначала поставим то, без чего он не запустится — программу Node.js, а затем сам Claude Code.

Шаг А. Устанавливаем Node.js

1. Скачай Node.js

   Открой nodejs.org и нажми большую зелёную кнопку LTS (рекомендуемая версия). Скачается файл-установщик.

2. Установи

   Запусти скачанный файл. И на Windows, и на Mac это обычный установщик: жми Продолжить → Принять условия → Установить → Готово (ничего не меняй). На Mac может спросить пароль от компьютера — это нормально.

3. Проверь, что установилось

   Открой терминал (Windows — приложение «PowerShell», Mac — «Terminal» через поиск Spotlight). Введи команду и нажми Enter:

   node -v

   Если появилось что-то вроде v22.3.0 — Node.js установлен. ✅

Шаг Б. Устанавливаем Claude Code

1. Введи команду установки

   В том же терминале вставь и нажми Enter:

   npm install -g @anthropic-ai/claude-code

   Подожди 1–2 минуты, пока всё загрузится. Побегут строки — это нормально.

2. Запусти Claude Code

   Введи короткую команду:

   claude

   В первый раз он попросит войти — откроется браузер, нажми авторизоваться аккаунтом claude.ai (тем самым из урока 0.2).

3. Проверь, что работает

   Когда увидишь приветствие Claude Code прямо в терминале — напиши ему: Привет! Ты готов помочь мне собрать Telegram-бота? Если ответил — всё работает. 🎉

0.4 Заводим бота в BotFather

Все Telegram-боты создаются через официального бота Telegram — @BotFather. Это займёт 2 минуты.

1. Найди BotFather

   В Telegram в поиске введи @BotFather и открой чат (у него синяя галочка — официальный).

2. Создай нового бота

   Отправь команду /newbot. BotFather спросит:

   • Имя бота — как он будет подписан (например, «Магазин FANTASY · помощник»).
   • Username — уникальный адрес, обязательно заканчивается на bot (например, fantasy_help_bot).
3. Скопируй и сохрани токен

   BotFather пришлёт токен вида 1234567890:AAF...длинная_строка. Скопируй и сохрани в надёжное место — это ключ управления ботом.

4. Настрой бота (по желанию)

   Тут же можно задать аватар и описание: /setuserpic — картинка, /setdescription — текст, который видит новый пользователь, /setabouttext — короткое «о боте».

Модуль 1 — Первый Telegram-бот

1.1 Кладём токен бота безопасно

Хорошая привычка с самого начала: секреты храним отдельно от кода — в файле .env. Тогда их не увидит никто посторонний.

Путь Claude Code

1. Открой Claude Code в папке бота

   В терминале в папке moy-bot введи claude.

2. Поручи создать файл секретов
   Задание Claude Code

   Создай файл .env со строками TELEGRAM_TOKEN=сюда_токен_бота и ANTHROPIC_API_KEY=сюда_мой_ключ. Добавь .env в .gitignore, чтобы он никуда не попал. Объясни одним предложением, что ты сделал.

   Потом открой .env, вставь свой токен бота (из урока 0.4) и API-ключ (из 0.2) вместо заглушек, сохрани.

Путь n8n / Make

В n8n/Make секреты хранятся в разделе Credentials — их не нужно писать в файл. Мы добавим их прямо при подключении Telegram и AI (в уроках 1.2 и 2.1). Сейчас просто держи токен бота и API-ключ под рукой.

1.2 Первый запуск — бот отвечает «эхо»

Путь Claude Code

1. Поручи собрать бота-эхо
   Задание Claude Code

   Собери простого Telegram-бота на Python с библиотекой aiogram. Токен бери из .env (TELEGRAM_TOKEN). Пока бот должен просто: на команду /start отвечать «Привет! Я твой бот-помощник 🤖», а на любое текстовое сообщение отвечать тем же текстом с припиской «Ты написал: …». Объясни, как запустить.
2. Запусти

   Claude Code подскажет команду (обычно python bot.py). Запусти её — в терминале появится сообщение, что бот стартовал.

3. Проверь в Telegram

   Открой своего бота (по username из 0.4), нажми Start. Он должен ответить приветствием. Напиши что угодно — бот повторит. Связь работает. ✅

Путь n8n / Make

1. Заведи аккаунт n8n или Make

   Открой n8n.io (есть бесплатное облако) или make.com. Зарегистрируйся, создай новый пустой сценарий (workflow / scenario).

2. Добавь триггер Telegram

   Нажми «+», найди Telegram Trigger (в Make — модуль Telegram Bot → Watch Updates). При подключении вставь токен бота — создастся Credential.

3. Добавь ответ

   После триггера добавь блок Telegram → Send Message. В поле Chat ID подставь {{ $json.message.chat.id }}, в текст — Ты написал: {{ $json.message.text }}.

4. Включи и проверь

   Нажми Execute / Listen (в проде — Activate). Напиши боту в Telegram — придёт ответ-эхо.

1.3 Меню и команды

Клиенту проще нажать кнопку, чем гадать, что писать. Добавим меню и команды /start, /help, /menu.

Путь Claude Code

1. Поручи добавить меню
   Задание Claude Code

   Добавь боту кнопочное меню (reply-клавиатуру) с кнопками: «🛍 Каталог», «💬 Задать вопрос», «📞 Контакты», «📝 Оставить заявку». На /start показывай приветствие и это меню. Команда /help — короткая справка что умеет бот. По нажатию «📞 Контакты» отправляй мой адрес и телефон (я подставлю). Остальные кнопки пока отвечают заглушкой — их наполним дальше.
2. Зарегистрируй команды в меню Telegram
   Задание Claude Code

   Зарегистрируй команды бота через set_my_commands, чтобы в Telegram появилось синее меню «/»: start — начать, help — что умеет бот, menu — показать меню. Объясни, как это проверить.

Путь n8n / Make

1. Добавь ветвление по тексту

   После Telegram Trigger поставь блок Switch (в Make — Router). Правила: если текст = «📞 Контакты» → ветка контактов, «🛍 Каталог» → ветка каталога, и т.д.

2. Отправь клавиатуру

   В блоке Send Message в поле Reply Markup задай кнопки. В n8n это JSON вида: {"keyboard":[["🛍 Каталог","💬 Задать вопрос"],["📞 Контакты","📝 Оставить заявку"]],"resize_keyboard":true}.

3. Наполни ветки ответами

   Для каждой кнопки — свой Send Message с нужным текстом. «Каталог» и «Задать вопрос» пока заглушки — подключим AI в Модуле 2.

1.4 Тест первого бота

1. Пройди сценарий как клиент

   Открой бота с телефона (не с того аккаунта, где BotFather). Нажми /start, потыкай все кнопки, отправь несколько сообщений. Всё должно отвечать без «зависаний».

2. Проверь на «странные» вводы

   Отправь пустое сообщение, стикер, фото, очень длинный текст. Бот не должен падать. Если падает — вставь текст ошибки в Claude Code, попроси обработать такие случаи.

3. Проверь перезапуск

   Останови бота (в терминале Ctrl+C) и запусти снова. Он должен подняться и снова отвечать. В n8n — выключи и включи workflow.

4. Пусть Claude Code закалит бота

   Одним заданием попроси защитить бота от типичных сбоев — это сэкономит часы отладки:

   Задание Claude Code

   Сделай бота устойчивым к сбоям: 1) оберни обработчики в try/except, чтобы одно кривое сообщение не роняло всё; 2) на не-текст (стикер, фото, голосовое) отвечай вежливо «Пока понимаю только текст 🙂»; 3) слишком длинный ввод обрезай; 4) добавь автоперезапуск при обрыве связи с Telegram. Объясни в двух словах, что изменил.

Модуль 2 — Мозг бота: умные ответы

2.1 Подключаем AI (Claude / GPT)

Сейчас связка простая: клиент пишет → бот берёт его текст → отправляет в AI → получает ответ → шлёт клиенту.

Путь Claude Code

1. Поручи подключить модель
   Задание Claude Code

   Подключи к боту Claude через официальный SDK Anthropic. Ключ бери из .env (ANTHROPIC_API_KEY). Логика: текст сообщения клиента отправляй в модель и её ответ шли обратно клиенту. Пока используй базовый системный промпт «Ты вежливый помощник интернет-магазина, отвечай коротко по-русски». Модель вынеси в переменную сверху файла, чтобы легко менять. Объясни, как запустить.

   Если выбрал GPT — в промпте замени «Claude через SDK Anthropic» на «GPT через SDK OpenAI, ключ OPENAI_API_KEY».

2. Проверь

   Напиши боту вопрос своими словами — он должен ответить осмысленно, а не эхом.

Путь n8n / Make

1. Добавь AI-блок

   Между Telegram Trigger и Send Message вставь узел Anthropic (Claude) или OpenAI (в Make — модуль соответствующего сервиса). При подключении вставь свой API-ключ — создастся Credential.

2. Настрой узел

   В поле User Message подставь текст клиента: {{ $json.message.text }}. В System Message — базовый промпт из шага выше.

3. Верни ответ клиенту

   В финальном Send Message в текст подставь ответ модели (в n8n — {{ $json.text }} или {{ $json.content }}, точное имя поля видно в предпросмотре узла).

2.2 База знаний: бот знает твой бизнес

Модель умная, но твоего бизнеса не знает. Дадим ей «шпаргалку» — базу знаний. Для малого бизнеса хватит простого способа: собрать всё в один текстовый файл и подкладывать модели в каждый запрос.

1. Собери базу знаний в файл

   Создай файл baza.md (обычный текст). Опиши всё, что чаще всего спрашивают клиенты, простыми блоками:

   # О компании
   Магазин «НАЗВАНИЕ», работаем с 2020 года, город …
   
   # Товары и цены
   - Товар А — 1200 грн, в наличии
   - Товар Б — 2500 грн, под заказ 3–5 дней
   
   # Доставка
   Новая Почта по всей Украине, 1–2 дня, отправка в день заказа до 16:00.
   
   # Оплата
   Картой, наложенный платёж, предоплата на ФОП.
   
   # Возврат и гарантия
   14 дней на возврат, гарантия 12 месяцев.
   
   # Частые вопросы
   В: Есть ли скидки оптом? О: Да, от 5 шт — обсуждаем индивидуально.

2. Подключи базу к боту (Claude Code)
   Задание Claude Code

   При каждом запросе к модели подставляй содержимое файла baza.md в системный промпт как справочник компании. Правило: отвечать ТОЛЬКО на основе этого справочника; если ответа в нём нет — честно сказать, что уточнит у менеджера. Файл читай при старте, чтобы правки в baza.md подхватывались после перезапуска.
3. Подключи базу (n8n / Make)

   Простой способ: скопируй текст базы прямо в поле System Message AI-узла (перед инструкциями). Продвинутый: положи базу в узел Set или прочитай из Google Sheets / Notion и подставляй переменной.

2.3 Тон и правила: бот говорит как ты

Системный промпт — это постоянная инструкция боту: кто он, как говорит, что можно и что нельзя. Возьми заготовку, подставь свой бизнес и подправь под себя:

1. Вставь промпт в бота

   Claude Code: попроси заменить базовый системный промпт на этот и вынести его в отдельную переменную/файл prompt.txt, чтобы легко редактировать. n8n/Make: вставь текст в поле System Message AI-узла.

2. Настрой тон под себя

   Хочешь на «ты» — напиши «обращайся на ты». Хочешь с эмодзи — добавь «используй 1–2 уместных эмодзи». Есть фирменное приветствие — впиши его дословно.

3. Прогони 10 типичных вопросов

   Задай боту реальные вопросы клиентов. Где ответ не в твоём стиле — правь промпт и повторяй. 2–3 итерации — и бот звучит как ты.

2.4 Экономная модель и память диалога

Экономная модель

У Claude и GPT есть «большие» и «быстрые» модели. Для чата с клиентами быстрой модели почти всегда достаточно — она в разы дешевле, а отвечает отлично.

1. Выбери быструю модель

   Claude: используй модель линейки Haiku для чата (вместо Opus/Sonnet). GPT: используй компактную mini-модель вместо флагманской. В Claude Code это одна строка — попроси: «поставь для чата экономную быструю модель Claude Haiku». В n8n — выбери модель в выпадающем списке AI-узла.

2. Ограничь длину ответа

   Задай в настройках модели небольшой лимит ответа (max tokens ≈ 300–400). Клиенту не нужен «реферат» — короткий ответ и дешевле, и приятнее.

Память диалога

1. Добавь память

   Чтобы бот помнил, о чём говорили выше (а не отвечал каждый раз «с чистого листа»), храни последние сообщения диалога и подставляй их в запрос.

   Задание Claude Code

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

   n8n/Make: у AI-узлов есть блок Memory (например, «Window Buffer Memory») — подключи его, укажи ключ по chat_id.

Модуль 3 — Заявки, заказы, уведомления

3.1 Приём заявок

Бот-болтун без заявок бесполезен. Сделаем сценарий «Оставить заявку»: бот по одному спрашивает данные и сохраняет их.

1. Опиши поля заявки

   Реши, что собирать. Минимум: что интересует, имя, телефон. По желанию — город, удобное время связи.

2. Собери сценарий (Claude Code)
   Задание Claude Code

   Добавь кнопку «📝 Оставить заявку». По нажатию бот по шагам спрашивает: 1) что интересует, 2) имя, 3) телефон. Веди диалог по состояниям (FSM в aiogram), чтобы бот помнил, на каком шаге клиент. В конце покажи клиенту сводку заявки и попроси подтвердить кнопкой «Отправить». Собранные данные пока просто выведи в лог — сохранять будем на следующем шаге.
3. Собери сценарий (n8n / Make)

   Используй узел Telegram Trigger + ветвление по шагам. Проще всего в n8n — включить у Telegram-узла режим ожидания ответа (или использовать «AI Agent» с функцией сбора полей). Данные шага складывай в переменные через Set.

3.2 Оплата и контакты (заказ)

1. Попроси контакт одной кнопкой

   Telegram умеет отдавать номер телефона по кнопке — клиенту не надо печатать. Попроси Claude Code: «добавь кнопку "📱 Поделиться номером" (request_contact), сохраняй полученный телефон в заявку». В n8n — кнопка с request_contact:true.

2. Подключи оплату (по желанию)

   Для приёма оплаты в Telegram есть встроенные платежи. Провайдера (например, банк-эквайер или платёжный сервис) подключают через @BotFather → /payments — там ты выбираешь своего провайдера и получаешь свой платёжный токен. Затем бот выставляет счёт (Invoice).

   Задание Claude Code

   Добавь приём оплаты через Telegram Payments. Платёжный токен провайдера бери из .env (PAYMENT_TOKEN — я подставлю свой). По кнопке «Оплатить» выставляй счёт (send_invoice) на сумму заказа, обрабатывай успешную оплату (successful_payment) и подтверждай клиенту. Объясни, где в BotFather взять платёжный токен.
3. Альтернатива без встроенной оплаты

   Проще всего — бот присылает клиенту твои реквизиты/ссылку на оплату (Monobank-банка, платёжная ссылка), а факт оплаты подтверждает менеджер. Для старта этого достаточно.

3.3 Уведомления тебе в Telegram

1. Узнай свой chat_id

   Напиши боту @userinfobot — он покажет твой chat_id (куда слать уведомления). Сохрани в .env как MANAGER_CHAT_ID (или в Credential n8n).

2. Добавь отправку тебе (Claude Code)
   Задание Claude Code

   Когда клиент подтверждает заявку/заказ, отправляй мне в Telegram (chat_id из .env, MANAGER_CHAT_ID) сообщение со сводкой: что интересует, имя, телефон, дата/время, ник клиента. Формат — аккуратный, с эмодзи-заголовком «🔔 Новая заявка». Клиенту при этом отвечай «Спасибо! Менеджер свяжется с вами в ближайшее время».
3. Добавь отправку тебе (n8n / Make)

   После шага подтверждения добавь ещё один Telegram → Send Message, но с Chat ID = твой личный chat_id, и в текст собери все поля заявки. Так одно событие уходит и клиенту, и тебе.

3.4 CRM-таблица: заявки складываются сами

Уведомления в Telegram легко потерять. Таблица — это память и учёт. Проще всего — Google Таблицы.

1. Создай таблицу-CRM

   Сделай Google Таблицу с колонками: Дата · Имя · Контакт · Что интересует · Источник · Статус · Комментарий.

2. Подключи запись (n8n / Make — проще всего)

   После узла уведомления добавь блок Google Sheets → Append Row. Подключи свой Google-аккаунт (Credential), выбери таблицу и лист, сопоставь поля заявки с колонками. Теперь каждая заявка = новая строка автоматически.

   Workflow: заявка в CRM Заявка подтверждена→Google Sheets: Append Row→Уведомить менеджера
3. Подключи запись (Claude Code)
   Задание Claude Code

   Добавь запись заявок в Google Таблицу. Подскажи по шагам, как получить доступ через Google Sheets API (сервисный аккаунт и ключ — я создам сам в своём Google Cloud), куда его положить и как дать таблице доступ. Затем каждую подтверждённую заявку добавляй новой строкой: дата, имя, контакт, что интересует, источник «Telegram-бот», статус «Новая».

Модуль 4 — AI-агент на автопилоте 24/7

4.1 Планировщик задач

До сих пор бот реагировал на клиента. Агент умеет действовать сам: по расписанию проверять, напоминать, собирать отчёты. Основа — планировщик (по таймеру запускает задачи).

Примеры полезных задач по расписанию для бизнеса:

• Догрев заявок: если клиент оставил заявку и не ответил — через 2 часа бот пишет вежливое напоминание.
• Утренний отчёт: каждое утро в 9:00 агент шлёт тебе сводку заявок за вчера.
• Проверка новых заказов из внешнего источника (сайт, форма, маркетплейс) каждые 10 минут.

1. Планировщик в n8n / Make

   Самый простой способ. Создай workflow с триггером Schedule Trigger (в Make — Scheduling): задай интервал (каждые 10 минут / каждый день в 9:00). Дальше — нужные действия (прочитать таблицу, спросить AI, отправить сообщение).

   Workflow: утренний отчёт Schedule 9:00→Google Sheets: читать заявки за вчера→AI: составить сводку→Telegram: отправить тебе
2. Планировщик (Claude Code)
   Задание Claude Code

   Сделай планировщик задач для агента. Расписание: (1) каждое утро в 9:00 присылать мне в Telegram сводку заявок за вчера из моей CRM-таблицы; (2) каждые 15 минут проверять заявки без ответа старше 2 часов и слать клиенту одно вежливое напоминание (только один раз на заявку). Веди простой лог, чтобы я видел, что агент работает. Объясни, как запустить одной командой.

4.2 Автоматизация в n8n / Make

n8n/Make — это «дирижёр» всего. Даже если бота ты собрал на Claude Code, автоматизации вокруг удобно вести здесь: связывать Telegram, AI, таблицы, CRM, почту, оплаты — блоками.

1. Собери главный сценарий диалога

   Один workflow на входящие сообщения:

   Главный workflow бота Telegram Trigger→Switch: команда / заявка / вопрос→AI (Claude/GPT) + база знаний→Send Message клиенту

   Ветка «заявка» дополнительно пишет в Google Sheets и шлёт уведомление тебе.

2. Используй AI Agent-узел (продвинуто)

   В n8n есть узел AI Agent: ему даёшь системный промпт, подключаешь «инструменты» (tools) — например, «записать заявку в таблицу», «проверить наличие», «уведомить менеджера». Модель сама решает, какой инструмент вызвать. Это и есть настоящий AI-агент: не просто отвечает, а действует. Если собираешь на коде — поручи это Claude Code:

   Задание Claude Code

   Переделай бота в AI-агента с инструментами (function calling). Дай модели 3 инструмента: 1) save_lead — записать заявку в мою CRM-таблицу; 2) notify_manager — прислать мне сводку в Telegram; 3) check_knowledge — найти ответ в базе знаний baza.md. В системном промпте объясни, когда какой инструмент вызывать. Модель сама решает, что вызвать по ходу диалога. Покажи, как проверить, что инструменты срабатывают.
3. Обработай ошибки

   Добавь ветку Error Trigger (в Make — обработчик ошибок): если что-то упало (AI не ответил, таблица недоступна) — агент шлёт тебе сообщение «⚠️ Ошибка в боте», а клиенту — «Секунду, уточняю». Бот не должен «молча падать».

4.3 Деплой на сервер: бот работает 24/7

Пока бот запущен на твоём ноутбуке — он живёт, пока ноутбук включён. Чтобы работал 24/7, его ставят на недорогой сервер (VPS) — это отдельный «всегда включённый компьютер» в дата-центре за пару долларов в месяц.

1. Возьми свой VPS

   Зарегистрируйся у любого провайдера (DigitalOcean, Hetzner, любой украинский хостинг) и создай самый простой сервер (1–2 ГБ RAM, Ubuntu). Получишь IP-адрес и доступ. Это твой сервер и твой аккаунт.

2. Деплой бота на Claude Code
   Задание Claude Code

   Помоги вынести моего бота на VPS Ubuntu. По шагам: как подключиться по SSH, установить нужное окружение, скопировать файлы бота (без .env — его создам на сервере руками), запустить бота как службу через systemd, чтобы он поднимался сам после перезагрузки и падений. Дай команды по одной и объясняй каждую.
3. Деплой n8n на сервер (self-hosted)

   Если работаешь в n8n — его ставят на тот же VPS через Docker одной командой (Claude Code даст точную команду под твой сервер). Тогда все автоматизации крутятся у тебя 24/7 без платы за операции. После установки открываешь n8n в браузере по IP сервера и переносишь workflow.

4. Проверь автозапуск

   Перезагрузи сервер (sudo reboot) и убедись, что бот сам поднялся и отвечает. Это значит — он переживёт любые сбои.

4.4 Финальный проект и чек-лист запуска

Поздравляю — если ты дошёл сюда, у тебя не «папка с уроками», а рабочая система: бот-продавец на твоей базе знаний, приём заявок и заказов, уведомления, CRM и агент на автопилоте 24/7. Проверь себя по финальному чек-листу.