# Telegram Bot

ИИ для Телеграма: ответы в чатах бота без ручной переписки

Подключите собственного Telegram-бота для работы с ИИ-агентом

## Как агент работает с Telegram Bot

Агент обращается к Bot API на api.telegram.org с токеном вашего бота от @BotFather. Первый вызов — getMe: он подтверждает, что токен рабочий, и показывает, какой именно бот подключён. Дальше в работу идут входящие сообщения этого бота, данные их отправителей и вложения: из них агент вытаскивает контакт и суть обращения и складывает заявки списком, чтобы ничего не терялось в потоке чата.

У бота есть две особенности, которые определяют всё остальное. Вебхук у него один: обновления уходят по единственному адресу, и два обработчика на одном токене не уживаются — второй просто перестаёт получать сообщения. А в группах при включённой настройке Group Privacy бот видит только команды и ответы на свои сообщения: остальную переписку Telegram ему не отдаёт, и такую группу агент считает частично видимой, а не пустой.

Пишет агент от имени бота: отвечает на типовые вопросы в тоне бренда, присылает сводки в нужный час и рассылает сообщения пользователям, а после собирает статистику доставки и ответов. Первым он написать не может — Telegram разрешает боту отвечать только тем, кто сам начал с ним диалог. Сложное обращение агент не додумывает, а передаёт человеку с готовой сводкой переписки.

Токен даёт права ровно этого бота: личные чаты вашего аккаунта и переписки, где бота нет, ему недоступны. Скомпрометированный токен отзывается у @BotFather без остановки остального — старая строка перестаёт работать сразу. Ограничения Telegram на частоту отправки агент соблюдает сам, а если сообщений по запросу нет или бот их не получает из-за приватности, он скажет это прямо.

## Сценарии интеграции

### Автоответы на входящие сообщения
Агент читает сообщения вашего бота, отвечает на типовые вопросы в тоне бренда и передаёт сложные обращения человеку с готовой сводкой.

### Приём и сортировка заявок из бота
Агент разбирает входящие заявки, вытаскивает контакт и суть запроса и складывает их списком, чтобы ничего не потерялось в чате.

### Уведомления и дайджесты в чат
Агент присылает в Telegram сводки по продажам, задачам или заявкам на нужный час — без ручной выгрузки и захода в кабинеты.

### Рассылка сообщений подписчикам бота
Агент подготовит и отправит сообщение пользователям бота, а после соберёт статистику доставки и ответов.

### Файлы, присланные в бот
Агент прочитает вложения из диалога с ботом — фото документа, накладную, выгрузку — и ответит по их содержимому, не выходя из переписки.

### Команды в рабочей группе
Агент отработает команды в группе и ответит на реплики к своим сообщениям, честно помечая, что при включённой приватности видит не всю переписку.

## Как подключить

**Перед подключением**

- Аккаунт Telegram, с которого создаётся бот
- Права администратора в группе, куда добавляется бот

### Создайте бота командой /newbot
Откройте @BotFather и отправьте /newbot. Он спросит имя и username: 5–32 символа, латиница, цифры, подчёркивания, окончание «bot».

### Скопируйте токен из ответа BotFather
Токен приходит одним сообщением: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Потеряли или засветили — новый выдаёт команда /token.

### Выключите «Group Privacy» для группы
В @BotFather: /mybots → ваш бот → «Bot Settings» → «Group Privacy» → выключить. После смены добавьте бота в чат заново.

### Освободите бота от прежней интеграции
У бота один активный вебхук, и пока он установлен, обновления уходят туда. Если бот уже обслуживает другой сервис или ваш скрипт, заведите отдельного.

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

### Как подключить Telegram-бота?
Создайте бота у @BotFather, скопируйте токен и вставьте его при подключении. Свой сервер не нужен — приём сообщений идёт через вебхук, который настраивается автоматически.

### Какие данные видит агент?
Только сообщения, которые приходят вашему боту, и данные их отправителей. К личной переписке и другим чатам аккаунта доступа нет — работает именно бот, а не ваш личный Telegram.

### Может ли агент писать от имени бота?
Да: агент отправляет ответы и рассылки от имени подключённого бота. Если нужно только читать входящие и уведомлять вас — так тоже можно настроить.

### Что происходит после подключения?
Бот сразу начинает получать сообщения, и агент отвечает по вашему сценарию. Ограничения Telegram на частоту отправки соблюдаются автоматически.

### Как сделать чат-бот с ИИ в Телеграме?
Чат-бот с ИИ здесь собирается без разработки: вы заводите бота у @BotFather, вставляете токен — и отвечает уже агент. Он разбирает входящие в тоне бренда, вытаскивает из переписки контакт и суть заявки, а то, что не берётся решить сам, передаёт человеку с готовой сводкой диалога.

[Открыть Telegram Bot](https://t.me/botfather)