Максим
Полезные статьи

ПОШАГОВОЕ РУКОВОДСТВО: ИНТЕГРАЦИЯ НЕЙРОСЕТИ GIGACHAT

Представьте чат-бота, который может отвечать на любые вопросы пользователей, поддерживать диалог и решать задачи — всё это благодаря искусственному интеллекту. Звучит как что-то сложное и дорогое? На самом деле, это проще, чем кажется!
В этом руководстве мы создадим чат-бота с интеграцией российской нейросети GigaChat от Сбербанка. Почему именно GigaChat? Во-первых, это отечественная разработка, которая отлично понимает русский язык и адаптирована под наши реалии. Во-вторых, оплатить подписку можно обычной российской картой без всяких сложностей. В-третьих, сервис стабильно работает и быстро отвечает на запросы.
Давайте пошагово разберем, как собрать такого бота на платформе Watbot.ru и настроить все необходимые интеграции.

Как будет выглядеть готовый бот

Прежде чем погружаться в технические детали, давайте посмотрим, что мы получим в итоге. Пользователь запускает бота, получает приветственное сообщение с картинкой и описанием возможностей. Затем задает любой вопрос — и нейросеть генерирует развернутый ответ.
Самое интересное: после получения ответа можно продолжать диалог, задавать уточняющие вопросы, и бот будет поддерживать беседу как настоящий собеседник. Никаких ограничений — общайтесь сколько угодно!

Основы работы с конструктором

Перед тем как приступить к сборке, давайте быстро повторим базовые принципы работы с платформой Watbot.ru. Если вы уже работали с конструктором, можете пропустить этот раздел, но для новичков он будет полезен.
Блоки и связи — это два основных элемента любого сценария. Блоки выполняют конкретные действия (отправляют сообщения, делают запросы, сохраняют данные), а связи определяют порядок их выполнения.
Удаление блоков: наведите курсор на блок, нажмите на значок корзины и подтвердите действие. Блок исчезнет из рабочей области.
Создание связей: наведите курсор на черную точку блока, от которого нужно провести связь, зажмите левую кнопку мыши и протяните синюю стрелку к целевому блоку. Чтобы удалить связь, наведите на неё курсор (она станет красной) и нажмите на корзину.
Добавление блоков возможно двумя способами. Первый — через кнопку «Добавить блок» в верхнем правом углу. Там все блоки разделены по категориям, есть раздел «Часто используемые» и удобная поисковая строка.
Второй способ быстрее: наведите курсор на черную точку блока, нажмите правую кнопку мыши — появится меню для добавления. Выбранный блок сразу добавится с проведенной связью. Очень удобно для быстрой работы!
Полезные функции интерфейса: внизу слева находятся кнопки масштабирования — увеличивайте или уменьшайте рабочую область по своему усмотрению. А еще можно одним кликом переключаться между светлой и темной темой. Кнопка находится вверху — без захода в настройки, просто нажали и сменили тему.
Кстати, для этого туториала давайте включим темную тему — так будет интереснее работать, и код будет лучше виден.

Подготовка: регистрация в GigaChat

Перед началом сборки сценария вам понадобится получить доступ к API GigaChat. Зайдите на официальный сайт сервиса и пройдите регистрацию. Процесс простой: указываете email, подтверждаете его, выбираете тип доступа (физическое или юридическое лицо) и оплачиваете подписку российской картой.
После оплаты в личном кабинете вы получите специальный токен доступа — это ключ для работы с API. Скопируйте его и сохраните где-нибудь — он понадобится при настройке блоков. Не волнуйтесь, мы подробно разберем, куда его вставлять.
Важный момент: если вы регистрировались как физическое лицо, запомните это — при настройке нужно будет указать соответствующий scope. Для юрлиц и корпоративных аккаунтов параметры будут другими.

Создание сценария: технические блоки

Теперь переходим к самой интересной части — сборке сценария. Интеграция с GigaChat требует двухэтапного процесса: сначала получаем временный токен доступа, затем используем его для запросов к нейросети. Звучит сложно? На практике всё просто!

