Привет! Это команда Нодуля. Скорее всего вы уже знакомы с low-code автоматизациями и облачной разработкой. Если нет – ничего. Ведь перед вами детальный гайд о том, как использовать 80% возможностей платформы Нодуль, изучив всего лишь 20% ее функционала. Итак, приступим:

Основа всех автоматизаций

"Trigger → Action" это основной принцип платформы. Все начинается с триггера. Как только триггер активирует ваш сценарий, начинают исполняться последующие узлы. Представьте это так: если что-то происходит в одной системе, то другая система автоматически выполняет заданное действие.

module – модуль, нодуль, узел | scenario – сценарий, воркфлоу, автоматизация

В каждом сценарии есть только один триггер, но количество последующих действий не ограничено.

Триггеры

Всего существует три типа триггеров:

Из библиотеки зерокод приложений
Запланированные (Schedule)
Вебхук

Триггеры #1 Зерокод приложения

Отличный пример: модуль Google Sheet, который вы видите на скриншоте выше. Это означает, что как только происходит изменение в определенной таблице Google, ваш сценарий запускается автоматически. Для использования зерокод триггеров потребуется лишь авторизация. Далее для исполнения узла заполняем необходимые поля в пару кликов.

*завершаете настройку триггера, заполнив необходимые поля*

Триггеры #2 Запланированные (Schedule)

Этот модуль позволяет активировать ваш сценарий с определенной периодичностью. Указываете интервал в формате CRON – и готово. Если не знакомы с CRON, наш ИИ ассистент всегда на подмоге. Об ИИ Нодуля чуть позже.

*ии Нодуля предоставляет нужное CRON выражение*

Триггеры #3 Вебхук

Этот модуль запускает сценарий каждый раз, когда на Webhook URL поступает внешний сигнал. Это как позвонить исполнителю и сказать: "Зеленый свет, приступаем!".
Кроме того, если в сценарий необходимо передавать информацию для дальнейшей работы с ней – это делается с помощью Webhook URL. Кстати, этот адрес можно кастомизировать как показано ниже.

можно редактировать подчеркнутую часть URL

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

Сначала сохраняем и активируем сценарий.

Затем вставляем Webhook URL в адресную строку браузера и добавляем три ключа и их значения: бюджет, электронная почта и имя. Нажимаем Enter.

формат передачи данных: ?key_1=parameter1&key_2=parameter_2&key_3+parameter_3

Идём обратно на Нодуль и находим Историю.

история расположена в правом верхнем углу интерфейса

Кликаем на иконку с глазом в строке нашего запуска. И теперь рядом с модулем Webhook мы видим число в кружочке (в нашем случае это единица), которое символизирует полученный результат исполнения узла. Нажав на него, откроется окно, где вы увидите переданный контент. Все три ключа (бюджет, электронная почта и имя) и их параметры на месте!

иконка глаза рядом с запуском развернет узлы с историческими данными

С помощью функции "История" вы можете проследить за всем, что происходило с вашим сценарием ранее. Хотите проверить переданные данные? Используйте иконку глаза. Есть необходимость перезапустить последнюю версию сценария с предыдущими данными? Для этого пригодиться функция повтора.

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

подстановка данных возможна после нажатия на поле, которое поддерживает этот формат

Действия

Существует 4 основные группы, о которых следует знать:

Из библиотеки зерокод приложений
HTTP-запрос
Webhook
JavaScript

Действие #1 Зерокод приложения

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

примеры готовых интеграций из зерокод библиотеки

Пока мы находимся в бета-версии, наша библиотека готовых интеграций ограничена основными приложениями, такими как Airtable, ChatGPT, Google Drive/Sheets/Docs и др.

Однако вы не обязаны ждать, когда мы добавим нужное вам приложение, ведь мы упростили процесс создания собственных интеграций. Следующий тип действия прекрасно это демонстрирует:

Действие #2 HTTP-запрос

Данный модуль позволяет вашему сценарию взаимодействовать с любым внешним приложением.

Давайте рассмотрим пример: предположим, вы хотите создать карточку Trello в рамках своего сценария. Сделать это довольно просто:

Посетите документацию API Trello и найдите cURL example для действия, которое вы хотите выполнить в вашем сценарии на Нодуле. Воспринимайте cURL как готовый шаблон, который показывает, как другие системы должны коммуницировать с Trello.

как выглядит cURL example в документации Trello

Просто скопируйте и вставьте его в ваш HTTP-запрос, как показано ранее. После этого ваш HTTP-запрос будет настроен с необходимым методом HTTP и правильным URL для вызова API Trello.

окно для вставки cURL из документации любого приложения

Затем добавьте ваши реальные API-ключ и API токен в URL который будет вызван. Кроме того, добавьте необходимые параметры для выполнения действия. В нашем случае, чтобы добавить новую карточку, мы должны указать ID колонки, где она должна быть размещена – idList.

ручное дозаполнение необходимых полей, связанных с вашим Trello аккаунтом

Готов. Теперь на одну нужную интеграцию на Нодуле стало больше! 🎉

Совет: любой настроенный кубик или даже весь сценарий можно копировать и вставлять в другие проекты на платформе. А так как копируются эти элементы как текстовый массив, вы можете легко передать файл коллеге или клиенту, чтобы они могли развернуть готовую автоматизацию в два клика.

Действие #3 Webhook response

Представьте себе, что ваш сценарий активировался благодаря Webhook. Он успешно выполнил все необходимые действия. И теперь, вы хотите об этом сообщить. Для этого служит модуль "Webhook response".
После завершения сценария он отправляет обратный отклик. Это может быть информация о том, что все прошло успешно, сообщение об ошибке или даже специфические данные, полученные в процессе выполнения.
Это особенно удобно, если внешняя система ищет подтверждение успешного выполнения сценария или ей нужны ответные данные. Для примера давайте рассмотрим простой сценарий:

webhook активирует сценарий, JavaScript предоставляет HTML форму, webhook response выводит её вам на экран

Результат выполнения модуля JavaScript – это объект JSON с именем "HTML". Он содержит HTML-код формы веб-сайта, предназначенной для сбора ответов.
В ответе веб-хука мы выбираем этот JSON объект, так что когда вы получаете доступ к URL веб-хука, перед вами появляется сгенерированная HTML-форма.

Что за JSON? Это формат данных, который подходит для передачи информации между модулями на платформе.

Действие #4 JavaScript

И вот мы подходим к последнему, но не менее мощному инструменту — модулю JavaScript. На первый взгляд, кажется, что он создан для опытных разработчиков, но благодаря AI ассистенту (видите вкладку AI Chat?), даже новичок может пользоваться всеми преимуществами полноценного кода.

интерфейс модуля JavaScript, где в структуру кода можно подставлять данные

Этот модуль дает вам невероятную гибкость. Код исполняется в облаке и сразу же предоставляет результаты. Никакой дополнительной инфраструктуры для этого не требуется. К тому же, вам доступна интеграция с более чем 1,2 миллионами NPM пакетов – если вы ищете какое-то конкретное решение, есть большая вероятность, что кто-то уже создал подобное до вас.

И самое лучшее? Вам не нужно писать код самостоятельно! Прочитайте материал и убедитесь в этом сами:
👉 Бесплатный ИИ ассистент для работы с JavaScript автоматизирует что угодно по вашему запросу

платформа Нодуль
сообщество Телеграм

‍