Справочник узлов

Полное описание всех типов узлов конструктора потоков: входы, выходы, параметры конфигурации и примеры использования.

Триггеры

Каждый граф должен начинаться с узла-триггера. Триггер не имеет входного порта.

Тип	Описание	Выходы
`trigger_widget`	Входящее сообщение от виджета на сайте	`output`
`trigger_webhook`	Входящий POST-запрос на `/api/webhook/{key}`	`output`
`trigger_telegram`	Сообщение из Telegram-бота	`output`

AI-узлы

AI Chat

Отправляет сообщение в AI и получает ответ. Результат сохраняется в {{reply}}.

Параметр	Тип	Описание
`integration_id`	int	ID AI-интеграции (обязательно)
`system_prompt`	string	Системный промт. Поддерживает `{{variables}}`
`temperature`	0–2	Температура генерации (по умолч. 0.7)
`max_tokens`	int	Максимум токенов в ответе
`output_variable`	string	Имя переменной для ответа (по умолч. `reply`)

Выходы: output

AI Classify

Классифицирует входящее сообщение в одно из заданных намерений. Подробнее в разделе AI роутер контекста.

Параметр	Тип	Описание
`integration_id`	int	ID AI-интеграции
`intents`	array	Список ключей намерений (напр. `["sales","support"]`)
`classify_prompt`	string	Дополнительные подсказки для классификации

Выходы: по одному порту на каждое намерение + unknown

AI Extract

Извлекает структурированные данные из текста сообщения. Каждое поле сохраняется в {{extracted_fieldname}}.

Параметр	Тип	Описание
`integration_id`	int	ID AI-интеграции
`fields`	array	Имена полей для извлечения: `["name","email","budget"]`
`extract_prompt`	string	Подсказки для AI об ожидаемых данных

Выходы: output — всегда активен независимо от результата извлечения

Логика

Condition

Разветвляет поток по булевому условию. Сравнивает переменную с константой.

Параметр	Описание
`variable`	Имя переменной контекста (без `{{}}`)
`operator`	`eq`, `neq`, `gt`, `lt`, `contains`, `empty`
`value`	Значение для сравнения

Выходы: yes (условие истинно), no (ложно)

Switch

Ветвит поток по значению переменной (аналог switch/case).

Параметр	Описание
`variable`	Имя переменной контекста
`cases`	Массив значений `["vip","standard","trial"]`

Выходы: по одному порту на каждый case + default

Transform

Создаёт или изменяет переменные контекста. Поддерживает шаблонные выражения.

Примерgreeting  = "Здравствуйте, {{extracted_name}}!"
crm_note  = "Клиент: {{extracted_name}}, тема: {{detected_intent}}"
is_urgent = "{{extracted_budget > 100000}}"

Выходы: output

Delay

Приостанавливает выполнение на заданное время (асинхронно).

Параметр	Описание
`seconds`	Задержка в секундах (1–300)

Выходы: output

Действия

Action Reply

Отправляет ответ пользователю в канал, из которого пришёл запрос.

Параметр	Описание
`text`	Текст ответа. Поддерживает `{{variables}}`. По умолч. `{{reply}}`

Webhook Call

Отправляет HTTP-запрос на внешний сервис. Ответ сохраняется в {{webhook_response}}.

Параметр	Описание
`url`	URL эндпоинта
`method`	`POST`, `GET`, `PUT`, `PATCH`
`headers`	JSON-объект заголовков
`body`	Тело запроса. Поддерживает `{{variables}}`

Выходы: output

Telegram Send

Отправляет сообщение в Telegram-бот или конкретный чат.

Параметр	Описание
`integration_id`	ID Telegram-интеграции
`chat_id`	ID чата (если не указан — ответ текущему пользователю)
`text`	Текст сообщения. Поддерживает `{{variables}}`

1C Request

Запрос к системе 1С через настроенный коннектор. Ответ в {{onec_response}}.

Параметр	Описание
`integration_id`	ID 1C-интеграции
`method`	Имя метода 1С
`params`	Параметры запроса. Поддерживает `{{variables}}`

Action Log

Записывает данные в журнал выполнения пайплайна без отправки ответа пользователю.

Параметр	Описание
`message`	Сообщение лога. Поддерживает `{{variables}}`
`level`	`info`, `warn`, `error`

End

Явное завершение ветки. Используйте, когда ветка не должна отправлять ответ пользователю.

Параметров нет. Выходов нет.