1. Создание уникального идентификатора запроса

Начнем с блока «Операция над переменной». Добавьте его сразу после стартового блока и проведите связь.
Зачем нужен этот блок? GigaChat требует, чтобы каждый запрос имел уникальный идентификатор. Это помогает системе отслеживать запросы и предотвращать дубликаты. Мы создадим локальную переменную и присвоим ей уникальное значение.
Откройте настройки блока:
  • Тип операции — выберите «Массовое присвоение»
  • Переменная — добавьте локальную переменную с именем «ID» (можете назвать по-своему, но лучше придерживаться простых названий)
  • Значение — здесь нужно вставить уникальный идентификатор
Где взять этот идентификатор? Откройте в браузере сайт онлайн-генератора UUID - это сервис, который генерирует уникальные идентификаторы.
Скопируйте сгенерированное значение и вставьте в поле «Значение» вместо нуля.
Online UUID Generator Tool www.uuidgenerator.net
Готово! Теперь при каждом запуске этого блока переменная ID будет содержать уникальный идентификатор.

2. Первый HTTP-запрос: получение токена доступа

Добавьте блок «HTTP запрос» и проведите связь от предыдущего блока. Этот запрос нужен для получения временного токена, который будет действовать ограниченное время и с помощью которого мы сможем обращаться к нейросети.
Теперь самое важное — правильно настроить этот блок. Для этого нам понадобится официальная документация GigaChat. Откройте её в отдельной вкладке (ссылка также будет в описании).
Настройка URL и метода
В документации перейдите в раздел «Справка API» → «REST API» → «Получить токен доступа». Здесь вы увидите:
  • Метод запроса: POST
  • URL эндпоинта для получения токена
Скопируйте URL из документации и вставьте в поле «URL» блока HTTP-запрос. В поле «Метод» выберите POST.

Настройка заголовков

Теперь самая кропотливая часть — добавление заголовков. Нам понадобится три заголовка, и каждый нужно настроить точно по документации.
Посмотрите в документацию, в раздел «Пример запроса». Там указаны все необходимые заголовки.
Первый заголовок — Content-Type:
  • Слева (название): Content-Type
  • Справа (значение): application/x-www-form-urlencoded
Копируйте аккуратно, без лишних кавычек и двоеточий — только чистое значение!
Второй заголовок — Authorization:
  • Слева: Authorization
  • Справа: Bearer [ваш_токен]
Внимание! Здесь нужно написать слово Bearer, затем пробел, и после этого вставить токен, который вы получили в личном кабинете GigaChat после оплаты. Не путайте его с временным токеном, который мы получим этим запросом — это два разных токена!
Третий заголовок — RqUID:
  • Слева: RqUID
  • Справа: $(ID)
Здесь мы вставляем локальную переменную, которую создали в первом блоке. Обратите внимание на формат: локальные переменные всегда пишутся в круглых скобках и со знаком доллара перед ними.

Настройка тела запроса

Перейдите на вкладку «Тело» в документации. По умолчанию там может быть пустое поле или какой-то шаблон.
Добавьте одну строку:
  • Слева: scope
  • Справа: GIGACHAT_API_PERS
Важное уточнение! Значение GIGACHAT_API_PERS используется, если вы регистрировались как физическое лицо. Если у вас другой тип доступа:
  • Для индивидуальных предпринимателей: GIGACHAT_API_B2B
  • Для корпоративных клиентов: GIGACHAT_API_CORP
Финальные настройки
В поле «Тайм-аут» укажите 25 секунд — этого достаточно для получения ответа от сервера.
Включите опцию «Выводить тело ответа в чат» — это временная мера для тестирования, потом мы её отключим.

3. Тестирование получения токена

