Как создать Telegram-бота с Claude AI: пошаговый гайд

Telegram — самый популярный мессенджер в Казахстане и Центральной Азии. Для бизнеса это основной канал коммуникации с клиентами. Но отвечать на сообщения вручную 24/7 невозможно. Наём операторов — дорого. Простые боты с кнопками — не решают сложные вопросы.

Решение — AI-бот на базе Claude, который понимает естественный язык, знает ваш продукт и ведёт полноценные диалоги с клиентами. Не скрипты, не деревья решений, а настоящий AI-ассистент, который может ответить на любой вопрос о вашем бизнесе.

Бот состоит из четырёх основных компонентов, каждый из которых отвечает за свою часть функционала.

1. Telegram Bot API

Точка входа для сообщений от пользователей. Бот регистрируется через @BotFather, получает токен и слушает входящие сообщения через webhooks или long polling. Мы используем webhooks — они надёжнее и не требуют постоянного соединения.

2. Серверное приложение (Node.js)

Обрабатывает входящие сообщения, управляет контекстом диалога, вызывает Claude API и отправляет ответы обратно в Telegram. Это «мозг» системы, который координирует все компоненты.

3. Claude API

Генерирует ответы на основе сообщения пользователя, истории диалога и базы знаний. Claude Sonnet — оптимальный выбор: достаточно умный для сложных вопросов и достаточно быстрый для мессенджера (ответ за 1-2 секунды).

4. База знаний

Файлы с информацией о вашем продукте, ценах, политиках, FAQ. Это контекст, который передаётся Claude вместе с каждым запросом. Бот «знает» ваш бизнес потому, что получает эту информацию в каждом вызове API.

Шаг 1: Создание бота в Telegram

Откройте @BotFather в Telegram, отправьте /newbot, следуйте инструкциям. Получите токен вида 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz. Этот токен — ваш ключ доступа к Telegram Bot API. Храните его в переменных окружения, никогда не коммитьте в git.

Шаг 2: Настройка серверного приложения

Создайте Node.js-проект с Express для обработки webhooks. Основные зависимости: express (HTTP-сервер), @anthropic-ai/sdk (Claude API), node-telegram-bot-api (Telegram Bot API). Или используйте grammy — более современную библиотеку для Telegram-ботов.

Шаг 3: Подключение Claude API

Зарегистрируйтесь на console.anthropic.com, получите API-ключ. Каждый вызов Claude API включает: system prompt (роль бота + база знаний), историю сообщений (контекст диалога) и текущее сообщение пользователя.

Шаг 4: Управление контекстом диалога

Claude не помнит предыдущие сообщения — каждый вызов API независим. Чтобы бот вёл связный диалог, нужно хранить историю сообщений и передавать её в каждом запросе. Варианты хранения: Redis (быстро, но теряется при перезапуске), PostgreSQL (надёжно), в памяти (для прототипа).

• Храните последние 20-30 сообщений каждого диалога. Больше — дорого и медленно.
• Очищайте старые диалоги через 24 часа неактивности.
• Добавьте команду /reset для сброса контекста.
• Учитывайте лимиты токенов: база знаний + история + ответ должны уместиться в контекстное окно.

Шаг 5: Подключение базы знаний

Базу знаний можно организовать разными способами, от простого к сложному:

• Простой: текстовый файл с FAQ и информацией о продукте, включённый в system prompt. До 50-100 вопросов.
• Средний: несколько файлов (products.md, pricing.md, policies.md), подгружаемых по контексту вопроса.
• Продвинутый: RAG (Retrieval-Augmented Generation) — векторная база данных, где релевантные куски информации подгружаются динамически.

Для большинства бизнесов достаточно простого или среднего варианта. RAG нужен только если у вас сотни продуктов или обширная документация.

Клиентская поддержка

Самый популярный кейс. Бот отвечает на вопросы о продукте, статусе заказа, условиях доставки, политике возврата. Решает 80%+ обращений без участия человека. Для оставшихся 20% — переводит на живого оператора.

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

Бот помогает выбрать продукт, рассчитывает стоимость, собирает данные для доставки и создаёт заказ. Интеграция с CRM или Google Sheets для хранения заказов.

FAQ и онбординг

Новые клиенты или пользователи задают десятки одинаковых вопросов. Бот отвечает мгновенно, проводит онбординг, объясняет функционал, помогает настроить продукт.

Внутренний ассистент

Бот для сотрудников: отвечает на вопросы о политиках компании, помогает с HR-вопросами (отпуск, больничный, документы), предоставляет доступ к внутренней документации.

Для деплоя рекомендую VPS (DigitalOcean, Hetzner) + pm2 для process management + nginx как reverse proxy. Настройте HTTPS для webhook endpoint (Telegram требует). Мониторинг: логирование всех диалогов, алерты при ошибках API, метрики (время ответа, % успешных ответов, количество диалогов).

• pm2 для автоперезапуска при падении и управления логами.
• nginx для HTTPS-терминации и rate limiting.
• Telegram webhook: POST https://your-domain.com/webhook с токеном.
• Health check endpoint: GET /health для мониторинга доступности.
• Логируйте все диалоги для улучшения базы знаний и отладки.

Давайте посчитаем реальную стоимость и сравним с альтернативами.

• Claude API: ~$50-100/мес для 1000-5000 диалогов/день.
• VPS: $5-20/мес (DigitalOcean/Hetzner).
• Домен: $10-15/год.
• Итого: $60-120/мес за 24/7 AI-ассистента.
• Для сравнения: один оператор поддержки — от $500-1000/мес (Казахстан).
• ROI: бот заменяет 2-3 операторов = экономия $1000-3000/мес.

• AI-бот в Telegram решает 80%+ клиентских обращений без человека.
• Архитектура: Telegram Bot API + Node.js + Claude API + База знаний.
• Время создания: 1 день. Стоимость: $60-120/мес. ROI: замена 2-3 операторов.
• Ключевой элемент — системный промпт и база знаний. Claude не обучается на ваших данных.
• Контекст диалога нужно хранить и передавать явно — Claude не помнит предыдущие вызовы.
• Варианты использования: поддержка, заказы, FAQ, внутренний ассистент.
• Деплой: VPS + pm2 + nginx + HTTPS webhook.