Функции этой группы работают с текстом: обрезают, делят, склеивают и меняют регистр.
Где пригодится:
- обратиться к подписчику по имени с заглавной буквы;
- разобрать ФИО или адрес на части;
- собрать сообщение из нескольких полей;
- проверить длину ответа.
Функции
| Функция | Описание | Пример |
|---|---|---|
| len(text) | Возвращает количество символов в строке. | len("Привет") → 6 |
| upper(text) | Преобразует текст в верхний регистр. | upper("привет") → "ПРИВЕТ" |
| lower(text) | Преобразует текст в нижний регистр. | lower("HELLO") → "hello" |
| strip(text) | Убирает пробелы в начале и в конце строки. | strip(" привет ") → "привет" |
| capitalize(text) | Делает первую букву строки заглавной, остальные — строчными. | capitalize("иВАН") → "Иван" |
| title(text) | Делает заглавной первую букву каждого слова, остальные — строчными. | title("иван петров") → "Иван Петров" |
| substring(str, n1, n2) | Обрезает строку: n1 — сколько символов пропустить слева, n2 — отрицательное число, сколько символов обрезать справа. n2 можно не указывать. | substring("BotHelp", 3) → "Help" substring("BotHelp", 3, -2) → "He" |
| split(text, separator, index) | Делит строку по разделителю и возвращает часть с указанным номером (нумерация с 0). Если номер не указан, возвращается первая часть. Если такой части нет — пустая строка. | split("Иван Петров", " ") → "Иван" split("Иван Петров", " ", 1) → "Петров" |
| split_list(text, separator, max_parts) | Делит строку по разделителю и возвращает все части списком. max_parts ограничивает количество частей (необязательно). | split_list("курс, книга", ", ") → ["курс", "книга"] |
| replace(text, old, new, count) | Заменяет часть строки на другую. По умолчанию заменяет все совпадения; count ограничивает количество замен (необязательно). | replace("8-900-123", "-", "") → "8900123" |
| contains(text, pattern, ignore_case) | Проверяет, есть ли в строке подстрока или шаблон. По умолчанию учитывает регистр; чтобы не учитывать, передайте третьим аргументом True. | contains("хочу курс", "курс") → True |
| startswith(text, prefix) | Проверяет, начинается ли строка с указанного текста. | startswith("+79001234567", "+7") → True |
| endswith(text, suffix) | Проверяет, заканчивается ли строка указанным текстом. | endswith("mail@gmail.com", "gmail.com") → True |
Даты в строковых функциях
Переменные типа «Дата» и «Дата и время» хранятся во внутреннем формате ГГГГ-ММ-ДД. Например, ввод 11.11.2011 хранится как "2011-11-11". Поэтому substring() обрезает дату именно по этому формату.
Чтобы получить ожидаемые значения:
Вариант 1: привести дату к привычному виду
date = format_date(client.birth_date, "%d.%m.%Y")
Вариант 2: обрезать дату с учётом формата ГГГГ-ММ-ДД
Используйте индексы строки "2011-11-11".
Пример: проверить длину ответа
Посчитаем количество символов в ответе через len. Переменные с нужными названиями необходимо создать заранее.

# Считаем количество символов client.answer_count = len(client.answer) # Проверяем, что символов 10 и больше: если да, в answer_valid запишется 1, если нет — 0 client.answer_valid = len(client.answer) >= 10
Пример: имя с заглавной буквы
Подписчик написал « иван петров». Возьмём первое слово и приведём его к нормальному виду.
client.first_name = title(split(strip(client.full_name), " "))
В first_name запишется Иван.
Пример: число судьбы
Посчитаем число судьбы — сумму всех цифр даты рождения. Дату подписчика передаём в переменной birth_date.
- В 1 строке приводим дату к виду
ДД.ММ.ГГГГ, потому что внутри BotHelp дата хранится как"2011-11-11". - Со 3 по 10 строку функцией substring выделяем каждую цифру и записываем в локальную переменную.
- В 12 строке складываем цифры в переменную life_number для ответа подписчику.
date = format_date(client.birth_date, "%d.%m.%Y") d1 = int(substring(date, 0, -9)) d2 = int(substring(date, 1, -8)) d3 = int(substring(date, 3, -6)) d4 = int(substring(date, 4, -5)) d5 = int(substring(date, 6, -3)) d6 = int(substring(date, 7, -2)) d7 = int(substring(date, 8, -1)) d8 = int(substring(date, 9, 0)) client.life_number = d1+d2+d3+d4+d5+d6+d7+d8
Перенос строки (\n)
Символ \n добавляет перенос строки внутри текста.
client.text = "Первая строка\nВторая строка"
Результат:
Первая строкаВторая строка
Склеивание строк
1. Склеивание через оператор +
Объединяет несколько значений в одну строку и сохраняет результат в переменную. Пригодится, чтобы собрать итоговое сообщение, идентификатор или подпись.
- Склеивать через
+можно только строки. Значения других типов сначала приведите к строке:str(client.A). - Склеиваем значения через
+. - Результат присваиваем переменной.
client.result = "Заказ №" + client.order_id + " принят"
Что хранится в client.result: Заказ №12345 принят
Важно: оператор + создаёт новое значение. Если выполнить код ещё раз, предыдущее значение будет перезаписано.
2. Добавление текста через оператор +=
Постепенно дописывает текст в конец строки, не затирая предыдущее значение. Пригодится для логов, истории сообщений, накопления комментариев.
client.log = "Первое сообщение" client.log += "\nВторое сообщение" client.log += "\nТретье сообщение"
Что хранится в client.log:
Первое сообщениеВторое сообщениеТретье сообщение
Важно: оператор += не заменяет значение, а добавляет новое в конец строки. Для разделения строк используйте \n.
Например, будем копить в одной переменной историю вводов подписчика и добавлять к каждой записи время:
- Записываем текущее время в локальную переменную через
get_current_time(). - Склеиваем номер заказа, перенос строки и время. Склеивать можно только строки — другие типы переведите через
str(). - Добавляем запись в конец лога через
+=, отделяя записи пустой строкой.

A = get_current_time()
client.проверка += ('\n' + '\n' + client.number_order + '\n' + ' ◷ ' + A)Привести телефон к единому виду, принять ответ с опечаткой или найти фрагмент по шаблону — в статье Формула: проверка ответов подписчика.
Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io
Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.
Зарегистрируйтесь в BotHelp
14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.
Создать аккаунт