Update Dump: JSON ваших сообщений

Пишете бота и не понимаете, почему обработчик не срабатывает? Скорее всего, вы ждёте одно поле, а Telegram присылает другое. Update Dump решает эту задачу за пару секунд: отправляете сообщение, получаете в ответ его JSON-обновление.

Бот сделан для тех, кому нужно увидеть данные так, как их видит код. Команда одна, /start, дальше достаточно писать боту что угодно. ✨

Что за JSON вы получаете

Когда пользователь пишет боту, сервер Telegram формирует объект Update. Внутри лежит само сообщение: идентификатор, отправитель, чат, дата, текст или вложение. Именно такие объекты приходят в обработчики ваших ботов.

Update Dump возвращает это обновление в читаемом виде. Вам не нужно поднимать сервер, писать код и подключать токен только ради того, чтобы заглянуть в структуру.

Для чего пригодится на практике

• Узнать id. Идентификатор чата, пользователя или пересланного сообщения нужен для настройки рассылок и прав доступа.
• Понять тип контента. Фото, стикер, голосовое, документ, опрос: у каждого свои поля и своя вложенность.
• Проверить форматирование. По полю с описанием частей текста видно, где у сообщения жирный шрифт, ссылки и упоминания.
• Разобрать пересылку. В JSON видно, откуда пришло пересланное сообщение, если отправитель это разрешил.

Так проще писать парсер: вы сначала смотрите реальный образец, а потом уже пишете обращения к полям.

Как отправить запрос и что делать с ответом

1. Откройте бота и нажмите /start.
2. Отправьте сообщение, структуру которого хотите увидеть: текст, фото, голосовое, стикер.
3. Скопируйте JSON из ответа в редактор и найдите нужные поля.

Для сравнения отправьте несколько видов контента подряд. Разница в структуре сразу бросается в глаза.

Как устроены обновления в Bot API

Боты получают обновления двумя способами: через метод getUpdates или через webhook. Одновременно оба способа работать не могут. В обоих случаях вы получаете сериализованные в JSON объекты Update.

Сервер хранит необработанные обновления не дольше 24 часов. Если бот долго молчал, старые события пропадут. Поэтому для надёжной работы код должен забирать обновления без больших перерывов.

Приватность и осторожность

В JSON часто видны ваши имя, username и числовой id. Не пересылайте боту сообщения, в которых есть пароли, коды, платёжные данные или чужие личные сведения. Для тестов хватит нейтрального текста.

Если вы разбираете сообщение из рабочего чата, перед публикацией JSON на форуме или в багтрекере удалите id и имена. Это такая же личная информация, как и телефон. ⚠️

Как у любого публичного бота, у Update Dump нет гарантий по хранению и доступности. Для критичной отладки разумнее поднять собственный тестовый бот с логированием. 🔍

Кому подойдёт

Бот пригодится начинающим и опытным разработчикам, настройщикам автоматизаций и тем, кто просто любопытен. Он лучше всего справляется с одной задачей: показывает данные честно и без украшений. Автор проекта подписан в профиле бота, обратиться можно к нему.