Инструкция как настроить еженедельный отчёт по задачам из Бипиума в Telegram

Оглавление

Настройте сценарий, который выберет задачи, созданные за отчётную неделю, посчитает их по статусам и отправит сводку в Telegram. В сообщении будут период, общее число задач и разбивка на новые, находящиеся в работе, готовые и отменённые. Сценарий берёт статус каждой записи на момент чтения. Поэтому число в строке «Готовые» показывает, сколько задач из недельной выборки сейчас имеют этот статус.

Подготовьте каталог задач и чат

Проверьте, что в каталоге задач есть дата создания и статус. Сверьте значения статуса с теми, которые будете считать: «Новая», «В работе», «Готовая» и «Отменённая». Если в вашем каталоге значения отличаются, сопоставьте их со строками будущего отчёта. Для сводки из чисел достаточно даты создания и статуса. В демонстрационную выборку также включена тема, но в сообщении темы отдельных задач не нужны.

Подготовьте токен Telegram-бота и идентификатор чата, куда он будет отправлять отчёт. Для первого теста используйте личный диалог: откройте бота и запустите его. Если отчёт нужен всей команде, настройте отправку в групповой чат и проверьте её отдельным тестом. Сохраните токен в отдельной записи с ограниченным доступом и получайте его из сценария при запуске.

На проверку редактору: добавить подтверждённый способ получения ID чата и настройки доступа к записи с токеном. Сверить порядок подключения бота к групповому чату.

Рассчитайте отчётный период и выберите задачи

В начале сценария вычислите границы недели. Определите, с какого дня она начинается, в каком часовом поясе задаются границы и включает ли отчёт всю неделю или только время до запуска. Если отправка происходит до окончания последнего дня недели, задачи, созданные после запуска, в этот отчёт не попадут. Для полной недели удобно отбирать записи от её начала включительно до начала следующей недели исключительно.

В шаге получения записей примените фильтр по дате создания. Сохраните найденные задачи и их общее число для следующих шагов. Проверьте, что в подсчёт поступают все записи за период. Если компонент возвращает только часть результатов, настройте получение остальных до формирования сообщения.

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

Посчитайте задачи по статусам и соберите сообщение

Задайте по одному счётчику на каждый статус. Начните с нуля. Для каждой найденной задачи прочитайте её статус и увеличьте соответствующий счётчик на единицу. Если в каталоге возможны пустые или дополнительные статусы, заранее решите, как они будут отражены в отчёте. Например, вынесите их в строку «Другие», чтобы разбивку можно было сверить с общим числом задач. Такая строка — вариант для расширения настройки.

Сформируйте текст сообщения: укажите границы недели, общее число задач и число записей по каждому статусу. Дайте сообщению однозначный заголовок, например «Задачи, созданные за неделю». Если для заголовка и подписей используете жирный шрифт или курсив, соберите текст с HTML-разметкой.

Отправьте отчёт веб-запросом и проверьте результат

Получите токен из отдельной записи. В компоненте веб-запроса вызовите метод sendMessage Telegram Bot API. Передайте идентификатор чата в chat_id, подготовленный отчёт — в text. Для текста с HTML-разметкой укажите parse_mode=HTML. Если передаёте параметры в URL, закодируйте их значения, чтобы переносы строк и специальные символы не нарушили запрос. Параметры для редакторской сверки: справочник Telegram Bot API.

До подключения расписания запустите сценарий отдельно. В демонстрации для этого использован внешний запрос. Откройте нужный чат и проверьте период, общее число и разбивку по статусам. В Бипиуме примените тот же фильтр по дате создания и сравните цифры. В демонстрационном прогоне отчёт показал 16 задач; отдельно сверили, что одна из них отменена. Для своей проверки также возьмите записи на границе периода и убедитесь, что они попадают в нужную неделю.

На проверку редактору: подтвердить настройки веб-запроса, способ тестового запуска и место, где можно посмотреть ответ Telegram при ошибке. Справочник API в ходе подготовки открыть не удалось.

Подключите еженедельный запуск

Создайте планировщик, привяжите к нему сценарий и задайте день, время и часовой пояс запуска. Согласуйте расписание с формулой периода. Например, если отчёт уходит после закрытия недели, сценарий должен выбрать завершившуюся неделю. Если сводка нужна до конца последнего рабочего дня, укажите в сообщении, до какого момента собраны данные.

Дождитесь первого запуска по расписанию и проверьте, что отчёт пришёл в нужный чат за ожидаемый период. Это отдельная проверка: пробная отправка подтверждает расчёт и доставку, а запуск по расписанию — ещё и работу планировщика.

Посмотреть настройку на Бипиум Хабе:

‍

November 20, 2026
Антонова Елизавета

Узнайте, подходит ли вам решение