Блок сообщений

Чтобы попасть в настройки блока сообщений кликаем на кнопку «Редактировать» в созданной группе сообщений.

Блок сообщений — это самый главный блок, без которого нельзя построить самого простого бота. Кликаем на кнопку «Добавить блок сообщений» и создаем блок сообщений.

Настройки блока сообщений.

Создали блок сообщений (1), название по умолчанию «Сообщение». Изменить имя по умолчанию — вводим название (2), которое нужно.

Стартовое сообщение — начало группы сообщений. Если поставите галочку, то группа начнет работать именно с этого блока сообщений. На скриншоте вверху, виден блок «Приветствие», с точкой в верхнем правом углу — обозначает стартовое сообщение.

Подождать ответа — опция сохранения ответа от пользователя. При включенной галочке ответ сохраняется в переменную, которая прописывается только латинскими буквами. При необходимости можно к латинским буквам добавлять цифры. Переменные назначаются по вашему желанию.

Пример

tel — переменная для сохранения телефона.

ww2 — произвольная переменная.

Если не ставить галочку «Подождать ответа», то будет переход к другому сообщению, которое указано в ссылке по умолчанию. Когда не указана ссылка по умолчанию, то бот не будет далее реагировать на запросы.

Включить markdown — опция для подсвечивания текста в Telegram. При создании текста вставьте символы, которые указаны ниже в примере

Пример

