📄 Техническое задание
Проект: Интеграция платформы AIREX с мессенджерами WhatsApp и Telegram, с подключением GPT (OpenAI) для интеллектуальной обработки пользовательских запросов.
1. 🎯 Цель проекта
Обеспечить доступ к функционалу платформы AIREX через популярные мессенджеры (Telegram и WhatsApp), с возможностью интеллектуальной обработки запросов с помощью GPT.
2. ✅ Функциональные требования
2.1 Telegram-бот
Создание Telegram-бота через @BotFather
Подключение через Telegram Bot API
Поддержка команд:
/start — запуск и приветствие
/help — список доступных команд
pbg [номер] — проверка номера разрешения
девелопер [название] — проверка застройщика
объект [название] — проверка объекта недвижимости
отчет — генерация PDF-отчета
2.2 WhatsApp-бот
Подключение через одного из официальных провайдеров WhatsApp Business API:
Twilio
360dialog
Gupshup
WATI
Обработка входящих сообщений
Ответы по ключевым словам и запросам
Поддержка шаблонных сообщений (в соответствии с требованиями WhatsApp)
2.3 Общие функции
Приём и обработка текстовых команд
Генерация и отправка PDF-отчётов
Ответы на вопросы пользователей
Ведение истории переписок (контекста)
3. 🤖 Интеграция с GPT (OpenAI)
Цель:
Интеграция модели GPT (через OpenAI API) в логическую цепочку ботов, чтобы отвечать на сложные вопросы, генерировать пояснения, проводить анализ рисков и формировать текстовые отчёты.
Требования:
Использовать модель GPT-4o (или GPT-4, в зависимости от ключа)
Подключение через
Использовать ключ OpenAI (API Key), предоставленный заказчиком
Формат общения:
json
Копировать
Редактировать
{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "Ты помощник AIREX. Отвечай кратко, профессионально, анализируя риски и данные по недвижимости в Индонезии."},
{"role": "user", "content": "Проверь девелопера Mirah Group"}
]
}
Обработка команд:
GPT получает только смысловые команды (естественный язык)
Команды типа /help или pbg-номер обрабатываются локально, без участия GPT
Поддержка короткой истории чата (3–5 сообщений)
Ошибки и безопасность:
Обработка ошибок (нет соединения, токены, лимиты)
Ограничение токенов в ответе
Защита от неподобающего ввода (модерация)
4. 🔧 Серверная часть (backend)
API-сервер на Python (Flask / FastAPI) или Node.js (Express)
Приём запросов от Telegram и WhatsApp
Обработка ввода: нормализация, маршрутизация (локально или в GPT)
Подключение логики AIREX: проверка девелоперов, генерация отчётов, PBG
Формирование и отправка PDF-файлов
Логирование всех событий
5. 🗃 Хранение данных и отчётов
Хранение логов (MongoDB / PostgreSQL)
Кеширование популярных данных
Отчёты в форматах PDF, Excel, JSON
6. 🧰 Рекомендуемый стек технологий
Компонент Технология
Язык программирования Python / Node.js
Telegram API python-telegram-bot / Telegraf.js
WhatsApp API Twilio / Gupshup / 360dialog
OpenAI GPT-4 / GPT-4o via OpenAI API
Backend Flask / FastAPI / Express.js
Хранилище PostgreSQL / MongoDB
PDF ReportLab / pdfkit
7. 📦 Ожидаемые результаты
Полностью функционирующий Telegram-бот и WhatsApp-бот
Интеграция с GPT, настроенная под контекст AIREX
Исходный код с комментариями
Документация по запуску
Примеры тестов и диалогов
Инструкция по размещению на сервере
8. ⏱ Сроки выполнения
MVP (минимально работающая версия): 3–5 рабочих дней
Полная версия с GPT, отчётами, логикой AIREX: до 14 рабочих дней