Пришло время проверить, правильно ли мы всё настроили. Перейдите в Telegram к вашему боту (он должен быть уже создан и подключен к платформе Watbot.ru). Ссылка на видео для создания чат-бота:
- YouTube Смотрите любимые видео, слушайте любимые песни, загружайте собственные ролики и делитесь ими с друзьями, близкими и целым миром. www.youtube.com
Нажмите кнопку «Старт» или отправьте команду /start. Бот должен прислать длинное сообщение — это JSON-ответ от GigaChat с токеном доступа.
Скопируйте всё это сообщение полностью. Теперь откройте сайт JSON-форматора: 
Best JSON Formatter and JSON Validator: Online JSON Formatter Online JSON Formatter / Beautifier and JSON Validator will format JSON data, and helps to validate, convert JSON to XML, JSON to CSV. Save and Share JSON jsonformatter.org
Вставьте скопированный текст в левую часть форматора и переключите отображение с «Code» на «Tree» (дерево).
В древовидной структуре найдите путь к нужному нам значению — это будет что-то вроде access_token. Скопируйте весь путь к этому полю.

4. Сохранение токена в переменную

Вернитесь на платформу Watbot.ru и откройте настройки блока HTTP-запрос.
Отключите опцию «Выводить тело ответа в чат» — она нам больше не нужна, мы уже знаем, что запрос работает.
Включите опцию «Записать ответ JSON в переменную». Добавьте новую переменную:
  • Путь — вставьте скопированный путь к токену из JSON-форматора. Обычно это просто access_token, но может быть и более сложный путь
  • Имя переменной — назовите её, например Токен.
Сохраните настройки блока.

Создание интерактивной части

Теперь, когда техническая основа готова, создадим пользовательскую часть — приветствие и интерфейс для общения с нейросетью.

5. Приветственное сообщение с картинкой

От кнопки «Продолжить» предыдущего блока добавьте «Цепочку сообщений». Здесь мы создадим красивое приветствие.
Нажмите на иконку «Фото» и загрузите изображение — это может быть логотип вашего бота, картинка с нейросетью или что-то тематическое. Визуальный контент делает бота более привлекательным и профессиональным.
В текстовое поле добавьте описание. Например:
«Привет! Я твой AI-помощник на основе GigaChat. Буду рад помочь тебе ответить на любой вопрос. В ответ на это сообщение задай интересующий вопрос».
Важный момент: активируйте опцию сохранения ответа пользователя в пользовательскую переменную. Назовите её «вопрос» — в этой переменной будет храниться то, что напишет пользователь.

6. Второй HTTP-запрос: получение ответа от нейросети

От кнопки «Любая другая фраза» добавьте еще один блок «HTTP запрос». Этот запрос будет отправлять вопрос пользователя в GigaChat и получать ответ нейросети.
Снова обратимся к документации. Найдите слева вкладку «Получить ответ модели на сообщение» (или «Chat Completions»).
Настройка URL и метода
  • Скопируйте URL эндпоинта из документации и вставьте в поле «URL»
  • поле «Метод»: POST
Настройка заголовков:
Здесь тоже понадобится три заголовка, но немного других.
Первый заголовок — Content-Type:
  • Слева: Content-Type
  • Справа: application/json
Второй заголовок — Accept:
  • Слева: Accept
  • Справа: application/json
Третий заголовок — Authorization:
  • Слева: Authorization
  • Справа: Bearer {{ $Token }}
Обратите внимание! Здесь мы используем слово Bearer (с заглавной буквы), затем пробел, и вставляем локальную переменную , которую получили в первом HTTP-запросе. Формат записи: знак доллара, круглые скобки, внутри подчеркивание и имя переменной.
Настройка тела запроса
Перейдите на вкладку «Тело» и выберите тип «JSON». Теперь нужно создать структуру запроса в формате JSON.
Из документации нам нужен массив с определенными полями. Вот пример структуры, можете воспользоваться им:
{
"model": "GigaChat:1.0.26.20",
"messages": [
{
"role": "user",
"content": "{{ $Вопрос }}"
}
],
"temperature": 0.7,
"top_p": 0,
"stream": false,
"repetition_penalty": 1,
"update_interval": 0
}
Что здесь важно:
  • model — название модели. На момент создания инструкции актуальна модель GigaChat, но проверьте документацию — возможно, появились новые версии вроде GigaChat-Pro или другие
  • content — здесь вставьте переменную {{вопрос}} (в двойных фигурных скобках) — это вопрос, который написал пользователь
  • temperature — параметр креативности ответов. Значение от 0 до 1, где 0 — максимально точные и предсказуемые ответы, 1 — более творческие и разнообразные. Оптимальное значение 0.7
