Процесс автоматизации собран, отлажен и работает. Теперь его нужно повторить: в тестовом пространстве, у второго клиента, на собственном сервере компании или просто показать коллеге. Раньше такой workflow приходилось собирать заново узел за узлом — и надеяться, что ни одна настройка не потерялась.
В Staqflow появились экспорт и импорт workflow: процесс выгружается в один JSON-файл и загружается обратно в любое пространство или на другую установку платформы. Разберём, как это работает, что попадает в файл, что остаётся на месте и как безопасно переносить процессы с подключениями к CRM, 1С и другим сервисам.
Что такое экспорт и импорт workflow
Экспорт workflow — выгрузка процесса в файл *.workflow.json: название, настройки, все узлы с параметрами и связи между ними. Импорт workflow — загрузка такого файла в Staqflow: узлы появляются на холсте, связи сохраняются, а подключения к сервисам подставляются, если они есть в пространстве.
Главное правило переноса: секреты в файл не попадают. Токены, пароли и OAuth-ключи остаются в учётных данных пространства, из которого процесс выгрузили.
Когда пригодится перенос процесса файлом
- Тест и прод. Собрали и проверили процесс в пространстве «Тесты» — перенесли в «Прод», где у него свои подключения и свои переменные.
- Одинаковые процессы для разных клиентов. Интегратор или агентство делает процесс один раз — например, передачу заявок с сайта в CRM с уведомлением в Telegram — и разворачивает его в пространстве каждого клиента.
- Переезд из облака в собственный контур. Процессы из облачного Staqflow переносятся на on-premise установку файлами, без ручной пересборки.
- Резервная копия перед большой правкой. Выгрузили рабочую версию — если эксперимент не удался, её можно вернуть на холст.
- Обмен опытом. Файл можно отправить коллеге или приложить к задаче: в нём нет ключей доступа, а значит, и риска утечки учётных данных.
- Хранение процессов в git. Файл — это читаемый JSON с отступами, его удобно хранить в репозитории и смотреть изменения между версиями.
Как экспортировать workflow
- Откройте процесс на холсте.
- Нажмите на меню в шапке редактора.
- Выберите «Экспорт в файл».
Браузер скачает файл с именем по названию процесса, например zayavki-s-sayta.workflow.json.
В файл попадает то, что сейчас на холсте, включая ещё не сохранённые правки. Удобно, если вы хотите выгрузить вариант процесса, не записывая его поверх рабочей версии.
Что попадает в файл, а что нет
| Переносится | Не переносится |
|---|---|
| Название процесса | Токены, пароли, API-ключи и OAuth-доступы |
| Настройки процесса: часовой пояс, язык | Значения переменных пространства |
| Все узлы, их параметры и настройки: повторы, заметки, поведение при ошибке | Признак «включён»: новый процесс из файла создаётся выключенным |
| Связи между узлами | История запусков |
Выражения, в том числе $vars.ключ | Участники и права пространства |
| Имя и идентификатор подключения на узле |
Внутри файл выглядит так:
{
"format": "staqflow.workflow",
"version": 1,
"exported_at": "2026-09-17T10:00:00.000Z",
"workflow": {
"name": "Заявки с сайта",
"settings": { "timezone": "Europe/Moscow" },
"nodes": [ ... ]
}
}
Поле format отличает файл Staqflow от любого другого JSON, а version — версию формата. Если файл создан более новой версией платформы, импорт честно откажет и попросит обновить приложение, а не загрузит процесс с потерями.
Как импортировать workflow
Импортировать файл можно двумя способами.
Новый процесс из списка
- Откройте список workflow в пространстве.
- В меню над списком выберите «Импорт из файла».
- Укажите файл
*.workflow.json.
Откроется редактор нового процесса с узлами из файла. Подключения, которые есть в пространстве, подставятся сами, остальные останутся пустыми на узлах. Процесс ещё не сохранён: проверьте его и нажмите «Сохранить».
Замена открытого процесса
- Откройте процесс на холсте.
- В меню шапки выберите «Импорт из файла».
- Проверьте сводку по файлу и нажмите «Импортировать».
В сводке Staqflow предупредит, что текущие узлы и связи будут заменены содержимым файла. Идентификатор процесса и пространство остаются прежними, а изменения применятся только после сохранения. Передумали — просто не сохраняйте.
В обоих случаях узлы получают новые идентификаторы. Поэтому файл можно спокойно импортировать даже в то же пространство, откуда его выгрузили: копия не конфликтует с оригиналом.
Что Staqflow проверяет при импорте
Любой импорт начинается с разбора файла. Файл не примут, если он не читается как JSON, не является файлом workflow Staqflow, создан более новой версией платформы или в нём нет ни одного узла.
При импорте в открытый редактор платформа ещё и показывает сводку перед заменой:
- сколько узлов в файле;
- какие подключения нашлись в пространстве и подставятся сами;
- каких подключений нет — по именам, чтобы было понятно, что выбрать на узлах;
- какие узлы неизвестны этой установке — они появятся на холсте, но работать не будут (например, если на вашем сервере другая версия каталога интеграций).
Подключения и безопасность
Учётные данные — самая чувствительная часть любой интеграции, поэтому с ними экспорт работает осторожно.
В файл уходит только ссылка на подключение и его имя. Всё остальное, что могло храниться в этом поле узла, отбрасывается при выгрузке и ещё раз при загрузке — даже если файл отредактировали руками.
При импорте ссылка оживает, только если такое подключение есть в пространстве. Импортировали процесс туда же, откуда выгрузили, — подключения подставятся сами. Перенесли в другое пространство или на другой сервер — ссылки на чужие подключения удаляются, а при импорте в открытый редактор их имена показываются в сводке. Останется выбрать нужные подключения на узлах.
Так процесс невозможно привязать к чужим учётным данным, а файл безопасно пересылать по почте или хранить в репозитории.
Что стоит проверить перед отправкой файла:
- Не вписаны ли ключи прямо в поля узлов. Токен, вставленный текстом в заголовок HTTP-запроса, — это обычный параметр, и он уйдёт в файл. Храните ключи в учётных данных, а общие значения — в переменных пространства.
- Нет ли в узлах закреплённых тестовых данных с реальными данными клиентов. Перед выгрузкой для внешних получателей их лучше открепить.
Переменные при переносе
Значения переменных в файл не попадают — остаются выражения вида {{ $vars.api_url }}. В новом пространстве процесс берёт его собственные переменные с теми же ключами.
Это удобно для схемы «тест — прод»: в пространстве «Тесты» api_url указывает на тестовый сервер, в «Проде» — на боевой. Один и тот же файл работает в обоих местах без правок. Если нужной переменной в новом пространстве нет, создайте её до первого запуска.
Чек-лист после импорта
- Выберите подключения на узлах, где они не подставились.
- Создайте переменные с теми же ключами, если процесс использует
$vars. - Проверьте триггер: адрес вебхука, расписание и часовой пояс в настройках процесса.
- Проверьте workflow для ошибок в настройках: если он указан, выберите процесс из нового пространства.
- Сохраните процесс.
- Сделайте тестовый запуск и посмотрите результат каждого узла.
- Включите процесс — новый процесс из файла создаётся выключенным, чтобы ничего не запустилось раньше времени.
Экспорт, дублирование или MCP: что выбрать
| Задача | Способ |
|---|---|
| Копия процесса в том же пространстве | «Дублировать» в списке workflow |
| Перенос в другое пространство или на другой сервер | Экспорт и импорт файлом |
| Резервная копия и хранение в git | Экспорт в файл |
| Собрать похожий процесс по описанию | ИИ-клиент через MCP |
Через MCP-сервер Staqflow ИИ-клиент — Claude, ChatGPT, Cursor, Codex или GigaCode — может прочитать существующий процесс и собрать на его основе новый в пространстве, к которому у вас есть доступ. Экспорт в файл удобнее, когда нужна точная копия, передача без доступа к исходному пространству или перенос на другую установку платформы.
Частые вопросы
Переносятся ли пароли и токены при экспорте workflow?
Нет. В файл попадают только имя и идентификатор подключения. Сами учётные данные остаются зашифрованными в исходном пространстве.
Можно ли перенести workflow из облака Staqflow на свой сервер?
Да. Выгрузите процесс в облаке и импортируйте файл на on-premise установке. Подключения на новом сервере выберите заново — ссылки на облачные учётные данные там не действуют.
Импортированный процесс сразу начнёт работать?
Нет. Импорт ничего не сохраняет сам, а новый процесс из файла создаётся выключенным. Включить его нужно вручную после проверки.
Что будет с переменными $vars?
В файле остаются выражения, значения не переносятся. Процесс использует переменные того пространства, куда его импортировали.
Можно ли импортировать файл в то же пространство?
Да. Узлы получат новые идентификаторы, подключения этого пространства подставятся автоматически.
Можно ли отредактировать файл вручную?
Можно: это обычный JSON. При импорте Staqflow починит мелкие повреждения — например, выдаст новый идентификатор узлу без него, — но узлы без типа будут пропущены.
Что если на сервере нет какого-то узла из файла?
При импорте в открытый редактор Staqflow перечислит такие узлы. Они появятся на холсте, но выполняться не будут, пока интеграция не появится на установке.
Попробуйте
- Создайте аккаунт — личное пространство появится сразу.
- Соберите процесс на холсте или попросите свой ИИ-клиент через MCP.
- Выгрузите его через «Экспорт в файл» и импортируйте в новое пространство — например, для тестов.
Подробнее о работе с процессами — в документации.