Чек-лист и решение проблем

Чек-лист запуска

• Создал бота в BotFather и сохранил токен в переменной окружения (Быстрый старт).
• Указал в коде адрес https://bot.tech.liza.ru (и /file/bot для файлов) (Подключение кода).
• Запущен один экземпляр бота (второй получит 409), и вебхук не задан, если используется getUpdates.
• Вызвал setMyCommands — в личном чате с ботом по «/» видно меню.
• Нажал «Открыть чат с ботом» в /mybots, написал /start — бот ответил.
• Проверил кнопки: callback_data приходит, answerCallbackQuery вызывается сразу после нажатия (не позже 15 минут).
• Бот пропускает служебные сообщения от 777000 и не отвечает ботам (is_bot).
• Сохраняю from.liza_user_id клиента в CRM — для startChat.
• Вызовы неподдерживаемых методов и ошибки 403 обёрнуты в обработку ошибок.

Если что-то не работает

getUpdates отвечает 409 Conflict

Запущен второй экземпляр бота (одновременно может опрашивать только один) или у бота задан вебхук. Остановите лишний процесс или вызовите deleteWebhook.

sendMessage → 400 «No session found for chat_id …» или getChat → «chat not found»

Бота нет в этом чате: человек ещё не писал боту и не приглашал его. Нужен входящий от человека или startChat, если у бота есть разрешение.

403 «bot was blocked by the user» или «bot was kicked from the group chat»

Человек ушёл из личного чата с ботом, отклонил приглашение или удалил бота — писать ему нельзя, пока он сам снова не позовёт бота. Во втором случае бота исключили из группы. Перестаньте слать в этот чат и не повторяйте запрос в цикле.

startChat → 403

Боту не выдано разрешение писать первым (this bot is not allowed to start chats). Разрешение включает администратор Liza для конкретного бота — обратитесь в поддержку. Если описание — bot was blocked by the user, см. пункт выше.

Бот молчит в чате

Проверьте, что чат не зашифрован: боты работают только в незашифрованных чатах. Затем проверьте, что бот — участник чата и что токен и адрес верные (getMe).

Человек видит «1» вместо нажатия кнопки

У него старая версия приложения. Бот всё равно получил обычный callback_query — менять ничего не нужно, поможет обновление приложения.

answerCallbackQuery → 400 «query is too old…»

callback_query_id принимается только выданный этому боту, один раз и не позже 15 минут после нажатия. Отвечайте сразу при получении нажатия и не вызывайте answerCallbackQuery повторно для того же id.

Человек не видит текст из answerCallbackQuery

Ответ показывается только нажавшему — всплывающим уведомлением или диалогом (show_alert=true), в чат ничего не пишется. Показ ответа появится в следующей версии приложения. Если текст должны увидеть все участники, отправьте обычное сообщение.

Меню «/» не появляется

Меню есть только в личном чате с ботом и в новой версии приложения. После setMyCommands оно обновляется не мгновенно: API отдаёт меню с кэшем до 1 минуты, приложение перечитывает его при повторном открытии чата. Проверьте getMyCommands.

setMyCommands → 400

Команда должна состоять из 1–32 символов: латиница в нижнем регистре, цифры и подчёркивание, без «/» и пробелов; описание — от 1 до 256 символов.

Команды из меню не срабатывают в библиотеке

Обработчики команд срабатывают по entities типа bot_command — они приходят с версии API 1.2. Если бот написан без библиотеки, разбирайте текст /команда сами или используйте entities.

Вебхук получает один апдейт дважды

Если ваш сервер ответил не 2xx или не успел ответить, Лиза повторит доставку. Проверяйте update_id и пропускайте уже обработанные.

Не скачивается файл

Используйте getFile, затем https://bot.tech.liza.ru/file/bot<ТОКЕН>/<file_path>. В python-telegram-bot задайте base_file_url. Прямые ссылки на сервер из версий до 1.2 не сохраняйте.

Не меняется картинка через editMessageMedia

Картинку правкой заменить нельзя, только подпись (editMessageCaption). Удалите сообщение и отправьте новое.

Не получается править или удалить старое сообщение

Сопоставления сообщений хранятся 30 дней: более старые сообщения нельзя править и удалять, а ответ на них уходит без цитаты. Сохранённые до 1 октября 2026 года message_id недействительны.

Ошибка 400 «not supported in MVP»

Этого метода нет в Лизе (реакции, пересылка, опросы, стикеры и т. п., см. Возможности и ограничения). Оберните вызов в try/except.

Кнопки бота не видны в веб-версии

Проверьте в приложении для iOS, Android или macOS. Если в веб-версии (web.liza.ru) кнопок по-прежнему нет — сообщите в поддержку Liza.

Не нашли ответ — напишите в поддержку Liza, указав логин бота, метод и текст ошибки (без токена).