Гайд
- 1
Что даёт модуль
Модуль приносит три вещи:
- Действия — шаги, которые вы кладёте в блок Action. Google Таблицы добавляют «Добавить строку», «Обновить строку» и «Удалить строку».
- Триггеры — некоторые модули добавляют ещё и способы запустить сценарий. У Stripe это вебхук платёжных событий, у Telegram — посты в канале и изменения участников.
- Доступы — модуль сам знает, что ему нужно (аккаунт Google, API-ключ), и спрашивает это один раз в одном месте, а не в каждом действии.
Модуль ставится в приложение целиком — то, которое выбрано в переключателе слева вверху, — а не в отдельный сценарий.
- 2
Откройте страницу «Модули»
Нажмите Модули в левом меню. Там две вкладки:
- Установленные — то, что уже стоит в этом приложении. Количество написано рядом с названием вкладки.
- Маркетплейс — всё, что можно добавить.
На вкладке «Маркетплейс» уже установленные модули по умолчанию скрыты. Включите переключатель Показывать установленные справа, чтобы увидеть весь список. Поиск над вкладками ищет и по названию модуля, и по названиям действий внутри него: наберите «строку» — найдутся Google Таблицы, даже если вы забыли название модуля.
Все карточки устроены одинаково: логотип и название, идентификатор с версией (
google-sheets@1.0.0), короткое описание и два счётчика — действий и триггеров. Нажмите на счётчик, чтобы прочитать полный список до установки.
- 3
Установите модуль
Нажмите Установить на карточке. Это весь шаг: действия модуля сразу появляются в приложении, а карточка переезжает на вкладку «Установленные».
Что будет дальше, подсказывают две метки:
- Требуется OAuth — нужен подключённый аккаунт (Google Таблицы, Gmail, Google Календарь, Notion).
- Нужен API-ключ — нужен ключ, который вы вставите сами (OpenAI, Stripe, YooKassa, TomoAds).
Нет метки — настраивать нечего. Модуль Telegram работает через бота, которого вы уже подключили, а модули генерации изображений и видео используют встроенных AI-провайдеров FlowCastle, поэтому ключ вставлять не нужно.
- 4
Настройка: ключи и аккаунты
Если модулю нужны ключи, окно настройки открывается сразу после установки — например «Настройка TomoAds». У каждого поля есть своя ссылка Как получить: она ведёт прямо на ту страницу внешнего сервиса, где лежит нужное значение. Под полем — короткая подсказка.
Делать это прямо сейчас не обязательно. Кнопка Позже закрывает окно, модуль остаётся установленным. Заполните поля и нажмите Сохранить ключи, когда будете готовы.
- 5
Что показывает вкладка «Установленные»
Каждая карточка на вкладке Установленные сообщает своё состояние:
- Без метки — всё готово к работе.
- Нужна настройка (оранжевая) — ключей нет. На карточке есть кнопка Настроить ключи, она открывает то же окно.
- Настроен (зелёная) — ключи сохранены. Окно можно открыть снова и заменить значение, а пустое поле оставит прежнее.
- Требуется OAuth — на карточке кнопка подключения аккаунта, например Подключить аккаунт Google. По нажатию открывается всплывающее окно входа провайдера, а после него карточка показывает, какой аккаунт подключён. Notion подключается так же.
Ключи и подключения хранятся на уровне приложения: один ключ Stripe работает во всех сценариях этого приложения.
- 6
Где появляются действия модуля
Нигде нового. Вернитесь на холст, откройте блок Action и нажмите Добавить действие. Под встроенными действиями в меню появился раздел Модули: действия сгруппированы по модулям, каждая группа — под своим логотипом.
Выберите любое — оно встанет в блок как обычное действие, со своими полями: таблица и строка для «Добавить строку», чат и текст для «Отправить сообщение». Всё, что написано про порядок действий, результаты и переменные в статье «Узел Action: что умеет бот», работает и здесь. Переменные попадают в поля модуля из окна выбора переменных и выглядят как чипы — например
{{lead_email}}в ячейке таблицы. Вручную их печатать не нужно.Кнопка Смотреть ещё внизу того же меню открывает маркетплейс поверх сценария, так что за модулем не придётся уходить с холста.
- 7
Что есть в каталоге сейчас
Двенадцать модулей:
- Telegram — работа с группами и каналами: отправить сообщение, фото или документ, создать ссылку-приглашение, проверить участника, ограничить, забанить, назначить администратором. Плюс два триггера: пост в канале и изменение участника.
- Google Таблицы — добавить, обновить и удалить строку в подключённой таблице.
- Gmail — отправлять письма, искать, читать, обновлять и удалять сообщения.
- Google Календарь — список календарей, создание и правка событий, проверка занятости.
- Notion — поиск по содержимому, создание и обновление страниц, запросы к источникам данных.
- OpenAI AI — спросить ChatGPT и получить текстовый ответ или сгенерировать речь.
- Stripe — платежи — checkout-сессии, оформление подписки, статус платежа, возвраты и вебхук платёжных событий.
- YooKassa — платежный провайдер — то же самое для российских платежей, со своим вебхуком.
- TomoAds — рекламные сообщения: способ зарабатывать на боте, а не брать деньги за него.
- Генерация AI-изображений — новые картинки по промпту.
- Генерация AI-видео — короткие ролики на 4–12 секунд. Рендер идёт несколько минут, поэтому запускайте такое действие в фоновом режиме.
- Обработка изображений — предсказуемая правка готовых картинок: наложение, обрезка, изменение размера и формата.
Отдельные статьи по каждому модулю ещё впереди. Пока полный список действий видно прямо на карточке — по кнопке со счётчиком.
- 8
Если что-то не получилось
В меню «Добавить действие» нет раздела «Модули». Скорее всего, модуль установлен в другое приложение. Проверьте переключатель слева вверху.
Действие модуля падает при работе бота. Откройте вкладку Установленные. Обычная причина — оранжевая метка «Нужна настройка» или неподключённый аккаунт: действие срабатывает, а внешний сервис его отклоняет.
Удаление предупреждает, что блоки могут перестать работать. Так и есть: вместе с модулем удаляются его действия. Сначала разберитесь с блоками, которые их используют.
- 9
Что дальше
Все части бота на месте — покажите его живым людям: Тест и публикация бота