Группа Telegram стала супергруппой: безопасное обновление Chat ID

После преобразования группы Telegram в супергруппу бот должен использовать новый идентификатор чата для последующих отправок. Bot API передаёт migrate_to_chat_id и migrate_from_chat_id в служебных сообщениях, а в ответе на неуспешный API-запрос может вернуть parameters.migrate_to_chat_id. Явно сохраните связь старого и нового ID: обновите маршрутизацию будущих отправок, но оставьте исходные идентификаторы чатов у сохранённых сообщений.

Главное

• Миграция группы меняет идентификатор назначения, а не свидетельствует о сбое webhook.
• Используйте структурированные поля миграции, а не текст ошибки или догадки о формате ID.
• Историю сохраняйте с исходным чатом; актуальный адрес определяйте непосредственно перед отправкой.
• Публичная схема событий UnifyPort не описывает эквивалентное сопоставление при миграции. Не переносите в неё поля Bot API автоматически.

Что означают migrate_to_chat_id и migrate_from_chat_id

Официальная документация Telegram Bot API определяет оба необязательных поля в Message, а поле нового адреса — также в ResponseParameters.

Основание	Старый чат	Новый чат
Сообщение с migrate_to_chat_id	chat.id этого сообщения	message.migrate_to_chat_id
Сообщение с migrate_from_chat_id	message.migrate_from_chat_id	chat.id этого сообщения
Неуспешный ответ с parameters.migrate_to_chat_id	Числовой ID чата из исходного запроса	parameters.migrate_to_chat_id

Для варианта с ответом API сохраняйте контекст исходного запроса. Если адресом было имя пользователя, а не сохранённый числовой ID, не выдумывайте старый числовой идентификатор на основании одной ошибки.

Telegram предупреждает: идентификаторы миграции могут содержать больше 32 значащих бит, но не более 52. Для хранения подходят знаковое 64-битное целое или число с плавающей точкой двойной точности. Исключите 32-битные преобразования на всём пути данных. Десятичные строки в собственных ключах приложения тоже могут быть удобным проектным решением; сохраняйте знак и точное значение.

Здесь предполагается, что обновления уже доходят до обработчика. Если вы ещё выбираете тип учётной записи и способ доставки, начните со сравнения Telegram Bot API webhook и единого входящего webhook.

Связь адресов вместо переписывания истории

Рекомендуемая архитектура: отделить логический диалог поддержки от адресов на платформе. Храните сопоставление старого и нового ID в пределах арендатора и конкретной интеграции бота, вместе с подтверждающими данными. Это элементы локального хранилища, а не дополнительные поля Telegram API.

Не заменяйте ID чата во всех исторических записях. Telegram определяет message_id как уникальный внутри конкретного чата, а не глобально. Приписав старые сообщения новому чату, можно получить неверные связи. Соответствие адресов не означает документированного преобразования идентификаторов сообщений.

Рекомендуемая последовательность:

1. Проверьте источник и надёжно сохраните входящее обновление. Если основание — ошибка API, сохраните фактический ответ и исходный запрос.
2. Извлеките старый и новый ID по таблице выше.
3. Если хранилище позволяет, запишите сопоставление и обновите текущий маршрут в одной транзакции.
4. Повторное подтверждение той же пары не должно создавать новую работу. Противоречивые связи и циклы отправляйте на проверку, а не перезаписывайте молча.
5. Оставьте историю неизменной. Для заданий очереди определяйте актуальный адрес непосредственно перед отправкой.

Согласуйте обновление сопоставления и чтение адреса блокировкой приложения или эквивалентным механизмом управления конкуренцией. Иначе один обработчик может прочитать старый адрес перед тем, как другой зафиксирует миграцию. Даже при локальной координации сохраняйте обработку ошибок для такой гонки.

Восстановление отправок из очереди без слепых повторов

Неуспешный ответ с parameters.migrate_to_chat_id сообщает новый адрес. Сначала сохраните его, затем решайте вопрос повторной попытки и проверяйте, актуально ли ещё задание. Сетевой тайм-аут — другой случай: он не доказывает ни миграцию, ни неудачу отправки.

Если задание ссылается на более раннее сообщение, не подставляйте старый message_id вместе с новым ID чата. Проверьте применимость ссылки или передайте задание на ручную проверку. Не превращайте действие, зависящее от контекста, в другое обычное сообщение без явного решения.

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

Предлагаемые приёмочные проверки — это план, а не отчёт о результатах:

• Повторные данные миграции оставляют одно сопоставление и не создают второе задание отправки.
• Запоздавшее обновление старого чата сохраняет исходную принадлежность и не возвращает маршрут к старому ID.
• Противоречивое сопоставление приостанавливает связанные задания.
• Посторонний чат с тем же названием не объединяется с исходным.
• Идентификаторы проходят сериализацию и чтение из базы без усечения.

Граница возможностей UnifyPort

Неофициальный интерфейс UnifyPort использует message.received с provider, account_id и data.conversation.id. Храните эти идентификаторы в отдельном пространстве имён и не предполагайте, что вместо них можно напрямую использовать Bot API chat ID.

Публичная документация событий не описывает migrate_to_chat_id, migrate_from_chat_id или гарантированную связь старого и нового чата. Нельзя считать group.updated или conversation.updated такой гарантией. Для подключённого Telegram-аккаунта обмена сообщениями проверяйте контракт списка диалогов и используйте возвращаемые conversation_id для сверки. Одинаковое название само по себе не доказывает преемственность; неясные связи требуют проверки.

Для приёма событий задайте signing_secret и следуйте правилам проверки webhook. UnifyPort не предоставляет REST API чтения истории сообщений и не гарантирует повторную выдачу пропущенных событий. Список текущих диалогов не восстановит отсутствующие сообщения и не даст недокументированное сопоставление миграции.

Частые вопросы

Нужно ли менять webhook URL после преобразования группы в супергруппу?

Новый ID чата — вопрос маршрутизации, сам по себе он не указывает на необходимость смены URL. Сначала проверьте полученное обновление и сохранённый адрес отправки.

Можно ли вычислить новый ID из старого?

Используйте поля миграции от Telegram. Не конструируйте адрес добавлением префикса или изменением цифр.

Нужно ли перенести все старые сообщения на новый chat ID?

Нет. Сохраняйте исходные пары «чат — сообщение». Свяжите диалоги на уровне приложения, не утверждая, что идентификаторы сообщений были преобразованы.

UnifyPort автоматически передаёт поля миграции Bot API?

Публичный контракт этого не описывает. Сверяйте идентификаторы подключённого аккаунта через собственный API UnifyPort и проверяйте неоднозначные соответствия.

Следующий шаг и источники

Проверьте, в какой момент отправитель определяет адрес, особенно для заданий очереди. Для сверки подключённого аккаунта начните с List conversations.

• Telegram Bot API: Message и ResponseParameters, проверено 2026-09-21.
• Стандартные события UnifyPort.