Telegram Checklists — чеклисты в Bot API от имени business account

Чеклисты в Telegram Bot API — это нативные интерактивные списки задач, которые бот может отправить и редактировать от имени подключенного business account. Удобный инструмент для брифов, тикетов, контроля публикаций и точечной работы с клиентами без сторонних бот-конструкторов.

Что это такое

Чеклисты появились в Telegram летом 2025 года как Premium-функция для пользователей, а в Bot API — как отдельные методы для бизнес-ботов. В отличие от ToDo-ботов с inline-кнопками, это родной тип сообщения: список задач с галочками, который собеседник видит как полноценное сообщение, а не как набор приклеенных кнопок.

Главный нюанс: отправлять и редактировать чеклисты бот может только в режиме business connection. То есть от имени подключенного к боту бизнес-аккаунта Telegram, а не от собственного имени бота.

Основные возможности

Что нужно перед началом

1. Telegram Premium у владельца бизнес-аккаунта — без него Business-режим в Telegram недоступен.
2. Бот, привязанный к бизнес-аккаунту через настройки Telegram Business → Chatbots.
3. Включенные права для бота: чтение сообщений и отправка от имени бизнес-аккаунта.
4. Обработчик webhook или long polling, который ловит апдейт business_connection и сохраняет business_connection_id — без него ни один из методов чеклиста не сработает.

Метод sendChecklist

Базовый набор параметров:

{
  "business_connection_id": "AAAAAA-...",
  "chat_id": 123456789,
  "checklist": {
    "title": "Бриф на статью",
    "tasks": [
      { "id": 1, "text": "Согласовать тему" },
      { "id": 2, "text": "Подготовить outline" },
      { "id": 3, "text": "Написать черновик" }
    ],
    "others_can_add_tasks": true,
    "others_can_mark_tasks_as_done": true
  }
}

Ключевые правила:

• business_connection_id обязателен. Обычные сообщения от собственного имени бота сюда не подходят.
• chat_id принимает только числовой идентификатор. @username через этот метод не работает.
• id каждой задачи — уникальное положительное число. По нему вы потом найдёте задачу при редактировании.
• others_can_add_tasks и others_can_mark_tasks_as_done по умолчанию false. Для совместных списков их нужно явно включить.

Метод editMessageChecklist

Используется для замены чеклиста в уже отправленном сообщении: можно поменять заголовок, добавить или удалить задачи, переключить права на совместную работу. Структура та же — business_connection_id, chat_id, message_id и новый объект InputChecklist.

Практическое следствие: вам не нужно удалять старый чеклист и слать новый. Всё, что меняется внутри одного процесса (например, появился новый этап в редакционной цепочке), удобно делать через editMessageChecklist поверх того же сообщения.

События от чеклиста

Бот получает два дополнительных типа апдейтов:

• checklist_tasks_added — кто-то добавил задачу.
• checklist_tasks_done — кто-то отметил задачу выполненной или, наоборот, снял отметку.

Этого достаточно, чтобы повесить на чеклисты автоматизацию: уведомления в общий чат, синхронизацию с Notion или CRM, изменение статуса карточки на бэкенде, запуск следующего этапа пайплайна.

Тарифы и лимиты

Практические сценарии

Бриф на контент

Менеджер ведёт переписку с клиентом в личке бизнес-аккаунта, а бот присылает чеклист с пунктами брифа: тема, целевая аудитория, ключевые тезисы, дедлайн. Клиент отмечает галочками подтверждённое, и сразу видно, где он застрял.

Контроль редакционного процесса

Один чеклист на статью с этапами: тема согласована → outline готов → черновик → правка → обложка → публикация. Бот ловит checklist_tasks_done и автоматически меняет статус карточки в Notion CMS — без ручного переключения.

Тикеты и заявки клиентов

Поддержка в Telegram-аккаунте бизнеса: бот превращает каждое обращение в чеклист с шагами решения. Клиент видит прогресс прямо в чате, без отдельного CRM-портала и логинов.

Чеклисты для подрядчиков

Дизайнер, монтажёр, копирайтер получают список того, что нужно сдать. Каждый отмечает выполненное — менеджер видит готовность сразу в Telegram, а не в почте и трёх досках одновременно.

Внутренние ритуалы команды

Утренний стендап, чек-лист релиза, шаги онбординга нового сотрудника. Чеклист живёт в командном чате, добавлять задачи могут все, и история отметок остаётся прямо в сообщении.

Антипаттерны

• ❌ Использовать чеклист как полноценный таск-трекер. 30 пунктов кончаются быстро, комментариев и истории нет — это формат для одной итерации, а не для вечного бэклога.
• ❌ Пытаться отправить чеклист от имени бота без настройки business connection. Метод вернёт ошибку.
• ❌ Передавать chat_id строкой с @username. Только числовой ID.
• ❌ Забывать про others_can_mark_tasks_as_done. Без этого флага получится список «только для чтения», и клиент не сможет ничего отметить.
• ❌ Дёргать id задач случайно из Math.random(). Используйте монотонный счётчик или хеш — иначе при редактировании будет каша.

Чеклист быстрой проверки перед запуском

Ссылки

• Официальная документация Bot API: core.telegram.org/bots/api
• Анонс чеклистов от Telegram: telegram.org/blog/checklists-suggested-posts
• Раздел Business в Telegram API: core.telegram.org/api/business
• Описание метода sendChecklist со списком параметров: gramio.dev/telegram/methods/sendChecklist

По теме

• Статья: Мои закладки больше не умирают: как Notion-агент заменил мне 80% работы над контентом
• Блог: Notion MCP теперь умеет работать с записями встреч
• База знаний: Tribute — бот для монетизации Telegram-каналов и чатов

Чеклисты в Telegram — маленький кирпич, но в связке с Notion и автоматизациями он закрывает половину рутинных согласований с клиентами и подрядчиками. Если интересно, как такие штуки встраиваются в реальный контент-конвейер или клиентский процесс — напишите, обсудим вашу задачу.

📢 Telegram-канал: t.me/pimenov_ru · ✉️ Личка: t.me/pimenov