AGONTS
Руководство пользователя

Подключить Telegram

Создайте бота у BotFather, вставьте токен и привяжите AI-сотрудника к каналу за 3 минуты.

Telegram — самый быстрый канал для запуска. Регистрация бота — бесплатно, ограничений на количество сообщений почти нет, клиенты уже пользуются мессенджером.

Статус: ready

Telegram-канал доступен в self-serve UI: Settings → Connections → Telegram. Wizard регистрирует webhook автоматически, поддерживает группы, супергруппы, callback-кнопки и edited-сообщения. Outbound-инструменты (tg_send_message, tg_edit_message_text, tg_pin_message, tg_set_commands, …) доступны AI-сотруднику через MCP-сервер mcp-telegram-bot после TELEGRAM_BOT_MCP_ENABLED=1.

За 3 минуты вы получите

  • Своего Telegram-бота с именем и аватаркой
  • AI-сотрудника, который отвечает клиентам в личке или в группе
  • Сразу рабочий welcome-сценарий при первом /start

Что понадобится

Три шага

Создайте бота у BotFather — 1 минута

Откройте Telegram и найдите @BotFather. Это официальный бот Telegram для управления ботами.

Отправьте команду /newbot. BotFather задаст два вопроса:

  1. Имя бота. Видит пользователь в верхней части диалога. Например, «Регистратор клиники Альфа». Любое, с пробелами и русскими буквами.
  2. Username. Уникальный ник, по которому бот находится в поиске. Обязан заканчиваться на bot: alpha_clinic_bot, shop_support_bot.

В ответ BotFather пришлёт сообщение с токеном — длинной строкой вида 123456:ABCdefGHI.... Это пароль вашего бота. Не публикуйте его.

Диалог с BotFather и строка с токеном

Вставьте токен в AG0NTS — 1 минута

В AG0NTS откройте раздел ПодключенияTelegramДобавить бота. Вставьте токен в поле и нажмите Подключить.

AG0NTS проверит токен за 2–3 секунды. Если всё ок — увидите имя вашего бота, аватарку (которую BotFather подтягивает сам) и статус «Активен».

Webhook настраивается автоматически

AG0NTS сам регистрирует webhook в Telegram по защищённому URL. Вам не нужно настраивать сервер, открывать порты или возиться с туннелями. Всё происходит в фоне за пару секунд.

Форма AG0NTS с полем для токена и статусом подключения

Привяжите AI-сотрудника — 1 минута

В карточке подключения выберите AI-сотрудника из списка и нажмите Сохранить. Всё, канал работает.

Напишите своему боту первое сообщение — он ответит по вашим документам, со ссылкой на источник. Обычно первый ответ приходит за 2–5 секунд.

Диалог в Telegram с первым ответом AI-сотрудника

Что увидят клиенты после /start

По умолчанию AG0NTS показывает короткое приветствие, сгенерированное на основе роли AI-сотрудника. Например, для «регистратора клиники» — это что-то вроде «Здравствуйте, я Анна, регистратор клиники Альфа. Помогу записаться на приём или отвечу на вопросы о врачах и услугах».

Ниже приветствия показываются 3 кнопки с частыми действиями — их тоже AG0NTS подбирает автоматически: «Записаться», «Часы работы», «Связаться с оператором».

Это можно перенастроить.

Настройка welcome-сообщения

В карточке подключения откройте Welcome-сценарий.

Текст приветствия. Поле с обычным текстом, поддерживает Markdown (жирный, курсив, ссылки, списки). Укажите, кто вы, что можете, и добавьте пару примеров запросов.

Быстрые действия. До 5 кнопок. Каждая — это короткая фраза, которую AG0NTS воспримет как первое сообщение от клиента. Удобно для частых сценариев: «Узнать цены», «Записаться», «Позвать человека».

Часы работы. Если AI-сотрудник должен отвечать только в рабочее время, поставьте галочку «Только в часы работы» и укажите расписание. Вне часов бот отправит заранее заданное сообщение («Мы онлайн пн-пт 9:00–18:00, напишите позже или оставьте номер») и запишет запрос в очередь к оператору.

Все изменения применяются мгновенно. Новая версия приветствия видна при следующем /start.

Частые ошибки

Что дальше

On this page