Для AI-агентов: markdown этой страницы — /docs/telegram-workspace.mdиндекс документации — /llms.txt
Работа в Telegram
Обновлено
Рабочее место владельца и операторов TelegaFirst живёт в Telegram: три супергруппы с включёнными «Темами». В одной вы ведёте диалоги с клиентами, в другой настраиваете каталог и знания, в третьей обрабатываете заказы и оплаты. Этот раздел объясняет, что где находится и что происходит, когда вы пишете в тему или отвечаете на карточку.
Операторская часть работает только в Telegram, какие бы мессенджеры ни использовали ваши клиенты: покупатели могут писать боту из Telegram, MAX или VK, а владелец и операторы всегда отвечают из своих Telegram-групп. Подключение групп описано в начале работы, диалоги с клиентами — в Открытых линиях.
Три группы и их роли
| Группа | Для чего | Что внутри |
|---|---|---|
| Открытые линии | Диалоги с клиентами | Тема «General» и отдельная тема на каждого клиента. Здесь вы видите ответы AI, перехватываете разговор и возвращаете его AI |
| Настройки | Настройка бизнеса прямо перепиской | Темы: Каталог, Статусы заказов, База знаний (Менеджер и Коуч), Поддержка, Аналитика, Маркетинг, Рассылки, Цепочки сообщений, Онлайн-запись, События, Уведомления, а также «General» |
| Операторская | Работа с заказами и оплатами | Темы: Заказы, Платежи, Обращения, Активные чаты, Заявки, а также «General» |
Подробности по группам: общие действия в темах, группа Настроек, Операторская, Открытые линии.
Кто есть кто
Клиент вашего бизнеса (конечный пользователь) пишет вашему боту в личной переписке. Он не видит ваших групп.
Владелец подключает группы и управляет бизнесом. Подключить группу может только владелец, нажав свою ссылку подключения.
Оператор работает в группах: отвечает клиентам, обрабатывает заказы. Что именно ему разрешено, определяют права из настроек команды.
Доступ к группе определяется участием в ней: добавляйте в группу Настроек только тех, кому доверяете менять каталог, статусы и базу знаний.
Как группы подключаются и как их отличить
Для каждой роли онбординг выдаёт одноразовую ссылку подключения, действующую 24 часа. Владелец открывает её в Telegram, выбирает или создаёт группу с включёнными «Темами» и оставляет боту предложенные права администратора. Группы можно подключать в любом порядке. Когда подключена третья группа, платформа добавляет ботов и готовит темы: это может занять несколько минут.
Названия готовых групп начинаются с адреса вашего бизнеса: «адрес · Открытые линии», «адрес · Настройки», «адрес · Операторская». Если у вас несколько бизнесов, по адресу в начале названия видно, какому из них принадлежит группа. Проверяйте его перед тем, как писать в группу.
Бот отказывает в подключении понятным сообщением, если «Темы» не включены, у бота не хватает прав, группа уже подключена к другой роли или ссылка устарела. Исправьте причину и нажмите ту же ссылку снова либо возьмите новую в онбординге.
Карта тем
Таблица показывает, что произойдёт в каждой теме. «Сообщение» — обычное сообщение без ответа, «Ответ» — сообщение в формате reply на карточку, «/menu» — команда меню без ответа. Столбец «/menu + ответ» относится к ответу командой на карточку или сообщение, которое тема зарегистрировала.
Группа Настроек
| Тема | Сообщение | Ответ | /menu | /menu + ответ |
|---|---|---|---|---|
| General | Рабочих действий нет; в названии темы счётчики AI | Нет | Нет | Нет |
| Каталог | Создаёт товар | Задаёт выдачу товара | Общее меню темы | Меню этого товара |
| Статусы заказов | Создаёт статус | Создаёт статус, копируя настройки статуса, на который вы ответили | Общее меню темы | Карточка настройки статуса |
| База знаний: Менеджер, Коуч | Текст, голос или кружок попадают в базу знаний соответствующего AI | Управление записью | Общее меню темы | Минимальное меню |
| Поддержка | Вопрос AI-ассистенту | Как сообщение | Общее меню темы | Минимальное меню |
| Аналитика | Вопрос AI-аналитику | Как сообщение | Общее меню темы | Минимальное меню |
| Маркетинг | Название новой кампании | Задаёт контент доставки кампании | Общее меню темы | Статистика кампании |
| Рассылки | Название новой рассылки (черновик) | На пустую карточку: содержимое рассылки; на карточку с содержимым: копия рассылки | Общее меню темы | Пересоздаёт карточку рассылки |
| Цепочки сообщений | Добавляет шаг в цепочку | Тоже добавляет шаг | Минимальное меню | Меню шага |
| Онлайн-запись | Ресурс создаёт агент, а не сообщение человека | Не создаёт ресурс | Минимальное меню | Минимальное меню |
| События | Создаёт событие | Обновляет содержимое события | Минимальное меню | Минимальное меню |
| Уведомления | Лента автоматических уведомлений | Нет | Нет | Нет |
Операторская
| Тема | Сообщение | Ответ | /menu | /menu + ответ |
|---|---|---|---|---|
| General | Рабочих действий нет; в названии темы счётчики аудитории | Нет | Нет | Нет |
| Заказы | Карточки заказов появляются сами | Заметка к заказу | Инструкция темы | Инструкция темы |
| Платежи | Платежи появляются сами; ваши сообщения удаляются | Нет | Инструкция темы | Меню платежа |
| Обращения | Обращения появляются сами; ваши сообщения удаляются | Нет | Инструкция темы | Инструкция темы |
| Активные чаты | Карточки сессий появляются сами | Нет | Инструкция темы | Инструкция темы |
| Заявки | Заявки с сайта появляются сами; ваши сообщения удаляются | Нет | Инструкция темы | Инструкция темы |
Открытые линии
| Тема | Сообщение | Ответ | /menu | /menu + ответ |
|---|---|---|---|---|
| General | Рабочих действий нет, меню открывается в теме клиента | Нет | Подсказка открыть меню в теме клиента | Нет |
| Тема клиента | Уходит клиенту в его канал | Ответ на конкретное сообщение клиента | Меню клиента | Контекстное меню сообщения |
Ячейка «Нет» означает, что платформа в этой теме не выполняет отдельного действия; она не обещает, что сообщение будет сохранено или показано как-то особо.
Любая команда, кроме /menu, в темах Настроек не выполняется, а само сообщение с командой удаляется. В темах Поддержка и Аналитика команды, кроме /menu, не обслуживаются.
Что показывают цифры в названии темы
Названия многих тем несут живые счётчики, например «Заказы (⏳2/💬5)». Что означает каждая цифра, видно в инструкции темы по команде /menu. Описание по темам: Настройки и Операторская. Темы Операторской обновляют название за несколько секунд, остальные раз в минуту.
С чего начать
Откройте нужную группу и тему из таблицы выше.
Нажмите команду
/menuили ответьте ей на карточку: вы увидите инструкцию темы и доступные кнопки.Выполняйте действие и проверяйте результат по карточке, названию темы или сообщению бота. Для каждого действия страницы этого раздела дают пару «сделайте, увидите».
Те же настройки можно выполнять через собственного AI-агента: он публикует карточки в те же темы тем же способом. Работа через агента описана в MCP-руководстве.