AiHummer доки
v1.0.x ▾
v1.0.x stable
RU EN
Каналы /Telegram

Telegram

v1.0.x · обновлено 2026-06-26

Telegram — это production-grade канал AiHummer, который мы рекомендуем подключать первым. Это самый быстрый способ показать рабочего агента живым людям: создайте бота через @BotFather, передайте коннектору токен — и входящие сообщения начнут поступать в gateway.

Коннектор Telegram устанавливается из встроенного Marketplace и настраивается в Admin UI. Он работает host-native и общается с gateway через inbound-API, поэтому масштабируется и перезапускается независимо от turn-движка.

Почему начинать с Telegram

У Telegram наименьший порог входа среди всех каналов AiHummer: нет оператора связи, нет экрана согласия OAuth, нет ревью приложения. Токена бота достаточно, чтобы отправлять и принимать сообщения, и один и тот же коннектор покрывает и внутренние чаты сотрудников, и клиентских ботов. Поскольку канал production-grade и полностью обкатан, именно его мы советуем подключить первым при знакомстве с AiHummer.

Polling или webhook

Коннектор поддерживает оба режима приёма, поэтому работает независимо от того, доступен ли ваш gateway из публичного интернета.

  • Long polling — коннектор сам забирает обновления у Telegram. Не нужны ни входящий порт, ни TLS, что идеально для локальной разработки и приватных сетей.
  • Webhook — Telegram пушит обновления на публичный HTTPS-URL. Ниже задержка, лучше подходит для продакшена за reverse-proxy, который терминирует TLS.

Коннектор слушает порт 8800 в обычной установке или 8091 при локальном запуске. Каждое входящее сообщение отправляется на URL gateway из AIHUMMER_INBOUND_URL и аутентифицируется общим inbound-секретом.

Rich Messages, реакции и опросы

Помимо обычного текста, канал Telegram отрисовывает Rich Messages — форматированные ответы, которые сопоставляют структурированный вывод агента с нативными возможностями сообщений Telegram. Также поддерживаются реакции и опросы, поэтому агент может отреагировать на сообщение пользователя или поставить быстрый опрос в чат прямо в рамках хода.

[!TIP] Telegram идентифицируется в AiHummer как канал telegram. Используйте этот id канала, привязывая агента или фильтруя диалоги по источнику.

Бот-к-боту с защитой от циклов

Агенты могут общаться с другими ботами. Чтобы это было безопасно, коннектор включает защиту от циклов (loop guard): он обнаруживает и разрывает неконтролируемые обмены бот-к-боту до того, как они превратятся в бесконечный пинг-понг. Это позволяет собирать мульти-ботовые сценарии без классического сбоя с петлёй обратной связи.

Брокеринг секретов по OIDC

Токен бота и другие секреты коннектора не зашиты в сервис. Вместо этого коннектор получает их в рантайме из Secrets Service по OIDC — аутентифицируется, а затем забирает нужные доступы. Секреты остаются в зашифрованном vault и не попадают в конфигурационные файлы и аргументы процесса.

[!NOTE] Входящие сообщения отправляются на AIHUMMER_INBOUND_URL и защищены общим HMAC inbound-секретом (AIHUMMER_INBOUND_SECRET). Для их диспетчеризации в gateway должно быть задано рабочее пространство по умолчанию.

Куда дальше