Финальные настройки
Тайм-аут поставьте 25 секунд. Включите «Выводить тело ответа в чат» для первого тестирования.

7. Тестирование ответа нейросети

Перейдите в Telegram, перезапустите бота (команда /start). Должно прийти приветственное сообщение с картинкой. Задайте любой вопрос, например: «Как дела?»
Через несколько секунд придет длинное сообщение с JSON-структурой — это ответ от GigaChat. Скопируйте его полностью.
Откройте JSON-форматор, вставьте ответ в левую часть и переключите на режим «Tree». В древовидной структуре найдите путь к тексту ответа — он обычно находится в choices[0].message.content или подобном пути. Скопируйте весь путь.

8. Извлечение и отображение ответа

Вернитесь на платформу и откройте настройки второго HTTP-запроса.
Отключите «Выводить тело ответа в чат». Включите «Записать ответ JSON в переменную».
Добавьте переменную:
  • Путь — вставьте скопированный путь. Если путь содержит стрелки (например, choices→0→message→content), замените все стрелки на точки: choices.0.message.content
  • Имя переменной — назовите «Ответ»
Сохраните настройки.

9. Вывод ответа пользователю

От кнопки «Продолжить» добавьте блок «Цепочка сообщений». В текстовое поле вставьте переменную {{ответ}}.
Как вставить переменную правильно? Нажмите на кнопку «Переменная» в редакторе текста — откроется список доступных переменных, выберите «ответ». Она автоматически вставится в нужном формате с двойными фигурными скобками.

Создание непрерывного диалога

Сейчас бот работает, но только для одного вопроса. После получения ответа диалог обрывается. Давайте исправим это и сделаем полноценный чат!

10. Зацикливание сценария

В блоке «Цепочка сообщений», где выводится ответ нейросети, активируйте опцию "Записать ответ в пользовательскую переменную".
Критически важно: назовите эту переменную точно так же — «вопрос». Это та же самая пользовательская переменная, что мы использовали ранее! Так система будет перезаписывать старый вопрос новым, и диалог продолжится.
Теперь от кнопки «Любая другая фраза» этого блока проведите связь обратно к предыдущему блоку HTTP-запрос.
Получается замкнутый цикл: пользователь пишет вопрос → запрос в GigaChat → получение ответа → вывод ответа → пользователь пишет следующий вопрос → снова запрос в GigaChat — и так до бесконечности!

Финальное тестирование

Отлично! Сценарий готов. Давайте оценим результат. Кстати, обратите внимание — весь бот состоит всего из шести блоков (включая стартовый). Компактно и эффективно!

11. Проверка полного функционала

Перейдите в Telegram и перезапустите бота. Нажмите /start.
Приходит приветственное сообщение с картинкой и описанием. Задайте первый вопрос, например: «Расскажи про квантовые компьютеры».
Обратите внимание на скорость ответа — GigaChat обычно генерирует ответы очень быстро, за 2-5 секунд. Получаете развернутый, структурированный ответ.
Теперь не перезапуская бота, задайте следующий вопрос.
Некоторые ответы могут генерироваться чуть дольше — это нормально, зависит от сложности запроса. Через несколько секунд приходит ответ, учитывающий контекст предыдущего сообщения.
Продолжайте диалог сколько угодно — бот будет отвечать на все вопросы, поддерживая контекст беседы.

Практические советы по использованию

