Создание документов с помощью GPT
Данный функционал позволяет создавать красиво оформленные документы (PDF или DOCX) прямо в боте. Вы можете создавать отчеты, коммерческие предложения, договоры или целые статьи одним нажатием.

Для чего это нужно?
В документ можно упаковать длинный текст (вместо отдельных коротких сообщений в Телеграм).
Вы можете выдать пользователю черновик (например, договора или статьи), который он сможет скачать, открыть в Word и доработать под себя.
Документ можно сразу распечатать, подписать или переслать коллегам по почте, не занимаясь ручным копированием текста из чата в файл и настройкой шрифтов.
(Доступно для тарифа "Бизнес-Премиум")
Настройка запроса

В любой команде вашего бота (например, document_tracker) добавьте действие «Отправить запрос» и настройте его:
Ссылка:
https://api.pxsto.re/main/puzzlebot-trackerТип запроса:
POSTВид запроса:
Сформированный
Нажмите на кнопку «Добавить параметр». Ниже приведен список параметров, которые необходимо передать.
Параметры запроса
user
{{USER_ID_TEXT}}
ID пользователя Telegram
Да
bot
{{BOT_USERNAME_TEXT}}
Имя вашего бота
Да
token
[Ваш API-токен]
Ваш API-токен из настроек интеграции.
Да
model
gpt-5
Выберите модель: gpt-free, deepseek-chat, deepseek-reasoner, gpt-4.1, gpt-5-mini, gpt-5, gemini-2.5-pro
Да
document
true
Активирует режим генерации документа
Да
format
pdf или docx
Формат файла на выходе
Да
style
modern или classic
modern: современный дизайн
classic: строгий деловой стиль
Да
role
[Ваша роль]
Роль ИИ, например: "Ты опытный юрист" или "Ты маркетолог"
Да
prompt
[Ваш промпт] или {{переменная}}
Текст запроса или инструкция для генерации контента
Да
send_answer
true или false
true: Бот пришлет документ пользователю.
false: Документ запишется в переменную {{tracker_answer}}
Нет
chat
-100xxxxxxx
ID группы или канала для отправки (если нужно)
Нет
topic
123
ID топика (для форумов)
Нет
Получение результата
Как и в других сценариях Puzzle AI, для корректной работы убедитесь, что в вашем боте создана команда gpt_done.

Эта команда вызовется автоматически, когда документ будет готов для отправки пользователю. Также в ней вы можете настроить сообщение об успешном завершении или вернуть пользователя в главное меню бота.
Примеры использования
Ниже мы разобрали 2 примера: от простой формы ввода до сложной интеграции с базой данных.
Пример 1. Простой генератор статей (через форму ввода)
Пользователь отправляет тему статьи, а бот пишет весь материал и отправляет его в виде документа DOCX, который удобно читать и редактировать.
Создайте команду
/article.Добавьте «Форму ввода»:
Текст:
Напишите тему для вашей статьиТип ввода:
ТекстПеременная:
{{article_topic}}

Сразу после нее действие «Отправить запрос» (Tracker):
... (bot, user, token, model)
document
true
Включаем режим документа
format
docx
Пользователю удобнее будет редактировать статью в DOCX-формате
style
modern
Для статей подходит современный стиль
role
Ты профессиональный редакто
блога
Задаем стиль письма
prompt
Напиши подробную статью на тему: {{article_topic}}. Используй заголовки, списки и выделение важного.
Передаем тему от пользователя
Бот пришлет сверстанный DOCX-файл с готовой статьей.

Пример 2. Автоматический генератор плана питания (через NocoDB)
Идеально для фитнес-тренеров и нутрициологов. Клиент заполняет анкету, например, в красивом Mini App (Вес, Рост, Цель, Аллергии и др.), данные сохраняются в базу NocoDB. Бот берет эти данные и генерирует персональный PDF-гайд с меню на неделю. Вот как это реализовать.
Шаг 1. Подготовка базы данных (NocoDB)
В вашей таблице NocoDB должны быть столбцы для хранения анкеты клиента. Обязательно добавьте поле tg_id, чтобы бот мог идентифицировать пользователя.
Название столбца
Тип поля
Описание
tg_id
SingleLineText
ID пользователя Telegram (ключ для поиска).
Name
SingleLineText
Имя клиента.
Weight
Number
Вес (кг).
Height
Number
Рост (см).
Goal
SingleSelect
Цель (Похудение / Набор массы).
Allergies
LongText
Аллергии или нелюбимые продукты.
Шаг 2. Сбор данных (заполнение таблицы)
Прежде чем генерировать документ, нужно чтобы данные пользователя попали в таблицу. Вы можете реализовать это любым удобным способом в зависимости от уровня сложности вашего бота:
Простая анкета в виде серии блоков «Форма ввода» прямо в чате.
Постепенный сбор данных через воронку сообщений и «Сценарии».
Mini App: красивая анкета для заполнения, которая передает данные в бота.
Главное условие: после заполнения данные должны быть записаны в NocoDB в строку, где tg_id равен {{USER_ID_TEXT}} текущего пользователя.
Шаг 3. Создание интегрированной переменной
Создайте одну переменную, которая сама сходит в таблицу, возьмет нужные поля и соберет их в готовый текст для нейросети.

Перейдите в главное меню PuzzleBot -> раздел Переменные.
Нажмите «Создать переменную». Назовите её, например:
client.В поле Тип значения выберите:
Интегрированный.Интеграция: Выберите подключенную таблицу NocoDB.
Настройте поиск строки пользователя:
Поле таблицы
tg_idРавно переменной{{USER_ID_TEXT}}
Переключите с «Ячейка» на «Строка». В поле шаблона составьте текст, используя столбцы из NocoDB
Теперь у вас есть супер-переменная {{client}}, которая внутри себя уже содержит полную анкету на пользователя в текстовом виде.
Шаг 4. Настройка запроса в Tracker
Теперь остаётся только отправить эту переменную в GPT.
В нужном месте сценария (например, на кнопке "Получить рацион") добавьте действие «Отправить запрос» (Tracker).
Заполните параметры:
... (bot, user, token, model)
document
true
Включаем режим документа.
format
pdf
PDF удобно открывать на телефоне.
style
modern
Современный дизайн с акцентами
role
Профессиональный диетолог
prompt
Составь подробный план питания на 7 дней на основе данных анкеты. АНКЕТА ПОЛЬЗОВАТЕЛЯ: {{client}}. ЗАДАЧА: 1. Рассчитай КБЖУ для указанной цели. 2. Составь меню на неделю (Завтрак, Обед, Ужин), исключая аллергены. 3. Оформи это в красивый план с рекомендациями.
Мы просто вставим сюда нашу переменную {{client}}
Вам не пришлось прописывать в промпте каждую переменную отдельно ({{Weight}}, {{Height}}...). Вы используете одну переменную {{client}}, которая автоматически подтягивает и форматирует все данные из базы NocoDB. Бот генерирует персональный PDF-файл, полностью готовый к использованию.
Экспериментируйте со связкой PuzzleBot + NocoDB + GPT, чтобы создавать сложные автоворонки, где пользователь на входе заполняет простую форму, а на выходе получает готовый к использованию документ.
Последнее обновление
Это было полезно?