Свой Telegram-бот на GigaChat собирают из трёх частей: бот в @BotFather, ключ GigaChat API из кабинета Сбера и посредник, который пересылает сообщения между ними. Посредником служит конструктор SaluteBot от Сбера или программа на Python примерно в 30 строк. Частным лицам ключ API дают только резидентам России, а бесплатный годовой лимит в 365 млн токенов (в них GigaChat считает объём текста) можно тратить лишь на личные проекты: боту, который отвечает клиентам, нужен платный доступ.
Начинают с @BotFather: там создают бота, и Telegram выдаёт к нему токен — длинный пароль, по которому программа управляет ботом. Ключ GigaChat API берут в личном кабинете Сбера. Посредник принимает сообщение из Telegram, передаёт его GigaChat и отправляет ответ обратно в чат.
Посредником бывает конструктор, где всё настраивают мышкой, или короткая программа на Python. Быстрее всего без программиста собрать бота в SaluteBot, конструкторе самого Сбера: GigaChat там уже встроен.
Какой способ подключения выбрать
Если программиста нет, берите конструктор: SaluteBot, Albato или LEADTEX. Если бот должен брать данные из вашей CRM или сам считать цены, удобнее код. Бот на Python делает всё, что вы запрограммируете, но его нужно держать запущенным круглосуточно: на арендованном виртуальном сервере или на компьютере, который не выключается.
| Способ | Нужен программист | Где работает бот | Подойдёт, если |
|---|---|---|---|
| SaluteBot (Сбер) | нет | на платформе Сбера | нужен консультант по вашим правилам и документам |
| Albato, LEADTEX | нет | на платформе сервиса | бот — часть цепочки: заявка, таблица, CRM |
| Свой код на Python | да, или вечер с документацией | на вашем сервере или компьютере | бот сам считает цены, пишет в CRM или базу |
Официальный бот Сбера @gigachat_bot для этого не подойдёт: это общий чат GigaChat от Сбера, настроить его под свою компанию нельзя. Про сам чат, модели и тарифы мы подробно писали в обзоре ГигаЧата. Telegram и сам встраивает помощников: о его тестовом ИИ-ассистенте мы писали в новости.
Кто может получить GigaChat API
По соглашению Сбера частные лица подключают API только с 18 лет и только если они резиденты России. Поэтому частному лицу, которое не резидент России, например из Казахстана или Узбекистана, официально подключиться нельзя, к тому же вход в кабинет идёт через Сбер ID.
Второе ограничение касается денег. При регистрации дают бесплатный пакет Freemium: 365 млн токенов на год. Токен — кусочек слова, в токенах GigaChat считает и вопрос, и ответ. Тратить бесплатный пакет можно только на личные некоммерческие задачи. На странице о коммерческом использовании Сбер пишет, что продавать и распространять проекты на GigaChat можно только после покупки платного пакета.
Бот, который отвечает покупателям магазина или записывает клиентов в салон, считается коммерческим использованием, даже если сам бот бесплатный. Для него нужен платный пакет, а надёжнее заключить договор со Сбером на ИП или компанию. У такого проекта в кабинете другой тип доступа: в поле Scope стоит GIGACHAT_API_B2B или GIGACHAT_API_CORP.
С 1 сентября 2026 года Сбер продаёт частным лицам пакеты токенов, только если они уже покупали их раньше. Остальные частные клиенты платят за модели GigaChat через облачную платформу Cloud.ru. SaluteBot живёт в том же кабинете Studio со входом через Сбер ID, поэтому сначала проверьте, что можете войти в кабинет. Если вы не резидент России, проще подключить к боту другую нейросеть: как получить ключи ChatGPT, Gemini и Claude, разобрали в гайде про API-ключи.
Что понадобится для бота с GigaChat
Нужны две вещи: токен бота из Telegram и ключ GigaChat из кабинета Сбера.
Токен Telegram-бота. Откройте @BotFather, отправьте команду /newbot, придумайте боту имя и адрес, который заканчивается на bot. В ответ придёт токен: строка вида 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Telegram предупреждает, что любой, у кого есть этот токен, может управлять ботом.
Ключ GigaChat API. Войдите в личный кабинет Studio на developers.sber.ru через Сбер ID, нажмите «Создать проект» и выберите GigaChat API. В проекте откройте «Настройки API» и нажмите «Получить ключ». Сбер один раз покажет три строки: Client ID, Client Secret и Authorization key. Для бота нужна последняя, сразу скопируйте её в менеджер паролей. В поле Scope, где указан тип доступа, у частного лица будет GIGACHAT_API_PERS.
Authorization key — постоянный ключ. По нему программа получает временный пропуск на 30 минут, в документации он называется токеном доступа. Библиотека Сбера для Python сама запрашивает новый пропуск, когда старый истекает.
Как сделать бота на GigaChat без программиста в SaluteBot
SaluteBot — конструктор чат-ботов Сбера в том же кабинете Studio. GigaChat работает в нём во всех тарифах, а без своего ключа доступен тестовый режим с моделью GigaChat Lite. Бесплатный тариф «Разработчик» обслуживает до 50 уникальных пользователей в месяц.
Создайте проект SaluteBot
- в Studio: «Создать проект», сценарий на Graph (его собирают из блоков)
Добавьте ключ GigaChat
- раздел «Токены и доступы», вкладка «Ключи GigaChat»
- вставьте Authorization key и включите «Использовать ключ по умолчанию»
Настройте ответы бота
- блок «Генерация ответа» с системным промтом
- для ответов по прайсу и регламентам — блок генерации на базе документов
Подключите Telegram
- раздел «Чат-платформа», интеграция Telegram, «Далее»
- вставьте токен из @BotFather и нажмите «Добавить»; токен не должен стоять в другом проекте SaluteBot
Проверьте бота в Telegram
- после сборки бот отвечает в Telegram
- задайте боту пять вопросов клиента и один провокационный
Чтобы бот отвечал по вашим документам, SaluteBot сначала ищет в них нужный фрагмент. Для этого поиска нужна отдельная модель Embeddings, без неё генерация по документам не заработает.
У прямого подключения к Telegram есть ограничение: перевести клиента на живого оператора бот не сможет: блоки перевода будут выдавать ошибку. Когда пользователей в месяц станет больше 50, понадобится платный тариф SaluteBot, а частные лица оплачивают его только российской картой.
Какие ещё конструкторы подключают GigaChat к Telegram
Albato соединяет приложения цепочками. В его инструкции 2024 года сообщение из Telegram уходит в действие «Создать запрос к модели» GigaChat, а ответ возвращается в чат. Чтобы бот помнил переписку, в Albato собирают вторую связку, которая передаёт историю.
В LEADTEX есть готовый шаблон «Чат-бот с ИИ за 15 минут» с GigaChat и памятью диалога. В n8n, похожем сервисе цепочек, такого бота тоже собирают, но без технических навыков там тяжело. О том, где проходит граница между ботом и агентом, который сам выполняет задачи, читайте в статье что такое ИИ-агент.
Как написать бота на Python с GigaChat
Код короче, чем кажется: около 30 строк на двух библиотеках, python-telegram-bot и официальной gigachat от Сбера. Нужен Python 3.10 или новее. Код написан под библиотеку gigachat версии 0.2: в готовящейся версии 0.3 Сбер меняет основной способ вызова модели, поэтому в установке версия закреплена.
Установка:
pip install python-telegram-bot "gigachat<0.3"
export TG_TOKEN="токен из BotFather"
export GIGACHAT_CREDENTIALS="Authorization key из кабинета Сбера"
Сам бот, файл bot.py:
import os
from collections import defaultdict
from gigachat import GigaChat
from gigachat.models import Chat, Messages, MessagesRole
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes, MessageHandler, filters
SYSTEM = open("instruction.txt", encoding="utf-8").read()
giga = GigaChat(
credentials=os.environ["GIGACHAT_CREDENTIALS"],
model="GigaChat-2",
ca_bundle_file="russian_trusted_root_ca.cer",
)
history = defaultdict(list) # последние реплики каждого чата
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.effective_message.reply_text("Здравствуйте! Напишите ваш вопрос.")
async def reply(update: Update, context: ContextTypes.DEFAULT_TYPE):
chat = update.effective_chat.id
history[chat].append(Messages(role=MessagesRole.USER, content=update.effective_message.text))
history[chat] = history[chat][-10:]
messages = [Messages(role=MessagesRole.SYSTEM, content=SYSTEM)] + history[chat]
answer = await giga.achat(Chat(messages=messages))
text = answer.choices[0].message.content
history[chat].append(Messages(role=MessagesRole.ASSISTANT, content=text))
await update.effective_message.reply_text(text)
app = Application.builder().token(os.environ["TG_TOKEN"]).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(MessageHandler(filters.UpdateType.MESSAGE & filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()
Ключи программа берёт из переменных окружения: это настройки компьютера, их задают командами export выше. В файле с кодом ключей нет, поэтому код можно спокойно показать подрядчику. Модель указана явно, без неё библиотека выдаст ошибку ModelNotSpecifiedError. GigaChat-2 — модель Lite, на неё в бесплатном пакете больше всего токенов: 250 млн.
Файл russian_trusted_root_ca.cer — сертификат Минцифры России, его скачивают на gosuslugi.ru/crt. По нему программа проверяет, что соединилась с настоящим сервером GigaChat, без него Python откажется подключаться. Скачанный файл называется иначе, поэтому положите его рядом с bot.py и переименуйте или впишите в код его настоящее имя. Проверку можно отключить параметром verify_ssl_certs=False, но авторы библиотеки советуют так делать только на время отладки.
Частному лицу GigaChat API даёт один поток, то есть обрабатывает один запрос за раз. Для личного бота этого хватит. Компаниям и ИП по умолчанию дают 10 потоков, поэтому бота для очереди покупателей подключают на бизнес-доступ.
Если бот молчит, проверьте три места: Authorization key вставлен целиком, в коде указана модель, файл сертификата лежит рядом с программой. История переписки хранится в памяти программы и обнуляется после перезапуска. Чтобы бот её не терял, переписку сохраняют в базу данных.
Какую роль дать боту в системном промте
Системный промт — инструкция, которую бот получает перед каждым вопросом клиента. В ней задают роль, тон, длину ответа и запреты. Роль и длину ответа советует прописывать и справка SaluteBot. Положите текст в instruction.txt или в поле системного промта конструктора.
Ты — консультант кофейни «Зерно». Отвечай на «вы», коротко: не больше 60 слов.
Отвечай только про наше меню, цены, часы работы и доставку. Данные ниже — единственный источник, ничего не придумывай.
Если вопрос не про кофейню или ответа нет в данных, скажи: «Уточню у администратора, оставьте номер телефона».
Не обещай скидок и сроков, которых нет в данных. Не обсуждай политику и конкурентов. Пиши вежливо, без грубых слов, даже если клиент грубит.
Данные:
[меню с ценами, часы работы, адрес, условия доставки]Перед запуском проверьте бота вопросами, на которые ответа в данных нет: «Есть ли у вас веганские торты?», «Сделаете скидку 50%?». Если бот начинает выдумывать, усильте запрет и сократите данные до нужного.
Как защитить токен бота и ключ GigaChat
У бота два секрета, и оба дают полный доступ. Кто знает токен бота, может управлять им от вашего имени. С чужим ключом GigaChat любой может тратить ваш оплаченный лимит, а по соглашению Сбера за сохранность ключей и кодов доступа отвечает сам клиент.
Так ключи утекают
- ключ вписан прямо в код, и код выложен на GitHub
- токен отправлен подрядчику в Telegram или по почте
- скриншот кабинета с ключом в чате поддержки
Так безопасно
- ключи в переменных окружения или в настройках конструктора
- ключи подрядчику не пересылают: в сервер или конструктор их вписываете вы сами
- отдельный проект GigaChat под каждого бота
- после ухода подрядчика оба ключа выпускают заново
Если ключ всё-таки утёк, меняйте оба сразу. Токен бота перевыпускают в @BotFather командой /token, Telegram предусмотрел её как раз на случай утечки или потери. Ключ GigaChat меняют в «Настройках API» кнопкой «Получить новый ключ», старый Сбер оставляет рабочим ещё до 250 минут. Соглашение Сбера требует сразу сообщить о подозрении на чужой доступ.
Telegram-боту по умолчанию может написать любой человек. Если бот нужен только сотрудникам, проверяйте в коде номер чата по списку разрешённых, иначе ваш лимит GigaChat будет тратить кто угодно.
Сколько стоит бот на GigaChat
Для теста платить не нужно, если вы резидент России: хватит бесплатного пакета, а создать бота в Telegram можно бесплатно. Платить придётся, когда бот начнёт отвечать клиентам. Цены по тарифам Сбера на 10 ноября 2026 года.
| Что | Цена |
|---|---|
| Freemium для частного лица | 365 млн токенов на 12 месяцев бесплатно: 250 млн Lite, 40 млн Pro, 25 млн Max, 50 млн Ultra |
| Пакет Lite для частного лица* | 20 млн токенов за 1 300 ₽ на месяц |
| Пакеты Pro и Max для частного лица* | 3 млн токенов за 1 500 ₽ и 1 950 ₽ на месяц |
| Компании, оплата по факту, с НДС | Lite 0,065 ₽, Pro 0,5 ₽, Max 0,65 ₽ за 1 000 токенов; минимум 600 ₽ в месяц, если пользовались |
| SaluteBot «Разработчик» | бесплатно до 50 уникальных пользователей в месяц |
* Пакеты продаются тем, кто уже покупал токены у Сбера. Новые частные клиенты с 1 сентября 2026 года платят за GigaChat через Cloud.ru по его ценам.
Сколько токенов уходит на ответ, зависит от длины системного промта и переписки. Для прикидки: если на ответ вместе с системным промтом и историей уходит 1 500 токенов, тысяча ответов на тарифе Lite для компаний обойдётся примерно в 100 ₽, но минимальный платёж всё равно 600 ₽ в месяц.
К расходам на GigaChat в конструкторе добавится его тариф, если бесплатного не хватит. Для своего кода вместо конструктора нужен сервер: подойдёт самый дешёвый виртуальный сервер или любой компьютер, который не выключается.
Бесплатный мастер-класс · онлайнБот — только первая задача для нейросети в бизнесе. На бесплатном вебинаре разбираем, что ещё выгодно поручить ИИ первым делом.
Записаться бесплатно →Частые вопросы
Чем свой бот на GigaChat отличается от официального @gigachat_bot?
Официальный @gigachat_bot — общий чат Сбера: он отвечает на любые вопросы и ничего не знает о вашей компании. Свой бот работает под вашим именем, следует роли и правилам из вашего системного промта, отвечает только про ваш товар и может принимать заявки. За его ответы платите вы, через свой ключ GigaChat API.
Можно ли сделать бота на GigaChat бесплатно?
Да, для теста и личных задач. Резидент России получает на год 365 млн бесплатных токенов, в них GigaChat считает объём текста, а SaluteBot бесплатно обслуживает до 50 пользователей в месяц. Бот для клиентов бизнеса на бесплатном пакете держать нельзя: Сбер разрешает коммерческое использование только после покупки платного доступа.
Сколько клиентов одновременно выдержит бот на GigaChat?
Зависит от типа доступа. Частному лицу GigaChat API даёт один поток, то есть обрабатывает один запрос за раз, а компаниям и ИП по умолчанию даёт 10 потоков. Для личного бота одного потока хватает. Бот магазина, которому покупатели пишут одновременно, подключают на бизнес-доступ.
Будет ли бот помнить, о чём говорили раньше?
Только если это настроить. GigaChat API не помнит прошлые сообщения: каждый вопрос модель видит как первый. В коде бот сам отправляет последние 5-10 реплик вместе с новым вопросом, в Albato историю передаёт вторая связка, а в LEADTEX есть готовый шаблон с памятью диалога.
Что делать, если токен бота или ключ GigaChat попал в чужие руки?
Сразу выпустить новые: токен бота — командой /token в @BotFather, ключ GigaChat — кнопкой «Получить новый ключ» в «Настройках API». Старый ключ GigaChat работает ещё до 250 минут, за это время обновите оба значения в конструкторе или в программе и сообщите о случившемся Сберу, как требует соглашение.
Источники
- Сбер — Соглашение GigaChat API для физлиц
- GigaChat API — Коммерческое использование
- GigaChat API — Интеграция для физлиц
- GigaChat API — Регистрация в личном кабинете
- GigaChat API — Первые запросы и ключ авторизации
- GigaChat API — Тарифы для физлиц
- GigaChat API — Тарифы для юрлиц
- GigaChat API — Квоты и ограничения
- SaluteBot — GigaChat в чат-боте
- SaluteBot — Ключ GigaChat в проекте
- SaluteBot — Подключение Telegram
- SaluteBot — Бесплатный тариф
- SaluteBot — Платные тарифы для физлиц
- GitHub — библиотека gigachat для Python
- Telegram — Bot Features, раздел BotFather
- Альбато — интеграция GigaChat с Telegram-ботом
- LEADTEX — ИИ-бот с интеграцией GigaChat