Теперь у вас есть полностью рабочий AI-бот. Давайте обсудим несколько важных моментов, которые помогут использовать его максимально эффективно.
Управление контекстом диалога. Сейчас бот запоминает только последний вопрос пользователя. Если хотите, чтобы он учитывал всю историю беседы, нужно модифицировать массив в теле запроса — добавлять туда все предыдущие сообщения. Это немного сложнее, но значительно улучшает качество диалога.
Настройка temperature. Экспериментируйте со значением этого параметра. Для технических вопросов, где нужна точность, ставьте 0.3-0.5. Для творческих задач (написание текстов, генерация идей) увеличивайте до 0.8-1.0.
Ограничения по токенам. У GigaChat есть лимиты на длину запросов и ответов. Если планируете генерировать длинные тексты, изучите документацию по параметру max_tokens и добавьте его в тело запроса.
Мониторинг расходов. Каждый запрос к API тарифицируется. Следите за статистикой использования в личном кабинете GigaChat, чтобы не превысить бюджет.
Версионность модели. GigaChat регулярно обновляется, появляются новые версии моделей с улучшенными возможностями. Периодически проверяйте документацию и обновляйте значение параметра model в вашем запросе.
Обработка ошибок. Добавьте обработку ситуаций, когда API недоступен или возвращает ошибку. Можно настроить альтернативный блок с сообщением «Извините, временные технические неполадки, попробуйте позже».

Идеи для расширения функционала

Базовый бот готов, но его можно значительно улучшить. Вот несколько идей:
Специализация бота. Добавьте в начало диалога системное сообщение с инструкцией для нейросети. Например, если делаете бота-консультанта по юридическим вопросам, укажите: «Ты — юридический консультант, отвечай профессионально, ссылайся на законы».
Кнопки быстрых команд. Добавьте inline-кнопки с популярными запросами: «Помоги с кодом», «Объясни термин», «Напиши текст» — пользователям будет удобнее.
Ограничение количества запросов. Внедрите систему подсчета обращений на пользователя в день, чтобы контролировать расходы на API.
Мультимодальность. Если GigaChat поддерживает работу с изображениями (проверьте актуальную документацию), добавьте возможность отправки картинок для анализа.
Сохранение истории. Интегрируйте Google Таблицы или базу данных для сохранения всех диалогов — это полезно для аналитики и улучшения бота.

Что мы создали

Давайте подведем итог. Вы создали умного чат-бота, который:
  • Интегрирован с российской нейросетью GigaChat
  • Отвечает на любые вопросы пользователей
  • Поддерживает непрерывный диалог
  • Быстро генерирует качественные ответы на русском языке
  • Работает полностью автоматически
Такой бот открывает множество возможностей: автоматизация консультаций, помощь в обучении, создание виртуальных ассистентов, генерация контента и многое другое.
Самое приятное — вы собрали всё это без единой строчки кода, используя только визуальный конструктор. Это доказывает, что создание AI-решений доступно каждому, независимо от технических навыков.
Экспериментируйте, добавляйте новые функции, адаптируйте бота под свои задачи. Технологии искусственного интеллекта развиваются стремительно, и теперь у вас есть инструмент, чтобы быть частью этой революции.
Успехов в создании интеллектуальных чат-ботов! 🚀

Полезные ссылки

Бесплатная регистрация на платформе Watbot для создания чат-ботов:
Watbot — визуальный конструктор чат-ботов Визуальный конструктор чат-ботов для Вашего бизнеса. Подойдёт для любой ниши. Соберите готовое решение чат-бота за 10 минут! 300 видеоуроков внутри платформы. Больше 100 шаблонов чат-ботов. Легко научиться собирать. Усиливает продажи и автоматизацию. watbot.ru
Видео-инструкция GIGACHAT В ТЕЛЕГРАММ БОТЕ ЗА 10 МИНУТ:
- YouTube Смотрите любимые видео, слушайте любимые песни, загружайте собственные ролики и делитесь ими с друзьями, близкими и целым миром. www.youtube.com