Модули: Таблицы, AI, платежи и другие сервисы

Модуль приносит три вещи:

• Действия — шаги, которые вы кладёте в блок «Действие» (блок — один шаг сценария на холсте). Google Таблицы добавляют «Добавить строку», «Обновить строку» и «Удалить строку».
• Триггеры — некоторые модули добавляют ещё и способы запустить сценарий. У Stripe это вебхук платёжных событий — автоматическое уведомление, которое Stripe присылает при оплате, у Telegram — посты в канале и изменения участников.
• Доступы — модуль сам знает, что ему нужно (аккаунт Google, API-ключ), и спрашивает это один раз в одном месте, а не в каждом действии.

Модуль ставится в приложение целиком — то, которое выбрано в переключателе слева вверху, — а не в отдельный сценарий.

Нажмите Модули в левом меню. Там две вкладки:

• Установленные — то, что уже стоит в этом приложении. Количество написано рядом с названием вкладки.
• Маркетплейс — всё, что можно добавить.

На вкладке «Маркетплейс» уже установленные модули по умолчанию скрыты. Включите переключатель Показывать установленные справа, чтобы увидеть весь список. Поиск над вкладками ищет и по названию модуля, и по названиям действий внутри него: наберите «строку» — найдутся Google Таблицы, даже если вы забыли название модуля.

Все карточки устроены одинаково: логотип и название, идентификатор с версией (google-sheets@1.0.0), короткое описание и два счётчика — действий и триггеров. Нажмите на счётчик, чтобы прочитать полный список до установки.

Нажмите Установить на карточке. Это весь шаг: действия модуля сразу появляются в приложении, а карточка переезжает на вкладку «Установленные».

Что будет дальше, подсказывают две метки:

• Требуется OAuth — нужно войти в свой аккаунт сервиса и разрешить доступ (Google Таблицы, Gmail, Google Календарь, Notion).
• Нужен API-ключ — нужен ключ, который вы вставите сами (OpenAI, Stripe, YooKassa, TomoAds).

Нет метки — настраивать нечего. Модуль Telegram работает через бота, которого вы уже подключили, а модули генерации изображений и видео используют встроенных AI-провайдеров FlowCastle, поэтому ключ вставлять не нужно.

Если модулю нужны ключи, окно настройки открывается сразу после установки — например «Настройка TomoAds». У каждого поля есть своя ссылка Как получить: она ведёт прямо на ту страницу внешнего сервиса, где лежит нужное значение. Под полем — короткая подсказка.

Делать это прямо сейчас не обязательно. Кнопка Позже закрывает окно, модуль остаётся установленным. Заполните поля и нажмите Сохранить ключи, когда будете готовы.

Каждая карточка на вкладке Установленные сообщает своё состояние:

• Без метки — всё готово к работе.
• Нужна настройка (оранжевая) — ключей нет. На карточке есть кнопка Настроить ключи, она открывает то же окно.
• Настроен (зелёная) — ключи сохранены. Окно можно открыть снова и заменить значение, а пустое поле оставит прежнее.
• Требуется OAuth — на карточке кнопка подключения аккаунта, например Подключить аккаунт Google. По нажатию открывается всплывающее окно входа провайдера, а после него карточка показывает, какой аккаунт подключён. Notion подключается так же.

Ключи и подключения хранятся на уровне приложения: один ключ Stripe работает во всех сценариях этого приложения.

Нигде нового. Вернитесь на холст, откройте блок «Действие» и нажмите Добавить действие. Под встроенными действиями в меню появился раздел Модули: действия сгруппированы по модулям, каждая группа — под своим логотипом.

Выберите любое — оно встанет в блок как обычное действие, со своими полями: таблица и строка для «Добавить строку», чат и текст для «Отправить сообщение». Всё, что написано про порядок действий, результаты и переменные в статье Блок «Действие»: всё, что умеет ваш бот, работает и здесь. Переменные попадают в поля модуля из окна выбора переменных и выглядят как плашки — например {{lead_email}} в ячейке таблицы. Вручную их печатать не нужно.

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

Двенадцать модулей:

• Telegram — работа с группами и каналами: отправить сообщение, фото или документ, создать ссылку-приглашение, проверить участника, ограничить, забанить, назначить администратором. Плюс два триггера: пост в канале и изменение участника.
• Google Таблицы — добавить, обновить и удалить строку в подключённой таблице.
• Gmail — отправлять письма, искать, читать, обновлять и удалять сообщения.
• Google Календарь — список календарей, создание и правка событий, проверка занятости.
• Notion — поиск по содержимому, создание и обновление страниц, запросы к источникам данных.
• OpenAI AI — спросить ChatGPT и получить текстовый ответ или сгенерировать речь.
• Stripe — платежи — checkout-сессии, оформление подписки, статус платежа, возвраты и вебхук платёжных событий.
• YooKassa — платежный провайдер — то же самое для российских платежей, со своим вебхуком.
• TomoAds — рекламные сообщения: способ зарабатывать на боте, а не брать деньги за него.
• Генерация AI-изображений — новые картинки по промпту.
• Генерация AI-видео — короткие ролики на 4–12 секунд. Рендер идёт несколько минут, поэтому запускайте такое действие в фоновом режиме.
• Обработка изображений — предсказуемая правка готовых картинок: наложение, обрезка, изменение размера и формата.

Отдельные статьи по каждому модулю ещё впереди. Пока полный список действий видно прямо на карточке — по кнопке со счётчиком.

В меню «Добавить действие» нет раздела «Модули». Скорее всего, модуль установлен в другое приложение. Проверьте переключатель слева вверху.

Действие модуля завершается ошибкой при работе бота. Откройте вкладку Установленные. Обычная причина — оранжевая метка «Нужна настройка» или неподключённый аккаунт: действие срабатывает, а внешний сервис его отклоняет.

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

Все части бота на месте — покажите его живым людям: Тест и публикация бота