Telegram Business co-pilot
Позвольте вашему AI-агенту отвечать на DM в личном аккаунте пользователя Telegram Premium. Их контакты видят то, что выглядит как собственные ответы Premium-пользователя — идеально для основателей, креаторов, соло-предпринимателей и небольших команд, чьим клиентам пишут DM прямо в личный Telegram.
Обзор
Telegram Business co-pilot предоставляет:
- AI-ответы, отправляемые через
business_connectionPremium-пользователя, поэтому ответ выглядит исходящим от него - Привязку для каждого Premium-пользователя — один бот может обслуживать несколько Premium-пользователей в одной организации
- Автоматический manual takeover — когда Premium-пользователь сам печатает ответ, бот ставит этот чат на паузу на скользящее окно, чтобы не говорить поверх живого разговора
- Connection-level kill switch для отключения бота сразу для всех привязанных пользователей без удаления интеграции
- Транскрипцию голосовых заметок и потоковые ответы, как в обычном Telegram-канале
«Premium» здесь относится к уровню аккаунта Telegram-пользователя (подписка Telegram Premium, необходимая для включения Business Mode). Это не ваш план Cuneiform Chat — большинство планов Cuneiform Chat поддерживают эту интеграцию в зависимости от вашего тарифа.
Чем это отличается от обычного Telegram
Обычная интеграция с Telegram подключает агента к inbox самого бота — ваши конечные пользователи пишут боту напрямую по адресу t.me/<bot>. Telegram Business co-pilot — обратный случай: бот отвечает в личном аккаунте человека, перехватывая DM, которые приходят в его обычный список чатов.
| Telegram | Telegram Business co-pilot | |
|---|---|---|
| Кому пишут контакты? | Боту (t.me/<bot>) | В личный аккаунт Premium-пользователя |
| Что видят контакты? | Ответы от бота | Ответы, выглядящие как от Premium-пользователя |
| Один бот обслуживает… | Неограниченное число конечных пользователей | N Premium-пользователей в вашей организации (по одной строке на каждого) |
| Групповые чаты? | Да | Нет — только DM |
| Manual takeover? | Не применимо | Автопауза, когда Premium-пользователь печатает |
Предварительные требования
- Аккаунт Telegram с Telegram Premium для каждого пользователя, за которого бот должен отвечать
- Свежий BotFather-бот — выделенный под режим Business (нельзя переиспользовать в другой интеграции)
- Агент Cuneiform Chat, уже настроенный и протестированный в Playground
Шаги настройки
1. Создайте выделенного бота в BotFather
- Откройте Telegram, найдите @BotFather и отправьте
/newbot - Выберите имя и username
- Скопируйте Bot Token
2. Включите Business Mode на боте
Этот шаг делает бота пригодным для ответов в аккаунте Premium-пользователя. Без него Premium-пользователи увидят «this bot doesn’t support Telegram Business yet» при попытке его добавить.
- В BotFather отправьте
/mybotsи выберите вашего нового бота - Выберите Bot Settings → Business Mode
- Переключите его в положение ON
Business Mode настраивается для каждого бота отдельно. Если забыть его включить, каждая попытка привязки Premium-пользователя будет тихо завершаться неудачей с указанным выше сообщением. Переключите его повторно — и привязка сработает со следующей попытки.
3. Подключите бота в Cuneiform Chat
- В Cuneiform Chat откройте Integrations в боковой панели
- Найдите карточку Telegram Business co-pilot
- Нажмите Add Telegram Business bot
- Выберите Agent, который должен отвечать на DM (это можно изменить позже)
- Вставьте Bot Token и подтвердите
4. Premium-пользователи привязывают свои личные аккаунты
Каждый Premium-пользователь, за которого бот должен отвечать, выполняет это один раз:
- На карточке Telegram Business нажмите Link a Premium user — появится 10-минутный код (с QR-шорткатом)
- Premium-пользователь открывает Telegram → Settings → Business → Chatbots
- Добавляет username вашего бота и включает его
- Открывает обычный DM с ботом и отправляет
/start <код> - Бот отвечает подтверждением
После того как привязка готова, каждый контакт, написавший Premium-пользователю, получает AI-ответы — кроме случаев, когда Premium-пользователь сам отвечает (см. Manual takeover ниже).
Возможности
Ответы в аккаунте Premium-пользователя
Когда контакт пишет Premium-пользователю DM, Telegram доставляет событие business_message боту через business_connection Premium-пользователя. Бот вызывает агента, затем отправляет ответ обратно через то же соединение — поэтому контакт видит сообщение в существующей переписке, атрибутированное Premium-пользователю. На стороне контакта не создаётся новый диалог с ботом.
Автоматический manual takeover
В тот момент, когда Premium-пользователь печатает и отправляет ответ сам в любом чате, бот ставит этот чат на паузу на скользящее окно. Окно сбрасывается каждый раз, когда Premium-пользователь печатает снова, поэтому бот молчит столько, сколько продолжается живой разговор. После периода тишины бот возобновляет автоответы.
Это значит, что Premium-пользователю не нужно явно отключать бота при подключении к разговору — бот сам отступает.
Connection-level kill switch
Если Premium-пользователь хочет отключить AI-ответы во всех чатах без удаления привязки:
- Откройте карточку Telegram Business в Cuneiform Chat
- Включите переключатель Disable auto-reply
Интеграция остаётся подключённой (повторная привязка не нужна), но бот никому не отвечает. Выключите переключатель обратно, чтобы возобновить.
Голосовые заметки и rich-форматирование
Голосовые заметки от контактов транскрибируются через Whisper и обрабатываются как набранные сообщения. Ответы отображаются в MarkdownV2 с жирным, курсивом, блоками кода и ссылками — тот же набор инструментов, что и в обычном Telegram-канале.
Параметры конфигурации
Настройки на уровне интеграции
| Настройка | Описание |
|---|---|
| Agent | Какой агент отвечает на DM для всех привязанных Premium-пользователей этого бота |
| Auto-reply enabled | Connection-level kill switch (переключатель на карточке) |
Управление каждой привязкой
Каждая строка Premium-пользователя на карточке показывает:
- Отображаемое имя привязанного пользователя
- Метку времени последней активности
- Кнопку удаления для отвязки этого пользователя (бот перестаёт отвечать за него; его контакты снова не получают от бота ничего)
Советы
Один бот — один агент. Если вы хотите разные агенты для разных Premium-пользователей, создайте отдельных ботов — по одному на агент. Переключатель Business Mode и поток привязки нужно повторить для каждого бота.
Групповые чаты вне области применения. Telegram Business connections покрывают только личные сообщения. Бот игнорирует сообщения в группах, даже если его туда добавили.
Сначала протестируйте поток привязки самостоятельно с собственного Premium-аккаунта, прежде чем разворачивать его на коллег. Переключатель Business Mode в BotFather — самый частый камень преткновения; убедившись один раз, что он работает, вы избавите себя от раунда непонятных DM позже.
Устранение неполадок
Premium-пользователь видит «this bot doesn’t support Telegram Business yet»
Business Mode не включён на боте. Перейдите в BotFather → /mybots → ваш бот → Bot Settings → Business Mode → переведите в положение ON, затем попросите Premium-пользователя повторить шаг Settings → Business → Chatbots.
Истёк код привязки
Коды действуют 10 минут. Нажмите Link a Premium user ещё раз, чтобы сгенерировать новый.
Бот молчит для всех
Проверьте переключатель Disable auto-reply на карточке интеграции — когда он включён, бот игнорирует всех привязанных пользователей. Выключите его обратно.
Бот молчит для одного конкретного контакта
Premium-пользователь недавно сам печатал ответ в этом чате, и пауза manual takeover ещё активна. Подождите, пока скользящее окно очистится, или попросите Premium-пользователя перестать печатать в чате.
Ответы бота выглядят неправильно
Контакты Premium-пользователя видят ровно то, что генерирует агент. Если что-то off-brand или off-policy просочилось, исправьте это в промпте и инструментах агента — это тот же агент, который использует Telegram-канал, и тот же Playground для тестирования.
Отключение
Чтобы удалить интеграцию Telegram Business:
- Из Cuneiform Chat: Integrations → карточка Telegram Business co-pilot → меню из трёх точек → Delete
При этом удаляются все привязки Premium-пользователей и бот перестаёт отвечать. Сам бот остаётся в BotFather, пока вы его там не удалите.
Связанное
- Telegram — обычный customer-facing Telegram-канал (для inbox собственного бота вашего агента)
- Saba в Telegram — operator-facing платформенный ассистент (другая функция, тоже на базе Telegram)
- Магазин в Telegram — встроенный магазин для обычного Telegram-канала