Конструктор модулей
Руководство по Конструктору модулей Multogram: как собрать собственный модуль автоматизации Telegram — сценарий из готовых действий, форма настроек из ресурсов, тест и сборка в файл .agm. Устройство модуля, ключевые понятия и порядок работы.
Конструктор модулей — визуальный редактор, в котором вы собираете собственный модуль
автоматизации: сценарий из готовых действий (Telegram, файлы, сеть, данные) и форму настроек,
которую пользователь заполнит перед запуском. Готовый модуль — один файл .agm: его устанавливают и
запускают на вкладке Модули, как встроенный режим.
Конструктор открывается с вкладки Конструктор модулей кнопкой Создать модуль и доступен на тарифах Pro и Max — см. Конструктор модулей в списке режимов. Программировать не нужно: сценарий собирается из блоков, а код пишут только там, где готовых действий не хватает.
Из чего состоит модуль
| Часть | Что это | Где в конструкторе |
|---|---|---|
| Сценарий | Логика модуля: функции из действий, которые выполняются сверху вниз. Работа начинается с функции Main | Полотно и панель Действия |
| Форма настроек | Поля, которые пользователь заполняет перед запуском. Строится из ресурсов автоматически | Панель Ресурсы |
| Данные модуля | Название, описание, автор, версия и обложка — то, что видно на карточке модуля | Окно Сборка модуля |
| Требования | Режимы Multogram, которые нужны модулю. Определяются по действиям сценария | Окно Сборка модуля |
Ключевые понятия
| Понятие | Что значит |
|---|---|
| Действие | Один шаг сценария: отправить сообщение, прочитать файл, сделать запрос |
| Функция | Именованный набор действий. Main — точка входа модуля |
Переменная [[имя]] | Значение, которое сценарий вычисляет сам по ходу работы |
Ресурс {{имя}} | Настройка, которую задаёт пользователь модуля. Из ресурсов строится форма |
| Поток | Одна линия выполнения. Модуль запускается в несколько потоков одновременно |
Проект .agmp | Редактируемый исходник модуля |
Модуль .agm | Запечатанная сборка для установки и запуска |
Порядок работы
Создайте модуль. Конструктор откроется с готовым шаблоном: функцией входа в аккаунт и полем выбора аккаунтов — см. Первый модуль.
Соберите сценарий из действий на полотне — см. Полотно и действия и Условия, циклы и ошибки.
Вынесите настройки в ресурсы — всё, что пользователь должен выбрать сам: цели, тексты, задержки, файлы. См. Ресурсы и форма модуля.
Проверьте тестом прямо в конструкторе — см. Тестирование и отладка.
Сохраните проект и соберите модуль .agm — см. Сохранение и сборка.
Разделы
Первый модуль
Пошаговый пример: аккаунты, поле настроек, сообщение в чат, тест и сборка.
Окно конструктора
Панели, кнопки, горячие клавиши и настройки.
Полотно и действия
Добавление, настройка и поиск действий, подстановка значений.
Условия, циклы и ошибки
IF, FOR, FOREACH, WHILE, Try-Catch и как писать условия.
Переменные
Откуда берутся, типы, поля объектов и общие значения потоков.
Функции
Main, свои функции с параметрами и возвращаемым значением.
Ресурсы и форма модуля
Типы полей, группы, условия видимости, переводы, тестовые значения.
Потоки и аккаунты
Как модуль работает в несколько потоков и делит аккаунты.
Свой код
JavaScript, Python, Node.js и командные оболочки внутри сценария.
Тестирование и отладка
Тесты, инспектор переменных и логов, поиск причин ошибок.
Сохранение и сборка
Проект .agmp, сборка .agm, данные модуля и требования к режимам.
ИИ-ассистент
Чат, который объясняет и правит сценарий модуля.
Модули и действия
Справочник: все модули конструктора и их действия.
Вопросы и проблемы
Частые вопросы и что делать, если модуль не работает.
Обновлено
Конструктор модулей
Вкладка «Конструктор модулей» в Multogram: создание собственных модулей автоматизации в визуальном редакторе — своя логика и своя форма настроек. Проекты .agmp и готовые модули .agm, недавние модули, требования и советы.
Первый модуль
Пошаговый пример в Конструкторе модулей Multogram: модуль, который с каждого выбранного аккаунта отправляет сообщение в чат. Шаблон нового модуля (Main, ProcessAccount, AuthSession), поля настроек, тест и сборка .agm.