Как отправить эмодзи в Телеграм-бот из 1С: разбираем все способы

← На главную

При разработке интеграции 1С с Telegram часто возникает задача сделать интерфейс бота более живым и дружелюбным. Самый простой способ добиться этого — добавить эмодзи. Однако разработчики часто сталкиваются с проблемой: вместо ожидаемого смайлика в чате отображается странный набор символов вроде %F0%9F%98%81 или 😁. В рамках данной статьи мы подробно разберем, почему это происходит, и изучим надежные методы вывода эмодзи как в тексте сообщений, так и на кнопках клавиатуры.

Разберем причину: почему Telegram не всегда "понимает" код смайлика

Проанализируем ситуацию, с которой сталкивается большинство программистов 1С. Основная сложность заключается в смешивании способов передачи данных. Telegram API принимает данные двумя основными путями:

Через строку URL (метод GET): Здесь данные должны быть в формате URL-encoded. В этом случае коды типа %F0%9F%98%81 будут успешно декодированы сервером Telegram в соответствующий символ, что полезно при автоматизации записи WebHook.
Через тело запроса (метод POST в формате JSON): Это наиболее современный и правильный способ. Однако в JSON-строке нельзя просто написать URL-код. Telegram ожидает либо прямой символ в кодировке UTF-8, либо корректную HTML-сущность (если включен режим parse_mode).

Если мы отправляем JSON и вставляем туда %F0..., бот воспримет это как обычный текст, так как внутри JSON-парсера автоматическое URL-декодирование не происходит.

Способ 1. Использование HTML-сущностей (HTML Entity)

Это один из самых простых способов, если вы отправляете текстовое сообщение и используете режим разметки HTML. Суть метода заключается в передаче десятичного или шестнадцатеричного кода символа Unicode.

Рассмотрим пример формирования строки (это поможет, если вы решили реализовать прогресс-бар в Telegram):


Эмоджи = "&#128513;"; // Код смайла 😁
Текст = "Привет! Вот ваш заказ " + Эмоджи;

ПараметрыЗапроса = Новый Структура;
ПараметрыЗапроса.Вставить("chat_id", ИдентификаторЧата);
ПараметрыЗапроса.Вставить("text", Текст);
ПараметрыЗапроса.Вставить("parse_mode", "HTML");

Важный нюанс: Как было отмечено в обсуждении, всегда необходимо ставить точку с запятой ; в конце кода сущности. Без неё Telegram может не распознать код, особенно если сразу за ним следует цифра или другой текст. Например, &#128513100руб превратится в нечитаемую кашу, так как парсер заберет лишние цифры в код символа. Правильно писать: 😁100руб.

Способ 2. Использование функции Символ() и суррогатных пар

Платформа 1С внутри себя работает со строками в кодировке UTF-16. Большинство привычных нам символов (буквы, цифры) занимают 2 байта. Однако эмодзи находятся в "верхних" плоскостях Unicode и требуют 4 байта. В UTF-16 такие символы представляются в виде суррогатных пар — двух идущих подряд 16-битных кодов.

Посмотрим на пример, который успешно решили участники сообщества:


// Смайл "SOS" (🆘)
Эмоджи = Символ(55357) + Символ(57005); 
Текст = Эмоджи + " Срочное сообщение!";

Этот метод хорош тем, что он универсален. Полученная таким образом строка содержит "настоящий" символ, который можно передавать и в text сообщения, и — что критически важно — в текст кнопок (ReplyKeyboardMarkup или InlineKeyboardMarkup), где HTML-разметка не поддерживается.

Способ 3. Прямая вставка символа в конфигураторе

Если вы работаете в современных версиях 1С (начиная с 8.3.10), платформа корректно поддерживает Unicode в текстах модулей. Вы можете просто скопировать смайлик из Telegram Desktop или любого сайта и вставить его прямо в кавычки в коде 1С.

Проанализируем пример:


Процедура ОтправитьУведомление(ЧатИд)
    Текст = "✅ Операция выполнена успешно!";
    // 1С сохранит этот символ корректно внутри строки
    ОтправитьВТелеграм(ЧатИд, Текст);
КонецПроцедуры

Этот способ самый наглядный и удобный для поддержки кода другими разработчиками, так как сразу видно, какой именно смайл будет отправлен.

Особенности работы с кнопками клавиатуры

Выясним причину, по которой у многих разработчиков эмодзи работают в тексте сообщения, но не отображаются на кнопках. В Telegram API для объектов кнопок (KeyboardButton) параметр text не поддерживает parse_mode. Это значит, что HTML-коды там не работают.

Чтобы вывести смайл на кнопке, нужно использовать либо способ с Символ(), либо прямую вставку символа в строку. Рассмотрим правильное формирование клавиатуры через ЗаписьJSON:


Кнопка = Новый Структура;
Кнопка.Вставить("text", "🚀 Запустить процесс");

МассивКнопок = Новый Массив;
МассивКнопок.Добавить(Кнопка);

СтрокаКнопок = Новый Массив;
СтрокаКнопок.Добавить(МассивКнопок);

Клавиатура = Новый Структура;
Клавиатура.Вставить("keyboard", СтрокаКнопок);
Клавиатура.Вставить("resize_keyboard", Истина);

// Преобразуем структуру в JSON для отправки в POST-запросе
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Клавиатура);
РезультатJSON = ЗаписьJSON.Закрыть();

Использование объекта ЗаписьJSON гарантирует, что 1С правильно упакует суррогатные пары эмодзи в формат, понятный Telegram API.

Справочная таблица популярных кодов

Для тех, кто предпочитает использовать программное формирование через функцию Символ(), приведем несколько популярных кодов:

Огонь (🔥): Символ(55357) + Символ(56613)
Лампочка (💡): Символ(55357) + Символ(56449)
Внимание (⚠️): Символ(9888) (этот символ входит в базовую плоскость и не требует пары)
Галочка (✅): Символ(9989)

Подведем итоги

Рассмотрев все варианты, мы можем сделать следующие выводы. Для обычных текстовых сообщений удобнее всего использовать HTML-сущности с обязательным указанием parse_mode: "HTML". Если же вам необходимо добавить эмодзи в меню или на кнопки, используйте прямую вставку символа в строку 1С или формируйте его через суррогатные пары. Помните, что при использовании метода POST и формата JSON нельзя использовать URL-кодирование (знаки процента), так как они не будут распознаны как спецсимволы.