Что это
Telegram Bot API - интерфейс для приложения, которое общается через Telegram-бота. Он позволяет получать сообщения и отправлять ответы, файлы и кнопки. ИИ-бот использует этот интерфейс как канал общения, а обработку вопроса выполняет отдельный код.
Для приема новых событий выбирают getUpdates или webhook. Их нельзя одновременно использовать для одного бота. Сам API не читает произвольно чужие чаты и не дает боту доступ к корпоративным данным.
Для первого результата создайте отдельного учебного бота и отправьте сообщение самому себе. Не меняйте webhook рабочего бота и не запускайте рассылку клиентам.
Ключевые параметры
- Категория: Автоматизация
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- HTTPS-методы доступны без обязательного собственного SDK.
- getUpdates позволяет начать без публичного webhook-сервера.
- Поддерживает сообщения, вложения и inline-кнопки.
- Webhook имеет secret_token для проверки входящих запросов.
Ограничения
- Токен дает контроль над ботом и требует защиты.
- getUpdates и webhook конфликтуют, если настроены одновременно.
- Есть лимиты сообщений и ограничения доступа бота в чатах.
- Память, ИИ, права пользователей и защита от повторов реализуются отдельно.
Как использовать
1. Подготовка. Создайте отдельного учебного бота через @BotFather командой /newbot и сохраните токен в закрытой конфигурации. Откройте личный чат с ним и нажмите Start; не используйте рабочий bot token.
2. Настройка. Из серверного HTTP-клиента запросите https://api.telegram.org/bot<TOKEN>/getMe и /getWebhookInfo. Проверьте ok и имя учебного бота. Для getUpdates поле url webhook должно быть пустым; чужой или рабочий webhook не удаляйте.
3. Первый результат. Отправьте боту учебный текст, вызовите getUpdates и возьмите message.chat.id именно своего личного сообщения. Выполните POST /bot<TOKEN>/sendMessage с JSON {"chat_id":CHAT_ID,"text":"Проверка уведомления ezGPT"}. Убедитесь, что сообщение пришло вам.
4. Проверка. Сопоставьте result.chat.id, текст и message_id с чатом. В polling сохраняйте обработанный update_id и передавайте следующий offset, чтобы не повторять обработку. Для будущего webhook проверяйте secret_token, для approval - пользователя и статус задачи; учитывайте retry_after при 429.
Примеры сценариев
- Отправить себе одно учебное уведомление.
- Показать проверенный результат задачи ответственному сотруднику.
- Подготовить кнопку согласования с серверной проверкой доступа.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Обычная отправка сообщений бесплатна в пределах ограничений. Платные broadcasts и другие коммерческие функции не нужны для первого теста. Сервер и внешняя модель оплачиваются отдельно; доступность Telegram в вашей сети проверяйте самостоятельно.
Когда не подходит
- Читать все чаты пользователя
- Заменить языковую модель токеном бота
- Принимать любой callback как разрешение на действие
Альтернативы
aiogram и python-telegram-bot - библиотеки поверх того же Bot API, а не другие мессенджеры. Slack API подходит для командного чата Slack, но не отправляет сообщения вашему Telegram-боту.
