С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Текст** можно ввести текстовое сообщение, эмодзи для эмоциональной разгрузки текста и ссылки на сторонние ресурсы, например, Youtube, Telegram. Помимо этого вы можете использовать макропеременные в вашем сообщении. Так же текст можно форматировать в некоторых мессенджерах, что так же позволит сделать его более приятным глазу и читабельным. Вот несколько примеров форматирования:| Мессенджер | Форматирование | Спецсимволы |
| Telegram | Жирный текст | \*\***Жирный текст**\*\* |
| Текст курсивом | *\_\_Текст курсивом\_\_* | |
| Зачеркнутый текст | ~~ | |
| Моноширинный текст | `Моноширинный текст` | |
| ```Моноширинный текст 2``` | ||
| Ссылка в тексте | \[Текст\](Ссылка) | |
| Скрытый текст или spoiler | ||Скрытый текст|| | |
| Жирный текст | \***Жирный текст**\* | |
| Текст курсивом | *\_Текст курсивом\_* | |
| Зачеркнутый текст | ~ | |
| Моноширинный текст | ```Моноширинный текст``` | |
| Цитирование | > Цитирование | |
| Встроенный код | `Код` | |
Макропеременные доступные для команды **Отправить текст** можно посмотреть на странице **[Доступные макропеременные для команды Отправить текст и Email](https://docs.metabot24.ru/books/03-nastroika-botov/page/dostupnye-makroperemennye-dlya-komandy-otpravit-tekst-i-email "Доступные макропеременные для команды Отправить текст и Email")**
# Отправить изображение и Отправить файл **Результатом работы данных команд является сообщение с изображением или файлом отправленное пользователю бота.** Функциональную команду **Отправки изображения** можно использовать для передачи информации пользователю в графическом виде, что часто бывает проще сделать, чем написать текст. На основании команды **Отправки файла** можно настроить отправку текстового файла, презентации, прайс-листа и файла другого формата. ### Отправить изображениеС пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Файл с изображением** необходимо с помощью кнопки **Выберите файл***,* загрузить файл с изображением из проводника. Данная команда поддерживает любые графические файлы. По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/6XQRu2YR1ZdHYxsx-image.png) ### Отправить файлС пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
Следующие поля являются обязательными: - **Получатель(-ли)** — email пользователя-получателя уведомления. Пользователей может быть несколько, тогда email указываются последовательно через запятую (например: email1@mail.ru, email2@mail.ru и т.д.); - **Тема** — тема email уведомления; - **Содержимое** — текстовое содержания email уведомления (может содержать макропеременные).Помните, что **текстовое содержимое** email письма - это **HTML разметка**! Это значит, что все текстовые строки должны заключаться в символы **<b></b>**, а перенос строки обозначаться символом **<br>**. Макропеременные описываются без заключения в символы.
Макропеременные доступные для команды **Email** можно посмотреть на странице **[Доступные макропеременные для команды Отправить текст и Email](https://docs.metabot24.ru/books/03-nastroika-botov/page/dostupnye-makroperemennye-dlya-komandy-otpravit-tekst-i-email "Доступные макропеременные для команды Отправить текст и Email").**
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/4kLSu7o8xLNL3FGK-image.png) # Установить статус лида **Результатом работы данной команды является присвоение статуса лиду в боте.** Статусы необходимы для классификации клиентов по этапам их обработки. С помощью статусов бот различает логику взаимодействия с клиентом. Общий принцип данной команды таков — обязательно должен присутствовать начальный статус и два финальных статуса — для успешного и не успешного исхода. Между ними может быть любое количество статусов, это зависит от специфики вашего бизнеса и настройки бота.Подробнее со статусами вы можете познакомиться на странице **[Статусы](https://docs.metabot24.ru/books/metabot-platform/page/statusy "Статусы")**.
Данную команду можно добавить в скрипт, выбрав пункт **Установить статус лида** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/5muyGQQYtaL4ivTH-komandy.png) После выбора данной команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/3ZcutbGR1GKgqSvD-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Новый статус обращения** необходимо выбрать статус из выпадающего списка или добавить новый статус. Новый статут добавляется кнопкой **Создать новый** в выпадающем списке: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/D2hO4UIt2PlFwQEu-image.png) В отрывшемся диалоговом окне следует заполнить поле **Название** и нажать кнопку **Создать**: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/0aH5Lq50p9j4Vw6a-image.png) По кнопке **Создать** в диалоговом окне настроек свойств как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/qoPttEO6dwWZv2R1-image.png) # Выполнить скрипт **Результатом работы данной команды является мгновенный переход бота на указанный скрипт.** Данная команда помогает настроить маршруты в боте и связать скрипты между собой. Самым ярким примером ее использования является создание в боте главного меню, к которому в конце будут приходить все маршруты. Добавить в скрипт ее можно, выбрав пункт **Выполнить скрипт** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/zUV2eUb5CqkZi8H0-komandy.png) После выбора данной команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/FG92eY018bl58xsu-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В параметре **Скрипт** необходимо выбрать из выпадающего списка скрипт, в который будет совершен переход. По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/LuhYIxMYfonwAQGS-image.png) # Запросить значение **Результатом работы данной команды является сохранение значения данного пользователем в атрибуты лида.** Общий принцип данной команды таков - бот задает вопрос пользователю, пользователь вводит ответ, значение этого ответа запоминается в боте. В большинстве своем эта команда используется для сбора контактных данных клиента. Добавить в скрипт ее можно, выбрав пункт **Запросить значение** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/oZLNZCqAECJJxEnm-komandy.png) После выбора данной команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/ebBjA5lSQR811rbq-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
Следующие поля являются обязательными: - **Имя переменной** — имя, с которым переменная будет записана в базу данных; - **Шаблон валидации** — список шаблонов для вводимого пользователем значения (при выборе шаблона появятся два дополнительных поля): - **Регулярное выражение** — выражение задающее возможные значения, которые пользователь может ввести; - **Сообщение об ошибке** — сообщение, выскакивающее при введении пользователем значения несоответствующего регулярному выражению; - **Подсказка-приглашение** — текстовое сообщение помогающее пользователю понять какое значение ему требуется ввести. #### Шаблоны валидации Шаблон валидации задает ограничение на вводимые пользователем значения. Если пользователь ввел значение несоответствующее шаблону, то ему придет сообщение об ошибке. Нужно это для исключения разных форматов одной переменной. Ведь есть человеческий фактор и каждый может написать ту же дату по-разному. Ниже перечислены все существующие на платформе шаблоны и их значение.| Шаблон валидации | Описание |
| Дата ДД.ММ.ГГГГ | Дата в соответствующем формате |
| Дата ММ.ДД.ГГГГ | Дата в соответствующем формате |
| Дата ГГГГ.ММ.ДД | Дата в соответствующем формате |
| Российский номер телефона | Номер телефона в формате +7 (xxx) xxx-xxxx |
| Российский номер телефона, компактно | Номер телефона в формате 7xxxxxxxxxx |
| Российский мобильный | Мобильный в формате +7 (9xx) xxx-xxxx |
| Российский мобильный, компактно | Мобильный в формате 79xxxxxxxxx |
| Число | Только числовые символы |
| Формат email (\*@\*.\*) | |
| Произвольное рег. выражение | Регулярное выражение которое вы можете создать сами |
Как составить свое произвольное регулярное выражение можно узнать на странице [**Регулярные выражения**](https://docs.metabot24.ru/books/metabot-platform/page/regulyarnye-vyrazeniya "Регулярные выражения").
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/YblEyoEta2n7aHEk-image.png) Введенные значения будут записаны в раздел **Атрибуты** — тут их можно редактировать и удалять. Так же они отобразятся в поле **Атрибуты** в разделе **Лиды**.Подробнее с тэгами вы можете ознакомиться в статье **[Структура платформы](https://docs.metabot24.ru/books/metabot-platform/page/struktura-platformy "Структура платформы")** в разделе **11. Тэги и атрибуты**
Добавить в скрипт их можно, выбрав пункты **Добавить тэги** и **Удалить тэги** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/aAfgkjbHBeDOzf1j-komandy.png) После выбора команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/6NYeiM2QkUyuPm3z-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Тэги** необходимо ввести имя тэга и нажать **Enter**. Вы можете вводить в это поле больше одного тэга.Имена тегов пишутся одним словом, без пробелов. Если тэг состоит из нескольких слов, то слова разделяются между собой знаком "**\_**"
В случае команды **Удалить тэги**, если оставить поле **Тэги** пустым, то удалятся все тэги лида. По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/1ofB4xvPWoPolf9e-image.png)С тэгами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в **[Справочнике по функциям JS](https://docs.metabot24.ru/books/07-spravocnik-po-funkciyam-js/page/spravocnik-vsex-funkcii-Cgt#bkmrk-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D1%82%D1%8D%D0%B3%D0%B0%D0%BC%D0%B8:~:text=BC%25D0%25B8-,%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%82%D1%8D%D0%B3%D0%B0%D0%BC%D0%B8,-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4 "Справочник всех функций")**
# Добавить контекст и удалить контекст **Результатом работы данных команд является добавление контекста скрипту или его удаление.** Контекст необходимо использовать как дополнительный параметр выполнения маршрутов при настройке бота. На его основании можно гибко настроить ветку выполнения маршрута по ранее выполненным действиям пользователя. Если при выполнении скрипта включается выполнение того или иного контекста, то бот будет выполнять только маршруты с данным контекстом. Добавить в скрипт их можно, выбрав пункты **Добавить контекст** и **Удалить контекст** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/a4TxZNBvfTWQIUxa-komandy.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Контекст** необходимо ввести имя контекста и нажать **Enter**. Вы можете вводить в это поле больше одного контекста.Имена контекстов пишутся одним словом, без пробелов. Если контекст состоит из нескольких слов, то слова разделяются между собой знаком "**\_**"
В случае команды **Удалить контекст**, если оставить поле **Контекст** пустым, то удалятся все контексты бота.С контекстами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в **[Справочнике по функциям JS](https://docs.metabot24.ru/books/07-spravocnik-po-funkciyam-js/page/spravocnik-vsex-funkcii-Cgt#bkmrk-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0%D0%BC%D0%B8:~:text=BC%25D0%25B8-,%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0%D0%BC%D0%B8,-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4 "Справочник всех функций")**
# Повторить вопрос **Результатом работы данной команды является выполнение последней команды после которой произошла ошибка.** Функциональную команду вывода повторного вопроса используют, если пользователь указал неправильный код в меню или система не распознала ответ на поставленный вопрос. Команда **Повторить вопрос** применяется для дополнительного скрипта с типом **Fallback** и позволяет гибко настроить взаимодействие бота с пользователем. Таким образом, предотвращается остановка работы бота из-за нераспознанного или ошибочного ответа пользователя. Добавить в скрипт ее можно, выбрав пункт **Повторить вопрос **из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/EiJ3xKvvTrRlBtoT-komandy.png) После выбора данной команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/cvUfbimVRvwZP1rm-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/HqjHRsUBVPugJizc-image.png)Помните, что лучше всего использовать данную команду в скриптах типа **Fallback**. Добавьте в него команду **Отправить текст** с информационным сообщением пользователю о дальнейших действиях, а затем саму команду **Повторить вопрос**.
# Выполнить триггер **Результатом работы данной команды является прямой вызов триггера с проверкой условий в нем.** [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/zEkeL2euUXGOWYvq-komandy.png) В большинстве случаев проще использовать данную команду для вызова триггера в нужном месте. чем использовать подписание на событие и настраивать триггер в точке скрипта с помощью JS условия.С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В команде есть следующие поля: - **Триггер** — выпадающий список ранее созданных триггеров. Выбранный триггер будет вызываться командой; - **Запустить указанный Триггер в** — дата и время с погрешностью в одну минуту, когда будет запущен триггер; - **Запустить указанный Триггер через (минут)** — количество минут спустя которое будет запущен триггер.Параметр **Запустить указанный Триггер через (минут)** игнорируется, если указано точное время запуска в поле **Запустить указанный Триггер в**.
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/uhEew0lt3iiNiTZY-image.png) Здесь команда имеет операцию **Перейти к триггеру**. Переход по кнопке этой операции открывает форму редактирования данного триггера в разделе **Триггеры**. # Выполнить JavaScript **Результатом работы данной команды является выполнение написанного в параметрах команды JavaScript кода.** Функциональная команда позволяет выполнить JavaScript, например для установки значений глобальных переменных (переменных бота) или атрибутов лида. Добавить в скрипт ее можно, выбрав пункт **Выполнить JavaScript** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/8pjcYBxJdRVc1T2S-komandy.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В диалоговом окне, в поле **JavaScript** необходимо создать синтаксически верно написанный JavaScript.Все методы и их описание вы можете посмотреть в **[Справочнике по функциям JS](https://docs.metabot24.ru/books/7-spravocnik-po-funkciyam-js/page/spravocnik-vsex-funkcii-Cgt "Справочник всех функций")**.
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/PTExPvZdBM0BxZ1i-image.png) # Стоп **Результатом работы данной команды является остановка работы бота.** Функциональную команду Стоп обычно используется в конце скрипта одной или нескольких веток бота. Добавить в скрипт ее можно, выбрав пункт **Стоп** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/YdNbvVrSzrlaIAVY-komandy.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/IBWhDonTNe1d2FWb-image.png)Необходимо помнить, что данная команда должна быть добавлена в конце скрипта, так как работа бота остановится и все последующие команды не будут выполнены!
Для того, чтобы бот замолчал, но Лид мог в любой момент возобновить работу бота, необходимо перед командой **Стоп** выполнить команду **Установить статус лида.** Данная команда должна установить статус, для которого будет работать стартовый маршрут или будет выполнена команда **Вернуть боту**.
# Распознать NLP намерение **Результатом работы данной команды является выполнение соответствующего скрипта по распознанному намерению.** Если намерение не будет распознано или скрипт по намерению не найден, то будет выполнена следующая команда скрипта.Подробнее с тем как работают NLP намерения можно узнать из урока **[Автоматизируем службу поддержки](https://docs.metabot24.ru/books/metabot-platform/page/avtomatiziruem-sluzbu-podderzki "Автоматизируем службу поддержки")**.
Добавить в скрипт ее можно, выбрав пункт **Распознать NLP намерение** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/oDNXRpNFfpsUfdo7-komandy.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Текст для обнаружения намерения (будет отправлен в NLP)** нужно ввести текст, который соответствует нужному вам намерению в **Dialogflow**. По этому намерению и будет выполнен соответствующий скрипт бота. По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/vY8lYG6865n0vVV4-image.png) # Перевести на оператора и Вернуть боту **Результатом работы данных команд является перевод диалога на оператора CRM или перевод обратно с оператора на бота.** Функциональная команда **Перевести на оператора** позволяет выполнить перевод на оператора и установить по лиду параметр **Чат передан оператору***.* А функциональная команда **Вернуть боту** позволяет выполнить возврат диалога обратно боту и автоматически снимает по лиду этот параметр. Добавить в скрипт их можно, выбрав пункты **Перевести на оператора** и **Вернуть боту** из списка **Команд**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-12/x7lAzItnFgm8FKwC-komandy.png) После выбора команды в списке **Команд** перед вами откроется диалоговое окно настройки свойств: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/XMPK1ysE485tz7gX-image.png)С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
В поле **Если не поддерживается, то перевести в статус** можно указать в какой статус при выполнении данной команды будет переведен лид. Поле не обязательное для заполнения.При выполнении команды **Перевести на оператора** по Лиду будет установлен параметр **Чат передан оператору** и бот будет молчать. Командой Вернуть боту по лиду снимается параметр **Чат передан оператору** и она должна быть установлена в скрипт, который будет запускаться по маршруту с активным параметром **Действует при переводе на оператора***.*
По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/n9DlSiXITavuQrn3-image.png)Как правильно использовать данные команды можно подробнее узнать в уроке **[Автоматизируем службу поддержки](https://docs.metabot24.ru/books/metabot-platform/page/avtomatiziruem-sluzbu-podderzki "Автоматизируем службу поддержки")**.
С переводом на оператора так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в **[Справочнике по функциям JS](https://docs.metabot24.ru/books/07-spravocnik-po-funkciyam-js/page/spravocnik-vsex-funkcii-Cgt#bkmrk-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0%D0%BC%D0%B8:~:text=BD%25D0%25B8-,%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D0%BF%D0%B5%D1%80%D0%B5%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC%20%D0%BD%D0%B0%20%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0,-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B%20bot "Справочник всех функций")**
# Выполнить JavaScript Callback **Результатом работы данной команды является прием файлов в Телегам боте, отправленных пользователем.**С пунктом **Использовать условие** вы можете познакомиться на странице **[Условие выполнения команды JS](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/uslovie-vypolneniya-komandy-js "Условие выполнения команды JS")**.
Следующие поля являются обязательными: - **Сообщение-вопрос отправляемое до старта данной команды** — сообщение которое будет отправлено в мессенджер при старте данной команды, поле обязательно для заполнения ТОЛЬКО, если выключено поле **Запустить Callback сразу при старте этой команды**; - **Сообщение при возникновении ошибки** — сообщение которое будет отправлено в мессенджер при возникновении ошибки; - **Запустить Callback сразу при старте этой команды** — если поле неактивно, то JavaScript код запустится только после того как пользователь получит **Сообщение-вопрос отправляемое до старта данной команды** в мессенджер и что-то ответит;Если поле активно и это первый запуск **JavaScript Callback данной команды**, то в **JavaScript** будет установлена в **true** системная предопределенная переменная **isFirstImmediateCall**, во всех других случаях **isFirstImmediateCall** устанавливается в **false**. Это необходимо, чтобы можно было проинициализировать компонент и, например, выслать текст вопроса или отправить изначально меню и т.д.
- **JavaScript Callback** — здесь указывается исходный код вашего JavaScript компонента. По кнопке **Создать** как итог команда появится в редакторе скрипта: [](https://docs.metabot24.ru/uploads/images/gallery/2023-02/MF3NEyu8n6ukv4jY-image.png) ### Возвращаемые значения JavaScript Callback всегда должен возвращать данные с помощью **«return»** в определенном формате: ##### Для завершения инициализации - **return null**. Используется, чтобы платформа ничего не делала со своей стороны, ожидая ответа пользователя. Вместо **retrurn null** можно ничего не указывать после ключевого слова **return**. ##### Для прерывания цикла - **return true**; - **return { "result": true ... другие параметры }**; - **return { "break": true ... другие параметры }**. Используется для выхода из замыкания и переходу к следующей команде текущего скрипта (если не указан параметр для перехода к другому скрипту).Прерывание с помощью **throw new Error("break")** недопустимо, в таком случае JS прервется, но из зацикливания не выйдет, т.е. будет распознано как **return null.**
| Название | Макропеременная |
| Название бота | {{ $**botName** }} |
| Имя лида | {{ $**name** }} |
| Значение атрибута | {{ $**varName** }} |
| Тэг лида | {{ #**tagName** }} |
| Контекст лида | {{ @**contextName** }} |
| Последнее распознанное NLP намерение | {{ $**nlpLastIntentName** }} |
| Последний распознанный NLP Action | {{ $**nlpLastActionName** }} |
| Последний текстовый результат NLP | {{ $**nlpLastReponseText** }} |
| Заявка | {{ **ticket**.\* }} |
| JSON параметры передаваемые через методы JS | {{ $$**sys\_last\_script\_request\_params**.**varName** }} |
Что такое атрибуты вы можете подробнее узнать на странице **[Структура платформы](https://docs.metabot24.ru/books/metabot-platform/page/struktura-platformy "Структура платформы")** в разделе **11. Тэги и атрибуты**.
#### Тэг лида {{ #**tagName** }} — тэг лида, где вместо **tagName** нужно указать название тэга. Содержит значение “да” или “нет”, в зависимости от того установлен или нет соответствующий тэг для лида.Что такое тэги вы можете подробнее узнать на странице **[Структура платформы](https://docs.metabot24.ru/books/metabot-platform/page/struktura-platformy "Структура платформы")** в разделе **11. Тэги и атрибуты**.
#### Контекст лида {{ @**contextName** }} — контекст лида, где вместо **contextName** нужно указать название контекста. Содержит значение “да” или “нет”, в зависимости от того установлен или нет соответствующий контекст для лида. #### Последний текстовый результат NLP Используется в сочетании с DialogFlow Smalltalk Actions - для вывода в качестве ответа бота.Узнать, что такое Smalltalk вы можете на странице **[Dialogflow: Small talk](https://docs.metabot24.ru/books/3-instrukciya-polzovatelya/page/dialogflow-small-talk "Dialogflow: Small talk")**.
#### Заявка {{ **ticket**.\* }} *— где* **\*** — любое из полей перечисленных ниже: - **id** — id заявки; - **business\_id** — id бизнеса; - **bot\_id** — id бота; - **author\_person\_id** — id персоны-автора заявки; - **client\_person\_id** — id персоны-клиента заявки; - **assigned\_person\_id** — id персоны-исполнителя заявки; - **ticket\_type\_id** — id типа заявки; - **status\_id** (status.id ; статус.id) — id статуса заявки; - **title** (заголовок ; название) — название заявки; - **ticket.description** (ticket.описание) — описание заявки; - **ticket.createdAt** (ticket.датаСоздания) — дата создания заявки; - **ticket.updatedAt** (ticket.датаОбновления) — дата последнего обновления заявки; - **status.name** (статус.имя) — название статуса заявки; - **authorPerson.fullName** (автор.полноеИмя) — полное имя автора заявки; - **assignedPerson.fullName** (исполнитель.полноеИмя) — полное имя исполнителя заявки; - **clientPerson.fullName** (клиент.полноеИмя) — полное имя клиента заявки; - **ticketType.name** (типЗаявки.имя) — название типа заявки; - **ticket.field\_{ID}** ({ID} — id поля) — содержимое поля заявки; - **ticket.{name}** ({name} — название поля) — содержимое поля заявки; - **ticket.{title}** ({title} — заголовок поля) — содержимое поля заявки. В зависимости от выбранного поля будет содержать соответствующее ему значение.Подробнее с заявками вы можете познакомиться на странице **[Заявки](https://docs.metabot24.ru/books/2-instrukciya-polzovatelya/page/zayavki "Заявки")**.
#### JSON параметры {{ $$**sys\_last\_script\_request\_params**.**varName** }} — JSON параметры передаваемые через методы JS, например, через **bot.runScriptByCodeForPerson()** в параметре **jobParams**. Вместо **varName** нужно указать название поля JSON. Содержит значения соответствующей JSON переменной сохраненной в атрибутах лида после вызова метода, перехода по DeepLink или получения запроса API. # Регулярные выражения **Регулярное выражение** — это шаблон задающий ограничение на вводимые пользователем значения. Оно может состоять как из обычных, так и из специальных символов и их комбинаций. Обычные символы интерпретируются буквально, например регулярное выражение **абв** интерпретируется как строгая последовательность соответствующих букв в этом порядке. Помимо этого, для составления более сложных регулярных выражений используются специальные символы. Их написание и значение подробнее расписаны ниже. ### Специальные символы| Символ | Описание | Пример |
| Общие символы и символы количества | ||
| **\\** | Для **обычных символов**, означает что следующий символ будет интерпретироваться как специальный. Для **специальных символов**, означает что следующий символ будет интерпретироваться буквально. | **\\а** — символ **а** становится специальным символом, означающим границу слова. **\\\*** — специальный символ **\*** интерпретируется как обычный символ "звездочка". |
| **^** | Следующий символ должен присутствовать в начале строки. | **^А** — символ **А** должен быть первым в строке. |
| **$** | Предыдущий символ должен присутствовать в конце строки. | **а$** — символ **а** должен быть последним в строке. |
| **\*** | Предыдущий символ может быть повторен 0 или больше раз. | **а\*** — символ **а** может не быть в строке, а может повториться множество раз. |
| **+** | Предыдущий символ должен быть повторен 1 или больше раз. | **а+** — символ **а** может повториться один раз в строке, а может повториться множество раз. |
| **?** | Предыдущий символ должен быть повторен 0 или 1 раз. | **а?** — символ **а** может не быть в строке, а может быть один раз. |
| **.** | Любой символ кроме переноса строки. | **a.c** равно **abc**, **a1c** и тд. |
| **x|y** | В строке должен присутствовать либо x либо y. | **abc|xyz** — в строке может быть **abc** или **xyz**. |
| **{n}** | Предыдущий символ должен быть повторен n раз. | **а{2}** — **а** должна быть повторена в строке дважды. |
| **{n,m}** | Предыдущий символ должен быть повторен не меньше n раз, но и не больше m раз. | **а{2,5}** — **а** должна быть повторена в строке хотя бы дважды и не больше пяти раз. |
| Скобочные группы | ||
| **(x)** | Объединение символов в единый элемент (с запоминанием). | **abc\*** — **\*** относится только к **c**. **(abc)\*** — **\*** относится ко всему выражению в скобках. |
| **(?:x)** | Объединение символов в единый элемент (без запоминания). | |
| **x(?=y)** | Соответствует x только если за ним идет y. | **ab(?=c)** — после **ab** должна быть **c**. |
| **x(?!y)** | Соответствует x только если за ним не идет y. | **ab(?!c)** — после **ab** не должно быть **c**. |
| Соответствия набору символов | ||
| **\[xyz\]** | Соответствует любому из символов в скобках. | **\[abcd\]** или **\[a-d\]** — строка должна состоять из любых символов от **a** до **d**. |
| **\[^xyz\]** | Соответствует любому из символов не в скобках. | **\[^abcd\]** или **\[^a-d\]** — строка должна исключать символы от **a** до **d**. |
| **\[\\b\]** | Бэкспейс. | **\[\\b\] — находит символ бэкспейса в строке. |
| **\\b** | Граница слова. | **\\b** — перед или после предыдущего символа должен быть пробел или другая граница слова. |
| **\\d** | Цифровой символ. | **\\d** — любой из символов от 0 до 9. |
| **\\D** | Нецифровой символ. | **\\D** — любой из символов кроме символов от 0 до 9. |
| **\\s** | Пробел. | **\\s** — находит пробел, табуляцию, перенос строки. |
| **\\S** | Не пробел. | **\\S** — любой из символов кроме пробела, табуляции, переноса строки. |
| **\\w** | Цифробуквенные символы и нижнее подчеркивание. | **\\w** — любой из символов от 0 до 9, от А до Я и **\_**. |
| **\\W** | Нецифробуквенные символы. | **\\w** — любой из символов кроме символов от 0 до 9, от А до Я и **\_**. |
| **\\0** | NULL | **\\0** — находит пустое множество. |
| (0?\[1-9\]|\[12\]\[0-9\]|3\[01\]) | |
| 0?\[1-9\] | 0 может быть повторен 1 или 0 раз, а за ним идет любая цифра кроме 0. |
| \[12\]\[0-9\] | 1 или 2, а за ними любая цифра. |
| 3\[01\] | 3 и 0 или 1. |
| | | или. |
| (0?\[1-9\]|1\[012\]) | |
| 1\[012\] | 1 и 0 или 1 или 2. |
| \\.(19|20)\\d | |
| \\. | обычный символ точки. |
| 19|20 | 19 или 20. |
| \\d | любая цифра. |
| \[^@\\s\]+ | |
| \[^@\\s\] | любой из символов кроме @ и пробела. |
| + | предыдущий символ может быть повторен 1 или более раз. |
| @\[^@\\s\]+ | |
| @ | символ @. |
| \\.\[^@\\s\]+ | |
| \\. | обычный символ точки. |
| (?:\[a-z0-9!#$%&'\*+\\/=?^\_`{|}~-\]+(?:\\.\[a-z0-9!#$%&'\*+\\/=?^\_`{|}~-\]+)\*|"(?:\[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21\\x23-\\x5b\\x5d-\\x7f\]|\\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f\])\*")@(?:(?:\[a-z0-9\](?:\[a-z0-9-\]\*\[a-z0-9\])?\\.)+\[a-z0-9\](?:\[a-z0-9-\]\*\[a-z0-9\])?|\\\[(?:(?:(2(5\[0-5\]|\[0-4\]\[0-9\])|1\[0-9\]\[0-9\]|\[1-9\]?\[0-9\]))\\.){3}(?:(2(5\[0-5\]|\[0-4\]\[0-9\])|1\[0-9\]\[0-9\]|\[1-9\]?\[0-9\])|\[a-z0-9-\]\*\[a-z0-9\]:(?:\[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21-\\x5a\\x53-\\x7f\]|\\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f\])+)\\\]) |
| \[\\+\\-\]?\[\\d| \]+\[\\.\\,\]?\[\\d| \]\* |
| (^(\\+?7|\\+?37)\\d{10}$|отмена|назад|выход|стоп) |
| \[А-Я\]{1}\[а-я\]{2,20} |