Первые шаги
Этот раздел для тех, кто никогда не писал код. Никаких сложных слов: за пять минут вы соберете приветствие, которое обращается к участнику по имени.
Шаблон — это текст с пропусками
Вы пишете сообщение один раз, а в местах, где должно стоять что-то меняющееся — имя, число, дата, — ставите пропуск. Каждый раз, когда бот отправляет сообщение, он заполняет пропуски свежими данными.
Пропуск выглядит так: две фигурные скобки, внутри — название того, что нужно подставить.
{{ member.name }}{{и}}— начало и конец пропуска. Бот видит их и понимает: «здесь нужно что-то подставить».member— участник, о котором идет речь (тот, кто зашел в чат или вызвал команду)..name— его имя. Точка означает «у участника взять имя».
Как набрать фигурные скобки
На русской раскладке фигурных скобок нет — переключитесь на английскую. Затем зажмите Shift и нажмите клавишу, на которой нарисована буква Х, — получится {. Клавиша с буквой Ъ даст }.
Собираем первое приветствие
Откройте настройки приветствия
В панели выберите свой чат, затем в меню слева — «Приветствия». Включите «Приветствие при входе».
Напишите текст
В поле шаблона напишите обычное приветствие, как написали бы его сами:
Привет! Добро пожаловать в наш чат.Это уже рабочий шаблон — просто без пропусков. Бот отправит его каждому новичку слово в слово.
Добавьте имя участника
Поставьте пропуск туда, где должно быть имя:
Привет, {{ member.name }}! Добро пожаловать в наш чат.Посмотрите на превью справа — там уже появилось имя тестового участника.
Добавьте название чата
Название чата хранится в chat.title:
Привет, {{ member.name }}! Добро пожаловать в «{{ chat.title }}».Сохраните и проверьте
Нажмите «Сохранить» (или Ctrl + S). Чтобы увидеть настоящий результат, нажмите «Отправить тест в ЛС» — бот пришлет приветствие вам в личные сообщения.
Вот что увидит новичок:
Привет, Анна! Добро пожаловать в «Клуб Astral».
Упоминание вместо имени
Если написать просто {{ member }} без точки и названия, бот вставит не имя, а упоминание — имя-ссылку. Участник получит уведомление, а по нажатию на имя откроется его профиль.
Привет, {{ member }}! Добро пожаловать.Сделайте текст красивее
Звездочки делают текст жирным, решетка в начале строки — заголовком:
# Добро пожаловать!
Привет, {{ member }}! Ты **{{ chat.memberCount }}**-й участник чата **{{ chat.title }}**.Все про оформление — в статье Оформление текста.
Три вида скобок
В шаблонах встречаются три вида скобок. Пока вам нужны только первые, но полезно знать, что бывают и другие:
| Скобки | Что делают | Пример |
|---|---|---|
{{ … }} | Выводят значение: бот подставит его в текст | {{ member.name }} |
{% … %} | Выполняют команду: проверить условие, повторить, добавить кнопку. Сами ничего не печатают | {% if member.isPremium %}…{% endif %} |
{# … #} | Комментарий — заметка для себя. Бот ее пропускает | {# поменять ссылку в мае #} |
Все, что написано вне скобок, бот отправляет как есть.