Автоматизация n8n
ТЕХНИЧЕ ЗАДАНИЕ
Автоматизация обработки документов через Telegram бот на платформе n8n
1. ОБЩЕЕ ОПИСАНИЕ ПРОЕКТА
Необходимо создать автоматизированный workflow на платформе n8n, который обеспечит обработку документов через Telegram бот с последующим анализом с помощью Claude API, сравнением с эталонным перечнем документов в Google Таблице, автоматическим проставлением чекбоксов и формированием архива документов.
2. ТЕХНИЧЕСКИЙ СТЕК
- Платформа автоматизации: n8n
- Мессенджер: Telegram Bot API
- AI анализ: Claude API (промпт предоставляется Заказчиком)
- Хранение данных: Google Sheets
- Генерация архива: Google Apps Script (уже готов)
- Форматы файлов: PDF, DOCX
3. ФУНКЦИОНАЛЬНЫЕ ТРЕБОВАНИЯ
3.1 Прием файлов через Telegram
Входные данные:
- Пользователь отправляет от 1 до 6 файлов через Telegram бот
- Типы файлов: PDF, DOCX
- Количество сотрудников-пользователей: несколько человек
Технические требования:
- Бот должен принимать множественную загрузку файлов (до 6 штук за один запрос)
- Сохранять файлы для дальнейшей обработки
- Подтверждать получение файлов пользователю
3.2 Анализ документов с помощью Claude API
Процесс:
- Все полученные файлы передаются на анализ в Claude API
- Используется готовая инструкция (промпт), которую предоставляет Заказчик
- Claude анализирует содержание документов и извлекает информацию
Формат ответа:
- JSON структура (формат определен Заказчиком)
- Содержит названия/типы документов, обнаруженных в файлах
Технические требования:
- Обработка всех типов файлов (PDF, DOCX)
- Сохранение JSON ответа для дальнейшей обработки
3.3 Сравнение с эталонным перечнем и проставление чекбоксов
Источник эталонных данных:
- Google Таблица (конкретная таблица будет предоставлена Заказчиком)
- Структура: одна строка = один документ = один чекбокс
- Эталонный перечень названий документов хранится в той же таблице
Логика сравнения:
- Сравнение названий документов из JSON ответа с эталонным перечнем
- Принцип сравнения: совпадение по содержанию (не обязательно точное текстовое совпадение)
- Все названия в эталонном перечне уникальны (гарантируется Заказчиком)
Действия при нахождении совпадения:
- В соответствующей строке Google Таблицы проставляется активный чекбокс (checked)
Результат:
- Список документов делится на две категории:
- Найденные: документы, которые совпали с эталонным перечнем (чекбоксы проставлены)
- Не найденные: документы, которые не совпали ни с одной позицией в эталоне
3.4 Генерация архива документов
Процесс:
- После проставления чекбоксов вызывается готовый Google Apps Script
- Script генерирует ZIP архив с PDF документами на основе проставленных чекбоксов
- Архив формируется автоматически
Технические требования:
- n8n должен вызывать выполнение существующего Google Apps Script
- Получить ссылку или файл сгенерированного архива
3.5 Возврат результата в Telegram
Что возвращается пользователю:
- Архив документов (ZIP файл, полученный от Google Apps Script)
- Список незнайденных документов - простой текстовый перечень названий документов, которые не совпали с эталонным перечнем
Формат сообщения:
✅ Обработка завершена!
📦 Архив документов: [файл]
❌ Не найденные документы:
- [Название документа 1]
- [Название документа 2]
- [Название документа N](если все документы найдены, блок "Не найденные документы" не выводится)
4. НЕФУНКЦИОНАЛЬНЫЕ ТРЕБОВАНИЯ
4.1 Производительность
- Максимальное время обработки одного запроса: до 5 минут
- Workflow должен обрабатывать запросы последовательно (queue)
4.2 Логирование
- Обязательное логирование всех этапов обработки:
- Кто (Telegram User ID/Username)
- Когда (дата и время)
- Какие файлы загрузил (названия, количество)
- Результат анализа Claude
- Какие чекбоксы проставлены
- Какие документы не найдены
- Статус выполнения (успех/ошибка)
- Логи сохранять в отдельном листе Google Таблицы или другом удобном формате
4.3 Обработка ошибок
- Детали обработки ошибок (Claude API недоступен, ошибки обработки файлов, ошибки Google Sheets) будут согласованы с исполнителем на этапе разработки
- Пользователь должен получать понятные сообщения об ошибках
5. РАСПРЕДЕЛЕНИЕ ОТВЕТСТВЕННОСТИ
Исполняет Заказчик:
- ✅ Предоставляет готовую инструкцию (промпт) для Claude API
- ✅ Предоставляет доступ к Google Таблице со структурой
- ✅ Предоставляет готовый Google Apps Script для генерации архива
- ✅ Реализует авторизацию/идентификацию пользователей в Telegram боте
- ✅ Определяет формат JSON ответа от Claude
Исполняет Исполнитель:
- ✅ Создает workflow на платформе n8n
- ✅ Настраивает интеграцию Telegram Bot
- ✅ Настраивает интеграцию Claude API
- ✅ Настраивает интеграцию Google Sheets API
- ✅ Реализует логику сравнения документов
- ✅ Реализует автоматическое проставление чекбоксов
- ✅ Настраивает вызов Google Apps Script
- ✅ Реализует логирование процесса
- ✅ Согласует с Заказчиком обработку ошибок
- ✅ Проводит тестирование workflow
-
Добрый день!
У меня более 3 лет опыта работы с n8n, Telegram Bot API. Готов реализовать полный workflow: прием документов в Telegram, анализ через Claude API, сверку с эталонным списком в Google Таблицах, проставление чекбоксов, вызов готового Google Apps Script для формирования архива и возврата результатов и логирования в отдельный лист.
Можем обсудить детали?
-
1315 7 0 Добрый день.
Готов взять Ваш проект в работу.
Смогу разработать для Вас такую автоматизацию с помощью n8n.
Пишите в личные сообщения, обсудим все детали и сможем приступить к реализации.
-
2848 17 0 1 Привет, Данило!
Задача полностью понятна. Техническая реализация займет около 3 дней, если возникнет необходимость модернизировать промпт, то с этим тоже смогу помочь. Во всем остальном вопросов нет. Единственное, что может быть, что документы имеют большой объем и ИИ не будет их качественно обрабатывать (но тут вы скажете, возможна ли такая ситуация вообще). Но для этого тоже есть решение, поэтому проблем не возникнет.
Опыт у меня огромный, поэтому будет выполнено хорошо и вовремя)
В общем по срокам: 3 рабочих дня.
По стоимости 10000 грн будет хорошо, но можем обсудить.
-
206 Мы внимательно ознакомились с техническим заданием и готовы реализовать этот workflow на n8n под ключ.
У нас есть практический опыт работы с n8n, Telegram Bot API, интеграциями через REST API, Google Sheets и AI-сервисами (Claude / GPT). Мы понимаем специфику обработки PDF и DOCX, построения стабильного JSON-вывода от AI и реализации логики семантического сравнения документов.
Особое внимание уделим:
стабильности JSON ответа от Claude
корректному семантическому соответствию с эталонным перечнем
…
обработке ошибок и retry-логике
очереди обработки запросов (чтобы укладываться в 5 минут)
детальному логированию каждого этапа
У нас есть опыт построения production automation-решений, где важна не только функциональность, но и надежность и прозрачность процесса.
Ориентировочный срок реализации: 8-9 рабочих дней (с тестированием).
Готовы обсудить детали, уточнить нюансы семантического сравнения и начать работу в ближайшее время.
-
432 1 0 Здравствуйте, Данило!
Могу реализовать полный workflow в n8n для автоматизированной обработки документов через Telegram с интеграцией Claude API, Google Sheets и Google Apps Script.
Буду рад обсудить детали, чтобы предложить оптимальный вариант решения.
-
890 1 0 Добрый день, Данила.
Готов создать автоматизированный workflow на платформе n8n для обработки документов через Telegram. Интегрирую Telegram Bot API, Claude API для анализа, Google Sheets API для сравнения и вызову вашего Google Apps Script для генерации архива. Обеспечу логирование всех этапов и обработку ошибок для стабильной работы системы.
---
Основная проблема заключается в необходимости бесшовного соединения Telegram, Claude API и Google Sheets для автоматизации рутинной проверки документов. Я построю workflow в n8n, который надежно группирует входные файлы (до 6 штук), конвертирует PDF/DOCX в текст для Claude и обрабатывает JSON-ответ для синхронизации с вашей таблицей.
Особое внимание уделю логике сравнения: вместо жесткого поиска реализую гибкое сопоставление названий, чтобы Claude корректно идентифицировал пункты эталонного перечня. После установки чекбоксов через Google Sheets API, n8n инициирует ваш Apps Script через HTTP Request и вернет готовый архив пользователю вместе с отчетом об отсутствующих позициях.
…
Для стабильности настрою очередь обработки и детальное логирование каждого шага (от ID пользователя до статусов API) в отдельный лист Google Sheets, как указано в ТЗ. Использую n8n, Telegram Bot API и Claude API для создания отказоустойчивой системы.
---
Точную цену и сроки сможем согласовать во время обсуждения деталей задания.