TelegramSearchBot: от фото рукописного заказа до корзины за минуты

TelegramSearchBot: от фото рукописного заказа до корзины за минуты превью

Индустрия:

Ритейл / e-commerce

Предоставленные услуги:

Разработка Telegram-бота
AI-интеграция
Бэкенд-разработка
Интеграция с e-commerce API

Технологический стек:

Python
aiogram
FastAPI
OpenAI Vision
Sellwin API
MinIO
Docker

Сроки:

MVP за 2–3 месяца с итерациями по качеству OCR и поиска

Ключевые моменты проекта

Менеджеры по продажам и администраторы салонов ежедневно собирают заказы по фото: рукописные списки, чеки, фрагменты прайсов. Ручной перенос позиций в каталог занимает время и приводит к ошибкам. Команда WEB24 разработала TelegramSearchBot — бота, в который достаточно отправить до трёх изображений. OpenAI Vision распознаёт текст, бот формирует редактируемый список товаров, ищет позиции через Sellwin Search API и отправляет найденные товары в корзину одной кнопкой. Промпты OCR и синонимы поиска настраиваются через админ-панель без релиза бота.

Задача

Сбор B2B-заказов по фото — привычный рабочий процесс, но цифровой: сотрудник получает снимок, вручную расшифровывает позиции, ищет артикулы в каталоге и добавляет их в корзину. На этом пути теряется скорость и точность. Клиенту требовалось решение, которое:

  • Принимает фото и документы прямо в Telegram — без отдельного приложения
  • Распознаёт рукописный и печатный текст с чеков, списков и прайсов
  • Даёт менеджеру проверить и отредактировать список перед отправкой
  • Автоматически сопоставляет названия с товарами в каталоге
  • Создаёт заказ в корзине с готовой ссылкой для перехода
  • Авторизует пользователя по УНП для безопасной работы с API

Нужен был не просто OCR, а сквозной сценарий: фото → список → поиск → корзина.

Наш подход

Мы спроектировали TelegramSearchBot как связку Telegram-интерфейса, AI-распознавания и интеграций с Sellwin. Ключевые блоки решения:

Telegram-бот и сценарии пользователя

Long polling на aiogram: авторизация по УНП, приём до 3 изображений, сбор списка, редактирование позиций и отправка в корзину через inline-кнопки и команды /start, /unp, /list, /add.

OCR через OpenAI Vision

Сервис распознавания загружает system/user prompt из админ-API (ocr-ai-settings). При недоступности API используются fallback-промпты из конфигурации. Результат — структурированный список позиций для проверки менеджером.

Поиск и корзина Sellwin

Batch-search по списку названий, авторизация по УНП (token/refreshToken), создание строк заказа через Basket API. Синонимы поиска управляются в админ-панели и влияют на качество сопоставления без правки кода бота.

Хранение изображений в MinIO

Фото загружаются в объектное хранилище перед созданием корзины. Ключи вида user_{id}/{timestamp}_{uuid}.{ext} — для аудита и повторной обработки.

Инфраструктура и health-check

Docker Compose для деплоя, отдельный FastAPI endpoint GET /health для мониторинга. Модульная структура: handlers, services (ocr, sellwin, store, minio_storage), factory для регистрации хендлеров.

TelegramSearchBot: от фото рукописного заказа до корзины за минуты подход — изображение 1

Результат

Бот сократил путь от фото заказа до готовой корзины с нескольких минут ручной работы до одного сценария в Telegram:

  • Менеджер отправляет фото и получает редактируемый список позиций без ручного ввода
  • Поиск по каталогу выполняется пакетно — сразу по всему списку
  • Готовая ссылка «Перейти в корзину» сокращает время оформления заказа
  • Промпты OCR и синонимы обновляются через админ-панель без деплоя бота
  • Авторизация по УНП ограничивает доступ к корзине только для проверенных клиентов

Решение встроилось в привычный канал общения — Telegram — и убрало рутину переноса рукописных заказов в цифровую корзину.

Что мы реализовали

  • Полный user flow: УНП → фото → OCR → редактирование → корзина
  • Интеграция OpenAI Vision с настраиваемыми промптами из админки
  • Sellwin Auth, Search (batch-query) и Basket API
  • In-memory state для сессий: список, буфер изображений, токены
  • Загрузка файлов в MinIO и Docker-окружение для продакшена

Схема работы бота

Данные проходят цепочку: Telegram → OCR → редактирование → поиск → корзина.

  • Пользователь вводит УНП и загружает до 3 изображений
  • OpenAI Vision извлекает список позиций
  • Менеджер проверяет, добавляет или удаляет строки
  • Batch-search находит товары в каталоге Sellwin
  • Basket API создаёт заказ и возвращает ссылку на корзину
TelegramSearchBot: от фото рукописного заказа до корзины за минуты итоги — изображение 1

Telegram-интерфейс: загрузка фото, сбор списка и отправка в корзину

TelegramSearchBot: от фото рукописного заказа до корзины за минуты итоги — изображение 2

OpenAI Vision + настраиваемые промпты и синонимы поиска для точного сопоставления товаров

Что мы узнали

Качество такого бота складывается из трёх слоёв: читаемость фото, точность OCR-промпта и релевантность поиска с синонимами. Поэтому мы вынесли настройки промптов и синонимов в админку, а в коде оставили fallback и прозрачный сценарий редактирования списка перед отправкой в корзину. In-memory state подходит для MVP и одного инстанса; при масштабировании потребуется внешнее хранилище сессий.

Нужен бот, который превращает фото в заказ?

В WEB24 мы создаём Telegram-ботов с AI-распознаванием и интеграцией в ваши каталоги, CRM и корзины. Свяжитесь с нами, чтобы обсудить автоматизацию приёма заказов!

ДавайтеСотрудничать!

г. Минск, ул. Попова, 24А, пом 406 флагг. Минск, ул. Попова, 24А, пом 406

Общество с ограниченной ответственностью «НИКПА-СТРОЙ»

УНП 193184561

© 2026 WEB24Все права защищены