Развилка
Компонент Развилка определяет, куда перенаправить пользователя или какое сообщение вывести в зависимости от полученных от пользователя данных.
- Взаимодействие Развилки и Кнопок с подсказками →
- Как проверить значение переменной в Развилке →
- Как проверить переменную без значения →
- Как записать переменную в Развилке →
- Как принять файл или изображение от пользователя →
- Как настроить постоянное меню из кнопок под строкой ввода в Телеграм →
Как настроить взаимодействие Кнопок с подсказками и Развилки вы можете посмотреть в видеоуроке на нашем ютуб-канале →
А также в нашем Telegram-канале →
Файлы от пользователей попадают в переменные конкретного пользователя (раздел Пользователи), хранятся 7 дней, затем исчезают без возможности восстановления. Если нужен доступ к принятым в бота файлам на срок больше чем 7 дней, то все файлы необходимо сохранить на своем устройстве.
Файлы формата pdf и docx, загруженные через Viber, скачиваются без расширения. Чтобы файл открылся, необходимо дописать расширение (.pdf, .docx) вручную после скачивания.
Взаимодействие Развилки и Кнопок с подсказками
Кнопки с подсказками показывают пользователю несколько кнопок. Когда пользователь нажимает на кнопку, в чат отправляется её содержимое (текст, смайлы, номер телефона). Развилка может ловить этот ввод.
В примере Развилка направит пользователя на экран в зависимости от выбранной им кнопки. Если пользователь напишет что-то сам, то цель по умолчанию вернет его на этот же (предыдущий) экран.
Настройка
1. Добавьте на экран Кнопки с подсказками, заполните текст перед кнопками и на кнопках.
2. Добавьте на экран Развилку.
По умолчанию цели развилки находятся на экране. При необходимости, можно переместить цели в настройки компонента — для этого нужно включить чек-бокс Разместить цели развилок в дополнительных свойствах компонента. Этот чек-бокс включается в разделе Настроить профиль на странице с ботами.
3. В поле Что проверяется Развилкой оставьте без изменений пункт Сообщение от клиента.
4. В поле Тип ожидаемых данных от пользователя от пользователя оставьте без изменений тип Текст.
5. В поле Ожидаемое сообщение от пользователя скопируйте текст с первой кнопки, которая находится выше. В нашем случае это «Главное меню»
6. В поле Переход из выпадающего списка выберите экран, куда должен попасть пользователь после нажатия первой кнопки.
7. С помощью кнопки +Добавить условие добавьте условие для второй кнопки.
8. В поле Тип ожидаемых данных от пользователя от пользователя оставьте без изменений тип Текст.
9. В поле Ожидаемое сообщение от пользователя скопируйте текст со второй кнопки, которая находится выше. В нашем случае это «Информация о боте»
10. В поле Переход из выпадающего списка выберите экран, куда должен попасть пользователь после нажатия второй кнопки.
11. Добавьте и заполните условия для третьей кнопки по образцу первых двух.
12. В поле Переход по умолчанию, которое находится в самом низу компонента, добавьте переход на тот же самый экран, который вы настроили только что. В нашем примере он называется «Экран с Развилкой»
13. Сохраните изменения.
Проверка значения переменной
Иногда нужно проверить значение конкретной переменной. Например, при открытии доступа к определенным блокам бота.
Для этого нужно указать переменную в поле Имя переменнной для проверки и добавить цели для возможных значений.
Настройка
1. Добавьте Сообщение.
2. Добавьте Ввод от пользователя. В поле Имя переменной, куда попадут введенные данные добавьте переменную, которую вы хотите проверить.
3. Добавьте Развилку.
4. В поле Что проверяется развилкой? откройте выпадающий список и выберите из него пункт Переменная.
5. Впишите Имя переменной для проверки.
6. Заполните поле Ожидаемое значение переменной.
7. В Переходе выберите экран, куда попадет пользователь, если у него будет совпадать значение с тем, что ожидает первая цель развилки. В нашем примере ожидается цифра 1. Пользователь написавший эту цифру попадет на экран, который вы указали ниже. В нашем случае это экран 1.
8. С помощью кнопки +Добавить условие добавьте второе условие.
9. Заполните поле Ожидаемое значение переменной.
10. В Переходе выберите экран, куда попадет пользователь, если у него будет совпадать значение с тем, что ожидает вторая цель развилки. В нашем примере ожидается цифра 2. Пользователь написавший эту цифру попадет на экран, который вы указали ниже. В нашем случае это экран 2.
11. В Переходе по умолчанию, который находится в самом низу Развилки, укажите экран для пользователей, у которых значение переменной не подходит под первые две цели, то есть для всех, у кого значение не один и не два.
12. Сохраните изменения.
Если у пользователя не будет проверяемой переменной, то он застрянет на Развилке. Чтобы этого избежать, перед Развилкой нужно установить компонент Запись переменной и записать значение {{var}} в переменную var.
Как проверить переменную без значения в Развилке
1. Добавьте Развилку на экран.
2. В поле Что проверяется Развилкой? выберите пункт Переменная.
3. Добавьте переменную для проверки. В нашем случае это var.
4. Тип ожидаемых данных в переменной поменяйте на Регулярное выражение.
5. В Ожидаемое значение переменной добавьте шаблон, который проверяет переменную по регулярному выражению для любого ввода:
.+
6. В поле Переход выберите экран для пользователей у которых есть переменная.
7. Эта развилка не сработает только если в переменной пустая строка, поэтому следующим шагом добавьте Запись переменной и запишите в другую переменную проверку на то, равна ли переменная пустой строке. Для этого в значение добавьте хелпер:
{{eq var ""}}
где var — это наша переменная.
Если переменная пустая, то запишется true, если нет, то false.
8. Добавьте вторую Развилку, где будет проверяться ранее записанная переменная.
9. В поле Что проверяется развилкой? выберите из списка вариант Переменная.
10. Добавьте Имя переменной для проверки. В нашем случае это isEmptyString.
11. В Типе ожидаемых данных в переменной выберите Чистая «правда» — true.
12. В поле Переход выберите экран для тех пользователей, у кого есть переменная.
13. В Переход по умолчанию добавьте экран для тех, у кого нет переменной.
14. Добавьте экраны для перехода если переменная есть и если переменная отсутствует.
15. Сохраните изменения.
Запись переменной
Файлы от пользователей (изображения, документы и т.д.) записанные с помощью Развилки, попадают в переменные конкретного пользователя (раздел Пользователи), хранятся 7 дней, затем исчезают без возможности восстановления. Если нужен доступ к принятым в бота файлам на срок больше чем 7 дней, то все файлы необходимо сохранить на своем устройстве.
С помощью Развилки можно записать переменную перед переводом на другой экран.
Чтобы записать название кнопки или текст от пользователя в переменную, достаточно указать Имя переменной. В неё будет записано то, что прислал пользователь, если условие данной цели совпадет.
Выбранная кнопка записалась в переменные.
Чтобы записать значение переменной, которое будет отличаться от значения, с которым должен совпасть ввод пользователя, нужно вписать значение в поле Что записать.
Теперь в переменной заданное в настройках Развилки значение.
Как принять файл или изображение от пользователя
Любой файл или изображение можно принять, выбрав Файл в поле Тип ожидаемых данных от пользователя и задав имя переменной в настройках развилки, в поле Записать переменную.
Кнопка Открыть дополнительные настройки открывает все настройки условия цели, в том числе настройки для записи переменной.
Файл попадет в переменную пользователя в виде ссылки, которую нужно будет скопировать, вставить в строку браузера и нажать Enter. После чего начнется скачивание файла.
Также файл попадет в Диалог с этим пользователем в виде активной ссылки. Если кликнуть на эту ссылку, начнется скачивание файла.
Настройка постоянного меню из кнопок под строкой ввода в Телеграм
1. Добавьте на экран Кнопки с подсказками, активируйте чекбокс Не сворачивать кнопки в Телеграме.
2. Создайте Развилку для Кнопок с подсказками, заполните все необходимые настройки.
3. Продублируйте Развилку с помощью кнопки Дублировать в настройках компонента.
4. Поместите копии Развилки в конце всех экранов, куда ведут кнопки.
5. Сохраните изменения.
Теперь кнопки не исчезнут и будут всегда активны при нажатии.
Текст перед кнопками повторно приходить не будет. Если нужно, чтобы текст приходил, перед копиями Развилок нужно добавить копии Кнопок с подсказками.
Также можно предусмотреть неожиданный ввод от пользователя, т.е. если он напишет сообщение вместо нажатия на кнопку.
Для этого нужно во все Развилки добавить экран для перехода по умолчанию, на котором будет еще одна копия Развилки.
