Для AI-агентов: markdown этой страницы — /docs/telegram-settings.mdиндекс документации — /llms.txt
Группа Настроек в Telegram
Обновлено
Группа Настроек — место, где вы настраиваете бизнес обычными сообщениями: отправляете карточку, и платформа создаёт товар, статус, кампанию или запись в базе знаний. Каждая тема отвечает за свою часть. Общие приёмы (меню, ответ на карточку, замена, альбом) описаны в общих действиях, карта групп — в разделе Работа в Telegram.
Для каждой темы ниже указано: что отправить, что обязательно, что делает ответ, где настройки и как проверить результат. Те же сущности можно создавать через собственного AI-агента: он публикует карточки в эти же темы.
Каталог
Создать товар. Отправьте в тему сообщение без ответа: текст, фото, видео, документ или альбом. Название товара берётся из первых десяти слов текста или подписи, всё сообщение становится описанием. Подпись обязательна: фото, видео или документ без подписи товар не создают, бот ответит подсказкой, а имя файла названием не станет.
Сделайте: отправьте фото с подписью «Консультация, 60 минут». Увидите: товар создан, а под карточкой сразу открылось его меню — одно на товар, даже если в сообщении был альбом.
Меню товара. Состояние (неактивен, доступен по прямой ссылке или в каталоге), переключатели «Активен» и «Доступно публично», «Создать заказ», «Отложенная оплата», «Закрытый чат», «Проверка подписки», строка со ссылками «Карточка ↗» и «Доставка контента ↗», «Скопировать ссылку», «Заменить карточку», «Удалить товар» (с подтверждением) и «Закрыть меню». В тексте меню видны тип оплаты и цена. Задать цену и тип можно в кабинете CRM или через агента: каталог и продажи.
Если источника нет, вместо ссылки стоит кнопка «Карточка: ⚪ не найдена» или «Доставка: ⚪ не настроена»: нажмите её и следуйте подсказке. Ссылка без источника не выдумывается. Меню открывается и командой /menu, отправленной ответом на карточку, на сообщение выдачи или на любое сообщение альбома.
Выдача. Ответьте на карточку товара сообщением с тем, что получит покупатель: текст, файл, ссылка, альбом. Прежнее сообщение выдачи заменится. Если у товара был тип по умолчанию, а выдача появилась, он станет цифровым. Если Telegram-сообщение содержит элементы, которые платформа не умеет сохранить, бот ответит подсказкой, а выдача останется прежней. Кнопка-ссылка в сообщении выдачи сохраняется.
Разделяйте четыре ступени: контент отправлен; товар создан и привязан; выдача настроена; покупатель получил. Последнее вы видите по заказу покупателя, а не по карточке.
Статусы заказов
Создать. Любое сообщение в теме создаёт статус. Название — первые десять слов текста или подписи; если название уже есть, добавится «(2)», «(3)». Ответ на существующий статус создаёт новый, скопировав его группу, уведомление покупателю и кнопку.
Сделайте: отправьте «✅ Доставлено». Увидите: ответом приходит карточка настройки статуса.
Настройка. На карточке задаётся группа статуса (в работе, успешно, неуспешно), отправка уведомления покупателю, автоматическое выставление отложенной оплаты, удаление с подтверждением. /menu ответом на карточку открывает эту карточку настройки, /menu без ответа — общее меню темы.
База знаний: Менеджер и Коуч
Тема «База знаний — Менеджер» наполняет знания AI-менеджера, тема «База знаний — Коуч» — знания AI-коуча. Тексты не смешиваются.
Добавить. Отправьте текст (до 4000 символов), голосовое сообщение или кружок. Голос и кружок распознаются, AI оформляет запись. Исходное сообщение заменяется карточкой записи с раскрываемым текстом и кнопкой «Настройки». Слишком длинный текст платформа не принимает: исходное сообщение остаётся, а бот присылает пояснение. Документы не читаются: бот отвечает отказом.
Управление. Кнопка «Настройки» на записи показывает состояние и позволяет отключить запись, включить обратно или удалить с подтверждением. Отключённая запись перестаёт использоваться ответами AI. Количество записей видно в названии темы.
Маркетинг
Создать кампанию. Отправьте текст — это название кампании, оно должно быть уникальным для бизнеса. Платформа покажет два варианта первой ссылки: маркетинговая ссылка и кодовое слово. Выберите один и подтвердите создание. Если кампания с таким названием уже есть, бот предупредит и покажет её карточку, а удалённую кампанию восстановит.
Контент доставки. Ответьте на карточку кампании сообщением: оно станет тем, что получит пришедший по ссылке пользователь. Кнопки на карточке включают и выключают кампанию, показывают, как настроить доставку, и удаляют кампанию (два шага).
Рассылки
Создать черновик. Отправьте текст с названием рассылки без ответа. Создаётся черновик без содержимого. Фото или файл без текста названием стать не могут: такое сообщение удаляется с подсказкой.
Задать содержимое. Ответьте на пустую карточку сообщением с тем, что получат люди. На карточку, где содержимое уже есть, ответ создаёт копию рассылки на её основе.
Запуск. Кнопки на карточке: выбрать аудиторию (сегмент), выбрать цель, отправить тест себе в личную переписку, запустить (с подтверждением), добавить получателей, отменить, повторить неудачную, удалить. Команда /send ответом на карточку запускает рассылку сразу и без подтверждения. Если рассылка в таком состоянии уже не запускается (идёт, завершена, отменена), бот объяснит причину. /menu ответом на карточку пересоздаёт удалённую карточку.
Цепочки сообщений
Любое сообщение в теме, в том числе ответ, добавляет шаг в новейшую цепочку. Альбом даёт один шаг. В ответ приходит карточка «Шаг добавлен» с кнопкой открытия Mini App, где настраиваются связи, задержки и сроки. /menu ответом на шаг открывает его меню, /menu без ответа — минимальное. Карточки, которые уже отправлены покупателям, задним числом не меняются.
Онлайн-запись
Ресурсы (специалисты, залы, оборудование) и их график настраивает ваш AI-агент. Сообщение человека в этой теме новый ресурс не создаёт. Под карточкой ресурса есть кнопка «Заменить карточку»: нажмите её и пришлите новую карточку — фото и текст. /menu открывает минимальное меню.
События
Создать. Отправьте сообщение без ответа. Название — первая строка (до 100 символов). В ответ приходит карточка статистики. Обновить содержимое. Ответьте на карточку новым сообщением: старое удаляется, карточка пересоздаётся.
Кнопки на карточке: скопировать ссылку, показать статус связанных цепочек, открыть события в Mini App, завершить событие (с подтверждением).
Поддержка, Аналитика, Уведомления
Поддержка. Пишите вопросы обычным сообщением, отвечает AI-ассистент платформы. Пока настройка не завершена, он ведёт вас по ней. Предложения, требующие подтверждения, приходят карточкой с кнопками подтвердить и отменить; часть из них подтверждает только владелец.
Аналитика. Спрашивайте про метрики, отвечает AI-аналитик.
Уведомления. Лента системных сообщений платформы: оплаты, заказы, синхронизации. Писать сюда не нужно.
Счётчики в названиях тем
Цифры в названии темы читаются так. Расшифровку показывает /menu.
| Тема | Пример названия | Что означают цифры |
|---|---|---|
| General | General (AI: 👤12 💬87) | 👤 — сколько разных клиентов получили ответ AI в этом месяце; 💬 — сколько ответов AI доставлено |
| Каталог | Каталог [📦8/💳2] | активных товаров / из них подписок |
| Рассылки | Рассылки (👤420/💬460) | получателей / отправленных сообщений за месяц |
| Маркетинг | Маркетинг (👤30/💰5/сумма) [👥2] | привлечено / оплатили / сумма / рефералы второго уровня |
| Цепочки сообщений | Цепочки сообщений (👤40/💬90) | получателей / доставленных сообщений |
| База знаний | База знаний — Менеджер [📚24] | фактов в базе |
| События | События (📅3/👤54) | активных событий / зарегистрировавшихся |
| Поддержка | Поддержка 3/9 🏆2/6 | шаг настройки / достижения |
| Уведомления | Уведомления (остаток/лимит m, пакет m) | токены AI в миллионах |
Счётчик General. Он считает только ответы AI (Квалификатор, Менеджер, Коуч и платформенный Коуч), доставленные клиенту в личной переписке и подтверждённые Telegram. Не считаются: ответы оператора, карточки товаров и вложения, копии сообщений в группе, ответы AI из воронок форм сайта. Период — календарный месяц, в начале месяца счётчик месяца обнуляется. Счётчик меняют только такие доставленные ответы; число обновляется по минутному циклу, поэтому сразу после ответа его может быть не видно, а обычно в течение минуты видно. Названия тем Операторской обновляются быстрее — за несколько секунд.
Сделайте: клиент получает ответ AI. Увидите: обычно в течение минуты 💬 в названии General на единицу больше, а 👤 вырастает, только если этот клиент получал ответ AI в этом месяце впервые.
Как проверить результат
Контент отправлен: сообщение осталось в теме, а бот ответил карточкой или меню.
Сущность создана: есть карточка или меню; число в названии темы изменилось в пределах минуты.
Выдача настроена: в меню товара вместо «Доставка: ⚪ не настроена» стоит ссылка «Доставка контента ↗».
Покупатель получил: ищите факт в заказе или в теме клиента Открытых линий.