К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/chains-course-recipe.mdиндекс документации — /llms.txt

Курс в цепочке сообщений

Обновлено

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

Правило шага: 3 перехода и 1 цель

У каждого шага цепочки не больше трёх кнопок перехода на другие шаги (deeplink_buttons) и одной кнопки цели (button_target) — ссылки на страницу, бота или мини-приложение. Так цепочку легче пройти, а курсу хватает: «дальше», «повторить» и «в меню» помещаются в три перехода.

Четвёртый переход отклоняется с кодом CHAIN_STEP_TOO_MANY_TRANSITIONS. Исправление: разбейте выбор на два шага или вынесите один из вариантов в кнопку цели. Шаг, сохранённый до появления правила, уходит клиентам как есть; его по-прежнему можно выключить, удалить и править, а предел проверяется только при изменении самих переходов.

После нажатия на карточке остаётся только выбранный переход (зелёный «✅ название»); остальные варианты исчезают. Кнопка цели остаётся без изменений.

Какая бывает форма курса

  • Линейный курс. Урок 1 → урок 2 → урок 3 → финал. Порядок гарантирует, что предыдущее пройдено.

  • Ветвление со слиянием. Урок 1 → урок 2.1 или урок 2.2 (по выбору читателя) → урок 3. Обе ветки обязаны сходиться в общем шаге.

  • Дожим. Если читатель не нажал «дальше», таймаут шага (timeout_minutes и timeout_next_step_id) сам ведёт его к следующему уроку.

Всё сложнее — вложенные модули, меню курса с отметками «пройдено», свободный порядок уроков — в чате не строится.

Меню и прогресс живут на странице курса

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

Как собрать

  1. create_message_chain — создайте цепочку и запомните её id.

  2. create_chain_step для каждого урока — текст или медиа урока в content.

  3. list_chain_steps — возьмите id шагов.

  4. update_chain_step для каждого урока: переходы в deeplink_buttons, кнопка «Все материалы» в button_target, таймаут дожима. Уроки-входы отметьте is_entry_point.

  5. get_chain_step — проверьте шаги после сборки и отдайте владельцу готовую entry_url.