# Общие действия в темах Telegram Source: Locale: ru releaseGitSha: fc570c76ffc9cb87e2462d45b14f5c1b52fbaf0d sourceContentDigest: d34b58bc82e05a17e0f471c883cdae8e78513921501dc4dedeb54be8b1bd6285 Version: 1 Здесь описаны действия, одинаковые для многих тем: как вызвать меню, чем общее меню отличается от контекстного, как заменить карточку, что происходит с альбомом и что делать, если меню не открылось. Карта тем и групп — в разделе [Работа в Telegram](https://telegafirst.com/docs/telegram-workspace). Особенности конкретных тем — в [группе Настроек](https://telegafirst.com/docs/telegram-settings) и [Операторской](https://telegafirst.com/docs/telegram-operations). ## Как вызвать команду Команда — обычное сообщение, начинающееся с `/`. Главная команда рабочих групп — `/menu`. Telegram может дописать к ней имя бота, например `/menu@имя_бота`: это то же самое. В темах группы Настроек любая команда, кроме `/menu`, не выполняется, а сообщение с ней удаляется. В темах Поддержка и Аналитика команды, кроме `/menu`, не обслуживаются. В теме «General» Открытых линий команда подскажет, что меню открывается в теме клиента. Сделайте: напишите `/menu` в теме. Увидите: бот отвечает на вашу команду сообщением с инструкцией темы и кнопкой «Закрыть меню». Сама команда после обработки удаляется. ## Общее меню темы и контекстное меню У `/menu` два режима. | Как вы её отправили | Что открывается | Пример | | - | - | - | | Без ответа на сообщение | Общее меню темы: инструкция, расшифровка цифр из названия темы, кнопка «Закрыть меню». В теме Каталог в него входят кнопки сброса кэша и синхронизации с платёжными провайдерами | `/menu` в теме Заказы | | Ответом на карточку или сообщение, которое тема зарегистрировала | Контекстное меню этой сущности | `/menu` ответом на карточку товара открывает меню товара | Контекстное меню открывается только на **зарегистрированном** источнике: карточке или сообщении выдачи, которое платформа знает как часть товара, статуса, кампании, рассылки, шага цепочки, события или платежа. Ответ командой на любое другое сообщение контекстного меню не откроет. Не рассчитывайте, что любая команда или любое сообщение в любой теме откроет контекст. Поведение исключений: * В теме Заказы команда `/menu` всегда показывает общую инструкцию, даже если отправлена ответом на карточку заказа: действия с заказом выполняют кнопки на самой карточке. * В теме Платежи ответ командой на платёж открывает меню платежа; если сообщение не является известным платежом, команда удаляется без меню. * В темах События, Онлайн-запись и обоих базах знаний специального меню нет: открывается минимальное меню с инструкцией и кнопкой закрытия, а ответ на сообщение сначала проверяется на принадлежность сущности. ## Закрытие и замена меню Меню одиночное: когда вы открываете новое, прежнее заменяется. Кнопка «Закрыть меню» удаляет меню, а у общего меню заодно и команду, которой вы его вызвали. ## Карточка и выдача: две разные вещи Во многих темах у одной сущности есть два сообщения: * **Карточка** — то, что видят в теме и (для товара) покупатель в каталоге. * **Выдача** — то, что получает покупатель после действия: оплаты, регистрации, запроса. Выдача задаётся **ответом** на карточку. Выдача заменяет предыдущую: прежнее сообщение выдачи удаляется, ссылка обновляется. Не путайте четыре состояния: контент отправлен в тему, сущность создана и привязана к нему, выдача настроена и покупатель её получил. Первые три видны в теме и в меню, четвёртое подтверждает только факт доставки покупателю. ## Альбом — одна сущность Альбом из нескольких фото или файлов платформа считает одним целым. Из альбома создаётся один товар, один статус, одна выдача. Контекстное меню можно открыть ответом команды на любое сообщение альбома. Удаление и замена затрагивают весь альбом. ## Изменение, замена и удаление * **Изменение.** Если вы отредактируете в Telegram своё сообщение с карточкой, платформа обновит сохранённый текст и описание. Редактировать можно только то, что отправили вы сами. * **Замена.** Telegram не позволяет редактировать чужие сообщения, поэтому карточку, отправленную другим оператором, агентом или сервисом, сначала заменяют. В меню есть кнопка «Заменить карточку». Нажмите её и ответьте на карточку новым сообщением: оно станет новой карточкой, старая удалится, а вы станете автором. Другой оператор в это время не может редактировать ту же карточку: его сообщения удаляются, а на меню появляется отметка, кто сейчас редактирует. Отменить замену можно кнопкой отмены, если она показана. * **Удаление.** Удалять сущности нужно кнопками меню: удаление просит подтверждения вторым нажатием («Удалить» или «Оставить»). Удаление сообщения в Telegram само по себе не заменяет эту кнопку. ## Если у сообщения нет сущности Бывает, что в теме остаётся сообщение, за которым уже нет ни товара, ни статуса, ни другой сущности. Если вы ответили на него командой `/menu`, платформа различает четыре исхода: | Исход | Что делает платформа | Что вы видите | | - | - | - | | Сущность найдена | Открывает её меню | Контекстное меню | | Сущности нет, и это доказано | Удаляет такое сообщение (весь его альбом), вашу команду и прежнее меню, затем открывает общее меню темы | Тема очищена, общее меню без ответа | | Публикация ещё идёт | Ничего не удаляет, удаляет только вашу команду, отвечает подсказкой подождать несколько секунд | Подсказка «Карточка ещё публикуется, повторите через несколько секунд» | | Проверить не удалось | Ничего не удаляет, удаляет только вашу команду, отвечает подсказкой повторить | Подсказка «Не удалось проверить карточку, повторите» | Так вы не потеряете живую карточку из-за сбоя проверки. Исход «сущности нет» применяется в темах Каталог, Статусы заказов, Маркетинг, Рассылки, Цепочки сообщений, События, Онлайн-запись и в обеих базах знаний. Удаляется только сообщение в Telegram; сохранённый материал карточки в базе остаётся. ## Ручной путь и путь через агента Тот же результат даёт ваш AI-агент через Hub и MCP: он публикует карточку в нужную тему через ту же последовательность действий, что и человек. Отличия: * карточку агента публикует служебный аккаунт, поэтому меню товара открывается на ней **без имени оператора**, когда создание завершено; * чтобы редактировать такую карточку вручную, сначала замените её кнопкой «Заменить карточку»; * если меню на карточке агента не открылось, ответьте `/menu` на карточку: сущность уже создана. Какими инструментами агент управляет темами, описано в [руководстве по MCP](https://telegafirst.com/docs/mcp-guide). ## Картинка, видео и документ без подписи В теме Каталог подпись обязательна: название товара берётся из подписи или текста. Фото, видео, документ, аудио, анимация и голосовое без подписи товар не создают: бот отвечает одной подсказкой («Добавьте название товара в подпись к сообщению и отправьте его снова»). Имя файла названием не становится. Стикер игнорируется без ответа. Сообщение со ссылкой-кнопкой нельзя поставить на карточку товара. Отправьте карточку без кнопки, а кнопку-ссылку добавьте в выдачу ответом на карточку.