Telegram

Все коннекторыВходящиеTelegram

Быстрая настройка#

Если на коннекторе Telegram доступно Создать через QR, выберите его, отсканируйте QR-код или нажмите Открыть Telegram и коснитесь Создать бота в боте настройки. Вернитесь в Make Agent Fast, проверьте имя пользователя бота и выберите Подключить этого бота. Копирование токена не требуется. Настройка истекает через 15 минут; её можно отменить и начать заново.

Если быстрая настройка недоступна, используйте Подключение с токеном бота ниже. Оба метода используют одни проверки подключения и подтверждение замены.

Форма создания предлагает отображаемое имя вашего агента и имя пользователя в формате maf_<agent>_<random>_bot. Оба редактируемы; случайная часть снижает столкновения имён, но финальную проверку доступности делает Telegram. Существующие боты не переименовываются.

После создания бот настройки отправляет кнопку Подключить этого бота, открывающую проверку подключения вашего агента с аутентификацией. Одно создание бота не подключает его. После успешного подтверждения Открыть бота ведёт к диалогу для тестирования. /start или /help восстанавливает активную настройку или показывает кнопки панели и гайда.

Создайте и подготовьте бота вручную#

Следуйте официальному Введению в ботов Telegram и гайду BotFather:

1. Откройте проверенный аккаунт @BotFather в Telegram.
2. Выполните /newbot, выберите отображаемое имя и уникальное имя пользователя, заканчивающееся на bot.
3. Скопируйте токен бота. Любой с этим токеном управляет ботом.
4. Опционально настройте фото, описание, текст «о боте» и локализованную справку команд в BotFather перед запуском.

Токен предназначен для Telegram Bot API; это не код входа Telegram, API ID или API хеш.

Подключите в Make Agent Fast#

Откройте страницу Коннекторы сайта, выберите Telegram, вставьте Токен бота, выберите, должны ли поддерживаемые ответы также озвучиваться, и нажмите Подключить.

Make Agent Fast вызывает Telegram getMe для проверки токена и отображения имени пользователя бота. Затем вызывает setWebhook с публичным HTTPS URL коннектора, секретным токеном проверки и message, callback_query и my_chat_member как принимаемыми типами обновлений. Существующие ожидающие обновления не отбрасываются.

Ручной шаг вебхука обычно не требуется. Остановите любой сервис опроса перед подключением. Если у бота есть другой получатель вебхука, проверьте и подтвердите его замену; Make Agent Fast не перехватывает его молча. Только один бот актуален на агента. Бот, уже привязанный к другому агенту, должен быть сначала отключён там.

Протестируйте диалог#

1. Откройте ссылку t.me бота с аккаунта Telegram не владельца.
2. Выберите Запустить; боты не могут начать диалог с пользователем.
3. Отправьте текстовый вопрос по знаниям.
4. Отправьте голосовое сообщение, если голос включён.
5. Убедитесь, что ответы приходят, Последнее сообщение меняется и ветка появляется в Диалогах.

Личные сообщения публичны по умолчанию: посетителям не нужно одобрение владельца. Ответы в группах выключены, пока владелец не включит Отвечать в группах при упоминании или ответе. Режим приватности Telegram и разрешения групп по-прежнему действуют. Сначала тестируйте личные сообщения.

Поведение голоса#

Telegram поддерживает входящий голос и исходящий голос в этом коннекторе. Входящий голос загружается и транскрибируется перед ходом агента. С включённым Отвечать голосом и доступным провайдером речи Make Agent Fast отправляет голосовой/аудио ответ в дополнение к тексту. Если транскрибация или речь не работает, попросите пользователя повторить текстом и проверьте ошибку коннектора.

Ротация, отключение или удаление#

Если токен раскрыт, сгенерируйте/отзовите его в BotFather немедленно, обновите коннектор заменой и протестируйте снова. Обновление учётных данных для того же бота сохраняет его настройки и приостановленный статус. Замена другим ботом требует подтверждения и держит историю прежнего бота отдельно.

Отключение останавливает ответы локально; удаление архивирует подключение и сохраняет его историю. Ни то, ни другое не удаляет бота Telegram и не вызывает deleteWebhook, что могло бы нарушить работу более нового получателя. Архивированные подключения игнорируют входящие сообщения. Быстро созданные боты могут обновить учётные данные после событий жизненного цикла менеджера, но приостановленный бот остаётся приостановленным, а смена владельца отключает подключение для проверки.

Решение проблем#

Никогда не вставляйте живой токен в документацию, исходный код, аналитику или скриншот поддержки.