Паспорт проекта · ПП-01/2026Передаточный документ

Voronkabot отчёты из таблицы в Telegram

Сервис, который каждый вечер превращает план-факт из Google-таблицы клиента в аккуратные визуальные карточки и присылает их команде в Telegram — общую и персональную на каждого менеджера.

Продукт
Voronkabot, MVP-1
Статус
В эксплуатации
Дата паспорта
12 июля 2026
Адрес
voronkabot.standetagidev.ru
Стек
Django 5 · PostgreSQL 16 · Docker
Первый клиент
ЖК «Аура на Боевой»
01

Назначение

Отделы продаж ведут план-факт в Google-таблицах: планы на месяц, ежедневные цифры по стадиям воронки, конверсии. Таблица живёт и наполняется — но чтобы команда её увидела, кто-то должен открыть её, всмотреться и пересказать остальным.

Voronkabot убирает этот ручной шаг. Он читает таблицу сам, собирает из неё компактный визуальный отчёт и приносит его туда, где команда уже находится — в Telegram-чат. В назначенное время или мгновенно по команде /report.

Формула ценности: клиент продолжает вести привычную таблицу и не меняет ни одного процесса. Всё новое — то, что каждый вечер в чате появляется готовый отчёт, который раньше нужно было собирать руками.
02

Возможности

Отчёт

Карточка дня

События по 8 стадиям воронки — всего, собственные / агентские и % плана; договоры и выручка дня; блок «Закрыли договоры» — кто, сколько, на какую сумму; конверсии план/факт с дельтой; накопительный итог месяца с трендом.

Отчёт

Персональные отчёты

Один альбом: общая карточка плюс карточка на каждого менеджера с его личными цифрами и конверсиями. Менеджеры видят себя, руководитель — всех.

Доставка

Расписание + по запросу

Автоотправка в заданное время (у каждого клиента — своё). Команда /report в чате отдаёт свежий отчёт за секунды. Повторная отправка за день исключена — защита от дублей встроена.

Управление

Админка

Современный веб-интерфейс: дашборд со статусами отправок за сегодня, клиенты, подключения, расписания. Кнопка «Отправить отчёт сейчас» — без командной строки.

Масштаб

Мультиклиентность

У каждого клиента — собственный Telegram-бот и своя таблица. Один сервис обслуживает всех: боты работают через webhook, новых процессов и серверов под клиента не нужно.

Надёжность

Журналы и снапшоты

Каждая отправка фиксируется в логе доставки; распарсенные данные каждого отчёта сохраняются снапшотом — основа будущей сводной аналитики по всем клиентам. Токены ботов хранятся в зашифрованном виде.

03

Как это работает

Google Sheetsтаблица клиента по эталонному шаблону
Парсерчитает лист месяца, собирает стадии, менеджеров, конверсии
Рендеркомпактные PNG-карточки, светлая типографика
Telegramальбом в чат клиента от его собственного бота

Робот заходит в таблицу под сервис-аккаунтом Google, которому клиент один раз выдал доступ на чтение. Имя листа определяется автоматически по текущему месяцу («Июль 26»), колонка дня — по дате. Никакого вмешательства в таблицу: только чтение.

04

Состав системы

КомпонентРольСтатус
Веб-приложениеАдминка, приём Telegram-webhook, HTTPS через Caddyработает
База данныхКлиенты, подключения, расписания, журналы, снапшотыработает
ПланировщикПроверка расписаний каждые 5 минут, идемпотентная отправкаработает
Парсер + рендерЯдро: таблица → структура → PNG. Покрыт автотестами на реальных данныхработает
Эталонный шаблонГотовая Google-таблица: клиент копирует, вписывает менеджеров и планыопубликован
Инструкция онбордингаЧек-лист подключения из 10 пунктов + разбор частых проблемготова
05

Ключевые цифры

15 минподключение нового клиента по чек-листу
1+9карточек в альбоме: общая + до 9 персональных
16автотестов на парсер — самый ответственный узел
0изменений в процессах клиента — таблица остаётся его
06

Подключение клиента

  1. Копия шаблона

    Клиент делает «Файл → Создать копию» эталонной таблицы, вписывает менеджеров и планы месяца.

  2. Доступ роботу

    Шарит таблицу на сервис-аккаунт (адрес — в инструкции), права «Читатель».

  3. Свой бот

    Создаёт бота у @BotFather за две минуты, добавляет его в группу отчётов.

  4. Три записи в админке

    Подключение (ID таблицы) → Назначение (токен + чат) → Задание (время отправки). Webhook регистрируется кнопкой.

  5. Проверка

    «Отправить отчёт сейчас» из админки — в группе появляется альбом. Готово: дальше всё по расписанию.

07

Направления развития

ЭтапСодержаниеСтатус
MVP-2Алерты команде об ошибках доставки; проверка структуры таблицы с понятной диагностикой; автосоздание листа нового месяцаплан
MVP-3Сводная аналитика по накопленным снапшотам: динамика клиентов, сравнение периодов, выгрузкиплан
Профили парсераПоддержка альтернативных структур таблиц — расширение на клиентов с другими шаблонамиплан