Ошибка message is not modified приходит от Bot API, когда бот вызывает редактирование сообщения, а новое содержимое совпадает с текущим до последнего символа. Сервер отвечает кодом 400 и описанием Bad Request: message is not modified: specified new message content and reply markup are exactly the same as a current content and reply markup of the message. Это не поломка бота и не проблема токена: Telegram просто отказывается делать пустую правку. Но если исключение не перехвачено, обработчик падает, пользователь видит вечную «часики» на кнопке, а в логах копятся трейсбеки. Ниже я разбираю, откуда берутся такие правки, и показываю три способа с ней жить: не отправлять лишнее, перехватывать ответ и корректно закрывать callback.
Почему появляется message is not modified
Телеграм сравнивает то, что вы прислали, с тем, что уже хранится у сообщения. Сравниваются текст (или подпись) и клавиатура целиком. Если совпало всё, правка отклоняется. Если отличается хотя бы один символ или одна кнопка, она проходит.
На практике я встречал несколько типичных причин:
- Двойной клик по кнопке. Пользователь нажал «Обновить» дважды, первый запрос поменял сообщение, второй пришёл с теми же данными.
- Кнопка «Обновить» без изменений. Бот перерисовывает курс, остаток или статус заказа, а значение с прошлого раза не изменилось.
- Пагинация на краю списка. Кнопка «Назад» на первой странице перерисовывает ту же первую страницу.
- Выбор уже выбранного пункта. В меню настроек пользователь жмёт на включённый переключатель, и бот честно собирает то же самое сообщение.
- Повторная доставка вебхука. Если ваш обработчик отвечает медленно, Telegram может прислать апдейт ещё раз, и вторая обработка делает ту же правку.
- Разные способы записи, одинаковый результат. Вы переключили
parse_modeили поменяли экранирование, но на выходе получился тот же видимый текст с теми же сущностями.
Последний случай самый коварный. Строки в коде разные, а Telegram сравнивает результат после разбора разметки, поэтому ошибка прилетает там, где вы её не ждёте.
Какие методы Bot API дают ошибку «not modified»
Этот отказ возвращают методы редактирования: editMessageText, editMessageCaption, editMessageMedia и editMessageReplyMarkup. Отправка нового сообщения через sendMessage его не вызывает никогда, сколько бы одинаковых сообщений вы ни отправили.
Отдельно отмечу editMessageReplyMarkup. Когда бот обновляет только клавиатуру, например отмечает галочкой выбранный вариант, совпадение разметки даёт ту же ошибку. Её часто пропускают, потому что текст бот не трогает и кажется, что менять нечего.
Код ответа всегда 400, поэтому проверять по одному коду нельзя: под 400 попадают и другие ошибки, например «message to edit not found» или «can’t parse entities». Отличать нужно по тексту описания, подстроке message is not modified. Остальные 400‑е ошибки глотать нельзя, они значат реальный сбой.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Как избежать лишней правки: сравнение перед редактированием
Самый чистый способ вообще не вызывать API, если менять нечего. Для этого перед правкой нужно знать, что сейчас показано пользователю. Есть три источника.
Берём текст из самого сообщения
В апдейте от нажатия кнопки уже лежит исходное сообщение. В aiogram это callback.message.text. Сравниваем с новым текстом и выходим, если совпало. Но у способа есть предел: поле text хранит текст без разметки, а вы отправляете HTML или Markdown. Если в сообщении есть жирный шрифт или ссылки, сравнение строк даст «не совпало», хотя Telegram сочтёт правку пустой. Поэтому как быстрый фильтр этот способ годится, а как единственная защита нет.
Храним хеш последнего состояния
Когда сообщение собирается из нескольких частей (текст плюс клавиатура), я храню хеш от пары «текст, структура кнопок» в базе рядом с chat_id и message_id. На обычном хостинге с PHP это таблица в MySQL с уникальным ключом по паре chat_id и message_id. Перед правкой считаем новый хеш, и если он равен сохранённому, пропускаем вызов. Этот способ надёжнее сравнения текстов, потому что сравниваются данные, которые вы сами отправляли, а не то, что Telegram вернул после разбора.
Добавляем в текст меняющуюся деталь
Для кнопки «Обновить» иногда уместно показывать время последнего обновления: «Обновлено в 14:32». Тогда правка почти всегда отличается от предыдущей. Но так делать стоит осознанно: две правки в одну минуту дадут одинаковую строку, и ошибка вернётся. Время с секундами спасает, но выглядит шумно. Поэтому я использую этот приём только там, где пользователь и правда хочет видеть момент обновления.
Как перехватить исключение в aiogram и PHP
Фильтр по сравнению не закроет все случаи, например гонку двух апдейтов. Поэтому второй слой защиты это перехват ошибки. В aiogram 3 Bot API отвечает исключением TelegramBadRequest. Проверяем текст ошибки и пробрасываем дальше всё, что к нашей ситуации не относится:
from aiogram import Router, F
from aiogram.exceptions import TelegramBadRequest
from aiogram.types import CallbackQuery
router = Router()
@router.callback_query(F.data == 'refresh')
async def refresh(callback: CallbackQuery):
text = build_text()
keyboard = build_keyboard()
try:
await callback.message.edit_text(text, reply_markup=keyboard)
except TelegramBadRequest as e:
if 'message is not modified' not in str(e):
raise
await callback.answer()
Здесь build_text и build_keyboard это ваши функции, которые собирают содержимое. Обратите внимание на порядок: callback.answer() вызывается после блока try. Если его пропустить, кнопка у пользователя будет висеть с индикатором загрузки, пока не истечёт таймаут. Вызывать answer нужно и когда правка прошла, и когда её отклонили.
Если таких обработчиков много, не копируйте блок try в каждый. Я выношу его в небольшую функцию-обёртку над edit_text и вызываю её везде, где бот правит сообщения. Тогда условие по подстроке живёт в одном месте.
В PHP, где бот часто работает прямо как вебхук на обычном хостинге, механика та же. Telegram отдаёт JSON с полями ok и description, их и проверяем:
<?php
function tg(string $method, array $params): array
{
$ch = curl_init('https://api.telegram.org/bot' . BOT_TOKEN . '/' . $method);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($params, JSON_UNESCAPED_UNICODE),
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_RETURNTRANSFER => true,
]);
$raw = curl_exec($ch);
curl_close($ch);
return json_decode((string) $raw, true) ?: [];
}
$res = tg('editMessageText', [
'chat_id' => $chatId,
'message_id' => $messageId,
'text' => $newText,
'reply_markup' => [
'inline_keyboard' => [[['text' => 'Обновить', 'callback_data' => 'refresh']]],
],
]);
if (empty($res['ok'])) {
$desc = $res['description'] ?? '';
if (strpos($desc, 'message is not modified') === false) {
error_log('editMessageText failed: ' . $desc);
}
}
tg('answerCallbackQuery', ['callback_query_id' => $callbackId]);
Клавиатуру в правке передаём заново: без reply_markup редактирование уберёт кнопки у сообщения. Здесь мы молча игнорируем только нужную подстроку, а остальные ошибки пишем в лог. Это важно: если проглотить все ответы с ok = false, вы не заметите, что сообщение удалили или токен отозвали.
В python-telegram-bot ситуация та же, только исключение называется telegram.error.BadRequest, а текст ошибки лежит в его сообщении.
Ошибка 400 «not modified» в n8n
В n8n узел Telegram с операцией редактирования текста сообщения тоже упирается в этот отказ. Сценарий, где по расписанию или по кнопке обновляется «живое» сообщение со статусом заказов, рано или поздно получит одинаковые данные и остановится с красным узлом.
Есть два пути. Первый: в настройках узла выставить поведение при ошибке так, чтобы выполнение продолжалось, и дальше развести ветки по наличию поля ошибки в выходных данных. Тогда настоящие сбои уходят на уведомление админу, а «not modified» просто игнорируется. Второй путь честнее: поставить перед узлом редактирования узел сравнения (IF), который сверяет новый текст с предыдущим. Предыдущий текст можно хранить в статических данных воркфлоу или в таблице, смотря что у вас уже подключено. Я предпочитаю второй путь, потому что при нём сбои в логе не прячутся.
Персональные данные пользователей в таких сценариях лучше не складывать в зарубежные облачные таблицы: для хранения состояния достаточно базы на российском сервере.
Сводка: какой способ когда брать
| Способ | Что даёт | Ограничение |
|---|---|---|
Сравнение с message.text |
Быстрый фильтр без базы | Не видит разметку и клавиатуру |
| Хеш состояния в MySQL | Точно отсекает повторы | Нужна таблица и запись при каждой правке |
| Перехват исключения | Закрывает гонки и повторные апдейты | Каждый вызов API всё равно уходит в сеть |
| Обработка в n8n | Не останавливает сценарий | Нужна отдельная ветка для настоящих ошибок |
В рабочих ботах я комбинирую первый или второй способ с перехватом. Фильтр экономит лишние запросы, перехват страхует от случаев, которые фильтр не видит.
Что ещё проверить, если ошибка не уходит
Иногда после перехвата сообщение всё равно не меняется, и причина не в Telegram. Вот места, где я находил такое:
- Обработчик получает старые данные из кэша и каждый раз собирает один и тот же текст. Ошибки нет в смысле API, она есть в логике.
- Редактируется не то сообщение:
message_idвзят из другого апдейта. - Для инлайн-сообщений правка идёт по
inline_message_id, а в вызов передалиchat_idиmessage_id. - Вебхук срабатывает дважды из-за медленного ответа сервера. Лечится быстрым ответом 200 и выносом тяжёлой работы за пределы обработчика.
Если у бота много сценариев с живыми сообщениями, такие мелочи накапливаются. Когда логики редактирования становится много, проще один раз заложить правильную обёртку над вызовами API, и для этого можно заказать разработку Telegram-ботов с готовой обработкой типовых ошибок: ссылка ведёт на разработку Telegram-ботов под вашу задачу.
Bot API и aiogram обновляются, поэтому перед внедрением я сверяюсь с актуальной документацией Telegram.
Частые вопросы
Нужно ли что-то отвечать пользователю, если правка отклонена?
В чат ничего писать не нужно: для пользователя содержимое и так актуально. А вот на нажатие кнопки ответить обязательно, вызовом answerCallbackQuery (в aiogram это callback.answer()). Иначе кнопка продолжит показывать индикатор загрузки.
Можно ли отключить эту ошибку на стороне Telegram?
Нет, настройки для этого в Bot API нет. Поведение фиксированное: одинаковая правка отклоняется. Управлять можно только своим кодом, то есть не посылать лишнее или спокойно перехватывать отказ.
Почему ошибка появляется, хотя я точно поменял текст?
Скорее всего, различается только запись в коде, а после обработки parse_mode результат получился одинаковым. Если текст действительно другой, а ошибка идёт, проверьте, не уходят ли два одинаковых апдейта подряд.
Можно ли просто игнорировать любые ошибки 400 при редактировании?
Лучше не стоит. Под тот же код попадают удалённое сообщение, битая разметка и неверный идентификатор, и это уже настоящие сбои. Игнорируйте только случай, где в описании есть подстрока message is not modified, а остальное пишите в лог.