1.
Введение и цели проекта
Цель проекта:
С помощью визуального автоматизатора n8n настроить Telegram-бота, который:
● принимает сообщения от пользователя,
● отправляет их в AI-сервис (например, OpenAI или другой REST-API),
● сохраняет и извлекает данные из базы Notion (список задач, ведение логов, FAQ и
т.д.).
Основные задачи:
● Развернуть или подключиться к n8n-инстансу (cloud или self-hosted).
● Зарегистрировать Telegram-бота и получить токен.
● Получить API-ключ AI-сервиса и токен интеграции с Notion.
● Спроектировать workflow в n8n, объединяющий узлы Telegram, HTTP-Request (AI) и
Notion.
● Реализовать логику обработки сообщений:
○ разделение по интентам (например, “запомнить”, “спросить AI”, “показать
список”).
○ ветвления: если пользователь хочет добавить запись — сохраняем в
Notion, иначе — запрашиваем у AI.
● Провести тестирование и задокументировать все шаги.
2. Техническое задание
2.1. Среда разработки
● n8n (Cloud-аккаунт или контейнер/виртуальная машина с Docker).
● Telegram Bot (BotFather → @YourBot → полученный TOKEN).
● AI-сервис (OpenAI API key или аналог).
● Notion Integration (создать Integration, дать доступ к нужной базе и получить Internal
Token).
2.2. Компоненты workflow
1. Telegram Trigger
○ Узел: “Telegram Trigger”
○ Событие: “On Message”
2. Фильтрация и парсинг
○ Узел: “IF” или “Switch”
○ Условия:
■ Сообщение начинается с /add → интент “добавить”
■ /show → “извлечь”
■ всё остальное → “запрос к AI”
3. AI-запрос
○ Узел: “HTTP Request” или “OpenAI”
○ Метод: POST
○ URL: API эндпоинт AI
Тело запроса:
json
CopyEdit
{
"model": "gpt-4o-mini",
"prompt": "User: {{$[Link]}}\nAssistant:",
"max_tokens": 150
}
○
○ Заголовки: Authorization: Bearer {{ $[Link] }}
4. Notion – запись
○ Узел: “Notion” → “Create Page”
○ Выбор базы (Database ID)
○ Заполняем свойства:
■ Title: текст после /add
■ Date: текущая дата
5. Notion – чтение
○ Узел: “Notion” → “Search Database”
○ Параметр фильтрации: по тегу или всем элементам
○ Формирование списка из результатов
6. Ответ пользователю
○ Узел: “Telegram” → “Send Message”
○ Тело: результат AI-запроса или подтверждение записи/список из Notion
3. План реализации проекта
Этап 1: Подготовка среды
● Настроить n8n (запустить Docker-контейнер или подключиться к облаку).
● Сконфигурировать креденшлы: Telegram, OpenAI (или другой AI), Notion.
Этап 2: Создание базового Telegram-workflow
● Добавить узел “Telegram Trigger”.
● Добавить узел “Telegram → Send Message” с заглушкой (например,
“Привет!”).
● Протестировать получение и отправку простых сообщений.
Этап 3: Интеграция AI
● Вставить между Trigger и Send Message узел “HTTP Request” (или “OpenAI”).
● Сформировать prompt, передать в AI, получить ответ.
● Протестировать с простыми запросами (“Как дела?”).
Этап 4: Интеграция Notion
● Добавить узел “Notion – Create Page” для команды /add.
● Добавить узел “Notion – Search Database” для команды /show.
● Пропишите IF-ветвление по тексту сообщения.
● Протестировать добавление и извлечение записей.
Этап 5: Логика интентов и ветвление
● Настроить узел “Switch” для определения интента по префиксу команды.
● Ветвить поток на AI, NotionCreate и NotionRead.
● Обработать ошибки (узел Error Trigger и ответ “Что-то пошло не так”).
Этап 6: Тестирование и документация
● Подготовить минимум 5 сценариев диалога:
1. /add Сдать отчет в пятницу
2. /show
3. Расскажи анекдот
4. Что по расписанию на завтра? (если расширите логику)
5. Как стать лучшим программистом?
● Сохранить скриншоты конфигурации каждого узла и итоговую логику.
● Описать в отчёте использованные prompts и параметры узлов.
4. Критерии оценки проекта
● Использование n8n: настроено минимум 6 узлов (Telegram Trigger, Switch, HTTP
Request, Notion Create, Notion Search, Telegram Send), все креденшлы вынесены в
n8n Credentials.
● Работоспособность: бот корректно реагирует на 80 % сценариев из тестового
набора.
● Качество конфигурации:
○ Чёткие имена узлов и комментарии в описании.
○ Обработка ошибок и fallback-сообщения.
● Документация: отчёт со скриншотами и описанием каждого шага, список prompts,
примеры входных и выходных данных.
5. Задача для студентов
6. Развернуть n8n (cloud или локально на Docker).
7. Зарегистрировать Telegram-бота и получить токен.
8. Настроить интеграции (Notion и AI-сервис) в n8n Credentials.
9. Построить workflow по описанному техническому заданию.
10. Сформулировать не менее 5 prompts для AI-узла, обеспечивающих разнообразные
ответы.
11. Протестировать 5 сценариев диалога и зафиксировать результаты.
12. Подготовить отчёт с описанием узлов, параметров prompts и выводом логов
тестирования.
Ресурсы для изучения:
● Документация n8n: [Link]
● Telegram Bot API: [Link]
● Notion API: [Link]
● Примеры workflow n8n: [Link]
base/nodes
● [Link]
● [Link]
● [Link]
● [Link]