← Блог · Архитектура · 18.11.2026

Как самостоятельно настроить ИИ-менеджера для Авито и Telegram: пошаговый разбор архитектуры и API

Ниже — честная схема «как это устроено в бою». Если после чтения станет ясно, что вам нужен не pet-проект, а рабочий контур — это и есть цель статьи.

1. Карта системы (что реально нужно)

Минимальный боевой контур состоит не из «чат с ChatGPT», а из пяти слоёв:

  1. Каналы — Авито Messenger API и Telegram Bot API (входящие события).
  2. Транспорт — публичный HTTPS endpoint (webhook), быстрый ответ 200 и фоновая обработка.
  3. Диалоговое ядро — профиль ниши, этапы воронки, политика дожима, handoff человеку.
  4. Знания — RAG/поиск по прайсу, PDF, FAQ, ограничения скидок.
  5. Наблюдаемость — логи, уведомления о лидах, вечерние сводки собственнику.

Пропуск любого слоя даёт типичный провал: бот «умничает», но не берёт телефон, отвечает на половину реплики или теряет ночные сообщения.

2. Вебхуки: почему без них ночные заявки мертвы

Авито

Авито шлёт события на ваш URL (например POST /webhooks/avito). Важно:

Telegram

Через Bot API: либо long polling (проще для теста), либо webhook на тот же сервер. В продакшене webhook предпочтительнее: меньше задержек и проще горизонтально контролировать.

Ошибка новичка — два независимых «бота» с разным промптом. Правильно: один профиль продажника, разные channel + external_id чата.

3. Склейка сообщений (debounce): клиенты пишут «рвано»

Человек на Авито часто шлёт 3–5 коротких реплик подряд: «привет», «есть в наличии?», «а доставка?». Если отвечать на каждую — диалог превращается в кашу, а токены сгорают зря.

Рабочий приём — debounce 1–3 секунды: копим текст в буфер чата, затем одним запросом отдаём в ядро. Параллельно храним историю в БД (роли user/assistant), иначе модель «забывает» вчерашний торг.

4. RAG по прайсам: откуда берутся точные цифры

«Просто закинуть прайс в промпт» ломается на 50+ позициях и частых обновлениях. Нормальная схема:

  1. Нормализуете Excel/PDF в карточки товаров (название, артикул, цена, условия).
  2. Индексируете (эмбеддинги / поиск по ключам / гибрид).
  3. На каждом ходе модели подмешиваете только релевантный фрагмент — не весь каталог.
  4. Жёстко запрещаете выдумывать цену, если в выдаче RAG пусто: модель обязана уточнить позицию.

Отдельно — политика скидок: max %, условия, когда звать человека. Иначе ИИ «подарит» 40% на первом же торге.

5. Воронка и инструменты (tools), а не «свободный чат»

Хороший ИИ-менеджер двигает этапы: квалификация → оффер → возражения → контакт → handoff. Технически это:

6. Что обычно ломается у «самосборщиков»

7. Сколько это стоит по времени

Опытному инженеру — от нескольких вечеров на «демо в Telegram» до 2–4 недель на устойчивый контур Авито+CRM+отчёты. Собственнику без выделенного разработчика это обычно дороже, чем внедрение под ключ: пока собираете, заявки продолжают остывать.

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