Создание документов с помощью 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, который удобно читать и редактировать.

  1. Создайте команду /article.

  2. Добавьте «Форму ввода»:

    • Текст: Напишите тему для вашей статьи

    • Тип ввода: Текст

    • Переменная: {{article_topic}}

  1. Сразу после нее действие «Отправить запрос» (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. Сбор данных (заполнение таблицы)

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

  1. Простая анкета в виде серии блоков «Форма ввода» прямо в чате.

  2. Постепенный сбор данных через воронку сообщений и «Сценарии».

  3. Mini App: красивая анкета для заполнения, которая передает данные в бота.

Главное условие: после заполнения данные должны быть записаны в NocoDB в строку, где tg_id равен {{USER_ID_TEXT}} текущего пользователя.

Шаг 3. Создание интегрированной переменной

Создайте одну переменную, которая сама сходит в таблицу, возьмет нужные поля и соберет их в готовый текст для нейросети.

  1. Перейдите в главное меню PuzzleBot -> раздел Переменные.

  2. Нажмите «Создать переменную». Назовите её, например: client.

  3. В поле Тип значения выберите: Интегрированный.

  4. Интеграция: Выберите подключенную таблицу NocoDB.

  5. Настройте поиск строки пользователя:

    • Поле таблицы tg_id Равно переменной {{USER_ID_TEXT}}

  6. Переключите с «Ячейка» на «Строка». В поле шаблона составьте текст, используя столбцы из NocoDB

Теперь у вас есть супер-переменная {{client}}, которая внутри себя уже содержит полную анкету на пользователя в текстовом виде.


Шаг 4. Настройка запроса в Tracker

Теперь остаётся только отправить эту переменную в GPT.

  1. В нужном месте сценария (например, на кнопке "Получить рацион") добавьте действие «Отправить запрос» (Tracker).

  2. Заполните параметры:

Ключ
Значение
Пояснение

... (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, чтобы создавать сложные автоворонки, где пользователь на входе заполняет простую форму, а на выходе получает готовый к использованию документ.

Последнее обновление

Это было полезно?