*bold text* — жирный шрифт;
_italic text_ — курсивный шрифт;
[inline URL](http://www.example.com/) — активная ссылка. В [квадратных скобках] указывается текст ссылки.
В (круглых скобках) указывается ссылка на в формате http.
`inline fixed-width code` — моноширный шрифт.

Примеры отображения форматирования текста на картинке

Время ввода — выставление времени отклика блока сообщений. Время можно выставить от 0 до 10-ти секунд. Время отсчитывается от предыдущего блока сообщений.

Пример

Есть блок 1 и блок 2, без ссылки по умолчанию. У второго блока время ввода стоит в 5 секунд. После того, как блок 1 сработает, пройдет 5 секунд и появится блок 2.

Текст сообщения (3) — текст любой длины (смайлики поддерживаются, вставляются прямо в текст).

Вставить имя — вставляется шаблон имени в формате first_name — имя, last_name — фамилия. Если нужно персонализировать сообщение, то используйте шаблон имени.

Шаблоны имен для разных социальных сетей, мессенджеров.

ВКонтакте:
first_name – имя;
last_name – фамилия.

Telegram:
first_name – имя;
last_name — фамилия.
Telegram.start — содержит параметр переданный вместе с последней (для определенного пользователя) командой /start боту.

Viber:
name – имя.

Facebook Messenger:
first_name – имя.
last_name – фамилия.

Одноклассники:
name – имя.

Skype:
name – имя.

Пример

В тексте сообщения пишем: «Привет, first_name! Как дела?»

У пользователя отображается в чате: «Привет, Сергей! Как дела?»

Вставить Context переменную — вставляется шаблон переменной, в формате Context.имя переменной, где имя переменной — сохраненные ранее данные.

Пример

У пользователя запрашиваем адрес и т.п. контактные данные.

Для адреса назначаем переменную address, для телефона phone.

В конце опроса, требуем подтвердить введенные ранее данные. Наше сообщение выглядит в сервисе так:

first_name, подтвердите введенные данные:
Context.address
Context.phone

Все верно?

Для этого и нужны переменные. Все что нужно подставить данные, которые вводились человеком ранее и к примеру, спросить подтверждение.

Ссылка по умолчанию — переход к другому блоку в любом месте чат-бота.

Пример

Есть блок 1 и блок 2. Если в блоке 1, не стоит галочка «Подождать ответа» и стоит ссылка по умолчанию на блок 2, то произойдет переход из блока 1 в блок 2 с учетом только времени ввода.

(4) Добавление контента и переходов — возможность прикрепления контента (видео, аудио, изображений) к сообщению или их отправка отдельно.

Технические ограничения для контента:
Видео — не более 30 Мб;
Аудио — не более 30 Мб;
Изображение — не более 10 Мб.

Переходы, включают в себя 2 кнопки — клавиатура и кнопки.

Клавиатура — быстрые ответы от пользователя. Использовать можно в нескольких вариациях.

Вариант 1: назначаем ответы, через условный блок переводим далее в нужный блок. Пользователь делает выбор и переходит дальше.

Вариант 2: назначаем ответы и вводим теги. Пользователь нажимает на кнопку быстрого ответа и происходит срабатывание тега, который переводит в нужный нам блок.

Кнопки — переход в другие блоки внутри бота или по URL ссылке. Выбираем, как будет работать переход, назначаем блок или вводим ссылку.

Текст кнопки (1). Для Telegram не более 20 символа вместе с пробелами. (2) — ссылка на сообщение.

Поиск по нужным блокам работает через выпадающий список или вводом имени блока в поле ввода.

(1) — текст кнопки (для Telegram ограничение не более 21 символа, включая пробелы)
(2) — URL ссылка.

Пример

Пользователю чата отправляют статью или ссылку скачать файл. Кнопка работает, как переход по ссылке.

Условный блок

Работа условного блока — ветвление логики бота.

Пример

В процессе диалога нужно перевести подписчика на оператора. Как можно это сделать?

Шаг 1 из 3

Чтобы создать условие, нужно добавить условный блок (1) в группе сообщений.

Шаг 2 из 3

В блоке сообщений «Приветствие» сохраняем ответы в переменную и переводим в условный блок. Получаем такую схему, в условном блоке (1) срабатывает условие и далее переводит подписчика в блок сообщений (2) или (3) в зависимости от того, какой выбор он сделал.

В блоке сообщений «Приветствие» указываем ответы, которые должен выбрать подписчик. Ответы «Попасть бесплатно» и «Торт в подарок». Чтобы сохранить результат в Context переменную нужно поставить галочку «Подождать ответа». Более подробную информацию по опциям блока сообщений, читайте по ссылке.
Получаем действие от подписчика, нажатие на кнопки ответов «Попасть бесплатно» или «Торт в подарок» и переводим в условный блок, где и происходит переход.

Шаг 3 из 3

Переходим внутрь условного блока и смотрим, какое условие прописали.

В предыдущем блоке «Приветствие» сохранили ответ в переменную privet.
Прописываем условие с переходом к блоку сообщений «Имя». Выглядит оно так:

Где, Context.privet — переменная, в которую сохраняем ответ от подписчика. Далее ставим пробел, двойное равно, пробел и в кавычках указываем ответ, который указывали в блоке «Приветствие» Таким образом получаем выражение, по которому выполняется условие, и подписчик переходит в блок «Имя». Точно такой же порядок действий и с другим условием.

---

Выше рассмотрели легкий вариант. А что если нам нужно сделать двойное условие с выбором опции И / ИЛИ? Для этой задачи подойдет обычный режим условного блока

Пример. Вариант с «ИЛИ»

При условии такого выражения бот понимает, что переменные param или param2 равны соответствующим значениям. И переход пользователя бота будет в другой блок при соблюдении одного из условий.

Context.param == "Попасть бесплатно" || Context.param2 == "Хочу торт"

Пример. Вариант с «И»

При условии такого выражения бот понимает, что одна и вторая переменная param или param2 равна соответствующему значению. И переход пользователя бота будет в другой блок при соблюдении двух условий.

Context.param == "Попасть бесплатно" && Context.param2 == "Хочу торт"

Пример. Вариант с неверным значением

При условии такого выражения бот понимает, что переменные param не равна соответствующему значению. И переход пользователя бота будет в другой блок при соблюдении условия.

Context.param != "Попасть бесплатно"

После этого условия вы переводите в другой блок подписчика

 

Блок API

API — (программный интерфейс приложения, интерфейс прикладного программирования) (англ. application programming interface) — описание способов (набор классов, процедур, функций, структур или констант), которыми одна компьютерная программа может взаимодействовать с другой программой.

Блоку API задается имя, опции (стартовое сообщение, дождаться ответа удаленного сервиса). Настройки заголовков, параметров (переменных, постоянных).

Пример

Решаем задачу по отображению погоды в чате. Для этого нужно сделать запрос к сервису погоды и вывести данные в чат.

Самый простой для доступа к API — сервис погоды openweathermap.org.

Регистрируемся и получаем ключ приложения (APPID) по ссылке. Обычно ключ дублируется в email письме подтверждения.

Тестируем наш запрос в браузерной строке с городом Москва. Он выглядит так: http://api.openweathermap.org/data/2.5/weather?q=Москва&APPID=c12618e22638e74315c4cb17c85896d7

Ответ от сервера получаем такой

Для удобства копируем код запроса в json валидатор, например https://jsonlint.com/ и смотрим структуру запроса. Она выглядит так:

Температура находится в строке 14, параметр main.temp и равна 273,15 (Температура по Фаренгейту).

С запросами к сервису погоды разобрались. Переходим к настройке отправки запроса от бота и вывод в чат.

Создаем группу сообщений, добавляем 3 блока сообщений, 1 блок API, 1 условный блок. Цепочка выглядит так:

Переходим в блок сообщения под именем «Название города» и смотрим, что внутри.

Этот блок является стартовым сообщением, с опцией «подождать ответ». Cохраняем ответа от пользователя в контекстную переменную «city». Текстом сообщения: «Введите город» и ссылкой по умолчанию на блок «API».

В блоке «Название города» спрашиваем у подписчика бота, в каком городе он хочет узнать погоду. Ответ сохраняем в переменную и переходим в блок «API».

Включена опция «Дождаться ответа удаленного сервиса». Означает что запросы будут отправляться до тех пор, пока не получится результат. Положительный или отрицательный.

В поле «Ссылка» копируем http запрос к API сервиса погоды. Ссылка выглядит так: http://api.openweathermap.org/data/2.5/weather

Тип запроса – get.

Заголовки

Добавляются в http запрос переменные и постоянные. Слева название заголовка, справа значение. В примере использовать не будем.

Параметры

Параметры можно передавать в http запрос, переменные и постоянные. Слева название параметра, справа значение. В нашем примере используем опцию.

Параметр «q» — передается в http запросе и соответствует контекстной переменной «city». Является переменным параметром, так как от каждого подписчика получаем запросы к разным городам. Полученная информация от подписчика подставляется в запрос к API погоды.

Параметр APPID соответствует полученному API ключу в сервисе погоды. Является постоянным параметром, так как каждый запрос обращается с конкретным ключом доступа.

Сохранение результатов

Данные которые получим при ответе на http запрос должны быть в json. Сохраняем в контекстную переменную. Слева имя контекстной переменной, справа путь к данным, которые сохраняем.

При ошибке, значение «cod» будет 404 и сохранится в переменную «error». Полученная температура имеет путь main.temp, значение сохраняем в переменную «temp».

Настройки блока API закончили и переходим в условный блок для сравнения ответа от сервера.

Условие Context.error!=»404″ означает, что при коде ошибке НЕ РАВНОМ 404 происходит переход в блок «Успех».

Условие Context.error==»404″ означает, что при коде ошибке 404 происходит переход в блок «Повторный запрос».

Переходим в блок «Успех».

Текст сообщения: «Погода в Context.city Context.temp градусов».

Вместо переменных подставляются полученные значения от сервера и финальный ответ выглядит так: Погода в Москве 274.72 градусов.

Переходим в блок «Повторный запрос».

Текст сообщения: «Не верно. Введите заново город». Ответ от пользователя сохраняем в переменную «city» и происходит переход в блок «API» для нового запроса к серверу.