Сохраните обезличенный текст после подстановки данных и точный метод отправки. Лимит относится к конкретному полю API, поэтому длина шаблона до рендеринга мало что объясняет. Для первого сравнения отправьте короткий вариант без форматирования в тестовый чат: так отделяются ограничения текста от ошибок разметки.
Не обрезайте готовую строку произвольным числом байтов. Можно повредить символ, ссылку или диапазон форматирования. Вместо этого подготовьте план частей, проверьте каждую по правилам канала и сохраняйте результат отдельной отправки. Длинный ответ становится несколькими связанными сообщениями с собственными исходами.
У каждого метода свой способ считать длину
В Telegram Bot API поле text метода sendMessage допускает 1–4096 символов после разбора entities. Смещения и длины MessageEntity описаны в единицах UTF-16. Справочник проверен 29 октября 2026 года. Эти два утверждения нельзя заменить одним вызовом длины строки на любом языке; правила подписи к вложению также проверяются отдельно.
| Что измеряется | Где возникает ошибка |
|---|---|
| Байты UTF-8 | Разрыв внутри кодирования символа |
| Видимые знаки | Эмодзи может состоять из нескольких элементов |
| Диапазоны entities | После разреза нужны новые смещения |
| Разобранный текст | Разметка и итоговое содержимое различаются |
| Поле другого метода | Лимит sendMessage к нему неприменим |
Предпочитайте разрез по абзацам или законченным предложениям. Один очень длинный фрагмент требует запасного правила: безопасно разбить текстовую последовательность и заново сформировать форматирование. Если внутри находится ссылка, код или таблица, иногда удобнее передать документ, когда это допускают требования канала и задачи.
Сначала строится план, потом начинается отправка
Условный план ответа:
response_id -> одна версия длинного ответа
part_index -> порядок части
part_count -> общее число частей
rendered_text -> текст данной части
formatting -> диапазоны, пересчитанные для неё
status -> planned / accepted / failed / unknown
external_message_id -> если платформа его вернулаПлан должен быть неизменяемым во время повтора. Если при каждой попытке заново получать данные клиента и делить текст, часть с прежним номером может содержать уже другое предложение. Привяжите части к версии ответа; исправленный текст выпускайте как новую осмысленную редакцию, а не как незаметную замену середины старого набора.
Когда первая часть принята, а вторая отклонена, повтор всего массива создаёт дубли начала. Продолжайте по учтённым исходам. При сетевом таймауте результат может быть неизвестен: проверьте возможности сопоставления и идемпотентности конкретного API. Локальный номер части сам по себе не запрещает платформе принять её второй раз.
Сохраняйте порядок в пределах одного ответа и не смешивайте соседние ответы одного диалога. Отмена разговора, переход к оператору или смена разрешений должны останавливать ещё не допущенные части. Уже доставленные сообщения рассматривайте отдельно: возможность редактирования и удаления зависит от канала.
Пограничный корпус вместо одного длинного абзаца
- Собрать русский текст, длинную ссылку, переносы и составные эмодзи.
- Добавить форматирование на предполагаемой границе частей.
- Проверить значения непосредственно около лимита выбранного поля.
- Имитировать отказ средней части и повтор исполнения.
- Сверить полный порядок и содержимое у тестового получателя.
Сравнивайте не только отсутствие ошибки API. После объединения частей смысл и последовательность должны совпадать с исходным ответом; ссылки открываются, код не теряет строки, заголовки не остаются отдельно от пояснения. Техническая нумерация помогает понять пропуск, но занимает часть доступного объёма и тоже включается в расчёт.
Для разбора достаточно минимального обезличенного текста, метода, режима разметки и плана частей с ответами API. Не отправляйте в общие логи полные клиентские переписки ради измерения длины. Сохраните проблемную структуру и символы, заменив чувствительное содержимое сопоставимыми тестовыми данными.