Функции этой группы готовят данные для ссылок и запросов к внешним сервисам: кодируют текст для адреса, считают хеши и подписи, экранируют символы разметки 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.
Зарегистрируйтесь в BotHelp
14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.
Создать аккаунт