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

Для 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.

ТемаПример названияЧто означают цифры
GeneralGeneral (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 в этом месяце впервые.

Как проверить результат

  • Контент отправлен: сообщение осталось в теме, а бот ответил карточкой или меню.

  • Сущность создана: есть карточка или меню; число в названии темы изменилось в пределах минуты.

  • Выдача настроена: в меню товара вместо «Доставка: ⚪ не настроена» стоит ссылка «Доставка контента ↗».

  • Покупатель получил: ищите факт в заказе или в теме клиента Открытых линий.