← Блог · Архитектура · 18.11.2026
Как самостоятельно настроить ИИ-менеджера для Авито и Telegram: пошаговый разбор архитектуры и API
Ниже — честная схема «как это устроено в бою». Если после чтения станет ясно, что вам нужен не pet-проект, а рабочий контур — это и есть цель статьи.
1. Карта системы (что реально нужно)
Минимальный боевой контур состоит не из «чат с ChatGPT», а из пяти слоёв:
- Каналы — Авито Messenger API и Telegram Bot API (входящие события).
- Транспорт — публичный HTTPS endpoint (webhook), быстрый ответ 200 и фоновая обработка.
- Диалоговое ядро — профиль ниши, этапы воронки, политика дожима, handoff человеку.
- Знания — RAG/поиск по прайсу, PDF, FAQ, ограничения скидок.
- Наблюдаемость — логи, уведомления о лидах, вечерние сводки собственнику.
Пропуск любого слоя даёт типичный провал: бот «умничает», но не берёт телефон, отвечает на половину реплики или теряет ночные сообщения.
2. Вебхуки: почему без них ночные заявки мертвы
Авито
Авито шлёт события на ваш URL (например POST /webhooks/avito). Важно:
- URL должен быть стабильным HTTPS (постоянный домен, не «сегодня один trycloudflare, завтра другой»).
- Секрет в query/header — защита от чужих POST.
- Ответ платформе — быстрый 200; генерацию ответа модели уводите в фон, иначе будут ретраи и дубли.
- Нужна идемпотентность по
message_id: одно сообщение клиента не должно порождать три ответа бота.
Telegram
Через Bot API: либо long polling (проще для теста), либо webhook на тот же сервер. В продакшене webhook предпочтительнее: меньше задержек и проще горизонтально контролировать.
Ошибка новичка — два независимых «бота» с разным промптом. Правильно: один профиль продажника, разные channel + external_id чата.
3. Склейка сообщений (debounce): клиенты пишут «рвано»
Человек на Авито часто шлёт 3–5 коротких реплик подряд: «привет», «есть в наличии?», «а доставка?». Если отвечать на каждую — диалог превращается в кашу, а токены сгорают зря.
Рабочий приём — debounce 1–3 секунды: копим текст в буфер чата, затем одним запросом отдаём в ядро. Параллельно храним историю в БД (роли user/assistant), иначе модель «забывает» вчерашний торг.
4. RAG по прайсам: откуда берутся точные цифры
«Просто закинуть прайс в промпт» ломается на 50+ позициях и частых обновлениях. Нормальная схема:
- Нормализуете Excel/PDF в карточки товаров (название, артикул, цена, условия).
- Индексируете (эмбеддинги / поиск по ключам / гибрид).
- На каждом ходе модели подмешиваете только релевантный фрагмент — не весь каталог.
- Жёстко запрещаете выдумывать цену, если в выдаче RAG пусто: модель обязана уточнить позицию.
Отдельно — политика скидок: max %, условия, когда звать человека. Иначе ИИ «подарит» 40% на первом же торге.
5. Воронка и инструменты (tools), а не «свободный чат»
Хороший ИИ-менеджер двигает этапы: квалификация → оффер → возражения → контакт → handoff. Технически это:
- состояние клиента в БД (
stage,needs_human,target_done); - детектор намерения («РОП», «аудит», «дорого»);
- tools вроде «зафиксировать телефон», «подтвердить выезд/созвон» с валидацией полей;
- уведомление в Telegram собственнику, когда появился контакт или критичный слив.
6. Что обычно ломается у «самосборщиков»
- Нестабильный HTTPS → Avito отваливает webhook, ночные чаты молчат.
- Нет идемпотентности → двойные ответы, бан за спам в восприятии клиента.
- Нет RAG → галлюцинации по цене и срокам.
- Один промпт на все ниши → сливает B2B так же, как розницу.
- Нет handoff → горячий лид «варится» в боте, пока конкурент уже на линии.
7. Сколько это стоит по времени
Опытному инженеру — от нескольких вечеров на «демо в Telegram» до 2–4 недель на устойчивый контур Авито+CRM+отчёты. Собственнику без выделенного разработчика это обычно дороже, чем внедрение под ключ: пока собираете, заявки продолжают остывать.
Практический вывод: разберитесь в архитектуре, чтобы контролировать подрядчика — и заказывайте сборку тем, кто уже гоняет это в проде. Базовый ориентир по продуктам — на странице тарифов.