Как подключить Telegram-бота к агенту чата

Telegram-канал чата даёт тот же AI-агент, что и чат на сайте: сценарий, режимы (звонки / база знаний) и пространства базы знаний берутся из выбранной конфигурации чата. Пользователь пишет боту в Telegram — агент отвечает по вашим данным аккаунта.

Ниже — полный путь: бот в @BotFather → токен в Настройки → Интеграции → Telegram → привязка к чату. Webhook настраивается автоматически, токен хранится зашифрованным.

Зачем подключать Telegram

Что подготовить

1. Аккаунт с включённым модулем чата.
2. Хотя бы одну активную конфигурацию чата: сценарий, режимы, пространства базы знаний.
3. Аккаунт Telegram, чтобы создать бота через @BotFather.
4. Понимание, к какому чату привязать бота (сайт, поддержка, внутренний портал).

Создание бота в @BotFather

1. Откройте @BotFather в Telegram и отправьте /newbot.
2. Задайте имя (как отображается в чатах) и username (должен заканчиваться на bot).
3. Скопируйте токен вида 123456:AAE… — он понадобится один раз в кабинете A5X.
4. При желании настройте описание и аватар в BotFather — на работу агента это не влияет.

Добавление бота в кабинете

Откройте Настройки → вкладка «Интеграции» → «Telegram». Здесь создаёте ботов, смотрите статус webhook и копируете ссылку для пользователей.

1. Нажмите «Добавить».
2. Укажите название для себя — «Поддержка», «Сайт», «FAQ».
3. Вставьте токен BotFather и нажмите «Создать».
4. Дождитесь статуса «Активен»: кабинет сам выставит webhook и подтянет @username.

• Подключение…Краткий статус pending сразу после создания — список обновляется сам.
• АктивенWebhook настроен, username известен, бота можно привязать к чату.
• ОшибкаВ карточке виден текст ошибки; кнопка «Повторить активацию» без повторного ввода токена.

Привязка к конфигурации чата

Бот сам по себе не выбирает сценарий: его нужно привязать к чату. Откройте Настройки → «Чат», выберите нужную конфигурацию и в блоке Telegram укажите активного бота.

• В списке доступны боты со статусом «Активен».
• Один бот — одна конфигурация: сценарий, режимы и базу знаний этого чата.
• Сохраните чат после выбора бота.
• Создать и починить ботов можно из того же блока по ссылке в «Интеграции».

Проверка и ссылка для пользователей

В карточке активного бота появляется ссылка вида https://t.me/your_bot — скопируйте её в материалы, QR или кнопку «Написать в Telegram». Кнопка «Открыть в Telegram» запускает диалог сразу из кабинета.

1. Откройте бота по ссылке и отправьте тестовый вопрос по FAQ или по звонку.
2. Сравните ответ с тем же вопросом в чате на сайте или в кабинете.
3. Убедитесь, что источники и стиль ответа совпадают с выбранной конфигурацией.

Статусы, смена токена и удаление

• «Повторить активацию» — если статус ошибка или завис на «Подключение…».
• Новый токен в поле BotFather — переподключит webhook; пустое поле токен не меняет.
• Удаление бота в кабинете отвязывает его от чатов; сам бот в Telegram остаётся, пока вы не удалите его в BotFather.
• Если бот отвечает «не так» — сначала проверьте сценарий, режимы и пространства у привязанного чата, а не токен.

Чек-лист запуска

• 1. Чат готовСценарий и база знаний уже дают полезные ответы в кабинете или на сайте.
• 2. Бот созданТокен из @BotFather добавлен в Интеграции → Telegram.
• 3. Статус «Активен»Webhook подключён, есть @username и ссылка t.me.
• 4. Привязка и тестБот выбран в настройках чата; тестовый диалог в Telegram совпадает с агентом чата.

Частые вопросы