Ограничения и отличия

Tg2Max максимально повторяет поведение Telegram Bot API, но некоторые вещи работают иначе из-за различий между платформами.

Идентификаторы (ID)

В Telegram все идентификаторы числовые (chat_id, user_id, message_id). В MAX они строковые.

Шлюз автоматически конвертирует строковые ID в числовые и обратно. Для вашего бота всё выглядит как обычные числовые Telegram ID. Маппинг хранится на стороне сервера и работает прозрачно.

Числовые ID, которые возвращает шлюз — это не реальные Telegram ID, а внутренние идентификаторы Tg2Max. Не пытайтесь использовать их в настоящем Telegram API.

Стикеры

Метод sendSticker поддерживается, но стикер отправляется как обычное изображение (файл). MAX не имеет стикер-паков в формате Telegram, поэтому стикер будет выглядеть как картинка в чате.

Управление чатом

Методы управления чатом (banChatMember, pinChatMessage, setChatTitle и др.) принимаются шлюзом и возвращают успешный ответ, но реальных действий в MAX не выполняют. Это сделано для совместимости — бот не упадёт с ошибкой, если вызовет один из этих методов.

Команды бота

setMyCommands и getMyCommands работают как стабы: установка команд принимается, но не применяется в MAX, а получение возвращает пустой список. Меню команд в MAX настраивается иначе.

Dice (кубик)

sendDice поддерживается, но результат генерируется на стороне шлюза случайным образом, а не серверами MAX. Сообщение с результатом отправляется как обычный текст.

Инлайн-режим

Inline mode (инлайн-запросы через @бот запрос) пока не поддерживается. Если ваш бот использует инлайн-режим, эта функциональность не будет работать в MAX.

Платежи

Telegram Payments API не поддерживается. Если в боте есть платёжные функции, их нужно будет реализовать иначе.

Особенности работы с медиа

file_id — шлюз генерирует свои file_id, совместимые с Telegram Bot API. Их можно использовать для повторной отправки файлов.
getFile — скачивание файлов работает через шлюз. URL файла указывает на сервер Tg2Max, а не на серверы Telegram.
Загрузка файлов через multipart/form-data поддерживается для всех медиа-методов.

Неизвестные методы

Если бот вызывает метод, который не перечислен в списке поддерживаемых, шлюз вернёт:

{
  "ok": true,
  "result": true
}

Это предотвращает падение бота из-за неожиданных ошибок. Если метод критически важен для работы бота, обратите внимание на его отсутствие в списке полной поддержки.

Лимиты запросов

Tg2Max находится в стадии открытого бета-тестирования. На время беты все функции доступны бесплатно и без ограничений по количеству ботов или запросов.