Функции этой группы готовят данные для ссылок и запросов к внешним сервисам: кодируют текст для адреса, считают хеши и подписи, экранируют символы разметки Telegram.

Где пригодится:

  • передать имя или email подписчика в параметре ссылки;
  • подписать запрос к платёжному сервису или вашему API;
  • вывести текст с символами _, *, . так, чтобы разметка Telegram не сломалась.

Функции

ФункцияОписаниеПример
urlencode(text)Кодирует текст для безопасной вставки в ссылку. Пробел превращается в %20.urlencode("a&b=1") → "a%26b%3D1"
urldecode(text)Раскодирует текст из ссылки обратно в обычный вид.urldecode("a%26b%3D1") → "a&b=1"
base64_encode(text)Кодирует текст в Base64.base64_encode("hello") → "aGVsbG8="
base64_decode(text)Раскодирует текст из Base64.base64_decode("aGVsbG8=") → "hello"
md5(text)Возвращает MD5-хеш строки.md5("hello") → "5d41402abc4b2a76b9719d911017c592"
sha1(text)Возвращает SHA-1-хеш строки.sha1("hello") → "aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d"
sha256(text)Возвращает SHA-256-хеш строки.sha256("hello") → "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
hmac_hex(key, text, algorithm)Возвращает HMAC-подпись текста секретным ключом в шестнадцатеричном виде. Алгоритм: sha256 (по умолчанию), sha1, sha512 или md5.hmac_hex("key", "The quick brown fox jumps over the lazy dog") → "f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8"
tg_escape(text)Ставит обратный слэш перед символами разметки Telegram (_ * [ ] ( ) ~ ` > # + - = | { } . !), чтобы текст отобразился как есть.tg_escape("1.5*2") → "1\.5\*2"

Пример: имя подписчика в ссылке

client.link = "https://site.ru/order?name=" + urlencode(client.name)

Если подписчика зовут «Иван Петров», ссылка получится такой: https://site.ru/order?name=%D0%98%D0%B2%D0%B0%D0%BD%20%D0%9F%D0%B5%D1%82%D1%80%D0%BE%D0%B2. Сайт получит имя без искажений, а пробел не сломает адрес.

Пример: подпись запроса к платёжному сервису

Многие сервисы просят подписать запрос секретным ключом, чтобы проверить, что он пришёл от вас. Храните ключ в глобальной переменной, а не в тексте формулы.

client.sign = hmac_hex(globals.secret_key, str(client.order_id) + ":" + str(client.amount))

Подпись sign передайте во внешнем запросе вместе с номером заказа и суммой. Алгоритм по умолчанию — sha256; если сервис требует другой, укажите его третьим аргументом: hmac_hex(globals.secret_key, text, "sha512").

Пример: текст без поломки разметки Telegram

client.safe_name = tg_escape(client.name)

Если в имени подписчика есть символы _ или *, Telegram может принять их за разметку. После tg_escape они отобразятся как обычный текст.

Про вставку макросов в URL-кнопки — в статье «Макросы».


Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно

Зарегистрируйтесь в BotHelp

14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.

Создать аккаунт

Была ли статья полезна?

Наши каналыTelegramMAX
Спасибо за обратную связь!