Основні концепції

Flows

Flow — це конвеєр автоматизації. Починається з event та містить послідовність actions і functions, що виконуються по порядку.

Events

Event — це те, що запускає flow. Приклади:

  • Telegram Bot Update — хтось надіслав повідомлення боту
  • Telegram Update — повідомлення прийшло на ваш особистий акаунт
  • API Trigger — зовнішній сервіс надіслав HTTP запит на ваш webhook URL
  • Helper Flow — інший flow викликає цей через Call Flow або ForEach

Кожна подія створює outputs (текст повідомлення, ID користувача, дата тощо), які можна використовувати в наступних блоках.

Actions

Actions взаємодіють із зовнішніми сервісами:

  • Надіслати повідомлення Telegram
  • Викликати OpenAI з промптом
  • Зробити HTTP запит

Actions мають inputs (що надіслати) та outputs (що повернулось).

Functions

Щоб додати функцію, натисніть Add function в редакторі. Побачите вибір категорій:

Functions

Choose a category

Functions трансформують дані без виклику зовнішніх сервісів:

  • Text: конкатенація, заміна, розділення, пошук
  • Number: додавання, множення, округлення, формула
  • Object: отримання, встановлення, об'єднання, конструювання
  • List: фільтрація, сортування, forEach, map
  • Logic: if/else, continue if, lookup

З'єднання (Connections)

Connection з'єднує Fainflow із зовнішнім сервісом. Зберігає облікові дані (токен бота, API ключ тощо) безпечно. Одне з'єднання може використовуватись кількома flows.

Drag & Drop

Outputs будь-якого блоку можна перетягнути в inputs наступних блоків. Так дані переміщуються між кроками. Кольорові значки показують з якого блоку кожне значення.

Helper Flows

Helper flow — це багаторазовий під-потік, який запускається через:

  • Call Flow — запустити один раз і отримати результат
  • ForEach — запустити для кожного елемента списку
  • Repeat — запустити N разів

Розгалуження

Використовуйте Continue If для фільтрації повідомлень, або If/Else для умовної логіки:

Conditional Logic

Check if message is a command, then respond differently

Telegram Bot

Bot Update

message
userID

Branching

Continue If

value a
message
comparison
starts with
value b
/start

Telegram Bot

Send Message

chatId
userID
text
Welcome! How can I help?

Vault (Сховище секретів)

Vault зберігає чутливі значення (API ключі, токени, паролі) зашифровані AES-256. Посилайтесь на них у будь-якому полі через {{vault.KEY_NAME}}. Значення маскуються в історії виконання.