Все статьи

Telegram-бот не отправляет сообщение: как проверить текст

Если Telegram-бот отправляет обычное уведомление, но перестаёт работать на некоторых комментариях клиентов, проверьте форматирование сообщения. Символы из заявки могут попасть в команды оформления и помешать отправке. Особенно подозрительна ситуация, когда короткое "Позвоните мне" проходит, а описание детали со скобками вызывает ошибку.

Возьмём учебный пример. Клиент пишет в бот мастерской: "Нужен <уголок> для полки". Сотрудник ждёт уведомление с жирным заголовком и текстом заявки. Если программа вставляет комментарий прямо в HTML-разметку, слово в угловых скобках может оказаться на месте команды оформления. Уголок для полки внезапно получает обязанности программиста, хотя его об этом никто не просил.

Сначала посмотрите ответ Telegram

Попросите разработчика найти результат неудачной отправки. Запишите время, номер учебной заявки и текст ошибки. Сообщение can't parse entities указывает на проблему разбора оформления. Оно помогает сузить проверку, но ещё не объясняет, в каком месте собираемого сообщения возникла ошибка.

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

Узнайте, какой режим оформления включён

В Telegram Bot API параметр parse_mode задаёт правила оформления текста. Например, в режиме HTML теги могут выделять заголовок жирным. В MarkdownV2 используются другие правила и специальные символы. Способ подготовки текста должен соответствовать выбранному режиму.

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

Что проверить при HTML-оформлении

В официальной справке Telegram перечислены допустимые HTML-теги и правила передачи символов. Для знаков <, > и &, которые должны остаться обычным текстом, используются специальные записи. Разработчики называют такую подготовку экранированием.

Попросите применять её к вставляемому тексту клиента перед сборкой сообщения. Служебные теги самого шаблона должны сохранить свою роль. Если обработать готовое сообщение целиком, команды оформления тоже могут превратиться в видимый текст.

Проверьте сохранность комментария

Удаление неудобных символов меняет содержание заявки. Обозначение детали, условие "размер < 50" или название "Свет & дом" должны дойти до сотрудника в понятном виде. Поэтому проверяйте одновременно успешную отправку и точность полученного текста.

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

Учебные строки: что должен увидеть сотрудник
КомментарийЧто проверить
Нужен <уголок> для полкиСлово со скобками сохранилось целиком
Название: Свет & домЗнак & остался в названии
Размер < 50Условие читается так же, как при вводе

Этот набор относится к разбору HTML. Для MarkdownV2 понадобится проверка по его правилам. Переключение режима само по себе не подтверждает исправление: тот же исходный комментарий нужно отправить повторно в тестовом диалоге.

Повторите полный путь заявки

  1. Отправьте учебный комментарий через тот же шаг бота, на котором возникала проблема.
  2. Найдите сохранённое обращение и проверьте его текст.
  3. Откройте уведомление у тестового получателя. Сравните слова, символы и переносы строк с исходным комментарием.
  4. Повторите проверку с обычной короткой фразой и убедитесь, что оформление заголовка сохранилось.

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

Сохраните учебные строки рядом с описанием исправления. Они пригодятся после замены шаблона, добавления нового поля или подключения ответа ИИ. Текст модели тоже стоит проверять перед отправкой: инструкция "пиши аккуратно" не заменяет обработку специальных символов в программе. Выполнение этих проверок на конкретном боте нужно подтвердить отдельно; здесь приведён план проверки.

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

Какой комментарий клиента стоит добавить в проверку вашего бота?